@hyperguide HyperGuide.hguide
@$VER: HyperGuide.hguide 40.7 (02.09.96)
@macro m_prg "@{b}HyperGuide DataType@{ub}"
@macro m_hg_example "The following HyperGuide code :@{line}@{code}@{fg highlight}"
@macro m_hg_exampleend "@{body}@{line}@{fg text}produces : @{line}"
@macro m_cmdsect "@{line}Section : @{b}$1@{ub}"
@macro m_hgnew   "@{line}@{m_bold \"New for $1 hyperguide.datatype.\"}"
@include htds.hgm

@node main "HyperGuide DataType Documentation"
@toc HTDS.hguide

@{jcenter}@{m_title}@{m_copyright}@{m_welcome}@{jleft}

@{settabs 30}
@{m_sec Menu}
@{m_menuitem}@{" Configuration " link Configuration            }@{m_menuinfo "Adapt to your needs"}
@{m_menuitem}@{" Commands "      link Cmds                     }@{m_menuinfo "Overview"}
@{m_menuitem}@{" Attributes "    link Attrs                    }@{m_menuinfo "Overview"}
@{m_menuitem}@{" Standard macros " link StdMacros              }@{m_menuinfo "let the user decide"}
@{m_menuitem}@{" Compatibility " link Compatibility            }@{m_menuinfo "with AmigaGuide"}
@{m_menuitem}@{" New Features "  link NewFeatures              }@{m_menuinfo "compared to AmigaGuide"}
@{line}
@{m_menuitem}@{" Copyright "     link HTDS.hguideCopyright     }@{m_menuinfo "legal stuff"}
@{m_menuitem}@{" Author "        link SR.hguide/Addresses      }@{m_menuinfo "how to contact me"}
@{m_menuitem}@{" Registration "  link HTDS.hguide/Registration }@{m_menuinfo "It's Shareware !!!"}
@{m_endsec}

@endnode
@node Configuration "HyperGuide/Configuration"

@{m_sec "Configuration"}
As the recommended standard for datatypes, the preference file for the
hyperguide.datatype is called @{m_file hyperguide.prefs} and is searched first in the
@{m_file PROGDIR:Prefs/DataTypes} and then in the @{m_file Env:DataTypes} directory.
The following options are currently available using ReadArgs() argument parsing :

@{m_describe "MACRODIR/K,DEBUG/S"}

@{m_describeitem MACRODIR}
Specifies the directory, which contains all macro files/packages. Also macro files
are search in the directory of the @{hyperguide} file it referenced it.

@{m_describeitem DEBUG}
If this option is turned on, all unknown attributes and commands are reported to the
serial line using the KPrintF() function.
@{m_endsec}
@endnode

@node Cmds "HyperGuide/Commands"

@{m_sec "Information"}
@{m_item} Each command must start at the beginning of a line.
@{m_item} Commands can be used in the global section (outside of a node) and
within a node. For the possible usage of each command see the @{m_bold Section}
line in the documentation of the command.
@{m_endsec}

@{settabs 20 40 60 80 100}
@{m_sec "Commands"}
@{m_high "Theme index"}@{line}
@{" Macro " link Cmds_Macro}@{tab}
@{" Misc " link Cmds_Misc}@{tab}
@{" Navigation " link Cmds_Nav}@{tab}
@{" Node " link Cmds_Node}@{tab}
@{" Information " link Cmds_Info}@{tab}
@{" Preference " link Cmds_Prefs}@{tab}
@{line}@{line}
@{m_high "Alphabetic index"}@{line}
@{" @$VER: ... " link Cmds_Info}@{tab}
@{" @(c) ... " link Cmds_Info}@{tab}
@{" @annotation ... " link Cmds_Info}@{tab}
@{" @author ... " link Cmds_Info}@{tab}
@{" @endnode " link Cmds_Node}@{tab}
@{" @font ... " link Cmds_Prefs}@{tab}
@{" @help ... " link Cmds_Nav}@{tab}
@{" @hyperguide ... " link Cmds_Node}@{tab}
@{" @include ... " link Cmds_Macro}@{tab}
@{" @index ... " link Cmds_Nav}@{tab}
@{" @macro ... " link Cmds_Macro}@{tab}
@{" @master ... " link Cmds_Info}@{tab}
@{" @next ... " link Cmds_Nav}@{tab}
@{" @node ... " link Cmds_Node}@{tab}
@{" @prev ... " link Cmds_Nav}@{tab}
@{" @rem ... " link Cmds_Misc}@{tab}
@{" @remark ... " link Cmds_Misc}@{tab}
@{" @smartwrap " link Cmds_Prefs}@{tab}
@{" @tab ... " link Cmds_Prefs}@{tab}
@{" @title ... " link Cmds_Node}@{tab}
@{" @toc ... " link Cmds_Nav}@{tab}
@{" @wordwrap " link Cmds_Prefs}@{tab}
@{m_endsec}
@endnode
@node Cmds_Macro "HyperGuide/Commands/Macro"

