home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / util / editor / gnuid16.sit / indent-1.6 / *README.MPW* next >
Encoding:
Text File  |  1992-10-23  |  5.8 KB  |  123 lines
  1. GNU INDENT FOR MPW version 1.6r1            october 22, 1992
  2.  
  3. This is GNU indent for MPW version 1.6r1.
  4. The version 1.6 is the latest version of Indent available from GNU.
  5. This port has been made on the 1.4 port, which I made also and was based on
  6. a port of v 1.1.
  7. The manual is the same as for v 1.4 which in turn is the same as v 1.3.
  8. There are no additional features documented, only several bug fixes.
  9. One bug fix avoided me to make a strange klugde to use commando. Previously
  10. Indent wanted -c33, -cd37 but NOT -c 33 , -cd 37 etc... Now the support for this
  11. has been added by the author so the port was even faster.
  12. The tool has been compiled for the 68000 and thus can now be run on every macintosh
  13. without having to recompile it. The speed difference between the version compiled
  14. with the -mc68020 flag and this one is less than 3% (on my tests, which consisted
  15. simply in timing the tool on the whole Indent source). This because Indent is
  16. heavily I/O based and code optimization can do little.
  17. For other things see the notes below. If there are conflicts with what is written
  18. above, then what is above is right, and what is below wrong. That is new notes
  19. supersede older ones.
  20.  
  21. ------------------------------------------------------------------------------
  22. GNU INDENT FOR MPW version 1.4                october 15, 1992
  23.  
  24. Well, some days ago I picked up J. Kowalski's port of GNU Indent v1.1
  25. to the MPW environment. Moreover I noticed that v1.4 was around, but only
  26. for u**x boxes (of course, being it currently mantained by GNU ...:{ )
  27. So I got the v1.4 dist and patched it as Kowalski did with v1.1, then
  28. fixed something, modified the commando to support the many new functions,
  29. and made the beachball spin. Yes, that was really needed, sometimes I
  30. leave the shell in the background to reformat big chunks of code, therefore
  31. cursor spinning (which is the MPW way to cooperatively multitask) was a
  32. must. Now it's here. It works.
  33. now false (v1.6r1) : NOTE THAT THE TOOL HERE IS FOR THE 68020/030/040, SO IT WORKS ON A LC, BUT
  34. now false (v1.6r1) : NOT ON A CLASSIC I OR SE. TO USE IT WITH SMALLER MACS CHANGE THE OPTIONS IN
  35. now false (v1.6r1) : THE MAKEFILE AND REBUILD IT.
  36. I hope you'll find it useful.
  37. Folder {MPW}Indent-1.4:docs: contains documentation.
  38. The documentation is found as a .dvi file (created by OzTeX. to use it with
  39. DirectTex change type/creator, to use it with TeXtures import it, I believe
  40. a tool for the purpose is around, but don't ask me), or i three postscript 
  41. files. one contains all the pages, the secont the odd ones, another the 
  42. even ones. The names are quite obvious (explanation for Dan Quayle's fans):
  43.         oddpages.ps        front cover, pages 1,3,5,7,...
  44.         evenpages.ps    2nd cover page, pages 2,4,6,8,...
  45.         indent.dvi        the .dvi file
  46.         indent0.02.ps    version 0.02 of the documentation
  47. please keep in mind how you insert back your sheets in the laser printer
  48. when printing the odd pages and then the even ones.
  49. Original documentation sources in the GNU-Indent-1.4-original.sit archive.
  50. (AS FOR v1.6 : THE ARCHIVE NAME IS NOW : indent-1.6-original.sit.)
  51.  
  52. Roberto Avanzi
  53. <gandalf@sabrina.dei.unipd.it>        HEY !  ITALY !!!!!!!!
  54. "Those from Italy send you their greetings." (Hebrews 13:24-NIV)
  55.  
  56. ----------------------------------------------------------------------------
  57. ORIGINAL NOTE OF JEFFREY KOWALSKI FOLLOWS UNCHANGED
  58. for GNU INDENT FOR MPW version 1.1
  59.  
  60. Well here it is, as promised:  The popular GNU indent program,
  61. all ready for you MPW fans.
  62.  
  63. I'm distributing the whole thing, compiled for a generic Macintosh.
  64. You'll probably want to recompile it with the 68020 flag set if
  65. you can (a bit faster I guess).
  66.  
  67. At the miniumum, to use the ready-made version, follow these easy
  68. steps (gee, just like Betty Crocker!) :
  69.     1. Put a copy of Indent in {MPW}Tools
  70.     2. Copy the Indent.Help.Entry and stick it into {MPW}MPW.Help.
  71.         It goes in right before the *second* entry for Lib.  That's the
  72.         full-blown help entry.  For the "quickie" summary 
  73.         (what you get when you type "help commands"), you'll
  74.         have to look closer to the top of the file.  You can make 
  75.         you own entry there.  Be creative - be a star technical writer!
  76.     3. Dump the manual to a postscript printer.  It's just a pre-ps'ed
  77.         version for those of you without texinfo/tex/dvi2ps.  The
  78.         original is in indent.texinfo.
  79.     3. You might want to make a .indent.pro file.  See the manual
  80.         for further instructions.
  81.     4. Try it out on your favorite yucky code - presto!
  82.  
  83.  
  84. Some added features that you'll love:
  85.     1. A commando!  Gee do people really write those?  Sure!
  86.     2. Executable error messages, similar to those from C.
  87.         Screw up your code a bit (remove a crucial brace) and you'll
  88.         see what I mean.
  89.     3. A help entry (as mentioned above).
  90.     4. For those who love details, a *commented* diff file that
  91.         explains what I did to hack indent into shape.
  92.     5. .indent.pro (see the manual) is now changed to "Indent Prefs"
  93.         I think that makes more sense.  The mac can't have filenames
  94.         that start with a period anyway (remember why?).
  95.     
  96. Some things I left out:
  97.     1. The backup file that's created doesn't have the same file
  98.         type and creator as the original.  This is no big deal,
  99.         since you can just use SetFile.
  100.     2. Tabbing in MPW is usually 4 spaces per tab.  Well, on every
  101.         other machine it's 8.  I changed it and then changed it back
  102.         to the way it was.  I figure if you really care about tabs
  103.         you can use cmd-Y to change the faccess of the file.  Or,
  104.         better yet, use detab/entab to convert it.
  105.     3. I didn't spin the cursor.  Indent works really fast, so this
  106.         isn't really necessary.  I might do that if enough people
  107.         tell me to.  Peer pressure you know.
  108.  
  109. So there you are.  Mail me your comments.  If you like the
  110. program (my mods, I mean), why not mail me a chocolate chip cookie?
  111.  
  112.  
  113. Have fun,
  114. Jeffrey Kowalski
  115.  
  116. jeff@acacia.cadif.cornell.edu
  117. jeff@oak...
  118. AppleLink U1309
  119.  
  120. CADIF Swamp
  121. 172 Hollister Hall
  122. Cornell University
  123. Ithaca, NY 14853