;
; Clusse Setup Help Text
;
; Note:  This file must be compiled with the Version 1.1 of TVHC.EXE.
;
;  
;  
;

.topic NoContext=0
 SETUP - The Clusse Configuration Utility 
  
Welcome to the Clusse configuration utility.  This program is used to create
and modify the binary Clusse configuration file clusse.cfg.

The  menu is accessed by pressing Alt-Space (except under Win 95 8-).
All the other menus are accessed by pressing Alt-Z, where Z is the first
letter of the menu.  For example, the "File" menu is pulled down by
Alt-F.  Of course, you can use the cursor keys to navigate trough the
menus.  And yes, the mouse works, too.

In the different windows you can use the tabulator key to move trough the
fields.  Cursor keys are only used for moving inside a field.  Enter
usually presses the "OK" button.  The Escape key presses the "Cancel"
button, which in turn cancels the changes you've made in the window.

When you're finished, press alt-X to exit the program, or choose "Exit"
from the "File" menu.

.topic Calculator
 Calculator 
  
The calculator is a simple four-function calculator with add, subtract,
multiply, and divide.  To operate the calculator you can either use the
keyboard or press the buttons on the calculator with the mouse.  The 'C'
key clears the calculator, the '' key will erases the last character
typed, and the '' key toggles the value from positive to negative (the
keyboard equivalent of '' is '_').

.topic System
  (System) menu     (Alt-Spacebar)
  
The System menu appears on the far left of the menu bar and is
represented by the  symbol.

When you pull down the  menu, you see the choises

  {About:SAbout}
  {Calculator:SCalculator}

.topic SAbout
 About 
  
When you choose the About command from the  (System) menu, a
dialog box appears, showing copyright and version information.

To close the box, press Esc, Space, or Enter, or click the OK
button.

.topic SCalculator
 Calculator 
  
When you choose Calculator, a four-function {calculator} is
opened on the desktop.

.topic File
 File  (Alt-F) 
  
The File menu includes choices for opening and saving files, changing
directories, DOS shell, and exiting the program.

 {Open}          {Change Dir:ChangeDir}    {Exit}

.topic Open
 FileOpen  (F3) 
  
The Open command displays the Open a File dialog box. In this
dialog box you select the text file you want browse in an
editor.  Please note that the editor CAN NOT handle files larger
than 64 kilobytes.

The {Open a File:FOFileOpenDBox} dialog box contains:

  an {input box:FOName} with a history list
  a {list box:FOFiles} to browse the directory
  the standard {Cancel:CancelBtn} button
  {Open:FOOpenBtn} action button
  an information panel that describes the
   selected file

.topic New
 FileNew 
  
The New command creates a new editor window.  The window's name is
"Untitled", and is empty.

.topic Save
 FileSave 
  
The Save command allows you to save the current editor window to a disk
file.  If the window already has a name, the file will be saved under
this same name.  If you wish to save the file under a new name, select
the {File|Save As:SaveAs} command instead.

.topic SaveAs
 FileSave As 
  
The Save As command allows you to save the current editor window to a
new file name.  Note that if an editor window does not have a name (it
is called "Untitled") selecting {File|Save:Save} will execute the
Save As dialog box.

.topic SaveAll
 FileSave all 
  
The Save all command saves all editor windows to disk.

.topic ChangeDir
 FileChange Dir...
  
FileChange Dir brings up the {Change Directory:FCChDirDBox}
dialog box, in which you can change the current directory.

.topic DosShell
 FileDOS Shell 
  
With the DOS Shell command, you can leave the program temporarily
to perform a DOS command or run another program.

To return to this program, type EXIT at the DOS prompt.

.topic Exit
 FileExit      (Alt-X)
  
The Exit command terminates this program, saving the current
configuration.

.topic Edit
 Editor  (Alt-E) 
  
The Editor menu includes choices for {Undo} in the editor, managing the
clipboard and {finding:Find} strings in the editor.

.topic Undo
 EditorUndo 
  
The Undo command allows you to "take back" the last editor action you
performed.  For example, if the line:

  This is an editor test

is changed to:

  This was an editor test