@{m_sec "Macro"}
@{m_item} @{m_sample "@macro name \"string\""} :
assigns to a macro named @{m_sample name} the @{m_sample string} string. A macro can
be used the same way as an attribute command, and can consist of other attribute commands,
macros or texts. An argument can be accessed within the macro string using the @{m_sample $}
character followed by the argument number. If you want to use the @{m_sample "\""} character,
you have to escape it with the @{m_sample "\\"} character. For example :
 @{m_sample "\@macro m_item \"\\\@{object \\\"My PicDisk:mybullet.gif\\\"}"}@{line}
The macro list is searched after the standard attribute command list (@{m_bold Note}:
This is the reverse order of the amigaguide.datatype).
@{m_cmdsect "global"}

@{m_item} @{m_sample "@include macrofile"} :
tries to load the @{m_sample macrofile} file. This file is first searched in the directory
of the document and if this fails in the directory configured in the @{"prefs" link Configuration} file.
@{m_cmdsect "global"}
@{m_hgnew "V40"}
@{m_endsec}

@{m_sec Recommendation}
To avoid conflicts with future attribute commands, please use a prefix for your macros
like @{m_sample m_} :@{line}@{line}
@{m_sample "\@macro m_bold \"\@{b}$1\@{ub}\""}
@{m_endsec}

@{m_sec Attention}
The current macro expansion is implemented using recursion. Because the function
is executed in DoAsnycLayout() context with a stacksize of 4096 it may crash the
system with deep macro recursions. Currently a depth of 2 was tested and it looks
save.
@{m_endsec}

@{m_sec "See Also"}
@{" Default Macro File " link StdMacros}
@{m_endsec}
@endnode
@node Cmds_Nav "HyperGuide/Commands/Navigation"

@{m_sec "Navigation"}
@{m_item} @{m_sample "@help <node>"} :
Specify the name of the help node, which will be accessed by the Help button.
@{m_cmdsect "node, global"}
@{m_item} @{m_sample "@index <node>"} :
Specify the name of the index node, which will be accessed by the Index button
@{m_cmdsect "node, global"}
@{m_item} @{m_sample "@next <node>"} :
Node to display when the user selects the "Browse >" button.
@{m_cmdsect "node"}
@{m_item} @{m_sample "@prev <node>"} :
Node to display when the user selects the "Browse <" button.
@{m_cmdsect "node"}
@{m_item} @{m_sample "@toc <node>"} :
Name of the node that contains the table of contents for this node. Defaults
to @{m_sample main}. This is the node that is displayed when the user selects
the "Contents" button.
@{m_cmdsect "node, global"}
@{m_endsec}

@{m_sub "Note"}
Any node you can specifiy, can be a node or file in your system, which can be
displayed through the datatypes system.
@{m_endsec}
@endnode
@node Cmds_Node "HyperGuide/Commands/Node"

@{m_sec "Node"}
@{m_item} @{m_sample "@endnode"} :
Indicate the end of a node.
@{m_cmdsect "node"}
@{m_item} @{m_sample "@node <node> <title>"} :
Indicate the start of a node named @{m_sample "<node>"}. The first node in the
database must be named @{m_high main}. @{m_high Main} must be the master table
of contents for the database.
@{m_cmdsect "global"}
@{m_item} @{m_sample "@title <title>"} :
Title to display in the title bar of the window during the display of this
node.
@{m_cmdsect "node"}
@{m_endsec}
@endnode
@node Cmds_Info "HyperGuide/Commands/Information"

