Short:        How To Write Amigaguide Documents
Uploader:     bunton@acay.com.au (Frank Bunton)
Author:       bunton@acay.com.au (Frank Bunton)
Requires:     Amigaguide or Multiview
Version:      01.04
Replaces:     docs/help/aguidehowwrite.lha
Replaces:     docs/help/aguidehowwriteN.lha
Type:         docs/help
Distribution: * Commercial Magazines and CDs must request permission
                from author to include.
              * Non commercially, it can be distributed anywhere.
              * Aminet CDs & Fish CDs may include.

Description: 
-----------

This is a comprehensive guide to writing documents in Amigaguide format.
Of course, this document, itself, is in Amigaguide format ;-)
So you will need either Amigaguide or Multiview to read it properly.

There are plenty of examples included and lots of cross referencing.

Differences in the various versions of the amigaguide.library and
amigaguide.datatype are covered.

Changes In Version 1.04 05-12-97
--------------------------------

* Oh dear oh dear!!!! - found out that Amigaguide/Multiview in Version 39
  will NOT show lines which have this sequence of characters:-

     a backslash
     the @ symbol
     any character immediately after the @ other than space or {

  so users of version 39 had a lot of blank lines while reading this
  project!!! (VERY strange as versions 34 and 40 DO show such lines!!!).

  COMPLETELY REWROTE THE WHILE PROJECT TO FIX THIS V39 PROBLEM!!

* As I have now been able to access a version 39 setup I have revised all
  sections where there was doubt expressed as to how version 39 reacted. 

* I found out that there is a problem with `Retrace' with links to lines in
  the same node when using version 39. I have therefore created a lot more
  nodes rather than having links to lines other than the first in the node.

* Added the section on the BEEP section.

* Added a bit to the Unrecognised Commands to explain what happens when the
  unrecognised command is set up similarly to link commands.

* Added section on Current Directory recognised by Amigaguide/Multiview.

* Transferred section on Links to Non Amigaguide Documents from the node
  Links To Document Nodes to its own node.

* Added section on the debugging feature which resulted in a slight change
  to the DATABASE section.

* Rewrote "Problem 7" when I found that versions 34 and 39 did NOT react in
  the same way as I had previoulsy thought they did.

* A LOT of other minor cosmetic changes that have made no real change to the
  context. These are too numerous to mention.

The contents of this archive are:-
----------------------------------

  Amigaguide_How_To_Write (Dir)
    AGHTW_Boring_Stuff            20172
    AGHTW_Index                   24650
    AGHTW_Part1                   31112
    AGHTW_Part2                   42555
    AGHTW_Part3                   49865
    AGHTW_Part4                   35515
    AGHTW_Part5                   22413
    aguidehowwrite.readme          4037
    How_To_Write_Amigaguide         681
    How_To_Write_Amigaguide.info   2619
    Installation                   1766
    Installation.info               835

  Help (Sub Dir)
    ExtraNotes                     1254

  Miscellaneous (Sub Dir)
    adosbegin30.readme             3189
    AG_Settings                      28
    amigalogo.pic                  7334
    arexxbegn20.readme             3744
    AssignMyProgram                  21
    BasicDoc.guide                   78
    Cuckoo.snd                     4810
    DemoScript                      560
    Demo_Of_Settings.guide          320
    Demo_Of_Settings.rexx          1137
    helpdoc.guide                  1018
    MV_Settings                      28
    Testprogram.guide               336
    Testprogram_close.rexx          331
    Testprogram_open.rexx           333

--------------------------------------------------------------------
Frank Bunton   bunton@acay.com.au    http://www.acay.com.au/~bunton
--------------------------------------------------------------------