Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP Posting-Version: version B 2.10.1 6/24/83 (MC840302); site boring.UUCP Path: utzoo!linus!philabs!cmcl2!seismo!mcvax!boring!guido From: guido@boring.UUCP Newsgroups: net.sources.mac Subject: Re: New SUMacC rmaker.shar (manual updates) Message-ID: <6504@boring.UUCP> Date: Fri, 12-Jul-85 12:06:04 EDT Article-I.D.: boring.6504 Posted: Fri Jul 12 12:06:04 1985 Date-Received: Tue, 16-Jul-85 01:50:39 EDT References: <2287@ut-sally.UUCP> <6500@boring.UUCP> Reply-To: guido@mcvax.UUCP (Guido van Rossum) Distribution: net Organization: "Stamp Out BASIC" Committee, CWI, Amsterdam Lines: 137 Summary: Correct documentation is as important as working code! Apparently-To: rnews@mcvax.LOCAL Here are the manual updates for my rmaker patches. Use "patch" in the directory where you unpacked the posting by Brian Powell. Guido van Rossum, CWI, Amsterdam (guido@mcvax.UUCP) *** posted-rmaker.doc Fri Jul 12 09:44:24 1985 --- rmaker.doc Fri Jul 12 10:00:25 1985 *************** *** 2,7 FORMAT OF THE SUMACC RESOURCE COMPILER INPUT FILE Modified 07/01/85 by Brian Powell Adapt for SUMacC 07/06/85 Brian Powell mention backslash escapes _______________________________________________________________________________ You'll need to create a resource file for your application. This is --- 2,8 ----- FORMAT OF THE SUMACC RESOURCE COMPILER INPUT FILE Modified 07/01/85 by Brian Powell Adapt for SUMacC 07/06/85 Brian Powell mention backslash escapes + 07/12/85 Guido van Rossum change escapes and POST _______________________________________________________________________________ You'll need to create a resource file for your application. This is *************** *** 98,105 - The Type statements must be grouped by type in the input file. ! - In general, all strings may include backslash escape characters. ! (\b, \f, \n, \r, \t, \377, \x7a, etc.) Type WIND Window template --- 99,106 ----- - The Type statements must be grouped by type in the input file. ! - In general, all strings may include backslash escape sequences ! (\XX, where XX are two hexadecimal digits). Type WIND Window template *************** *** 221,227 [ SEE NOTE 3 BELOW ] Type POST Postscript resource ,1 Resource ID - 4 Number of strings This is string one The strings... This is string two Third string --- 222,227 ----- [ SEE NOTE 3 BELOW ] Type POST Postscript resource ,1 Resource ID This is string one The strings... This is string two Third string *************** *** 226,231 This is string two Third string Bench warmer Apple's joke, not mine. Notes: --- 226,232 ----- This is string two Third string Bench warmer Apple's joke, not mine. + Blank line required following POST Notes: *** posted-rmaker.1 Fri Jul 12 09:46:35 1985 --- rmaker.1 Fri Jul 12 09:56:19 1985 *************** *** 29,37 The optional \-d (debug) switch will list out in hex the contents of all resources matching that four letter type. .PP ! The usual backslash escape sequences are allowed in strings (\\[bfnrt] and ! \\ooo where the "o"'s are octal digits.) Also, \\xhh is allowed where "h" is ! a hexadecimal digit. .SH SEE ALSO "Putting Together a Macintosh Application" (note: this manual is no longer part of Inside Macintosh) --- 29,36 ----- The optional \-d (debug) switch will list out in hex the contents of all resources matching that four letter type. .PP ! The hexadecimal escape sequences that are (were once) described in Inside Mac ! are allowed in strings (\\XX where XX are two hexadecimal digits). .SH SEE ALSO "Putting Together a Macintosh Application" (note: this manual is no longer part of Inside Macintosh) *************** *** 49,54 to simulate unimplemented types. GNRL would be even better for this (if someone would only implement it!) .PP Rmaker input has no "standard" format. Where possible, the format of the Lisa Rmaker has been used. In the case of STR#, the format is different than that of the Mac Rmaker. See "Format of the SUMacC Resource Compiler --- 48,57 ----- to simulate unimplemented types. GNRL would be even better for this (if someone would only implement it!) .PP + The "nonstandard menu" feature of the Lisa Rmaker is not supported. + .PP + While initial spaces are skipped on most input lines, tabs are not! + .PP Rmaker input has no "standard" format. Where possible, the format of the Lisa Rmaker has been used. In the case of STR#, the format is different than that of the Mac Rmaker. See "Format of the SUMacC Resource Compiler *************** *** 53,58 Lisa Rmaker has been used. In the case of STR#, the format is different than that of the Mac Rmaker. See "Format of the SUMacC Resource Compiler Input File." .PP If you get the message "impossible relocation", it usually means your b.out had some undefined external references; check the error output --- 56,62 ----- Lisa Rmaker has been used. In the case of STR#, the format is different than that of the Mac Rmaker. See "Format of the SUMacC Resource Compiler Input File." + (POST is treated the same as STR#.) .PP If you get the message "impossible relocation", it usually means your b.out had some undefined external references; check the error output