@{m_sec "Information"}
@{m_item} @{m_sample "@$VER: <version string>"} :
Specify the version of the database. This command must always be upper-case,
so that the @{m_file version} program can also find the version information.
@{m_cmdsect "global"}
@{m_item} @{m_sample "@(c) \"<string>\""} or
@{line}@{m_sample "@copyright \"<string>\""} :
Specify the copyright notice for the database.
@{m_cmdsect "global"}
@{m_item} @{m_sample "@annotation \"<string>\""} :
Specify a annotation for the database.
@{m_cmdsect "global"}
@{m_item} @{m_sample "@author \"<string>\""} :
Specify the author of the database.
@{m_cmdsect "global"}
@{m_endsec}

@{m_sec "See Also"}
@{" About Requester " link hypertext.hguide/UserIFace_AboutRequester}
@{m_endsec}
@endnode
@node Cmds_Prefs "HyperGuide/Commands/Preference"

@{m_sec "Preference"}
@{m_item} @{m_sample "@font <name> <size>"} :
Specify the font to use for the database or node.
@{m_cmdsect "node, global"}
@{m_item} @{m_sample "@smartwrap"} :
This is used to indicate that the text of the database or node is to be
wordwrapped. It wordwraps a paragraph and not one physical line. To break
this use the following attributes or two physical line feeds (same as \@{par}) :
@{" @{line} " link ATTRS_PARAGRAPH}, @{" @{par} " link ATTRS_PARAGRAPH}
@{m_cmdsect "node, global"}
@{m_item} @{m_sample "@tab <size>"} :
Number of spaces in a tab. Defaults to 8.
@{m_cmdsect "node, global"}
@{m_item} @{m_sample "@wordwrap"} :
Turns on wordwrapping.
@{m_cmdsect "node, global"}
@{m_endsec}

@endnode
@node Cmds_Misc "HyperGuide/Commands/Misc"

@{m_sec "Misc"}
@{m_item} @{m_sample "@rem string"}
@{m_item} @{m_sample "@remark string"} :
This is used to place remarks in the database. These remarks are not displayed
to the user.
@{m_cmdsect "node, global"}
@{m_endsec}
@endnode

@node Attrs "HyperGuide/Attributes"

@{settabs 20 40 60 80 100}
@{m_sec "Attributes"}
@{m_high "Theme index"}@{line}
@{" Justification " link ATTRS_JUSTIFICATION}@{tab}
@{" Links " link ATTRS_LINKS}@{tab}
@{" Misc " link ATTRS_MISC}@{tab}
@{" Paragraph " link ATTRS_PARAGRAPH}@{tab}
@{" Tabulator " link ATTRS_TABULATOR}@{tab}
@{" Text Color " link ATTRS_TEXTCOLOR}@{tab}
@{" Text Font " link ATTRS_TEXTFONT}@{tab}
@{" Text Style " link ATTRS_TEXTSTYLE}@{tab}
@{line}@{line}
@{m_high "Alphabetic index"}@{line}
@{" @{<text> ...} " link ATTRS_LINKS}@{tab}
@{" @{amigaguide} " link ATTRS_MISC}@{tab}
@{" @{apen ...} " link ATTRS_TEXTCOLOR}@{tab}
@{" @{bg ...} " link ATTRS_TEXTCOLOR}@{tab}
@{" @{body} " link ATTRS_PARAGRAPH}@{tab}
@{" @{bpen ...} " link ATTRS_TEXTCOLOR}@{tab}
@{" @{b} " link ATTRS_TEXTSTYLE}@{tab}
@{" @{cleartabs} " link ATTRS_TABULATOR}@{tab}
@{" @{code} " link ATTRS_PARAGRAPH}@{tab}
@{" @{deffont} " link ATTRS_TEXTFONT}@{tab}
@{" @{fg ...} " link ATTRS_TEXTCOLOR}@{tab}
@{" @{font ...} " link ATTRS_TEXTFONT}@{tab}
@{" @{hyperguide} " link ATTRS_MISC}@{tab}
@{" @{i} " link ATTRS_TEXTSTYLE}@{tab}
@{" @{jcenter} " link ATTRS_JUSTIFICATION}@{tab}
@{" @{jleft} " link ATTRS_JUSTIFICATION}@{tab}
@{" @{jright} " link ATTRS_JUSTIFICATION}@{tab}
@{" @{lindent ...} " link ATTRS_PARAGRAPH}@{tab}
@{" @{line} " link ATTRS_PARAGRAPH}@{tab}
@{" @{link ...} " link ATTRS_LINKS}@{tab}
@{" @{noline} " link ATTRS_MISC}@{tab}
@{" @{object ...} " link ATTRS_MISC}@{tab}
@{" @{pard} " link ATTRS_PARAGRAPH}@{tab}
@{" @{pari ...} " link ATTRS_PARAGRAPH}@{tab}
@{" @{par} " link ATTRS_PARAGRAPH}@{tab}
@{" @{plain} " link ATTRS_TEXTSTYLE}@{tab}
@{" @{quit ...} " link ATTRS_LINKS}@{tab}
@{" @{runcommand ...} " link ATTRS_LINKS}@{tab}
@{" @{rx ...} " link ATTRS_LINKS}@{tab}
@{" @{rxs ...} " link ATTRS_LINKS}@{tab}
@{" @{separator} " link ATTRS_MISC}@{tab}
@{" @{settabs ...} " link ATTRS_TABULATOR}@{tab}
@{" @{style ...} " link ATTRS_TEXTSTYLE}@{tab}
@{" @{system ...} " link ATTRS_LINKS}@{tab}
@{" @{tab} " link ATTRS_TABULATOR}@{tab}
@{" @{ub} " link ATTRS_TEXTSTYLE}@{tab}
@{" @{ui} " link ATTRS_TEXTSTYLE}@{tab}
@{" @{uu} " link ATTRS_TEXTSTYLE}@{tab}
@{" @{u} " link ATTRS_TEXTSTYLE}@{tab}
@{" @{wbstart ...} " link ATTRS_LINKS}@{tab}
@{m_endsec}
@endnode
@node ATTRS_JUSTIFICATION "HyperGuide/Attributes/Justification"

