; misc.txt
;
; This is the WaterGate help file
; This file is included by wtrgate.txt
;
; Contents: WtrConf Miscallaneous information
;

; quick reference:
;
; #topic(reference text)
; #subtopic(reference text)
; #end
; #title(text)
; Space at start of line or #linebreak
; Empty line or #break
; #link(reference)(text)
; #highlight(text) or #hl(text)


;---------------------------------------------------------------------------
; Help on Help
;
; This link is brought up when F1 is pressed while in the help system.
;
; Note: Hardcoded inside RHFC!
;
#topic(Help on Help)
#title(Help on Help)
Use F1 to bring up context sensitive on-line help. Once in the
help system, you can use the following keys:

 #hl(Escape)      Close help topic
 #hl(F1)          Bring up "Help on help" topic
 #hl(Ctrl+F)      Find text in help window
 #hl(F2)          Global text search

Move the cursor key to scroll through the help topic. You can control the
cursor with the following keys:

 #hl(Up)          Move up
 #hl(Down)        Move down
 #hl(Left)        Move left
 #hl(Right)       Move right
 #hl(PgUp)        Go one page up
 #hl(PgDn)        Go one page down
 #hl(Ctrl+PgUp)   Go to the first line of the topic
 #hl(Ctrl+PgDn)   Go to the last line of the topic
 #hl(Home)        Move to start of current line
 #hl(End)         Move to end of current line
 #hl(Ctrl+Left)   Go to start of next word
 #hl(Ctrl+Right)  Go to start of previous word

A help topic can contain links to other help topics. The color of the
link text changes when the cursor is over a link. When this happens,
press Enter to follow the link. The following keys can be used to
quickly find and follow links:

 #hl(Enter)       Go to the link the cursor is on
 #hl(Tab)         Move cursor to next link
 #hl(Shift+Tab)   Move cursor to previous link

Help topics can contain several sub-topics. When context sensitive help
is brought up, you can end up in the middle of a larger topic.
#end


;---------------------------------------------------------------------------
; HowToUse
;
; How to use the user Ramon interface.
;
#topic(HowToUse)
#title(How to use the user interface)
This topic explains how to navigate the user interface of the
WaterGate programs.

#subtopic(HowToUse Menu)
#title(Menus)
This tells you how to use the menus.

#subtopic(HowToUse List)
#title(Lists)
This tells you how to use the Lists.
#linebreak
About tagging.

#subtopic(HowToUse Fields)
#title(Fields)
This tells you how to use the fields.

#subtopic(HowToUse TagKeys)
#title(Tag keys)
Using the tag keys, you can select multiple item to act upon.

#hl(F5): Tag/Untag a single option

#hl(F6): Tag options starting with a given sequence of characters.
For example, 'NE' will tag all options starting with the
letters 'NE'. An empty sequence will tag all options.

#hl(F7): Untag options starting with a given sequence of characters.
Empty to untag all options.

#hl(Enter): Use the selected options, or only the one below the cursor
if none are defined.
#end


;---------------------------------------------------------------------------
; File Manager
;
; Note: hard coded inside RHFC!
;
#topic(File Manager)
#title(File Manager)
Use this assistant to find directories, files and message bases
easily. The header displays the type of selection you are making.

Use the Up, Down, PgUp, PgDn, Home and End keys to navigate through
the files. Use Enter to change directories. You must use F3 or F10
to make a final selection. Press Escape to abort without changes.

You can change drives by holding down the Alt key and pressing one
of the drive letters A to Z. For example Alt+C for drive C. You
will change to the current directory of that drive.

If you know what you are searching for, then type in a key to jump
to the next item in the list starting with that character.
#end


;---------------------------------------------------------------------------
; Remote Gateway User
;
#topic(Remote Gateway User)
#title(Remote Gateway User)
WaterGate allows you to run a mailing list on a FTN-only system.
This means that you cannot send e-mail messages directly to the
Internet, but that you have to send these messages via a gateway.

To send a message to this person, you need send a netmail to the
gateway and tell the gateway to send translate the message and to
send it to his or hers e-mail address.

The three fields you have to fill in are the e-mail address, the
AKA of the gateway and the Username of the gateway. WaterGate will
write an netmail with on the first line To: <e-mail address>.
#end


;---------------------------------------------------------------------------
; Encoded files info
;
;## correct 8-bit info
;## extend with base64, binhex, xx-encode + examples
;## explain about multiple parts and inability to decode
#topic(Encoded files info)
#title(Encoded files)
It is normally not possible to transfer binary (8-bit) files over
the Internet. A special encoding scheme must be used to enclose the
file in the body of a text message. This encoding is normally done
by taking 3 bytes (24 bits) from the binary file and storing this as
four times 6 bits, encoded using a special series of 64 characters.

A UU-encoded file in a message would look like this:

@begin 644 wtrgate.zip@
@M4$L#!!0````(`,&Z;"`F&:(\YQA```E.```*````1D0R1E10+D1/0^T\77,;@
@M1W+O5W=5^0DMYNI$ND#P2Y0M)I<[?H`2SQ2I$ZA37<HOA]T!,,7=&7AFEA#R@
...

WaterGate can both encode an attached file into this format when
gating a message from FTN to RFC format and it detects and
automatically decodes files for certain users when gating from
RFC to FTN format or when importing messages into a message base.
#end


; end of file misc.txt