the Undo command will become active.  Executing the Undo command will
cause the line to revert back to its original version.  Note that
changes which can be undone are grouped into similar actions, such as
typing, or deleting characters.  Any action type you perform that is
different than the last action type will cause the Undo information to
be lost.

.topic Cut
 EditorCut 
  
The Cut command removes the selected text and places it on the
Clipboard.  Any information previously on the clipboard is lost.  Text
cut from the editor may be immediately replaced by selecting the
{Undo} command before moving the cursor.

.topic Copy
 EditorCopy 
  
The Copy command places a copy of the selected text on the
Clipboard.  The selected information is left unchanged, but any
information previously on the clipboard is lost.

.topic Paste
 EditorPaste 
  
The Paste command inserts a the contents of the clipboard into the
current editor window at the cursor position.  The contents of the
clipboard remain unchanged.  If any text is selected in the current
editor window, the highlighted text is replaced by the text coming from
the clipboard.  Information pasted into an editor may be removed
immediately by using the {Undo} command before moving the cursor.

.topic ShowClip
 EditorShow Clipboard 
  
The Show Clipboard command will display the Clipboard contents is an
ordinary editor window.  Note that {Cut} and {Paste} commands are not
enabled while the clipboard is the focused window.

.topic Clear
 EditorClear 
  
The Clear command removes any selected text from the current editor
without placing a copy of the text on the clipboard.  The effects of
this command may be reversed by selecting {Undo} before moving the cursor.

.topic Find
 EditorFind 
  
The Find command performs a text search in the editor.

.topic Replace
 EditorReplace 
  
The Replace command performs a text search and replace in the editor.

.topic SearchAgain
 EditorSearch again 
  
The Search again repeats the last Find or Replace.

.topic Windows
 Window     (Alt-W)
  
The Window menu contains commands to close, move and perform
other window-management commands.

Most of the windows in this program have all the standard window
elements, including scroll bars, a close box, and zoom icons.

For more about windows and their elements, refer to windows.


 Window-management commands
 

 {Size/Move:Resize}           {Zoom}
 {Tile}             {Cascade}
 {Next}             {Previous}
 {Close}

.topic Resize
 WindowSize/Move      (Ctrl-F5)
  
Choose this command to change the size or position of the active
window.

 
  Size
 
If you press Shift while you use the arrow keys, you can change
the size of the active window. Once you've adjusted its size or
position, press Enter.

If a window has a Resize corner, you can drag that corner to
resize the window.

 
  Move
 
When you choose WindowSize/Move, the active window moves in
response to the arrow keys. Once you've moved the window to where
you want it, press Enter.

You can also move a window by dragging its title bar with the
mouse.

.topic Zoom
 WindowZoom    (F5)
  
Choose Zoom to resize the active window to the maximum size. If
the window is already zoomed, you can choose this command to
restore it to its previous size.

You can also double-click anywhere on the window's title bar
(except where an icon appears) to zoom or unzoom the window.

.topic Tile
 WindowTile 
  
Choose WindowTile to tile all file editors on the desktop.

 Ŀ
  1ͻ2Ŀ 
                                 
                                 
                                 
                                 
  ͼ 
  3Ŀ4Ŀ 
                                 
                                 
                                 
                                 
   
 
             Tiled Windows

.topic Cascade
 WindowCascade 
  
Choose WindowCascade to stack all file editors on the desktop.

 1Ŀ
 2Ŀ
 3Ŀ
 4ͻ
                          
                          
                          
                          
                          
 ͼ

        Cascaded Windows

.topic Next
 WindowNext 
  
Choose Next to cycle forwards through the windows on the desktop. You can
also press alt-[window number] to invoke a window.

.topic Close
 WindowClose     (Alt-F3)
  
Choose Close to close the active window.

You can also click the Close box in the upper right corner to
close a window.

.topic Settings
 Settings (Alt-S) 
  