@{m_sec "Justification"}
@{m_item} @{m_sample "\@{jcenter}"} :
turns center justification on.
@{m_item} @{m_sample "\@{jleft}"} :
turns left justification on.
@{m_item} @{m_sample "\@{jright}"} :
turns right justification on.
@{m_endsec}

@{m_sec "Example"}

@{m_hg_example}
\@{line}\@{jright}This text is right aligned
\@{line}\@{jcenter}This text is centered
\@{line}\@{jleft}This text is left aligned
@{m_hg_exampleend}

@{line}@{jright}This text is right aligned
@{line}@{jcenter}This text is centered
@{line}@{jleft}This text is left aligned
@{m_endsec}
@endnode
@node ATTRS_LINKS "HyperGuide/Attributes/Links"

@{m_sec "Links"}
@{m_item} @{m_sample "\@{\"text\" link <node name>}"} or @{m_sample "\@{link text,path}"} :
defines a link with <text> as the visible part <path> the complete path
to a file to open, if this link is executed.
@{m_item} @{m_sample "\@{\"text\" rx <rxcommand>}"} or @{m_sample "\@{rx text,script}"} :
defines a button, which runs a ARexx-script, if its pressed.
@{m_item} @{m_sample "\@{\"text\" rxs <rxcommand>}"} or @{m_sample "\@{rxs text,string}"} :
defines a button, which executes a ARexx-string if its pressed.
@{m_item} @{m_sample "\@{\"text\" system <command>}"} or @{m_sample "\@{system text,command}"} :
defines a button, which runs a normal program, if its pressed.
@{m_item} @{m_sample "\@{\"text\" quit}"} or @{m_sample "\@{quit text}"} :
defines a button, which cause the program to quit, if its pressed.
@{m_item} @{m_sample "\@{\"text\" runcommand <command>}"} of @{m_sample "\@{runcommand text,command}"} :
defines a button, which runs a normal program using the RunCommand() system
call, if its pressed. This makes it possible to send a signal during deletion
of the object. Thus any this way started program could be terminated when the
object is disposed and the program supports Ctrl-C signal.@{line}
@{m_bold Note:} Currently there is a problem with the C:Execute program, which
doesn't work the RunCommand() right now.
@{m_item} @{m_sample "\@{\"text\" wbstart <command>}"} of @{m_sample "\@{wbstart text,command}"} :
defines a button, which starts a program using the wbstart.library, if its
pressed. This makes it possible to run a program totally independent from the
@{hyperguide} object.
@{m_endsec}

@{m_sec "Example"}

@{m_hg_example}
\@{link " Text Style " , ATTRS_TEXTSTYLE} , \@{rx " Show MsgPorts " , /examples/ports.rexx} ,
\@{system " Start Clock " , Sys:Utilities/Clock} , \@{rxs " DisplayBeep " , "ADDRESS MULTIVIEW.1.1 BEEP"}
@{m_hg_exampleend}

