Amigaguide.guide


@database Amigaguide.guide

@Master Amigaguide.texinfo

@Width 76


This is the AmigaGuideĀ® file Amigaguide.guide, produced by Makeinfo-1.55 from 
the input file Amigaguide.texinfo.


@Node "Main" "Amigaguide.guide"



                           The Amigaguide Manual

        The @{i}complete@{ui} documentation of Amigaguide commands.

                    Copyright (C) 1995 By Aric R Caley.


 @{" Copyright " Link "Copyright"} 
 @{" About " Link "About"} 
 @{" Amigaguide Background " Link "Amigaguide Background"} 
 @{" Paths and Nodes " Link "Paths and Nodes"} 
 @{" Global Commands " Link "Global Commands"} 
 @{" Node Commands " Link "Node Commands"} 
 @{" Attribute Commands " Link "Attribute Commands"} 


@EndNode

@Node "Copyright" "Amigaguide.guide/Copyright"
@Next "About"
@Prev "Main"
@Toc "Main"

Copyright
*********

Copyright Notice
----------------

   This document is Copyright (C) 1995 by Aric R. Caley.

Disclaimer
----------

   This document is offered "as is", and the author will not be held
responsible for any damage resulting from mistakes contained within, though
the best effort has been made to ensure that all the information is
complete and correct.

Distribution
------------

   This is only Copyrighted in order to protect the integrity of this
document and to ensure its free availability to all.  You may not directly
profit from the distribution of this document.  You may not put it in a disk
collection without prior permission from the author.  Fred Fish's disks and
CD-ROMed versions of Aminet are exempt.  You may freely and for free
distribute it across any medium.

   If you are a disk distributer, please contact the author and arrange to
receive the latest version.

   There is no shareware registration fee since this is "freeware".
However, contributions are of course welcome.  If there is a demand for a
printed version of this document, please inquire about one.  Printed
versions would be created with a Canon BubbleJet 200 (360 x 360 DPI).

About
-----

   This document was written on an Amiga 500, with an 85MB hd and 4.5MB ram.
The documentation is created with a combination of Makeinfo and TeX /
Metafont.


@EndNode

@Node "About" "Amigaguide.guide/About"
@Next "Amigaguide Background"
@Prev "Copyright"
@Toc "Main"

Amigaguide
**********

About
=====

   Like other people, I did not have a single concise source for all the
