home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / XNET101.ZIP / XNET.DOC next >
Text File  |  1993-03-07  |  6KB  |  147 lines
  1.  
  2.  
  3.     XNET v1.01 ■ Copyright 1993 by John Giesbrecht (1:247/128)
  4.  
  5.  
  6.     XNET extracts a selected net or region from a raw nodelist, producing
  7.     an FTS-0005-compatible nodelist (including the CRC) which can be
  8.     processed without error by nodelist processors such as XLAXNODE.  XNET
  9.     requires approximately 85K of RAM.
  10.  
  11.     It will optionally include administrative nodes, and produce a
  12.     formatted, human-readable list of the selected nodes.
  13.  
  14.  
  15.     Command-line syntax
  16.     ~~~~~~~~~~~~~~~~~~~
  17.  
  18.     XNET /N[<n>:]<n>|/R<n>|/Z<n> [/I<filespec>] [/A] [/T] [/W]
  19.  
  20.       /N specifies net to extract    ┐  (exactly
  21.       /R     "     region to extract ├         one
  22.       /Z     "     zone to extract   ┘           required)
  23.       /I     "     input nodelist (optional)
  24.       /A include zone-level independent (administrative) nodes (optional)
  25.       /T generate  80-column human-readable text (optional)
  26.       /W    "     132-column       "          "  (optional)
  27.  
  28.  
  29.     Notes:
  30.  
  31.     ■ Parameters must be preceded by either a forward slash ('/') or a
  32.       hyphen ('-').
  33.  
  34.     ■ The command line is not case-sensitive.
  35.  
  36.     ■ The order of the parameters is not significant.
  37.  
  38.  
  39.     /N, /R, : Exactly one must be specified.  N followed by a net number
  40.     /Z        specifies a net to be extracted; R specifies a region,
  41.               and Z a zone.  Since net numbers are unique only within
  42.               zones, you may optionally specify a zone by prefixing it
  43.               (and a colon) to the net number.  Zone 1 is the default.
  44.  
  45.               Examples:
  46.  
  47.               /N247
  48.  
  49.                    Extract net 247 in zone 1.
  50.  
  51.               /N2:247
  52.  
  53.                    Extract net 247 in zone 2.
  54.  
  55.     /I      : Followed by a filespec, specifies the input nodelist.  XNET
  56.               defaults to looking for the newest NODELIST.nnn (where nnn is
  57.               a day number) in the current directory.  If you provide a
  58.               backslash-terminated path, a similar search will be performed
  59.               in the specified directory.  If the path does not end in a
  60.               backslash, the last element will be used as the base filename
  61.               instead of NODELIST.  If an extension is provided, the
  62.               extract will come from the specified file.
  63.  
  64.               Examples:
  65.  
  66.               -Ifishnet
  67.  
  68.                    Use the newest FISHNET.nnn in the current directory.
  69.  
  70.               /Id:\max\nl\
  71.  
  72.                    Use the newest NODELIST.nnn in d:\max\nl.
  73.  
  74.                -id:\max\nl\crudnet
  75.  
  76.                    Use the newest CRUDNET.nnn in d:\max\nl.
  77.  
  78.                /ie:\bink\nodelist\nodelist.234
  79.  
  80.                    Use NODELIST.234 in e:\bink\nodelist.
  81.  
  82.     /A       : Include zone-level independent nodes.  This group of nodes
  83.                includes Fidonet administrative nodes, the zonegates, and
  84.                help nodes for most major Fidonet software.  By including
  85.                these nodes, a system using a small nodelist is still able
  86.                to crash mail to these important nodes.  Since these nodes
  87.                are always included in zone-level lists, the /A switch has
  88.                no effect if the /Z switch is used.
  89.  
  90.     /T       : Generate an 80-column-wide text listing of the nodes in
  91.                specified region or net, including address, system name,
  92.                sysop, and telephone number.  If an entry is too wide for
  93.                its field, it is truncated and terminated with an ampersand
  94.                ('&').
  95.  
  96.     /W       : Generate an 132-column-wide text listing of the nodes in
  97.                specified region or net, including address, system name,
  98.                sysop, location, BPS rate, and telephone number.  If an
  99.                entry is too wide for its field, it is truncated and
  100.                terminated with an ampersand ('&').
  101.  
  102.  
  103.     Output files
  104.     ~~~~~~~~~~~~
  105.  
  106.     Output files are named as follows, depending on the number of digits to
  107.     be accommodated.  Region listings begin with an 'R' rather than an 'N',
  108.     and zone listings with a 'Z'.  The file extension is the same as the
  109.     input nodelist's.
  110.  
  111.              Net            80-col text        132-col text
  112.  
  113.          N99-LIST.nnn       N99-TEXT.nnn       N99-WTXT.nnn
  114.         N247-LIST.nnn      N247-TEXT.nnn      N247-WTXT.nnn
  115.         N1234LIST.nnn      N1234TEXT.nnn      N1234WTXT.nnn
  116.         N54321LST.nnn      N54321TXT.nnn      N54321WTX.nnn
  117.  
  118.     History
  119.     ~~~~~~~
  120.  
  121.     1.00   - (13 Jan 93) Initial release.
  122.  
  123.     1.01   - (7 Mar 93) Fixed bug which made XNET crash if SHARE.EXE not
  124.              installed.  (Thanks to Jim Whitelaw, Charlie Merryman, and
  125.              Michael Kuhl for helping with this.)
  126.  
  127.     Other stuff
  128.     ~~~~~~~~~~~
  129.  
  130.     XNET is copyright, but it may be used without charge.  You are free
  131.     (and encouraged) to distribute it.  It comes with no warranty of any
  132.     kind.  It's possible that it won't even take up any space on your hard
  133.     drive.
  134.  
  135.     If you have comments, suggestions, or bug reports, please send them
  136.     to me at 1:247/128.  I want to make XNET as useful as I can.
  137.  
  138.     Thanks to Tony Auer, Michael Kuhl, and Paul Doerwald for beta-testing
  139.     XNET.  Matthew Hildebrand deserves special thanks for sending me more
  140.     bug reports than I had hoped for, and for providing valuable (and much-
  141.     appreciated) suggestions and encouragement.
  142.  
  143.     XNET is written in Borland Pascal 7, and uses TurboPower Software's
  144.     invaluable Turbo Professional library.
  145.  
  146.     -----------------------------------------------------------------------
  147.