@{link " Text Style " , ATTRS_TEXTSTYLE} , @{rx " Show MsgPorts " , /examples/ports.rexx} ,
@{system " Start Clock " , Sys:Utilities/Clock} , @{rxs " DisplayBeep " , "ADDRESS MULTIVIEW.1.1 BEEP"}
@{m_endsec}
@endnode
@node ATTRS_MISC "HyperGuide/Attributes/Misc"

@{m_sec "Misc"}
@{m_item} @{m_sample "\@{amigaguide}"} or @{m_sample "\@{hyperguide}"} :
displays the word HyperGuide in bold
@{m_item} @{m_sample "\@{object <file>}"}
embed the file <file> by using NewDTObjectA() (DTM_DRAW).
@{m_hgnew V40}
@{m_item} @{m_sample "\@{separator}"} :
insert a separator line.
@{m_hgnew V40}
@{m_endsec}

@{m_sec "Example"}

@{m_hg_example}
\@{amigaguide} ,\@{hyperguide}\@{separator}\@{object /pics/Attention.gif}
@{m_hg_exampleend}

@{amigaguide} ,@{hyperguide}@{separator}@{object /pics/Attention.gif}
@{m_endsec}
@endnode
@node ATTRS_PARAGRAPH "HyperGuide/Attributes/Paragraph"

@{m_sec "Paragraph"}

@{m_item} @{m_sample "\@{body}"} :
Indicate that the following text is the body of the
document. Word Wrap will be turned back on if it is the default.
@{m_item} @{m_sample "\@{code}"} :
Indicate that the following text is not to be word-wrapped.
@{m_item} @{m_sample "\@{lindent <chars>}"} :
Set the number of spaces to indent the body of a paragraph.
@{m_item} @{m_sample "\@{line}"} :
Force a line feed without starting a new paragraph.
@{m_item} @{m_sample "\@{par}"} :
Used to indicate the end of a paragraph. This is the same as two
sequential LF's in the source file.
@{m_item} @{m_sample "\@{pard}"} :
Restore the default settings for a paragraph. Text pen to 1,
background to 0, normal style font, default font, and no indentation.
@{m_item} @{m_sample "\@{pari chars}"} :
Set the number of spaces to indent the first line of
a paragraph relative to the normal paragraph indentation. The
value may be a negative number.
@{m_item} @{m_sample "\@{parset}"} :
Set the current horizontal pixel position as the new bodyindent margin.
Now you can indent according to a \@{object ...}
@{m_hgnew V40}
@{m_endsec}

@{m_sec "Example"}
@{m_hg_example}
\@{pari -5}\@{lindent 20}First line of paragraph five chars left\@{line}
paragraph body at twenty chars.\@{par}
@{m_hg_exampleend}

@{pari -5}@{lindent 20}First line of paragraph five chars left@{line}
paragraph body at twenty chars.@{par}
@{m_endsec}
@endnode
@node ATTRS_TEXTCOLOR "HyperGuide/Attributes/Text Color"

@{m_sec "Text Color"}

@{m_item} @{m_sample "\@{apen <pennum>}"} :
set foreground pen to <pennum>.
@{m_item} @{m_sample "\@{bpen <pennum>}"} :
set background pen to <pennum>.
@{m_item} @{m_sample "\@{bg <colortext>}"} :
Used to change the background text color. Color
can be :
@{code}
	 Text
	 Shine
	 Shadow
	 Fill
	 FillText
	 Background
	 Highlight
@{body}
@{m_item} @{m_sample "\@{fg <colortext>}"} :
Used to change the foreground text color. The
same colors can be used as in the @{m_sample "\@{bg <colortext>}"} command.
@{m_endsec}

@{m_sec "Example"}

@{m_hg_example}
\@{apen 2}TextColor set to pen 2\@{bpen 1} and background color to pen 1
\@{bg fill}Now background color to fill\@{fg shine} and text to shine
@{m_hg_exampleend}

@{apen 2}TextColor set to pen 2@{bpen 1}and background color to pen 1
@{bg fill}Now background color to fill@{fg shine} and text to shine
@{m_endsec}
@endnode
@node ATTRS_TEXTSTYLE "HyperGuide/Attributes/Text Style"

