home *** CD-ROM | disk | FTP | other *** search
/ Dream 47 / Amiga_Dream_47.iso / Amiga / Docs / aguidehowwrite.readme < prev    next >
Encoding:
Text File  |  1997-12-04  |  3.9 KB  |  108 lines
  1. Short:        How To Write Amigaguide Documents
  2. Author:       bunton@acay.com.au (Frank Bunton)
  3. Uploader:     bunton@acay.com.au (Frank Bunton)
  4. Version:      01.04
  5. Type:         docs/help
  6. Replaces:     docs/help/aguidehowwrite.lha
  7. Replaces:     docs/help/aguidehowwriteN.lha
  8. Requires:     Amigaguide or Multiview
  9. Distribution: * Commercial Magazines and CDs must request permission
  10.  
  11.                 from author to include.
  12.               * Non commercially, it can be distributed anywhere.
  13.               * Aminet CDs & Fish CDs may include.
  14.  
  15. Description: 
  16. -----------
  17.  
  18. This is a comprehensive guide to writing documents in Amigaguide format.
  19. Of course, this document, itself, is in Amigaguide format ;-)
  20. So you will need either Amigaguide or Multiview to read it properly.
  21.  
  22. There are plenty of examples included and lots of cross referencing.
  23.  
  24. Differences in the various versions of the amigaguide.library and
  25. amigaguide.datatype are covered.
  26.  
  27. Changes In Version 1.04 05-12-97
  28. --------------------------------
  29.  
  30. * Oh dear oh dear!!!! - found out that Amigaguide/Multiview in Version 39
  31.   will NOT show lines which have this sequence of characters:-
  32.  
  33.      a backslash
  34.      the @ symbol
  35.      any character immediately after the @ other than space or {
  36.  
  37.   so users of version 39 had a lot of blank lines while reading this
  38.   project!!! (VERY strange as versions 34 and 40 DO show such lines!!!).
  39.  
  40.   COMPLETELY REWROTE THE WHILE PROJECT TO FIX THIS V39 PROBLEM!!
  41.  
  42. * As I have now been able to access a version 39 setup I have revised all
  43.   sections where there was doubt expressed as to how version 39 reacted. 
  44.  
  45. * I found out that there is a problem with `Retrace' with links to lines in
  46.   the same node when using version 39. I have therefore created a lot more
  47.   nodes rather than having links to lines other than the first in the node.
  48.  
  49. * Added the section on the BEEP section.
  50.  
  51. * Added a bit to the Unrecognised Commands to explain what happens when the
  52.   unrecognised command is set up similarly to link commands.
  53.  
  54. * Added section on Current Directory recognised by Amigaguide/Multiview.
  55.  
  56. * Transferred section on Links to Non Amigaguide Documents from the node
  57.   Links To Document Nodes to its own node.
  58.  
  59. * Added section on the debugging feature which resulted in a slight change
  60.   to the DATABASE section.
  61.  
  62. * Rewrote "Problem 7" when I found that versions 34 and 39 did NOT react in
  63.   the same way as I had previoulsy thought they did.
  64.  
  65. * A LOT of other minor cosmetic changes that have made no real change to the
  66.   context. These are too numerous to mention.
  67.  
  68. The contents of this archive are:-
  69. ----------------------------------
  70.  
  71.   Amigaguide_How_To_Write (Dir)
  72.     AGHTW_Boring_Stuff            20172
  73.     AGHTW_Index                   24650
  74.     AGHTW_Part1                   31112
  75.     AGHTW_Part2                   42555
  76.     AGHTW_Part3                   49865
  77.     AGHTW_Part4                   35515
  78.     AGHTW_Part5                   22413
  79.     aguidehowwrite.readme          4037
  80.     How_To_Write_Amigaguide         681
  81.     How_To_Write_Amigaguide.info   2619
  82.     Installation                   1766
  83.     Installation.info               835
  84.  
  85.   Help (Sub Dir)
  86.     ExtraNotes                     1254
  87.  
  88.   Miscellaneous (Sub Dir)
  89.     adosbegin30.readme             3189
  90.     AG_Settings                      28
  91.     amigalogo.pic                  7334
  92.     arexxbegn20.readme             3744
  93.     AssignMyProgram                  21
  94.     BasicDoc.guide                   78
  95.     Cuckoo.snd                     4810
  96.     DemoScript                      560
  97.     Demo_Of_Settings.guide          320
  98.     Demo_Of_Settings.rexx          1137
  99.     helpdoc.guide                  1018
  100.     MV_Settings                      28
  101.     Testprogram.guide               336
  102.     Testprogram_close.rexx          331
  103.     Testprogram_open.rexx           333
  104.  
  105. --------------------------------------------------------------------
  106. Frank Bunton   bunton@acay.com.au    http://www.acay.com.au/~bunton
  107. --------------------------------------------------------------------
  108.