The Settings menu contains commands that let you configure Clusse:

  {General:GenSets}          - General settings
  Interface        - {G8BPQ:BPQSets} or {PC/FlexNet:FlexSets} Settings
  {Privilege groups:GroupSets} - User group definitions
  {Administrative:AdmSets}   - System operator, logging
  {Expiration:ExpSets}       - How long data is stored
  {Conference mode:ConvSets}
  {Screen:ScreenSets}

  {Mouse:SMouse}
  {Colors:SColors}

.topic SMouse
 SettingsMouse... 
  
The Mouse command brings up the {Mouse Settings:SMMouseDBox}
dialog box, where you can set various options that control how your
mouse works, including:

  how fast a double-click is
  which mouse button (right or left) is
   active

.topic SColors
 SettingsColors... 
  
The Colors item brings up the {Colors dialog:SCColorsDBox} box,
where you can customize the colors of the display.

.topic FOFileOpenDBox
 Help on Open a File Dialog Box 
  
The Open a File dialog box contains an input box, a {file list:FOFiles},
a file information panel, the standard button {Cancel:CancelBtn},
one other action button ({Open:FOOpenBtn}), plus a history list
that's attached to the {Name inputbox:FOName}.

.topic FOName
  Name Ŀ
                                  
 
The Name input box is where you enter the name of the file to
load, or the file-name mask to use as a filter for the Files list
box (for example, *.*).

.topic FOFiles
  Files Ŀ
                                  
   FILENM01.PAS    FILENM09.PAS  
   FILENM02.PAS    FILENM10.PAS  
   FILENM03.PAS    FILENM11.PAS  
   FILENM04.PAS    FILENM12.PAS  
   FILENM05.PAS    ..            
   FILENM06.PAS    \MOREXAMP     
   FILENM07.PAS    \TOURS        
   FILENM08.PAS    \ANSWERS.DIR  
      
 
The Files list box lists the names of files in the current
directory that match the file-name mask in the Name input box,
plus the parent directory and all subdirectories.

 Ŀ
  C:\CLU\*.INI                             
  LINKS.INI       52  Jul 14,1990  12:00pm 
 
The File information panel shows the path name, file name, date,
time, and size of the selected file.

None of the items on this information panel are selectable.

.topic FOOpenBtn
 Ŀ
  [ Open ] 
 
The Open button opens a new editor window and places the selected
file in that window.

.topic CancelBtn
 Ŀ
  [ Cancel ] 
 

If you choose Cancel, nothing changes and no action occurs, and
the dialog box is put away.

(Esc always cancels a dialog box, even if a Cancel button does
not appear.)

.topic OpenBtn
 Ŀ
  [ Open ] 
 

In the Open a File dialog box, if you choose the Open button
TVDEMO opens a new editor and places the selected
file in that window.

.topic FCChDirDBox
 Help on the Change Directory dialog box 
  
The Change Directory dialog box consists of an input box, a list
box, the standard OK and Help buttons, and two other buttons
(Chdir and Revert).

  Directory Name Ŀ
                                      
 
The Directory Name input box is where you type in the path of the
new directory.

  Directory Tree Ŀ
    Drives                            
    C:\                            
      TP                           
        TVISION                    
 
The Directory Tree list box enables you to navigate directories
by using the selecting bar and pressing Enter.

If you're using the keyboard, press Enter to make the selected
directory be the current directory, then choose OK or press Esc
to exit the dialog box.

 Ŀ
  [Chdir ] 
 
The Chdir button changes the current directory once you've
selected or typed in a directory name.

 Ŀ
  [Revert] 
 
The Revert button goes back to the previous directory, as long as
you haven't yet exited the dialog box.

.topic SMMouseDBox
 Help on the Mouse Options dialog box 
  
This dialog box consists of one check box, one slider bar, and
the standard buttons OK and Cancel.

 Ŀ
  Mouse Double Click       
  Slow     Medium     Fast 
   
 
The Mouse Double Click slider bar adjusts the double-click speed of
your mouse.

 Ŀ
  [X] Reverse Mouse Buttons 
 
Reverse Mouse Buttons makes the right mouse button take on the
normal functions of the left--and vice versa.

 See also:
 
 {SettingsMouse... menu command:SMouse}

.topic SCColorsDBox
 Help on the Colors dialog box 
  