@{m_sec "Text Style"}
@{m_item} @{m_sample "\@{b}"} :
turn on bold.
@{m_item} @{m_sample "\@{i}"} :
turn italic on.
@{m_item} @{m_sample "\@{plain}"}
used to turn off all @{m_sample "\@{b}"}, @{m_sample "\@{i}"}, and @{m_sample "\@{u}"} commands.
@{m_item} @{m_sample "\@{style [u]u[,[u]i][,[u]b][,n]}"} :
set font style, if the first character is a 'u' it undefine's the following style.
Styles are :
@{code}
	 `u' -- underlined
	 `i' -- italic
	 `b' -- bold
	 `n' -- reset to normal style
@{body}
@{m_bold "New for V40 hyperguide.datatype."}
@{m_item} @{m_sample "\@{u}"} :
turn underline on.
@{m_item} @{m_sample "\@{ub}"} :
turn bold off.
@{m_item} @{m_sample "\@{ui}"} :
turn italic off.
@{m_item} @{m_sample "\@{uu}"} :
turn underline off.
@{m_endsec}

@{m_sec "Example"}

@{m_hg_example}
\@{code}
\@{b}Bold
\@{i}Bold-Italic
\@{u}Bold-Italic-Underlined
\@{plain}\@{i}Italic
\@{u}Italic-Underlinded
\@{ui}Underlined
\@{plain}\@{style u,b}Underlined-Bold
\@{plain}\@{body}
@{m_hg_exampleend}

@{code}
@{b}Bold
@{i}Bold-Italic
@{u}Bold-Italic-Underlined
@{plain}@{i}Italic
@{u}Italic-Underlinded
@{ui}Underlined
@{plain}@{style u,b}Underlined-Bold
@{plain}@{body}
@{m_endsec}
@endnode
@node ATTRS_TEXTFONT "HyperGuide/Attributes/Text Font"

@{m_sec "Text Font"}

@{m_item} @{m_sample "\@{font <fontname>[,<size>]}"} :
Used to set a TextFont, with name <fontname> and size <size>.
If size isn't specified 8 is used.
@{line}@{m_bold "New for V40 hyperguide.datatype."}
@{m_item} @{m_sample "\@{deffont}"} :
Reset to default font.
@{line}@{m_bold "New for V40 hyperguide.datatype."}
@{m_endsec}

@{m_sec "Example"}

@{m_hg_example}
\@{line}\@{font courier,18}This is Courier 18\@{deffont}, the default \@{font diamond,15}and this Diamond 15
\@{line}\@{font diamond,15}again Diamond 15\@{deffont}, the default \@{font courier,18} and Courier 18
@{m_hg_exampleend}

@{line}@{font courier,18}This is Courier 18@{deffont}, the default @{font diamond,15}and this Diamond 15
@{line}@{font diamond,15}again Diamond 15@{deffont}, the default @{font courier,18} and Courier 18
@{m_endsec}
@endnode
@node ATTRS_TABULATOR "HyperGuide/Attributes/Tabulator"

@{m_sec "Tabulator"}

@{m_item} @{m_sample "\@{cleartabs}"} :
Restore the default tab stops.
@{m_item} @{m_sample "\@{tab}"} :
the same as character 9 in the source file.
@{m_item} @{m_sample "\@{settabs <n> ... <n>}"} :
This is used to establish tab stops.
@{m_endsec}

@{m_sec "Example"}

@{m_hg_example}
\@{settabs 20 40 60}
\@{code}
\@{b}Name\@{tab}Street\@{tab}City\@{tab}Country\@{ub}
\@{separator}
Ruppert,Stefan\@{tab}Windthorststr. 5\@{tab}Flörsheim\@{tab}Germany
\@{separator}
\@{body}
\@{cleartabs}
@{m_hg_exampleend}

@{settabs 20 40 60}
@{code}
@{b}Name@{tab}Street@{tab}City@{tab}Country@{ub}
@{separator}
Ruppert,Stefan@{tab}Windthorststr. 5@{tab}Flörsheim@{tab}Germany
@{separator}
@{body}
@{cleartabs}

@{m_endsec}
@endnode

@node StdMacros "HyperGuide/Standard macros"
@{m_sec "Why standard macros ?"}
These macros are defined to let the user customize the appearance of any
@{hyperguide}, which uses the standard macros. For example one user has a
screen size of 640x400 and another 800x600, so these two user needs different
font sizes for the different sections of a @{hyperguide} document. The
first one sets the title font size two 15 pixel and the second user perhaps to
24 pixel.
@{m_endsec}

