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