The Colors dialog box consists of two list boxes, a text display
area, the standard OK, Cancel, and Help buttons, and one of the
following:

  On color and black-and-white systems, it
   also contains two color palettes.
  On monochrome systems, it contains a set
   of radio buttons instead of the palettes.

This dialog box is where you can change the colors of different
parts of this program.

  Group Ŀ
    Desktop          
    Menus            
    Dialogs/Calc     
    Puzzle           
    Calendar         
    Ascii table      
                     
 
The Group list box contains the names of the different regions of
the program that you can customize.

  Item Ŀ
    Color            
                     

When you select a group from the Group list, the Item list box
displays the names of the different views in that region.

  Foreground     Background 
        
        
      
 
On color and black-and-white systems, you use the Foreground and
Background palettes to modify colors.

  Colors Ŀ
   () Mono low        
   ( ) Mono high       
   ( ) Mono underscore 
   ( ) Mono inverse    
 

On monochrome systems, you use the Colors set of radio buttons
systems to modify the character attributes.

 Ŀ
  Text Text Text 
  Text Text Text 
 
On all systems, the display text (above the Help button) shows
the current color or attribute settings.

Changes do not take effect on the desktop until you close the
Colors dialog box by choosing OK.

; Import standard values from APP.PAS. Place all such manually
; declared help contexts at end of file.

.topic CloseAll=65314
 WindowClose All 
  
Choose Close all to remove all windows from the desktop.

.topic Previous=65318
 WindowPrevious 
  
Choose Previous to cycle backwards through the windows on the desktop.

.topic GenSets
 General settings 
  
In this window you choose the callsigns you will be
using for the cluster node and the node console, the
QTH locator (mainhead) of the node, the date format being
used at your area, and the separator characters used between
the fields of a date or a time string.

You must also pick the interface you will be using,
either the G8BPQ Packet Switch or PC/FlexNet. Use the
{"Interface":IfSets} menu for setting the parameters of
the interface.

.topic IfSets
 Interface-specific settings 
  
This window's contents depend on the interface type you chose to use
in the {"General":GenSets} settings window. Pick one:

 {PC/FlexNet:FlexSets} settings
 {G8BPQ:BPQSets} settings

.topic FlexSets
 PC/FlexNet settings 
  

Due to the limitations of the G8BPQ Packet Switch, Clusse was designed
to handle 64 users at most. This limitation is also present in Clusse,
when PC/FlexNet is used.

Link timer reset interval tells clusse to send an empty packet to all
user connections, if the connection has been idle for the defined amount
of minutes. This feature is here to prevent nodes from disconnecting
users who are inactive for longer perioids than the inactivity timers
allow. If the nodes/digipeaters in your are don't have inactivity
timeouts, set this to 0!

User inactivity timer disconnects the user, if he doesn't give any
input for the specified amount of minutes.

You must also choose, what information you want to see in the monitoring
window. "Action" means the changing information on the third line
of the screen.

.topic BPQSets
 G8BPQ settings 
  

The G8BPQ interrupt is the software interrupt which is used for talking
to the G8BPQ Packet Switch. It's the first parameter in BPQCFG.TXT.

Application number refers to the position on the APPLICATIONS line in
BPQCFG.TXT. If you set "APPLICATIONS=BBS,CLU" you must set this to 2
to have the "CLU" command to connect to Clusse. If you set
"APPLICATIONS=CLU,BBS" you must set this to 1. Application 1 always
has the BBSCALL.

The BPQ has 64 streams for user/application connections. Each application
allocates an amount of streams, and each strem can be allocated for only
one application. If you run multiple applications, you must take care
that the applications don't conflict. The amount of streams used by an
application is the number of connections it can have, eg. the amount of
users + the amount of links in Clusse.

Link timer reset interval tells clusse to send an empty packet to all
user connections, if the connection has been idle for the defined amount
of minutes. This feature is here to prevent nodes from disconnecting
users who are inactive for longer perioids than the inactivity timers
allow. If the nodes/digipeaters in your are don't have inactivity
timeouts, set this to 0!

User inactivity timer disconnects the user, if he doesn't give any
input for the specified amount of minutes.