@{m_sec "Current standard macros :"}
@{m_sub Fonts}
@{m_sampleitem "\@{titlefont}"}
Normally used to display the document title. This should be the biggest of the
standard font macros.
@{line}Default: @{m_sample "times,24"}
@{m_sampleitem "\@{subtitlefont}"}
Normally used to display the document sub title or the title of a internal node.
This should be the a little smaller than the @{m_sample "\@{titlefont}"}.
@{line}Default: @{m_sample "times,15"}
@{m_sampleitem "\@{sectfont}"}
Normally used to display the title of a section within a document.
This should be the a smaller than the @{m_sample "\@{subtitlefont}"}.
@{line}Default: @{m_sample "times,13"}
@{m_sampleitem "\@{subsectfont}"}
Normally used to display the title of a sub section within a document.
This should be the a smaller than the @{m_sample "\@{sectfont}"}.
@{line}Default: @{m_sample "times,11"}

@{m_sub Misc}
@{m_sampleitem "\@{point}"}
Used to define the begin of an item within an list or enumeration
@{line}Default: @{m_sample ·}
@{m_endsec}

@{m_sec "Default Macro File"}
Each @{HyperGuide} object, tries to load the @{m_file Default.hgm} macro file.
This have to be in the directory configured by the @{HyperGuide}
@{"prefs" link Configuration} file. If you haven't set a macro directory, it
have to be in the @{m_file Help:HyperGuide} directory.@{line}
@{m_endsec}

@{m_sec "See Also"}
@{" Macros " link Cmds_Macro}, @{" Configuration " link Configuration},
@{" Text Font " link ATTRS_TEXTFONT}
@{m_endsec}
@endnode

@node Compatibility "HyperGuide/Compatibility"

@{m_sec Compatibility}
The following things differ to the current AmigaGuide datatype. So please
read it :

@{m_sub "Attributes"}
@{m_item}
The attribute @{" @{amigaguide} " link ATTRS_MISC} display's @{amigaguide}.

@{m_sub "Links"}
@{m_item}
Currently a link to a specific line in a document is not supported.

@{m_sub "Commands"}
@{m_item}
The command @{m_sample \@height} and @{m_sample \@width} aren't implemented.
What use have these commands ? I don't known.
@{m_item}
The @{m_sample \@onopen} and @{m_sample \@onclose} commands aren't implemented yet.
This will be done later.
@{m_item}
The command @{m_sample \@dnode} is not supported and it isn't a keyword.
@{m_item}
The @{m_sample \@keywords} command isn't implemented yet. This will be done later.

@{m_sub "ARexx Commands"}
@{m_item}
The @{m_sample GETNODECOUNT} and @{m_sample PRINT} commands aren't implemented yet.
See @{" ARexx Interface " link hypertext.hguide/ARexxIFace} of the HyperText DataType.
@{m_endsec}
@endnode
@node NewFeatures "HyperGuide/NewFeatures"

@{m_sec "New Features"}
@{m_sub "Attributes"}
@{m_item} Multiple @{"Font" link ATTRS_TEXTFONT} support
@{m_item} Embedding of @{"DataTypes Objects" link ATTRS_MISC}
@{m_item} @{"Separator" link ATTRS_MISC} line
@{m_item} New @{"link" link ATTRS_LINKS} style: \@{link "text",link}
@{m_item} New @{"command launching" link ATTRS_LINKS} commands : \@{wbstart ...} and \@{runcommand ...}
@{m_item} New @{"text style" link ATTRS_TEXTSTYLE} command
@{m_item} New @{"@{parset}" link ATTRS_PARAGRAPH} command

@{m_sub "Commands"}
@{m_item} @{m_sample \@include} command to include @{"macro" link Cmds_Macro} definitions

@{m_sub "ARexx Commands"}
The @{hyperguide} DataType has no own ARexx port. The HyperText DataType has
one. See @{" ARexx Interface " link hypertext.hguide/ARexxIFace} of that DataType.

@{m_sub "Buttons"}
The @{hyperguide} DataType don't handle the buttons. The HyperText DataType does
this. See @{" Buttons " link hypertext.hguide/UserIFace_Navigator} of that DataType.
@{m_endsec}
@endnode