Amigaguide commands and how they work (or don't as the case may be).  So I
decided to write one.  I believe I have covered all the commands from the
earliest Amigaguide to the latest (release 3.1 of AmigaOS).

   I've also considered writting more about how to work with Amigaguide as
a programer (how to work with dynamic hosts, the Amigaguide Datatype, etc),
but that will only come later if there is a demand.  I also thought about
doing a general tutorial on writting Amigaguide documents (or Texinfo
documents for that matter).

   I don't claim to be any expert on Amigaguide, but, I do think I do a
fairly good job at rounding up information and compiling it into a nice
readable form.  I hope you will agree.

     Aric R. Caley.
     
     Internet: dances@qedbbs.com
     
     Snail mail (US Postal service):
     
       5829 Los Feliz,
       Buena Park, CA. 90620.
     
     Voice phone:  (714) 229-9957


@EndNode

@Node "Amigaguide Background" "Amigaguide.guide/Amigaguide Background"
@Next "Paths and Nodes"
@Prev "About"
@Toc "Main"

Background
==========

   Amigaguide commands all begin with the '@' (pronounced 'at') symbol.
Most commands must start at the very begining of a line, and should be the
only thing that is on that line.  Although not required for most commands,
you should probably write them all in capital letters as a matter of
discipline (it also makes them much easier to see and keep track of!).

   There are three catagories of commands:  Global, Node, and Attributes.
Global commands are usualy specified at the begining of the document,
before any nodes are defined, and apply to all the nodes in the document.
Technicaly, they could be anywhere.  Many commands can be used both globaly
and in nodes.

   Node commands are usable inside of a node (after a '@NODE' and before an
"@ENDNODE"), and affect only the node in which they are used.

   Attributes may be specified anywhere in a normal line.  In addition to
the '@' symbol, attributes always use a pair of braces ('{' and '}') to
enclose the attribute name and possibly additional arguments.

   Many commands have been introduced over time, so some commands require a
minimum OS version.  These commands may be used without too much worry
about compatibility since older versions of Amigaguide largely ignore
unknown commands.  Where a command only works on more recent versions of
the OS, they will be followed by a "V39" or "V40", otherwise they work on
any Amiga.  V39 is AmigaOS/Workbench release 3.0 (only on A1200's and
A4000's), and V40 is release 3.1 (available to anyone willing to pay
through the butt for it).

   To avoid complications in viewing this document with Amigaguide, all the
commands listed will not include the necessary '@' - but don't forget it
when you are authoring an Amigaguide document!


 @{" Global Commands " Link "Global Commands"} 
 @{" Node Commands " Link "Node Commands"} 
 @{" Attribute Commands " Link "Attribute Commands"} 


@EndNode

@Node "Paths and Nodes" "Amigaguide.guide/Paths and Nodes"
@Next "Global Commands"
@Prev "Amigaguide Background"
@Toc "Main"

Paths and Nodes
===============

   The commands INDEX, HELP, NEXT, PREV, TOC and the all purpose hypertext
link specify other nodes to jump to.  They all support the naming of nodes
within the current document, but they also all support a path along with
that name which lets the node be located in any Amigaguide document.

   It is really the essence of the simple.  To access a node in another
document, simply put an AmigaDOS file path before the node name.  You do
not need a complete path including a volume name, if you are sure that the
file is going to be where it should be (generaly, if it is not in the same
directory as the main document, you should use a full path, maybe an
assigned volume name).  Some example paths are:  "s:help.guide/main",
"Amigaguide.guide/Copyright".

   If you are running AmigaOS 3.0 or above, you can jump to any file that is
supported by Datatypes - pictures, animation, anything.  You must still
give a "node" name, even though the file is not an Amigaguide file and has
no "nodes" - so just use "main":  "picture.iff/main".


@EndNode

@Node "Global Commands" "Amigaguide.guide/Global Commands"
@Next "Node Commands"
@Prev "Paths and Nodes"
@Toc "Main"

Global Commands
***************

Global Commands
===============

@{b}$VER: <AmigaDOS version string>@{ub}
     Specify an Amiga standard version string.  "VER" must be uppercase.
     The format for an Amiga version string is:  <name> (mm/dd/yy).  If you
     have this in your Amigaguide file, you can use the AmigaDOS command
     "Version" to get the string.

@{b}(C) <copyright>@{ub}
     Specify a copyright notice for this file.

@{b}AUTHOR <name>@{ub}
     Specify the author of this file.

@{b}DATABASE <name>@{ub}
     Identifies this file as an Amigaguide document.  Must be the very first
     thing in the file!

@{b}DNODE <name>@{ub}
     This is an obsolete command, do not use.  It used to be for indicating
     a "dynamic node", but is not needed because the Amigaguide system will
     search for a node that doesn't exist, at which point a dynamic node
     host can return the node.

@{b}ENDNODE@{ub}
     Specify the end of a hypertext node definition.

@{b}FONT <name> <size>@{ub}
     Specify the font to use for the database.

@{b}HEIGHT <rows>@{ub}
     The number of rows in the largest node.

@{b}HELP  @{ub}
     Specify a help node accessible with the "Help" button.

@{b}INDEX <path/node>@{ub}
     Specify an index node accessible with the "Index" button.

@{b}MACRO <name> <commands>@{ub}
     Define a macro for this document.  A macro is made up of attribute
     commands and or other macros, and is used like other attributes.  A
     macro can override the built in attributes.  A macro can accept
     arguments by embeding a '$' symbol with a number, for each argument
     supported; IE, '$1', '$2', etc.  If an argument is given when using
     the macro, but is not defined in the macro, then it simply doesn't
     appear, which might be usefull to somebody.  V40.

	     Example:

              @macro bold "\@{b} $1 \@{ub}"
                ...
          
              This is an example of a \@{bold "bold"} macro.

@{b}MASTER <path>@{ub}
     Specifies the AmigaDOS file path of the original document this
     Amigaguide file was derived from.

@{b}NODE <name> <title>@{ub}
     Specify the beginning of a hypertext node definition.

@{b}ONCLOSE <rxcommand>@{ub}
     Specify an ARexx script to execute when this document is closed.  The
     script's return value is not significant.  V40.

@{b}ONOPEN <rxcommand>@{ub}
     Specify an ARexx script to execute when this document is opened.  The
     document will not be opened if the script returns an error.  V40.

@{b}REM <remark>@{ub}
@{b}REMARK <remark>@{ub}
     Used to place a remark in the document which is not displayed.

@{b}SMARTWRAP@{ub}
     A more inteligent word wrapping algorithm than WORDWRAP.  Paragraphs
     must be separated by two line feeds (visualy, a blank line).  V40.

@{b}TAB <num>@{ub}
     Define the size in spaces of a tab.  Defaults to 8.  V40.

@{b}WIDTH <chars>@{ub}
     The number of columns in the largest node.

@{b}WORDWRAP@{ub}
     Use wordwrapping for all paragraphs.  To be wordwrapped, the paragraph
     must have no line feeds.  V39.  Since this is ugly to work with, and
     ugly to look at in Amigaguide 2.x and lower, you should use SMARTWRAP
     and write your Amigaguide files to look wordwrapped - this makes your
     document look decent on all systems while taking advantage of V40 and
     above since SMARTWRAP will be ignored on pre-V40 Amiga's.


@EndNode

@Node "Node Commands" "Amigaguide.guide/Node Commands"
@Next "Attribute Commands"
@Prev "Global Commands"
@Toc "Main"

Node Commands
*************

Node Commands
=============

@{b}\\ @{ub}
     Sometimes it is necessary to be able to use the '@' symbol in your
     document.  To prevent it from being interpreted as a command, use the
     '\\' to escape it:  '\\@'.  To use a '\\' itself, you must also escape
     it: '\\\\'.

@{b}FONT <name> <size>@{ub}
     Specify the font to use for this node.  The name must be the complete
     name of the font, IE:  "times.font".

@{b}HELP <path/node>@{ub}
     Specify a help node accessible with the "Help" button.

@{b}INDEX <path/node>@{ub}
     Specify a help node accessible with the "Help" button.

@{b}KEYWORDS <keywords>@{ub}
     Keywords for this node.  Not currently used by Amigaguide.

@{b}MACRO <name> <commands>@{ub}
     Same as the global version.

@{b}NEXT <path/node>@{ub}
     Define the next logical node (if not physicaly located right after this
     one) accessible with the "Browse >" button.

@{b}ONCLOSE <rxcommand>@{ub}
     Specify an ARexx script to execute when this node is closed.  The
     script's return value is not significant.  V40.

@{b}ONOPEN <rxcommand>@{ub}
     Specify an ARexx script to execute when this node is opened.  The node
     will not be opened if the script returns an error.  V40.

@{b}PREV <path/node>@{ub}
     Define the previous logical node (if not physicaly located right before
     this one) accessible with the "< Browse" button.

@{b}SMARTWRAP@{ub}
     Same as the global version, but only effective for this node.  Note:
     No matter where SMARTWRAP appears in the node, it will effect the
     @{i}entire@{ui} node.

@{b}TAB <num>@{ub}
     Define the size in spaces of a tab.  Defaults to 8.  V40.

@{b}TITLE <title>@{ub}
     Specifies the title of this node, which is displayed in the title bar
     of the window when this node is selected.  Must begin at the start of
     a line.

@{b}TOC <path/name>@{ub}
     Specifies the table of contents for this node (the default is the node
     "MAIN") accessible with the "Contents" button.

@{b}WORDWRAP@{ub}
     Same as the global version, but only effective for this node.


@EndNode

@Node "Attribute Commands" "Amigaguide.guide/Attribute Commands"
@Prev "Node Commands"
@Toc "Main"

Attribute Commands
******************

Attribute Commands
==================

@{b}{<label> <command>}@{ub}
     Specify a hypertext link.  Not really an attribute per se, but shares a
     similar syntax and scope.  It may be specified anywhere on a line.

     The command is usualy "LINK", to specify a normal hypertext link.
     There are other commands as follows:

    @{b}ALINK <path/name> <line>@{ub}
          Display the hypertext node in a new window, starting at <line>.
          This no longer works in V39 and up (why not??).

    @{b}CLOSE@{ub}
          Close the window, to be used with ALINK windows.  Doesn't work in
          V39 and up.

    @{b}LINK <path/name> <line>@{ub}
          Display the hypertext node, starting at <line>.

    @{b}RX <command>@{ub}
          Execute an ARexx script.

    @{b}RXS <command>@{ub}
          Execute an ARexx string file.

    @{b}SYSTEM <command>@{ub}
          Execute an AmigaDOS command.

    @{b}QUIT@{ub}
          Shutdown the current database.  Doesn't work in V39 and up.

     The node is the name of a node in this document, or a path to a node in
     another document.  In AmigaOS 3.0 and above, the node may be a path to
     any type of file which is recognized by the Datatypes system.

@{b}{AMIGAGUIDE}@{ub}
     Displays the word "Amigaguide(R)" in bold.  V40.

@{b}{APEN <n>}@{ub}
     Change the foreground (text) colour to specified pen number.  V40.

@{b}{B}@{ub}
     Turn on bolding.  V39.

@{b}{BG <colour>}@{ub}
     Change the background to a preferences defined colour.  Colour can be:

    @{b}Text@{ub}
    @{b}Shine@{ub}
    @{b}Shadow@{ub}
    @{b}Fill@{ub}
    @{b}FillText@{ub}
    @{b}Background@{ub}
    @{b}Highlight@{ub}
@{b}{BODY}@{ub}
     Restore default formatting for normal body text.  V40.

@{b}{BPEN <n>}@{ub}
     Change the background colour to specified pen number.  V40.

@{b}{CLEARTABS}@{ub}
     Restore default tabs.  V40.

@{b}{CODE}@{ub}
     Turn off wordwrapping.  V40.

@{b}{FG <colour>}@{ub}
     Change the foreground colour.  See command BG for colours.  V40.

@{b}{I}@{ub}
     Turn on italics.  V39.

@{b}{JCENTER}@{ub}
     Turn on centered justification.  V40.

@{b}{JLEFT}@{ub}
     Turn on left justification.  V40.

@{b}{JRIGHT}@{ub}
     Turn on right justification.  V40.

@{b}{LINDENT <n>}@{ub}
     Specify an indent in spaces for the body of paragraphs.  V40.

@{b}{LINE}@{ub}
     Force a line feed without starting a new paragraph.  V40.

@{b}{PAR}@{ub}
     Specifies the end of the paragraph, equivalent to two line feeds and
     usable with SMARTWRAP.  V40.

@{b}{PARD}@{ub}
     Reset to default paragraph settings:  APEN to 1, BPEN to 0, original
     font, and LINDENT to 0.  V40.

@{b}{PARI <n>}@{ub}
     Specify an indent in spaces for the first line of a paragraph.  Value
     is relative to LINDENT and may be negative.  V40.

@{b}{PLAIN}@{ub}
     Turns off all style attributes (bold, italics, underlineing).  V40.

@{b}{SETTABS <n> ... <n>}@{ub}
     Specify a series of tab stops in spaces.  V40.

@{b}{TAB}@{ub}
     Outputs a real tab character.  V40.

@{b}{U}@{ub}
     Turn on underlining.  V39.

@{b}{UB}@{ub}
     Turn off bolding.  V39.

@{b}{UI}@{ub}
     Turn off italics.  V39.

@{b}{UU}@{ub}
     Turn off underlining.  V39.

@EndNode