If the free packet buffers count of the BPQ switch goes below the
Buffer Treshold setting, Clusse reboots and disconnects all it's
streams to free the buffers occupied by Clusse.

You must also choose, what information you want to see in the monitoring
window. "Action" means the changing information on the third line
of the screen.

.topic UserSets
 User settings 
  

In this window you choose the default settings a new user has, when
he logs in for the first time. He can later change all of these,
except for the privilege group, which can only be changed by
someone who is in a group which can use the EUser (Edit User) command
(usually the system operators). See the {Privilege groups:GroupSets}
editor for details.

.topic GroupSets
 User privilege groups 
  

Clusse divides users to (at maximum) 20 different privilege groups.  In this
window you configure what the users in each group can do, and what the
group is called.

Press the "Next" and "Previous" buttons to move from group to another.
The Enabled/Disabled button is used to tell, if users can be moved to
this group.

  These are the available privilege options:

    {Login:pLogin}
    {Login in ARES mode:pALogin}
    {Interact:pInteract}
    {Wide-area interact:pWInteract}
    {File commands:pFileCMD}
    {Access to all files:pAllFiles}
    {LINK command:pLinkCMD}
    {HALT and REBOOT commands:pHaltCmd}
    {SU command:pSUCmd}
    {All commands:pAllCmd}
    {Never expires:pNeverExp}

.topic pLogin=1000
 Privileges: Login 
  

If set, the users in the group can log in to the node.  If not,
the users are disconnected a few seconds after connection.

 See also: {List of privilege options:GroupSets}

.topic pALogin=1001
 Privileges: Login in ARES mode 
  

If set, the users in the group can log in when the node is in the
{ARES mode:Aresmode}. Users which are going to participate in ARES
operations should be in a group with this option on.

 See also: {List of privilege options:GroupSets}

.topic pInteract=1002
 Privileges: Interact 
  

If set, the users in the group can interact with each other using the
commands Talk, Say and Announce (local).

 See also: {List of privilege options:GroupSets}

.topic pWInteract=1003
 Privileges: Wide-area interact 
  

If set, the users in the group can use the commands Dx, SHOUT, Announce full
and Wx.

 See also: {List of privilege options:GroupSets}

.topic pFileCmd=1004
 Privileges: File commands 
  

If set, the users in this group can use the file commands Get, PUt, BPut,
BGet, CD and DIr. By default the users can only access the public directory
CLU\USERS\.

 See also: {List of privilege options:GroupSets}

.topic pAllFiles=1005
 Privileges: Access to all files 
  

If set, the users in this group can access all files on all disks of the
system. Don't give this privilege to other users than the operators.

 See also: {List of privilege options:GroupSets}

.topic pARESCmd=1006
 Privileges: The ARES command 
  

If set, the users in this group can use the ARES command to switch
the node to and from ARES mode.

 See also: {List of privilege options:GroupSets}

.topic pLinkCmd=1007
 Privileges: The LINK command 
  

If set, the users in this group can use the LINK command to manage the
cluster links of this node.

 See also: {List of privilege options:GroupSets}

.topic pHaltCmd=1008
 Privileges: The HALT and REBOOT commands 
  

If set, the users in this group can use the HALT command (closes down the
node without the possibility to get it running again from a remote location)
and the REBOOT command (reboots the software or the whole computer).

 See also: {List of privilege options:GroupSets}

.topic pSUCmd=1009
 Privileges: The SU command 
  

If set, the users in this group can use the SU command, which is used to
give the superuser password.  After the correct password is given, the
user is moved to group 20 for the duration of the session.

 See also: {List of privilege options:GroupSets}

.topic pAllCmd=1010
 Privileges: All commands 
  

If set, the users in this group can use ALL commands without NO
restrictions.

 See also: {List of privilege options:GroupSets}

.topic pNeverExp=1011
 Privileges: Never expires 
  

If set, the users in this group are not expired from the user file even
if they don't connect to the node in the time specified in the expiration
settings.  In general, you don't want to allow operators and excluded users
to expire, since they would have the privileges of a normal user after
they've expired.  (Oh well, if an operator didn't connect to the node for
a month or two, he wasn't such a good operator anyway.)

 See also: {List of privilege options:GroupSets}

