Changes to manual namings to standardise. Added script from M0AZM to
[spider.git] / sgml / usermanual.sgml
index 8c0b89ce9fda7217330d611605878be2632db976..44629aa4602d5b57840e77779216aa58cc6361c1 100644 (file)
@@ -1010,1459 +1010,3 @@ ask your sysop what version number is the latest.
 
 <sect>The DXSpider command reference
 
-<P>
-Below is a complete list of commands available from the cluster prompt.
-These are listed below in alphabetical order. 
-
-<sect1>accept/announce
-
-<P>
-<tt>
-<bf>accept/announce &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set an accept filter
- line for announce
-</tt>
-
-<P>
-Create an 'accept this announce' line for a filter. 
-
-An accept filter line means that if the announce matches this filter it is
-passed onto the user. See HELP FILTERS for more info. Please read this
-to understand how filters work - it will save a lot of grief later on.
-
-You can use any of the following things in this line:-
-
-<tscreen><verb>
-  info <string>            eg: iota or qsl
-  by <prefixes>            eg: G,M,2         
-  origin <prefixes>
-  origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-  origin_itu <numbers>
-  origin_zone <numbers>
-  by_dxcc <numbers>
-  by_itu <numbers>
-  by_zone <numbers>
-  channel <prefixes>
-  wx 1                     filter WX announces
-  dest <prefixes>          eg: 6MUK,WDX      (distros)
-</verb></tscreen>
-
-some examples:-
-
-<tscreen><verb>
-  acc/ann dest 6MUK
-  acc/ann 2 by_zone 14,15,16
-  (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16)
-</verb></tscreen>
-
-or
-
-<tscreen><verb>
-  acc/ann by G,M,2 
-</verb></tscreen>
-
-This filter would only allow announces that were posted buy UK stations.  
-You can use the tag 'all' to accept everything eg:
-
-<tscreen><verb>
-  acc/ann all
-</verb></tscreen>
-
-but this probably for advanced users...
-
-<sect1>accept/spots 
-
-<P>
-<tt>
-<bf>accept/spots &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set an accept filter 
-line for spots
-</tt>
-
-<P>
-Create an 'accept this spot' line for a filter.
-
-<P>
-An accept filter line means that if the spot matches this filter it is
-passed onto the user. See HELP FILTERS for more info. Please read this
-to understand how filters work - it will save a lot of grief later on.
-
-You can use any of the following things in this line:-
-
-<tscreen><verb>
-  freq <range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
-  on <range>             same as 'freq'
-  call <prefixes>        eg: G,PA,HB9
-  info <string>          eg: iota or qsl
-  by <prefixes>            
-  call_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-  call_itu <numbers>
-  call_zone <numbers>
-  by_dxcc <numbers>
-  by_itu <numbers>
-  by_zone <numbers>
-  origin <prefixes>
-  channel <prefixes>
-</verb></tscreen>
-
-<P>
-For frequencies, you can use any of the band names defined in
-SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
-thus: hf/ssb. You can also just have a simple range like: 0/30000 -
-this is more efficient than saying simply: freq HF (but don't get
-too hung up about that)
-
-some examples:-
-
-<tscreen><verb>
-  acc/spot 1 on hf/cw
-  acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
-</verb></tscreen>
-
-You can use the tag 'all' to accept everything, eg:
-
-<tscreen><verb>
-  acc/spot 3 all
-</verb></tscreen>
-
-but this probably for advanced users...
-
-<sect1>accept/wcy 
-
-<P>
-<tt>
-<bf>accept/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> set an accept WCY filter
-</tt>
-
-<P>
-It is unlikely that you will want to do this, but if you do then you can
-filter on the following fields:-
-
-<tscreen><verb>
-  by <prefixes>            eg: G,M,2         
-  origin <prefixes>
-  origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-  origin_itu <numbers>
-  origin_zone <numbers>
-  by_dxcc <numbers>
-  by_itu <numbers>
-  by_zone <numbers>
-  channel <prefixes>
-</verb></tscreen>
-
-<P>
-There are no examples because WCY Broadcasts only come from one place and
-you either want them or not (see UNSET/WCY if you don't want them).
-
-This command is really provided for future use.
-
-See HELP FILTER for information.
-
-<sect1>accept/wwv 
-
-<P>
-<tt>
-<bf>accept/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set an accept WWV filter
-</tt>
-
-<P>
-It is unlikely that you will want to do this, but if you do then you can
-filter on the following fields:-
-
-<tscreen><verb>
-  by <prefixes>            eg: G,M,2         
-  origin <prefixes>
-  origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-  origin_itu <numbers>
-  origin_zone <numbers>
-  by_dxcc <numbers>
-  by_itu <numbers>
-  by_zone <numbers>
-  channel <prefixes>
-</verb></tscreen>
-
-for example 
-
-<tscreen><verb>
-  accept/wwv by_zone 4
-</verb></tscreen>
-
-is probably the only useful thing to do (which will only show WWV broadcasts
-by stations in the US).
-
-See HELP FILTER for information.
-
-<sect1>announce 
-
-<P>
-<tt>
-<bf>announce &lt;text&gt;</bf> Send an announcement to local users
-</tt>
-
-<P>
-Send an announcement to LOCAL users only, where &lt;text&gt; is the text 
-of the announcement you wish to broadcast
-
-<sect1>announce full 
-
-<P>
-<tt>
-<bf>announce full &lt;text&gt;</bf> Send an announcement cluster wide
-</tt>
-
-<P>
-This command will send your announcement across the whole cluster
-network.
-
-<sect1>apropos 
-
-<P>
-<tt>
-<bf>apropos &lt;string&gt;</bf> Search the help database
-</tt>
-
-<P>
-Search the help database for &lt;string&gt; (it isn't case sensitive), 
-and print the names of all the commands that may be relevant.
-
-<sect1>bye 
-
-<P>
-<tt>
-<bf>bye</bf> Exit from the cluster
-</tt>
-
-<P>
-This will disconnect you from the cluster
-
-<sect1>clear/spots 
-
-<P>
-<tt>
-<bf>clear/spots &lsqb;1&verbar;all&rsqb;</bf> Clear a spot filter line
-</tt>
-
-<P>
-This command allows you to clear (remove) a line in a spot filter or to 
-remove the whole filter.
-
-If you have a filter:-
-
-<tscreen><verb>
-  acc/spot 1 on hf/cw
-  acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
-</verb></tscreen>
-
-and you say:-
-
-<tscreen><verb>
-  clear/spot 1
-</verb></tscreen>
-
-you will be left with:-
-
-<tscreen><verb>
-  acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
-</verb></tscreen>
-
-If you do:
-
-<tscreen><verb>
-  clear/spot all
-</verb></tscreen>
-
-the filter will be completely removed.
-
-<sect1>dbavail 
-
-<P>
-<tt>
-<bf>dbavail</bf> Show a list of all the databases in the system
-</tt>
-
-<P>
-The title says it all really, this command lists all the databases defined
-in the system. It is also aliased to SHOW/COMMAND.
-
-<sect1>dbshow 
-
-<P>
-<tt>
-<bf>dbshow &lt;dbname&gt; &lt;key&gt;</bf> Display an entry, if it exists, 
-in a database
-</tt>
-
-<P>
-This is the generic user interface to the database to the database system.
-It is expected that the sysop will add an entry to the local Aliases file
-so that users can use the more familiar AK1A style of enquiry such as:
-
-<tscreen><verb>
-  SH/BUCK G1TLH
-</verb></tscreen>
-
-but if he hasn't and the database really does exist (use DBAVAIL or
-SHOW/COMMAND to find out) you can do the same thing with:
-
-<tscreen><verb>
-  DBSHOW buck G1TLH
-</verb></tscreen>
-
-<sect1>directory 
-
-<P>
-<tt>
-<bf>directory</bf> List messages<newline> 
-<bf>directory all</bf> List all messages<newline>
-<bf>directory own</bf> List your own messages<newline>
-<bf>directory new</bf> List all new messages<newline>
-<bf>directory to &lt;call&gt;</bf> List all messages to &lt;call&gt;<newline>
-<bf>directory from &lt;call&gt;</bf> List all messages from &lt;call&gt;<newline>
-<bf>directory subject &lt;string&gt;</bf> List all messages with &lt;string&gt; 
-in subject<newline>
-<bf>directory &lt;nn&gt;</bf> List last &lt;nn&gt; messages<newline>
-<bf>directory &lt;from&gt;-&lt;to&gt;</bf> List messages &lt;from&gt; message &lt;to&gt; message <newline>
-</tt>
-
-<P>
-List the messages in the messages directory.
-
-If there is a 'p' one space after the message number then it is a 
-personal message. If there is a '-' between the message number and the
-'p' then this indicates that the message has been read.
-
-You can use shell escape characters such as '*' and '?' in the &lt;call&gt;
-fields.
-
-You can combine some of the various directory commands together eg:-
-
-<tscreen><verb>
-   DIR TO G1TLH 5
-or 
-   DIR SUBJECT IOTA 200-250
-</verb></tscreen>
-
-You can abbreviate all the commands to one letter and use ak1a syntax:-
-
-<tscreen><verb>
-   DIR/T G1* 10
-   DIR/S QSL 10-100 5
-</verb></tscreen>
-
-<sect1>dx 
-
-<P>
-<tt>
-<bf>dx &lsqb;by &lt;call&gt;&rsqb; &lt;freq&gt; &lt;call&gt; &lt;remarks&gt;</bf> Send a DX spot
-</tt>
-
-<P>
-This is how you send a DX Spot to other users. You can, in fact, now
-enter the &lt;freq&gt; and the &lt;call&gt; either way round. 
-
-<tscreen><verb>
-   DX FR0G 144.600
-   DX 144.600 FR0G
-   DX 144600 FR0G 
-</verb></tscreen>
-
-will all give the same result. You can add some remarks to the end
-of the command and they will be added to the spot.
-
-<tscreen><verb>
-   DX FR0G 144600 this is a test
-</verb></tscreen>
-
-You can credit someone else by saying:-
-
-<tscreen><verb>
-   DX by G1TLH FR0G 144.600 he isn't on the cluster
-</verb></tscreen>
-
-The &lt;freq&gt; is compared against the available bands set up in the 
-cluster.  See SHOW/BANDS for more information.
-
-<sect1>help 
-
-<P>
-<tt>
-<bf>help &lt;cmd&gt;</bf> Get help on a command
-</tt>
-
-<P>
-All commands can be abbreviated, so SHOW/DX can be abbreviated
-to SH/DX, ANNOUNCE can be shortened to AN and so on.
-
-Look at the APROPOS &lt;string&gt; command which will search the help database
-for the &lt;string&gt; you specify and give you a list of likely commands
-to look at with HELP.
-
-<sect1>kill 
-
-<P>
-<tt>
-<bf>kill &lt;msgno&gt; &lsqb;&lt;msgno&gt; ..&rsqb;</bf> Delete a message 
-from the local system
-</tt>
-
-<P>
-Delete a message from the local system. You will only be able to
-delete messages that you have originated or been sent (unless you are
-the sysop).
-
-<sect1>links 
-
-<P>
-<tt>
-<bf>links</bf> Show which nodes are physically connected
-</tt>
-
-<P>
-This is a quick listing that shows which links are connected and
-some information about them. See WHO for a list of all connections.
-
-<sect1>read 
-
-<P>
-<tt>
-<bf>read</bf> Read the next unread personal message addressed to you<newline>
-<bf>read &lt;msgno&gt;</bf> Read the specified message<newline>
-</tt>
-
-<P>
-You can read any messages that are sent as 'non-personal' and also any
-message either sent by or sent to your callsign.
-
-<sect1>reject/announce
-
-<P>
-<tt>
-<bf>reject/announce &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set a reject filter
-for announce
-</tt>
-
-<P>
-Create an 'reject this announce' line for a filter. 
-
-An reject filter line means that if the announce matches this filter it is
-passed onto the user. See HELP FILTERS for more info. Please read this
-to understand how filters work - it will save a lot of grief later on.
-
-You can use any of the following things in this line:-
-
-<tscreen><verb>
-  info <string>            eg: iota or qsl
-  by <prefixes>            eg: G,M,2         
-  origin <prefixes>
-  origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-  origin_itu <numbers>
-  origin_zone <numbers>
-  by_dxcc <numbers>
-  by_itu <numbers>
-  by_zone <numbers>
-  channel <prefixes>
-  wx 1                     filter WX announces
-  dest <prefixes>          eg: 6MUK,WDX      (distros)
-</verb></tscreen>
-
-some examples:-
-
-<tscreen><verb>
-  rej/ann by_zone 14,15,16 and not by G,M,2
-</verb></tscreen>
-You can use the tag 'all' to reject everything eg:
-
-<tscreen><verb>
-  rej/ann all
-</verb></tscreen>
-
-but this probably for advanced users...
-
-<sect1>reject/spots 
-
-<P>
-<tt>
-<bf>reject/spots &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set a reject filter 
-line for spots
-</tt>
-
-<P>
-Create a 'reject this spot' line for a filter. 
-
-A reject filter line means that if the spot matches this filter it is
-dumped (not passed on). See HELP FILTERS for more info. Please read this
-to understand how filters work - it will save a lot of grief later on.
-
-You can use any of the following things in this line:-
-
-<tscreen><verb>
-  freq <range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
-  on <range>             same as 'freq'
-  call <prefixes>        eg: G,PA,HB9
-  info <string>          eg: iota or qsl
-  by <prefixes>            
-  call_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-  call_itu <numbers>
-  call_zone <numbers>
-  by_dxcc <numbers>
-  by_itu <numbers>
-  by_zone <numbers>
-  origin <prefixes>
-  channel <prefixes>
-</verb></tscreen>
-
-For frequencies, you can use any of the band names defined in
-SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
-thus: hf/ssb. You can also just have a simple range like: 0/30000 -
-this is more efficient than saying simply: on HF (but don't get
-too hung up about that)
-
-some examples:-
-
-<tscreen><verb>
-  rej/spot 1 on hf
-  rej/spot 2 on vhf and not (by_zone 14,15,16 or call_zone 14,15,16)
-</verb></tscreen>
-
-You can use the tag 'all' to reject everything eg:
-
-<tscreen><verb>
-  rej/spot 3 all
-</verb></tscreen>
-
-but this probably for advanced users...
-
-<sect1>reject/wcy 
-
-<P>
-<tt>
-<bf>reject/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set a reject WCY filter
-</tt>
-
-<P>
-It is unlikely that you will want to do this, but if you do then you can
-filter on the following fields:-
-
-<tscreen><verb>
-  by <prefixes>            eg: G,M,2         
-  origin <prefixes>
-  origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-  origin_itu <numbers>
-  origin_zone <numbers>
-  by_dxcc <numbers>
-  by_itu <numbers>
-  by_zone <numbers>
-  channel <prefixes>
-</verb></tscreen>
-
-There are no examples because WCY Broadcasts only come from one place and
-you either want them or not (see UNSET/WCY if you don't want them).
-
-This command is really provided for future use.
-
-See HELP FILTER for information.
-
-<sect1>reject/wwv 
-
-<P>
-<tt>
-<bf>reject/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set a reject WWV filter
-</tt>
-
-<P>
-It is unlikely that you will want to do this, but if you do then you can
-filter on the following fields:-
-
-<tscreen><verb>
-  by <prefixes>            eg: G,M,2         
-  origin <prefixes>
-  origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-  origin_itu <numbers>
-  origin_zone <numbers>
-  by_dxcc <numbers>
-  by_itu <numbers>
-  by_zone <numbers>
-  channel <prefixes>
-</verb></tscreen>
-
-for example 
-
-<tscreen><verb>
-  reject/wwv by_zone 14,15,16
-</verb></tscreen>
-
-is probably the only useful thing to do (which will only show WWV broadcasts
-by stations in the US).
-
-See HELP FILTER for information.
-
-<sect1>reply 
-
-<P>
-<tt>
-<bf>reply</bf> Reply (privately) to the last message that you have read<newline>
-<bf>reply &lt;msgno&gt;</bf> Reply (privately) to the specified message<newline>
-<bf>reply B &lt;msgno&gt;</bf> Reply as a Bulletin to the specified message<newline>
-<bf>reply NOPrivate &lt;msgno&gt;</bf> Reply as a Bulletin to the specified
-message<newline>
-<bf>reply RR &lt;msgno&gt;</bf> Reply to the specified message with read 
-receipt<newline>
-</tt>
-
-<P>
-You can reply to a message and the subject will automatically have
-"Re:" inserted in front of it, if it isn't already present.
-
-You can also use all the extra qualifiers such as RR, PRIVATE, 
-NOPRIVATE, B that you can use with the SEND command (see SEND
-for further details)
-
-<sect1>send 
-
-<P>
-<tt>
-<bf>send &lt;call&gt; &lsqb;&lt;call&gt; ...&rsqb;</bf> Send a message to 
-one or more callsigns<newline>
-<bf>send RR &lt;call&gt;</bf> Send a message and ask for a read receipt<newline>
-<bf>send COPY &lt;msgno&gt; &lt;call&gt;</bf> Send a copy of a  message 
-to someone<newline>
-<bf>send PRIVATE &lt;call&gt;</bf> Send a personal message<newline>
-<bf>send NOPRIVATE &lt;call&gt;</bf> Send a message to all stations<newline>
-</tt>
-
-<P>
-All the SEND commands will create a message which will be sent either to
-an individual callsign or to one of the 'bulletin' addresses. 
-
-SEND &lt;call&gt; on its own acts as though you had typed SEND PRIVATE, that is
-it will mark the message as personal and send it to the cluster node that
-that callsign is connected to.
-
-You can have more than one callsign in all of the SEND commands.
-
-You can have multiple qualifiers so that you can have for example:-
-
-<tscreen><verb>
-  SEND RR COPY 123 PRIVATE G1TLH G0RDI
-</verb></tscreen>
-
-which should send a copy of message 123 to G1TLH and G0RDI and you will
-receive a read receipt when they have read the message.
-
-SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak)
-SP is an alias for SEND PRIVATE
-
-<sect1>set/address 
-
-<P>
-<tt>
-<bf>set/address &lt;your_address&gt;</bf> Record your postal address
-</tt>
-
-<P>
-Literally, record your address details on the cluster.
-
-<sect1>set/announce 
-
-<P>
-<tt>
-<bf>set/announce</bf> Allow announce messages
-</tt>
-
-<P>
-Allow announce messages to arrive at your terminal.
-
-<sect1>set/beep 
-
-<P>
-<tt>
-<bf>set/beep</bf> Add beeps to terminal messages
-</tt>
-
-<P>
-Add a beep to DX and other terminal messages.
-
-<sect1>set/dx 
-
-<P>
-<tt>
-<bf>set/dx</bf>Allow DX messages to arrive at your terminal
-</tt>
-
-<P>
-You can stop DX messages with the <em>unset/dx</em> command
-
-<sect1>set/dxgrid
-
-<P>
-<tt>
-<bf>set/dxgrid</bf>Allow grid squares on the end of DX messages
-</tt>
-
-<P>
-Some logging programs do not like the additional information at
-the end of a DX spot.  If this is the case, use the <em>unset/dxgrid</em>
-command to remove the grid squares.
-
-<sect1>set/echo 
-
-<P>
-<tt>
-<bf>set/echo</bf> Make the cluster echo your input
-</tt>
-
-<P>
-If you are connected via a telnet session, different implimentations
-of telnet handle echo differently depending on whether you are 
-connected via port 23 or some other port. You can use this command
-to change the setting appropriately. 
-
-You can remove the echo with the <em>unset/echo</em> command
-
-The setting is stored in your user profile.
-
-YOU DO NOT NEED TO USE THIS COMMAND IF YOU ARE CONNECTED VIA AX25.
-
-<sect1>set/here
-
-<P>
-<tt>
-<bf>set/here</bf> Set the here flag
-</tt>
-
-<P>
-Let others on the cluster know you are here by only displaying your
-callsign.  If you are away from your terminal you can use the <em>unset/here</em>
-command to let people know you are away.  This simply puts brackets
-around your callsign to indicate you are not available.
-
-<sect1>set/homenode 
-
-<P>
-<tt>
-<bf>set/homenode &lt;node_call&gt;</bf> Set your home cluster
-</tt>
-
-<P>
-Tell the cluster system where you normally connect to. Any Messages sent
-to you will normally find their way there should you not be connected.
-eg:-
-
-<tscreen><verb>
-  SET/HOMENODE gb7djk
-</verb></tscreen>
-
-<sect1>set/language 
-
-<P>
-<tt>
-<bf>set/language &lt;language&gt;</bf> Set the language you wish to use
-</tt>
-
-<P>
-You can select the language that you want the cluster to use. Currently
-the languages available are <em>en</em> (English) <em>sp</em> (Spanish) 
-and <em>nl</em> (Dutch).
-
-<sect1>set/location 
-
-<P>
-<tt>
-<bf>set/location &lt;lat and long&gt;</bf> Set your latitude and longitude
-</tt>
-
-<P>
-You can set your latitude and longitude manually or alternatively use the
-<em>set/qra</em> command which will do the conversion for you.
-
-<tscreen><verb>
-  set/location 54 04 N 2 02 E
-</verb></tscreen>
-
-<sect1>set/logininfo 
-
-<P>
-<tt>
-<bf>set/logininfo</bf> Show logins and logouts of nodes and users
-</tt>
-
-<P>
-Show users and nodes when they log in and out of the local cluster.  You
-can stop these messages by using the <em>unset/logininfo</em> command.
-
-<sect1>set/name 
-
-<P>
-<tt>
-<bf>set/name &lt;your_name&gt;</bf> Set your name
-</tt>
-
-<P>
-Tell the cluster what your name is, eg:-
-
-<tscreen><verb>
-  set/name Dirk
-</verb></tscreen>
-
-<sect1>set/page 
-
-<P>
-<tt>
-<bf>set/page &lt;n&gt;</bf> Set the number of lines per page
-</tt>
-
-<P>
-Tell the system how many lines you wish on a page when the number of lines
-of output from a command is more than this. The default is 20. Setting it
-explicitly to 0 will disable paging. 
-
-<tscreen><verb>
-  SET/PAGE 30
-  SET/PAGE 0
-</verb></tscreen>
-
-The setting is stored in your user profile.
-
-<sect1>set/qra 
-
-<P>
-<tt>
-<bf>set/qra &lt;locator&gt;</bf> Set your QRA locator
-</tt>
-
-<P>
-Tell the system what your QRA (or Maidenhead) locator is. If you have not
-done a SET/LOCATION then your latitude and longitude will be set roughly
-correctly (assuming your locator is correct ;-). For example:-
-
-<tscreen><verb>
-  SET/QRA JO02LQ
-</verb></tscreen>
-
-<sect1>set/qth
-
-<P>
-<tt>
-<bf>set/qth &lt;your QTH&gt;</bf> Set your QTH
-</tt>
-
-<P>
-Tell the system where your are.  For example:-
-
-<tscreen><verb>
-  set/qth East Dereham, Norfolk
-</verb></tscreen>
-
-<sect1>set/talk
-
-<P>
-<tt>
-<bf>set/talk</bf> Allow talk messages to be seen at your console
-</tt>
-
-<P>
-Allow talk messages to arrive at your console.  You can switch off
-talks with the <em>unset/talk</em> command.
-
-<sect1>set/wcy
-
-<P>
-<tt>
-<bf>set/wcy</bf> Allow WCY messages to be seen at your console
-</tt>
-
-<P>
-Allow WCY information to be seen at your console.  You can switch off
-WCY messages with the <em>unset/wcy</em> command.
-
-<sect1>set/wwv
-
-<P>
-<tt>
-<bf>set/wwv</bf> Allow WWV messages to be seen at your console
-</tt>
-
-<P>
-Allow WWV information to be seen at your console.  You can switch off
-WWV messages with the <em>unset/wwv</em> command.
-
-<sect1>set/wx 
-
-<P>
-<tt>
-<bf>set/wx</bf> Allow WX messages to be seen at your console
-</tt>
-
-<P>
-Allow WX information to be seen at your console.  You can switch off
-WX messages with the <em>unset/wx</em> command.
-
-<sect1>show/configuration
-
-<P>
-<tt>
-<bf>show/configuration &lsqb;&lt;node&gt;&rsqb;</bf> Show all visible nodes and their users
-</tt>
-
-<P>
-This command allows you to see all the users that can be seen
-and the nodes to which they are connected.  With the optional <em>node</em>,
-you can specify a particular node to look at.
-
-This command is normally abbreviated to: sh/c
-
-BE WARNED: the list that is returned can be VERY long
-
-<sect1>show/configuration/node
-
-<P>
-<tt>
-<bf>show/configuration/node</bf> Show all the nodes connected
-</tt>
-
-<P>
-Show all the nodes connected locally and the nodes they have connected.
-
-
-<sect1>show/date 
-
-<P>
-<tt>
-<bf>show/date &lsqb;&lt;prefix&gt;&verbar;&lt;callsign&gt;&rsqb;</bf> Show
-the local time
-</tt>
-
-<P>
-This is very nearly the same as SHOW/TIME, the only difference the format
-of the date string if no arguments are given.
-
-If no prefixes or callsigns are given then this command returns the local
-time and UTC as the computer has it right now. If you give some prefixes
-then it will show UTC and UTC + the local offset (not including DST) at
-the prefixes or callsigns that you specify.
-
-<sect1>show/dx 
-
-<P>
-<tt>
-<bf>show/dx &lsqb;options&rsqb;</bf> interrogate the spot database
-</tt>
-
-<P>
-If you just type SHOW/DX you will get the last so many spots
-(sysop configurable, but usually 10).
-   
-In addition you can add any number of these options in very nearly
-any order to the basic SHOW/DX command, they are:-
-
-<tscreen><verb>   
-on &lt;band&gt;       - eg 160m 20m 2m 23cm 6mm
-on &lt;region&gt;     - eg hf vhf uhf shf      (see SHOW/BANDS)
-   
-&lt;number&gt;        - the number of spots you want
-&lt;from&gt;-&lt;to&gt     - &lt;from&gt; spot no &lt;to&gt; spot no in 
-                  the selected list
-   
-&lt;prefix&gt;        - for a spotted callsign beginning with &lt;prefix&gt;
-*&lt;suffix&gt;       - for a spotted callsign ending in &lt;suffix&gt;
-*&lt;string&gt;*      - for a spotted callsign containing &lt;string&gt;
-   
-day &lt;number&gt;    - starting &lt;number&gt; days ago
-day &lt;from&gt;-&lt;to&gt; - &lt;from&gt; days &lt;to&gt; days ago
-   
-info &lt;text&gt;     - any spots containing &lt;text&gt; in the info or remarks
-   
-by &lt;call&gt;       - any spots spotted by &lt;call&gt; (spotter &lt;call&gt; 
-                        is the same).
-
-qsl             - this automatically looks for any qsl info on the call
-                  held in the spot database.
-
-iota &lsqb;&lt;iota&gt;&rsqb;   - If the iota island number is missing it will 
-                  look for the string iota and anything which looks like 
-                  an iota island number. If you specify then it will look 
-                  for that island.
-
-qra &lsqb;&lt;locator&gt;&rsqb; - this will look for the specific locator if 
-                  you specify one or else anything that looks like a locator.
-</verb></tscreen>
-   
-e.g. 
-
-<tscreen><verb>   
-   SH/DX 9m0
-   SH/DX on 20m info iota
-   SH/DX 9a on vhf day 30
-   SH/DX rf1p qsl
-   SH/DX iota 
-   SH/DX iota eu-064
-   SH/DX qra jn86
-</verb></tscreen>
-
-<sect1>show/dxcc 
-
-<P>
-<tt>
-<bf>show/dxcc &lt;prefix&gt;</bf> Interrogate the spot database by country
-</tt>
-
-<P>
-This command takes the &lt;prefix&gt; (which can be a full or partial 
-callsign if desired), looks up which internal country number it is
-and then displays all the spots as per SH/DX for that country.
-   
-The options for SHOW/DX also apply to this command.   
-e.g. 
-
-<tscreen><verb>   
-   SH/DXCC G
-   SH/DXCC W on 20m info iota
-</verb></tscreen>
-
-<sect1>show/files 
-
-<P>
-<tt>
-<bf>show/files &lsqb;&lt;filearea&gt; &lsqb;&lt;string&gt;&rsqb;&rsqb;</bf> List
-the contents of a filearea
-</tt>
-
-<P>
-SHOW/FILES on its own will show you a list of the various fileareas
-available on the system. To see the contents of a particular file
-area type:-
-
-<tscreen><verb>
-   SH/FILES &lt;filearea&gt;
-</verb></tscreen>
-
-where &lt;filearea&gt; is the name of the filearea you want to see the 
-contents of.
-
-You can also use shell globbing characters like '*' and '?' in a
-string to see a selection of files in a filearea eg:-
-
-<tscreen><verb>
-   SH/FILES bulletins arld*
-</verb></tscreen>
-
-See also TYPE - to see the contents of a file.
-
-<sect1>show/filter 
-
-<P>
-<tt>
-<bf>show/filter</bf> Show the filters you have set
-</tt>
-
-<P>
-Show the contents of all the filters that are set by you. This command 
-displays all the filters set - for all the various categories.
-
-<sect1>show/moon 
-
-<P>
-<tt>
-<bf>show/moon &lsqb;&lt;prefix&gt;&verbar;&lt;callsign&gt;&rsqb;</bf> Show moon
-rise and set times
-</tt>
-
-<P>
-Show the Moon rise and set times for a (list of) prefixes or callsigns, 
-together with the azimuth and elevation of the sun currently at those
-locations.
-
-If you don't specify any prefixes or callsigns, it will show the times for
-your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
-together with the current azimuth and elevation.
-
-In addition, it will show the gain or loss dB relative to the nominal 
-distance of 385,000Km due to the ellipsoidal nature of the orbit.
-
-If all else fails it will show the Moonrise and set times for the node
-that you are connected to. 
-
-For example:-
-
-<tscreen><verb>
-  SH/MOON
-  SH/MOON G1TLH W5UN
-</verb></tscreen>
-
-<sect1>show/muf 
-
-<P>
-<tt>
-<bf>show/muf &lt;prefix&gt; &lsqb;&lt;hours&gt;&rsqb;&lsqb;long&rsqb;</bf> Show
-the likely propagation to &lt;prefix&gt;
-</tt>
-
-<P>
-This command allow you to estimate the likelihood of you contacting
-a station with the prefix you have specified. The output assumes a modest
-power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD)
-
-The result predicts the most likely operating frequencies and signal
-levels for high frequency (shortwave) radio propagation paths on
-specified days of the year and hours of the day. It is most useful for
-paths between 250 km and 6000 km, but can be used with reduced accuracy
-for paths shorter or longer than this.
-
-The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
-used to predict the MUF given the predicted flux, day of the year,
-hour of the day and geographic coordinates of the transmitter and
-receiver. This routine is reasonably accurate for the purposes here,
-with a claimed RMS error of 3.8 MHz, but much smaller and less complex
-than the programs used by major shortwave broadcasting organizations,
-such as the Voice of America.
-
-The command will display some header information detailing its
-assumptions, together with the locations, latitude and longitudes and
-bearings. It will then show UTC (UT), local time at the other end
-(LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
-(Zen) and the likely signal strengths. Then for each frequency for which
-the system thinks there is a likelihood of a circuit it prints a value.
-
-The value is currently a likely S meter reading based on the conventional
-6dB / S point scale. If the value has a '+' appended it means that it is
-1/2 an S point stronger. If the value is preceeded by an 'm' it means that
-there is likely to be much fading and by an 's' that the signal is likely
-to be noisy.  
-
-By default SHOW/MUF will show the next two hours worth of data. You
-can specify anything up to 24 hours worth of data by appending the no of
-hours required after the prefix. For example:-
-
-<tscreen><verb>
-  SH/MUF W
-</verb></tscreen>
-
-produces:
-
-<tscreen><verb>
-  RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
-  Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
-  Location                       Lat / Long           Azim
-  East Dereham, Norfolk          52 41 N 0 57 E         47
-  United-States-W                43 0 N 87 54 W        299
-  UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
-  18 23 11.5 -35  mS0+ mS2   S3
-  19  0 11.2 -41  mS0+ mS2   S3
-</verb></tscreen>
-
-indicating that you will have weak, fading circuits on top band and 
-80m but usable signals on 40m (about S3).
-
-inputing:-
-
-<tscreen><verb>
-  SH/MUF W 24
-</verb></tscreen>
-
-will get you the above display, but with the next 24 hours worth of
-propagation data.
-
-<tscreen><verb>
-  SH/MUF W L 24
-  SH/MUF W 24 Long
-</verb></tscreen>
-
-Gives you an estimate of the long path propagation characterics. It
-should be noted that the figures will probably not be very useful, nor
-terrible accurate, but it is included for completeness.
-
-<sect1>show/prefix 
-
-<P>
-<tt>
-<bf>show/prefix &lt;callsign&gt;</bf> Interrogate the prefix database
-</tt>
-
-<P>
-This command takes the &lt;callsign&gt; (which can be a full or partial 
-callsign or a prefix), looks up which internal country number 
-it is and then displays all the relevant prefixes for that country
-together with the internal country no, the CQ and ITU regions. 
-
-See also SHOW/DXCC
-
-<sect1>show/qra 
-
-<P>
-<tt>
-<bf>show/qra &lt;locator&gt &lsqb;&lt;locator&gt;&rsqb;</bf> Show the distance
-between locators<newline>
-<bf>show/qra &lt;lat&gt; &lt;long&gt;</bf> Convert latitude and longitude to 
-a locator
-</tt>
-
-<P>
-This is a multipurpose command that allows you either to calculate the
-distance and bearing between two locators or (if only one locator is
-given on the command line) the distance and beraing from your station
-to the locator. For example:-
-
-<tscreen><verb>
-SH/QRA IO92QL 
-SH/QRA JN06 IN73
-</verb></tscreen>
-
-The first example will show the distance and bearing to the locator from
-yourself, the second example will calculate the distance and bearing from
-the first locator to the second. You can use 4 or 6 character locators.
-
-It is also possible to convert a latitude and longitude to a locator by 
-using this command with a latitude and longitude as an argument, for
-example:-
-
-<tscreen><verb>
-SH/QRA 52 41 N 0 58 E
-</verb></tscreen>
-
-<sect1>show/qrz
-
-<P>
-<tt>
-<bf>show/qrz &lt;callsign&gt;</bf> Show any callbook details on a callsign
-</tt>
-
-<P>
-This command queries the QRZ callbook server on the internet
-and returns any information available for that callsign. This service
-is provided for users of this software by http://www.qrz.com 
-
-<sect1>show/route 
-
-<P>
-<tt>
-<bf>show/route &lt;callsign&gt;</bf> Show the route to &lt;callsign&gt;
-</tt>
-
-<P>
-This command allows you to see to which node the callsigns specified are
-connected. It is a sort of inverse sh/config.
-
-<tscreen><verb>
-  sh/route n2tly
-</verb></tscreen>
-
-<sect1>show/satellite 
-
-<P>
-<tt>
-<bf>show/satellite &lt;name&gt; &lsqb;&lt;hours&gt; &lt;interval&gt;&rsqb;</bf>
-Show satellite tracking data
-</tt>
-
-<P>
-Show the tracking data from your location to the satellite of your choice
-from now on for the next few hours.
-
-If you use this command without a satellite name it will display a list
-of all the satellites known currently to the system. 
-
-If you give a name then you can obtain tracking data of all the passes
-that start and finish 5 degrees below the horizon. As default it will
-give information for the next three hours for every five minute period.
-
-You can alter the number of hours and the step size, within certain 
-limits. 
-
-Each pass in a period is separated with a row of '-----' characters
-
-So for example:-
-
-<tscreen><verb>
-SH/SAT AO-10 
-SH/SAT FENGYUN1 12 2
-</verb></tscreen>
-
-<sect1>show/sun 
-
-<P>
-<tt>
-<bf>show/sun &lsqb;&lt;prefix&gt;&verbar;&lt;callsign&gt;&rsqb;</bf> Show
-sun rise and set times
-</tt>
-
-<P>
-Show the sun rise and set times for a (list of) prefixes or callsigns, 
-together with the azimuth and elevation of the sun currently at those
-locations.
-
-If you don't specify any prefixes or callsigns, it will show the times for
-your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
-together with the current azimuth and elevation.
-
-If all else fails it will show the sunrise and set times for the node
-that you are connected to. 
-
-For example:-
-
-<tscreen><verb>
-  SH/SUN
-  SH/SUN G1TLH K9CW ZS
-</verb></tscreen>
-
-<sect1>show/time 
-
-<P>
-<tt>
-<bf>show/time &lsqb;&lt;prefix&gt;&verbar;&lt;callsign&gt;&rsqb;</bf> Show
-the local time
-</tt>
-
-<P>
-If no prefixes or callsigns are given then this command returns the local
-time and UTC as the computer has it right now. If you give some prefixes
-then it will show UTC and UTC + the local offset (not including DST) at
-the prefixes or callsigns that you specify.
-
-<sect1>show/wcy 
-
-<P>
-<tt>
-<bf>show/wcy</bf> Show the last 10 WCY broadcasts<newline>
-<bf>show/wcy &lt;n&gt;</bf> Show the last &lt;n&gt; WCY broadcasts
-</tt>
-
-<P>
-Display the most recent WCY information that has been received by the system
-
-<sect1>show/wwv
-
-<P>
-<tt>
-<bf>show/wwv</bf> Show the last 10 WWV broadcasts<newline>
-<bf>show/wwv &lt;n&gt;</bf> Show the last &lt;n&gt; WWV broadcasts
-</tt>
-
-<P>
-Display the most recent WWV information that has been received by the system
-
-<sect1>sysop 
-
-<P>
-<tt>
-<bf>sysop</bf> Regain your privileges if you login remotely
-</tt>
-
-<P>
-The system automatically reduces your privilege level to that of a
-normal user if you login in remotely. This command allows you to
-regain your normal privilege level. It uses the normal system: five
-numbers are returned that are indexes into the character array that is
-your assigned password (see SET/PASSWORD). The indexes start from
-zero.
-
-You are expected to return a string which contains the characters
-required in the correct order. You may intersperse those characters
-with others to obscure your reply for any watchers. For example (and
-these values are for explanation :-):
-
-<tscreen><verb>
-  password = 012345678901234567890123456789
-  > sysop
-  22 10 15 17 3
-</verb></tscreen>
-
-you type:-
-
-<tscreen><verb>
- aa2bbbb0ccc5ddd7xxx3n
- or 2 0 5 7 3
- or 20573
-</verb></tscreen>
-
-They will all match. If there is no password you will still be offered
-numbers but nothing will happen when you input a string. Any match is
-case sensitive.
-
-<sect1>talk 
-
-<P>
-<tt>
-<bf>talk &lt;callsign&gt;</bf> Enter talk mode with &lt;callsign&gt;<newline>
-<bf>talk &lt;callsign&gt; &lt;text&gt;</bf> Send a text message to &lt;callsign&gt;<newline>
-<bf>talk &lt;callsign&gt; &gt; &lt;node_call&gt; &lsqb;&lt;text&gt;&rsqb;</bf>
-Send a text message to &lt;callsign&gt; via &lt;node_call&gt;
-</tt>
-
-<P>
-Send a short message to any other station that is visible on the cluster
-system. You can send it to anyone you can see with a SHOW/CONFIGURATION 
-command, they don't have to be connected locally.
-
-The second form of TALK is used when other cluster nodes are connected
-with restricted information. This usually means that they don't send 
-the user information usually associated with logging on and off the cluster.
-
-If you know that G3JNB is likely to be present on GB7TLH, but you can only
-see GB7TLH in the SH/C list but with no users, then you would use the
-second form of the talk message.
-
-If you want to have a ragchew with someone you can leave the text message
-out and the system will go into 'Talk' mode. What this means is that a
-short message is sent to the recipient telling them that you are in a 'Talking' 
-frame of mind and then you just type - everything you send will go to the 
-station that you asked for. 
-
-All the usual announcements, spots and so on will still come out on your
-terminal.
-
-If you want to do something (such as send a spot) you precede the normal 
-command with a '/' character, eg:-
-
-<tscreen><verb>
-   /DX 14001 G1TLH What's a B class licensee doing on 20m CW?
-   /HELP talk
-</verb></tscreen>
-
-To leave talk mode type:
-   
-<tscreen><verb>
-   /EX
-</verb></tscreen>
-
-<sect1>type 
-
-<P>
-<tt>
-<bf>type &lt;filearea&gt;/&lt;name&gt;</bf> Look at a file in one of the fileareas
-</tt>
-
-<P>
-Type out the contents of a file in a filearea. So, for example, in 
-filearea 'bulletins' you want to look at file 'arld051' you would 
-enter:-
-
-<tscreen><verb>
-   TYPE bulletins/arld051
-</verb></tscreen>
-
-See also SHOW/FILES to see what fileareas are available and a 
-list of content.
-
-<sect1>who 
-
-<P>
-<tt>
-<bf>who</bf> Show who is physically connected locally
-</tt>
-
-<P>
-This is a quick listing that shows which callsigns are connected and
-what sort of connection they have
-
-<sect1>wx 
-
-<P>
-<tt>
-<bf>wx &lt;text&gt;</bf> Send a weather message to local users<newline>
-<bf>wx full &lt;text&gt; </bf> Send a weather message to all cluster users
-</tt>
-
-<P>
-Weather messages can sometimes be useful if you are experiencing an extreme
-that may indicate enhanced conditions
-
-</article>