.topic AdmSets
 Administrative settings 
  

When the user with the "System operator callsign" logs in on the console,
he gets to the Operator group.  He can then use the SU command to become
superuser.  Other users which need to be in the operator group must be
moved there by another operator using the EUser command.

The secret number is used for the SU (SuperUser) command.  It's maximum
length is 256 numbers.  If you want some security, use at least 40 numbers.

When an user gives the SU command, Clusse returns 6 numbers.  Sysop
multiplies up the 5 first numbers in the corresponding positions of the
secret number and adds the 6th number & sends the result.

  An Example: The secret number is 24184137.
  SU returns "4 2 7 5 8 1".
  8*4*3*4*7+2 = 2690 is the right answer.

This rather complicated method is used since the other password systems
usually used on packet are quite vulnerable.  This one takes quite a lot
of monitoring and math to crack.

PLEASE NOTE that if your password includes a zero, every time clusse
picks it as a component, the result will become zero + the last number.
And it's very easy for a bad guy to catch the idea. Don't include a zero
in your secret number.

PS. If someone cracks your password even if it was long enough (mine is
around 50 numbers), let me know.  I have some [weird] ideas about how to
make the password even more fun to crack! 8-)

.topic ExpSets
 Expiration settings 
  

In this window you choose when the expiration (process of deleting old
entries from the different data files) takes place and how long the data
is stored in the files.  You might want to run the expiry at the time
most of your users are asleep, since clusse halts all other activity for
the duration of the expiration of each file.  Expiration can take a while
for large files, if you don't run it on a 486.

By the way, watch your disk space.  If the disk fills up, Clusse crashes.

PS. The memory buffer settings do nothing for now. Absolutely nothing.

.topic ConvSets
 Conference mode settings 
  

This window is used to configure the conference mode.  The mode is accessed
using the "Conference" command.

The conference consists of 65535 "virtual channels".  The users who are
on the same channel "hear" each other.  At the moment, Clusse does not
support linking of the conference mode (eg. the conversations are only
visible on the local node), but i'm planning to make it conversd
compatible.

The default channel is the channels users get into, when they enter the
conference.  The host name is used to identify the conference host once
when clusse supports linking, and is usually set to the name the town.

.topic ScreenSets
 Screen settings 
  

The screen size setting is a bit fuzzy.  The 43/50 lines position chooses
43 lines on an EGA and 50 lines on a VGA.  If you want 43 lines on a VGA
pick the last position "43 lines on a VGA".  The 50- and 28-line modes
are only available on VGA monitors.

  I/O mode:

In Automatic mode Clusse uses direct video I/O by default (eg. writes
directly to the video RAM) and BIOS calls, if DesqView is detected.
Direct video I/O is considerably faster than BIOS calls, but tends to
mess up the screen if running under DesqView or a similar multitasker.
When running with QEMM, DesqView can handle direct video, so you can
force direct video.  Windows and OS/2 can also handle direct video, but
you don't need to force it.  If you use some bizarre multitasker or a TSR
which doesn't like direct video, you can force BIOS video.

.topic SoundSets
 Sound settings 
  

Clusse can make the DX spots available to hams without packet radio
equipment by transmitting the spots in digitized speech on VHF or UHF
FM. A fanatic DX'er can carry an FM hand-held and get the DX spots
even when he's not near his packet terminal. Not to forget those of
us who can't see printed text.

This dialog is used to configure the audio interface. Clusse can utilize
either an Sound Blaster (or compatible) card or a very cheap and simple
printer port A/D converter (LPT port dac, also known as "speech thing"
and "Covox"). The LPT port is also used to key the transmitter.

See speech.doc for details on the sound hardware and it's configuration.

.topic Aresmode
 ARES mode 
  

ARES (Amateur Radio Emergency Service) mode is a special operating mode,
when only the users participating in the ARES operation are allowed to
log in and DX spots are not carried. In the future Clusse will include
more enhancements for use the ARES environment (suggestions welcome).

