home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / HILFEN / MODEM / FONDIR / FONDIR.DOC < prev    next >
Text File  |  1993-12-01  |  72KB  |  1,727 lines
  1.  
  2. ╔═══════════════════════════════════════════════════════════════════════╗
  3. ║                                                                       ║
  4. ║      ╔═══  ╔══╗  ╔╗  ╗  ╔══╗   ═╦═  ╔══╗           User's Guide       ║
  5. ║      ╠═══  ║  ║  ║╚╗ ║  ║  ╚╗   ║   ║  ╚╗          to Operation       ║
  6. ║      ║     ║  ║  ║ ╚╗║  ║   ║   ║   ╠═╦═╝                             ║
  7. ║      ╚     ╚══╝  ╚  ╚╝  ╚═══╝  ═╩═  ╚ ╚══                             ║
  8. ║                                                                       ║
  9. ║                                                                       ║
  10. ║       FONDIR - BBS Text File to Phone Directory Translate Utility     ║
  11. ║      Copyright (C) 1988-1991 Henry C. Clark, All rights reserved.     ║
  12. ║                                                                       ║
  13. ╚═══════════════════════════════════════════════════════════════════════╝
  14.  
  15.                           Software Mechanics
  16.                            P.O. Box 832052
  17.                          Richardson, TX 75083
  18.  
  19.         214-881-2627  12/24/96/14400 bps  24hr  FidoNet 1:124/6119
  20.  
  21.  'Phone Dear' is not the type of program you run everyday, but it
  22. will save you countless hours of manual data entry, and help open the
  23. door to the world of electronic communications for you.
  24.  
  25. ╔═══════════════════════════════════════════════════════════════════════╗
  26. ║ What is FONDIR                                                        ║
  27. ╚═══════════════════════════════════════════════════════════════════════╝
  28.  
  29. FONDIR reads from a list of phone numbers, like a BBS list, and
  30. creates a communications program dialing directory.  It's very fast,
  31. and it does a bundle of translations, such as :
  32.  
  33.         - supports 20 comm programs
  34.         - long distance, local, metro EMS dial code conversions
  35.         - modem speed adjustment
  36.         - transfer protocol, terminal emulation, script support
  37.         - import from and export to almost any BBS list
  38.  
  39. FONDIR is distributed as Shareware, you get to try it before you
  40. are required to pay a license fee.
  41.  
  42. ╔═══════════════════════════════════════════════════════════════════════╗
  43. ║ WHATS NEW                                                             ║
  44. ╚═══════════════════════════════════════════════════════════════════════╝
  45.  
  46. FONDIR Version 5.9 implements support for Qmodem 5 and K9X 8.8.
  47. Also tested, but unchanged were Telemate 3.01 and Telix 3.15.
  48.  
  49. A bug was fixed in certain situations of metro number translation.
  50.  
  51. The next release of FONDIR, version 6, will most likely change all
  52. the program type identifiers ( the /o: option ) to a three character
  53. identifier.  Watch for details.
  54.  
  55. Enjoy.
  56.  
  57.  
  58.  
  59. ╔═══════════════════════════════════════════════════════════════════════╗
  60. ║ TABLE OF CONTENTS   FONDIR Version 5.9                                ║
  61. ╚═══════════════════════════════════════════════════════════════════════╝
  62.  
  63. Chap.  1 -- FONDIR ARCHIVE.
  64.   Installation
  65.   Overview
  66.   History
  67.  
  68. Chap.  2 -- HOW TO IMPORT A BBS LIST TO YOUR PROGRAM.
  69.   Quick Start Section
  70.   Fondir Uses Default Directory Name
  71.   Fondir Renames Existing Directory File
  72.  
  73. Chap.  3 -- HOW TO EXPORT FROM YOUR PROGRAM TO A BBS LIST.
  74.   Fondir Appends To Existing BBS List
  75.  
  76. Chap.  4 -- ONLINE HELP.
  77.  
  78. Chap.  5 -- THE COMMAND LINE OPTIONS.
  79.   Comm Program type             ( /o: option )
  80.   Assume Protocol               ( /p: option )
  81.   Keep Date                     ( /k  option )
  82.   Local Area Code               ( /l: option )
  83.   Prefix Phone Number           ( /a: option )
  84.   Metro Number                  ( /d: option )
  85.   Format Specification Key      ( /c  option )
  86.   Modem Speed                   ( /m:  and /b:  options )
  87.   Export                        ( /x  option )
  88.   Support file path             ( /s: option )
  89.   Filter mask                   ( /f: option )
  90.  
  91. Chap.  6 -- FONDIR DOS COMMAND SYNTAX EXAMPLES.
  92.   Transform Example
  93.   Error Checking of Input ( semantic )
  94.   Error on Input ( logical )
  95.  
  96. Chap.  7 -- BBS LIST FORMAT SPECIFICATIONS.
  97.   Format Specification Coding
  98.   Format Specifier Stacking
  99.   Format First Word Length
  100.   Format Header Specification
  101.   Comm Program Field Support
  102.  
  103. Chap.  8 -- BBS LIST CONTENTS.
  104.   Protocol Field Format
  105.   The Bps Modem Rate
  106.   Modem Type
  107.   Parity Indicator
  108.   File Transfer Protocol Type
  109.   Terminal Emulator Mode Codes
  110.   Examples of BBS Lists
  111.  
  112. Chap.  9 -- PROGRAM SWITCHES AND DEFAULTS.
  113.   Comm Program Type Codes
  114.   Speed Code Parameters
  115.   Warnings and Other Notes
  116.  
  117. Chap. 10 -- SHAREWARE LICENSE REGISTRATION.
  118.   Mail-in License Registration Form
  119.  
  120. Chap. 11 -- LICENSE AGREEMENT.
  121.   The Terms of The Agreement
  122.   Note from the Author
  123.  
  124.  
  125.  
  126. ╔═══════════════════════════════════════════════════════════════════════╗
  127. ║ 1 -- FONDIR ARCHIVE                                                   ║
  128. ╚═══════════════════════════════════════════════════════════════════════╝
  129.  
  130. FONDIR is shipped in an archive file, FONDIRxx.ZIP.  The 'xx' is the
  131. version number.  The archive file should contain the following files :
  132.  
  133.    FONDIR.EXE          - 8088 compatible version,
  134.    FONDIR.DOC          - this document file you're reading now,
  135.    FONERR.DOC          - list of displayed output from FONDIR operations
  136.                          meaning and possible solutions to problems
  137.    FONMAN.EXE          - an interactive approach to FONDIR
  138.    METRO.214           - sample DFW 214 metro exchange list,
  139.    LDAREA.214          - sample Dallas 214 long distance exchange list,
  140.    METRO.817           - sample DFW 817 metro exchange list,
  141.    HCC.LST             - sample empty BBS list with format line
  142.                          use with conversions
  143.    COMCOL.EXE          - program to convert comma separated files to
  144.                          the columnar format used by FONDIR,
  145.    COMCOL.DOC          - document for that program.
  146.  
  147.  
  148. ┌───────────────────────────────────────────────────────────────────────┐
  149. │ OVERVIEW                                                              │
  150. └───────────────────────────────────────────────────────────────────────┘
  151.   
  152.  
  153. FONDIR will convert a text list of BBS phone numbers, names and other
  154. information into a file which can be used by your Comm Program.
  155.  
  156. That bears repeating :
  157.  
  158. FONDIR will convert a text list of BBS phone numbers, names and other
  159. information into a file which can be used by your Comm Program.
  160.  
  161. You may have to ADD CONTROL CODES TO THE TEXT LIST to show FONDIR where
  162. the information is.  The control codes are called the Format
  163. Specification Key in this documentation.
  164.  
  165. FONDIR can also convert back to a text list format from your Comm
  166. Program phone directory file.
  167.  
  168.   BBS List -> FONDIR Import -> Comm Program directory file
  169.   Comm Program directory file -> FONDIR Export -> BBS List
  170.  
  171. You can use this two step processes to convert from one comm program
  172. to another.
  173.  
  174. COMCOL will convert a text file with comma separated fields to a
  175. vertical column field text file.  There is a separate document
  176. covering that program.  FONDIR likes columns of data.
  177.  
  178.  
  179. ┌───────────────────────────────────────────────────────────────────────┐
  180. │ INSTALLATION                                                          │
  181. └───────────────────────────────────────────────────────────────────────┘
  182.  
  183. FONDIR is short for Phone Directory. Un-zip the FONDIRxx.ZIP file and
  184. either :
  185.  
  186.   a.) keep the .exe program and exchange lists
  187.       with your BBS list files, or
  188.   b.) keep the .exe program and exchange lists
  189.       with your Comm Program files.
  190.  
  191. FONDIR will work from a pathed sub-directory.  See the section on
  192. Support file path for information regarding the specification of
  193. subdirectories for the different files FONDIR uses.
  194.  
  195. No, FONDIR is not crippled or copy protected or any of that.
  196.  
  197.  
  198.  
  199. ┌───────────────────────────────────────────────────────────────────────┐
  200. │ HISTORY                                                               │
  201. └───────────────────────────────────────────────────────────────────────┘
  202.  
  203. FONDIR, Version 5.9 is the result of continual upgrades, including :
  204.  
  205.      as BF.EXE ( Boyan Phone, the original Procomm beater ! )
  206.    V 1.0a  initial release, options h,s,n,p,b,m,d, CARR to BOYAN
  207.    V 1.1a    correct 9600 bps value for BOYAN
  208.  
  209.      as XLATE.EXE ( Translate for Carr/Farmer BBS list format )
  210.    V 2.0a  add procomm 2.4.2, procomm plus, qmodem, gt-powercomm, telix
  211.    V 3.0b  corrected gt-power headers, added options x, k
  212.    V 3.1b   on /b set speed option, move speed text into name area at end
  213.    V 3.2   correct end of gt file handling, pibterm support ( /o:I )
  214.    V 3.3   correct less than 8 char phone number length
  215.    V 3.4   new BBS list system name formats
  216.  
  217.      as FONDIR.EXE ( "Phone Dear" )
  218.    V 4.0a  any list using format specification, /l, /a area code options
  219.    V 4.1a  gt v.14, format codes for elapse, upload, download
  220.    V 4.2   telix 3, pibterm 4.1
  221.    V 4.3a  metro number support
  222.    V 4.4   Boyan 4 support, any two metro areas, Qmodem 4.0 support
  223.    V 4.5   gt 1500, area headers, stacked format fields
  224.    V 4.6   telemate 1.10
  225.    V 4.7   telemate memo & passwords, blank field bug fix, Zmodem default
  226.    V 4.8   telix export bug fix, /x:dirfile name option
  227.    V 4.9   Qmodem index number bug fix
  228.    V 5.0   PC-Talk4, Rcomm, K9-Express support, 80 exchange tables
  229.    V 5.1   Mirror 3 support
  230.    V 5.2   telemate 2.0, PC Anywhere 3.11, Carbon Copy Plus 4.01,
  231.            |g logfile key, |i port key
  232.    V 5.3   gt-15.50, MSC 6.0, remove 's' functions, first word on
  233.            file names
  234.    V 5.4   ADialer 2.0, remove duplex, fix telemate speed code
  235.    V 5.5   Commo 4.3, Qmodem 4.2, fix count truncate bugs
  236.    V 5.6   Unicom 2.0, Procomm + 2.0, test GT 16
  237.    V 5.7   Unicom 3.0, Commo 5, Boyan 5 tests, Qmodem 4.3 tests,
  238.            /s: support file path parameter
  239.    V 5.8   Ultiterm 2.0, GT 17.00, Pilot 2.0, /f: filter, |K mask field
  240.    V 5.9   qm 5, k9x88, telix 3.15, telemate 3.01,
  241.            fix bug in metro logic.
  242.  
  243.  
  244.  
  245. ╔═══════════════════════════════════════════════════════════════════════╗
  246. ║ 2 -- HOW TO IMPORT A BBS LIST TO YOUR PROGRAM                         ║
  247. ╚═══════════════════════════════════════════════════════════════════════╝
  248.  
  249.  
  250. ┌───────────────────────────────────────────────────────────────────────┐
  251. │ QUICK START SECTION                                                   │
  252. └───────────────────────────────────────────────────────────────────────┘
  253.  
  254.  
  255. Most BBS lists are distributed in text file format.  The list entries
  256. are arranged 'one BBS system per line of text', and the data for each
  257. BBS is arranged in columnar format.
  258.  
  259. FONDIR will convert a BBS list text file to the binary file that your
  260. Comm Program uses in it's dialing directory.
  261.  
  262. For example, let's suppose you have a BBS list file, and each line of
  263. data looks something like this :
  264.  
  265. 03/24 MY BBS               OPUS  214-881-2627  #Z  Henry Clark
  266. 03/24 Joe's BBS            OPUS  214-555-1234  #Z  Joe Modem  
  267. 03/24 RBBS Central         RBBS  900-555-0000  #Y  Huck Finn  
  268.  
  269. You need to add a set of codes to the list file so that FONDIR knows
  270. where the information about each BBS system is :
  271.  
  272. |d5   |n20                 |f4   |#12          |p2 |i11
  273.  
  274. 03/24 MY BBS               OPUS  214-881-2627  #Z  Henry Clark
  275. 03/24 Joe's BBS            OPUS  214-555-1234  #Z  Joe Modem  
  276. 03/24 RBBS Central         RBBS  900-555-0000  #Y  Huck Finn  
  277.  
  278. The codes ( for Format Specification ) I have used include the
  279. date last called ( |d ), the BBS system name ( |n ), a Script
  280. File name ( |f ), the phone number ( |# ) and some protocol
  281. codes ( |p ) and an information field ( |i ).  The important field is
  282. the phone number ( |# ), which must exist, and the phone numbers must
  283. begin with a digit ( 0 through 9 ).
  284.   
  285. After each code letter is the width of each columnar field.
  286.  
  287. Given the above two lines in a file called BBS.LST, I could then
  288. create a Comm Program directory file, for example the Boyan Version 5
  289. BOYAN.FON file, with the DOS command :
  290.  
  291. C:>fondir bbs.lst /o:b /k
  292.  
  293. That's all there is to it.  To do a QMODEM.FON file, just change the
  294. /o:b parameter to /o:q.
  295.  
  296.  
  297. ┌───────────────────────────────────────────────────────────────────────┐
  298. │ MORE DETAIL ABOUT FONDIR IMPORT                                       │
  299. └───────────────────────────────────────────────────────────────────────┘
  300.   
  301. I don't know which Comm Program you use.  I do know that the /o:
  302. option is REQUIRED.  You must use the /o: option to tell FONDIR which
  303. Comm Program you use. You must figure out which /o:  option is for
  304. your Comm Program.  Is that so hard ?
  305.  
  306. Target phone directory filenames :
  307.  
  308. "BOYAN.FON"               use the  /o:b  option  Boyan
  309. "PROCOMM.DIR"             use the  /o:p  option  Procomm
  310. "PCPLUS.DIR"              use the  /o:+  option  Procomm Plus 1.1
  311. "PCPLUS.DIR"              use the  /o:2  option  Procomm Plus 2.0
  312. "QMODEM.FON"              use the  /o:q  option  Qmodem
  313. "GT.DIR"                  use the  /o:g  option  GT Powercomm
  314. "TELIX.FON"               use the  /o:t  option  Telix
  315. "PIBTERM.FON"             use the  /o:i  option  Pibterm
  316. "TM.FON"                  use the  /o:m  option  Telemate * See note below
  317. "PC-TALK4.DIR"            use the  /o:c  option  PC-Talk
  318. "PC-TALK.DIR"             use the  /o:r  option  Rcomm
  319. "K9X.P"                   use the  /o:k  option  K9 Express
  320. "DIALDIR.DAT"             use the  /o:o  option  Mirror
  321. "DIALDIR.PRM"             use the  /o:a  option  PC Anywhere
  322. "CC30.CFG"                use the  /o:y  option  Carbon Copy
  323. "BBS.DAT"                 use the  /o:d  option  A Dialer
  324. "COMMO.FON"               use the  /o:f  option  Commo
  325. "UNICOM.DIR"              use the  /o:u  option  Unicom
  326. "ULTITERM.NUM"            use the  /o:l  option  Ultiterm
  327. "PILOT.DAT"               use the  /o:e  option  Pilot
  328.  
  329. "Boyan, Procomm, Procomm +, Qmodem, Gt-Powercomm, Telemate, Telix,
  330. Pibterm, PC-Talk4, Rcomm, K9-Express, Mirror 3, PC Anywhere,
  331. Carbon Copy Plus, A Dialer, Commo, Unicom, Ultiterm and Pilot"...
  332.  
  333.   ...are all Copyrighted by their respective authors.
  334.  
  335. ( A note to comm program AUTHORS and COPYRIGHT/TRADEMARK holders :
  336. At no time have I ever release the source to FONDIR nor the structures
  337. of phone directories sampled for this utility. )
  338.  
  339. In general, the contents of the phone file reflect your programs
  340. dialing directory information.  The above file names are the
  341. defaults for your Comm Programs.
  342.  
  343. * File create name note :
  344.  
  345. For Telemate, when using the System ID ( |i ) specification, a file
  346. called "TM.MEM" is created.  This is the Telemate memo file and it's
  347. contents is seen in the online dialing directory.  FONDIR refers to
  348. it as the 'auxiliary' file.
  349.  
  350.  
  351. ┌───────────────────────────────────────────────────────────────────────┐
  352. │ FONDIR USES DEFAULT DIRECTORY NAME.                                   │
  353. └───────────────────────────────────────────────────────────────────────┘
  354.  
  355. FONDIR always uses the above file names, and they are assumed to be
  356. in your current directory. It is an ERROR to enter a file name of
  357. these types as a parameter for FONDIR.  You specify one of the file
  358. names above using the /o:? parameter.  The valid characters for the
  359. '?' are shown above.
  360.  
  361. FONDIR is going to convert from the text file to the Comm Program
  362. directory file, or vice versa.  You specify the Comm Program
  363. type with the /o:? option, and you specify the BBS List text file name
  364. explicitly.
  365.  
  366.  
  367. ┌───────────────────────────────────────────────────────────────────────┐
  368. │ FONDIR RENAMES EXISTING DIRECTORY FILE.                               │
  369. └───────────────────────────────────────────────────────────────────────┘
  370.  
  371. When FONDIR is going to write a directory file with one of the above
  372. names, AND that file already EXISTS : FONDIR will rename the existing
  373. file by changing the last letter of the 'filename' part of the
  374. complete file name to a unique number.  For example, BOYAN.FON might
  375. become BOYA1.FON.
  376.  
  377. This technique is used when the BBS list contains more entries than
  378. the Comm Program file will support.  FONDIR will continue to rename
  379. the file to a unique name, for each directory file that is necessary
  380. to COMPLETELY convert the BBS list.  For example, you might end up
  381. with the following files, ( again, I'll use the BOYAN.FON example ) :
  382.  
  383.    boyan.fon   - the last file
  384.    boya1.fon   - the first file ( assuming none existed previously )
  385.    boya2.fon   - the second file ( second set of entries )
  386.    etc.
  387.  
  388. There are two ways to use these 'numbered' files.  The first is to
  389. simply copy it to the actual name required by your Comm Program.  The
  390. second way is to use your Comm Program's "select phone directory
  391. file" option, many Comm Programs support this function.
  392.  
  393. Any auxiliary file generated will follow this same naming convention.
  394.  
  395. WARNING : the maximum number of BBS list entries supportable is
  396. dependent upon the number of entries per file your Comm Program
  397. supports.  If FONDIR has to create more than 10 directory files,
  398. the numbering system will fall into the characters which logically
  399. follow the '9' character;  this is not fatal, just be sure to watch
  400. the file names to get the idea.  After '9' comes '@', then 'A', 'B',
  401. etc.
  402.  
  403.  
  404. ┌───────────────────────────────────────────────────────────────────────┐
  405. │ USAGE EXAMPLE ( Import BBS list to Comm Program ).                    │
  406. └───────────────────────────────────────────────────────────────────────┘
  407.  
  408. The following command is an example.  To convert to Procomm Plus 2.0 :
  409.  
  410.  FONDIR bbslist.txt /o:2
  411.         ^           ^
  412.         |           |
  413.         |           |
  414.         |           |
  415.         |           `-  translate to the Procomm + 2.0 format
  416.         `-  translate from this BBS list file
  417.  
  418. The BBS list file must contain a Format Specification which FONDIR
  419. uses to determine how the data in the list file is organized.  YOU
  420. MUST MANUALLY enter the specification if it is not already there.
  421. See Chapter 7 for more information on the Format Specification.
  422.        
  423.  
  424.  
  425. ╔═══════════════════════════════════════════════════════════════════════╗
  426. ║ 3 -- HOW TO EXPORT FROM YOUR PROGRAM TO A BBS LIST                    ║
  427. ╚═══════════════════════════════════════════════════════════════════════╝
  428.  
  429. The idea of exporting TO a BBS list text file from your program phone
  430. directory is to support the changes you are still making manually, so
  431. that you don't have to enter them again every time a BBS list
  432. changes.  The Export feature is also useful for translating between
  433. two or more Comm Programs.
  434.  
  435. The BBS list file must contain a Format Specification.  See Chapter 7
  436. for more information on the Format Specification.
  437.  
  438. For example purposes, create a text file called BBSLIST.TXT with
  439. the following line in it :
  440.  
  441. |d5   |n20                 |#12          |p4
  442.  
  443. Make sure your text file does NOT contain a CONTROL-Z ( ascii EOF ),
  444. such as DOS EDLIN would generate.
  445.  
  446. The FONDIR export command has three parameters :
  447.  
  448.   FONDIR bbslist.txt /o:b /x
  449.          ^           ^    ^
  450.          |           |    |
  451.          |           |    `------  the export option
  452.          |           `--------- the program type Boyan option
  453.          `------------------ a BBS text file to write to
  454.  
  455. The above command will append list information from your Boyan
  456. program phone file directory ( boyan.fon ), to a file called 
  457. "bbslist.txt" which would look like this :
  458.  
  459. |d5   |n20                 |#12          |p4
  460.  
  461. 03/24 MY BBS               214-881-2627  #Z
  462. 03/24 Joe's BBS            214-555-1234  #Z
  463. 03/24 RBBS Central         900-555-0000  #Y
  464.   
  465. You can specify WHICH Comm Program directory file to export using the
  466. option /x:filename format, but you can only export one comm program
  467. dialing directory file at a time.  See the /x option description for
  468. more information.
  469.  
  470.  
  471. ┌───────────────────────────────────────────────────────────────────────┐
  472. │ FONDIR APPENDS TO EXISTING BBS LIST.                                  │
  473. └───────────────────────────────────────────────────────────────────────┘
  474.  
  475. FONDIR always writes it's export text to the file name given.  It
  476. does NOT overwrite an existing text file of that name, it adds it's
  477. export data to the end of existing data.  These are also called
  478. 'append' writes.
  479.  
  480. You may specify a fully qualified path name for your BBS list text
  481. file.
  482.  
  483.  
  484.  
  485.  
  486. ╔═══════════════════════════════════════════════════════════════════════╗
  487. ║ 4 -- ONLINE HELP                                                      ║
  488. ╚═══════════════════════════════════════════════════════════════════════╝
  489.  
  490. You can get the following help information by entering the FONDIR
  491. command with NO parameters, with the /h parameter, or with the /?
  492. parameter.
  493.  
  494. Command format is   >FONDIR  BBSLIST.FIL  /o:x  [options]
  495.  
  496. BBSLIST.FIL is the text file                   /o:x   x = Program Types
  497.   with the format specification.
  498.                                                 B - Boyan      R - Rcomm
  499. OPTIONS :                                       P - Procomm    K - K9-express
  500.  /m:n  - max modem speed 3,1,2,4,9,a,b          + - Procomm+1  O - MirrOr
  501.  /b:n  - speed always : 3,1,2,4,9,a,b           2 - Procomm+2  A - PcAnywhere
  502.  /c:c  - BBS list format key, default '|'       Q - Qmodem5    Y - CarboncopY
  503.  /p:c  - protocol always 'c'                    G - Gt-power   D - ADial
  504.  /k    - keep dates from BBS list               T - Telix      F - F-Commo
  505.  /l:ddd   - LOCAL area code 'ddd' is not LD     I - PIbterm    U - Unicom
  506.  /a:ddd   - prefix LD phone number 'ddd'        M - TeleMate   L - ULtiterm
  507.  /d:ddd   - METRO exchange area code 'ddd'      C - PC-talk4   E - Pilot
  508.  /f:ccc   - filter mask field for 'ccc'         4 - Qmodem45
  509.  /s:pppp      - support file path                   
  510.  /x[:dirname] - Export to BBS list                  
  511.                                                      
  512. 24hr. Help/Register at Fidonet 1:124/6119  MY BBS  214-881-2627  9600,HST,V32
  513.  
  514. Error messages, if any, would be displayed immediately following this
  515. screen of data.  See the document named FONERR.DOC for a description
  516. of each error message.
  517.  
  518.  
  519.  
  520. ╔═══════════════════════════════════════════════════════════════════════╗
  521. ║ 5 -- THE COMMAND LINE OPTIONS                                         ║
  522. ╚═══════════════════════════════════════════════════════════════════════╝
  523.  
  524. ┌───────────────────────────────────────────────────────────────────────┐
  525. │ COMM PROGRAM TYPE ( /o:  option ).                                    │
  526. └───────────────────────────────────────────────────────────────────────┘
  527.  
  528. It's required and fully described in Chapter 2, section More Detail
  529. on Import.
  530.  
  531. OK, one more time :
  532.  
  533. /o:x   x = Program Types
  534.  
  535.  B - Boyan      R - Rcomm
  536.  P - Procomm    K - K9-express
  537.  + - Procomm+1  O - MirrOr
  538.  2 - Procomm+2  A - PcAnywhere
  539.  Q - Qmodem     Y - CarboncopY
  540.  G - Gt-power   D - ADial
  541.  T - Telix      F - F-Commo
  542.  I - PIbterm    U - Unicom
  543.  M - TeleMate   L - ULtiterm
  544.  C - PC-talk4   E - Pilot
  545.  
  546.  
  547. ┌───────────────────────────────────────────────────────────────────────┐
  548. │ ASSUME PROTOCOL ( /p:   option ).                                     │
  549. └───────────────────────────────────────────────────────────────────────┘
  550.  
  551. If you specify a protocol using the /p option, then FONDIR will
  552. always set the protocol in each phone directory entry to the letter
  553. you specify in the /p option.
  554.  
  555. In the absence of the /p option, FONDIR will use the Format
  556. Specification for PROTOCOL Code ( |p5 ), as you specified in the text
  557. file, and look there for a file transfer protocol code.  The codes
  558. are defined in Chapter 8.
  559.  
  560.  
  561. ┌───────────────────────────────────────────────────────────────────────┐
  562. │ KEEP DATE ( /k  option ).                                             │
  563. └───────────────────────────────────────────────────────────────────────┘
  564.  
  565. If you want to import the date of the last call into your Comm Program
  566. phone file directory, then use the /k option.  If you do NOT use the
  567. /k option, then your phone file directory will contain a blank date.
  568.  
  569. In a special case, a Qmodem 4.3 entry will contain the date that
  570. FONDIR created the FON directory.
  571.  
  572.  
  573. ┌───────────────────────────────────────────────────────────────────────┐
  574. │ LOCAL AREA CODE ( /l:   option ).                                     │
  575. └───────────────────────────────────────────────────────────────────────┘
  576.  
  577. The /l: option allows you to specify which area code is your local
  578. area code, and FONDIR will remove the area code digits from the phone
  579. number in the text list entry.
  580.  
  581. The phone numbers in a BBS list are best kept as full 10 digit phone
  582. numbers.  Like this : 214-881-2627.  If this is a local call to you,
  583. then you want FONDIR to remove the 214- code.
  584.  
  585. They do not HAVE to be 10-digit, but the FONDIR /l, /d and /a options
  586. function best when you use 10 digit codes. For your local calls, area
  587. code dialing will not be required or desired.
  588.  
  589. See Chapter 7 for |L format options that allow use of 7 digit numbers
  590. in the list, with an area code 'header'.
  591.  
  592. For example, if you live in the 214 area code, you may want to use
  593. the option /l:214-   to remove ONLY those digits from the start of
  594. a phone number.  /l:214 is the same, because FONDIR always puts the
  595. trailing - character on area codes.
  596.  
  597. Of course, many numbers in your local area code are still long
  598. distance.  FONDIR will attempt to read a file called LDAREA.xxx,
  599. where 'xxx' is the three digit local area code.  Each exchange in the
  600. LDAREA.xxx file is assumed to be not local, but long distance.
  601. Since I don't know all the long distance areas and phone exchanges, I
  602. leave it up to you to make your own LDAREA.xxx files, if you need
  603. them.  Just make sure you use the same format that the METRO.xxx files
  604. use, ie. one three digit code per line.
  605.  
  606. Here's an example :  You live in the 214 area code, and you have a
  607. BBS list like this --
  608.  
  609. |d5   |n20                 |#12          |p4
  610.  
  611. 03/24 MY BBS               214-881-2627  #Z
  612. 03/24 Joe's BBS            214-555-1234  #Z
  613. 03/24 RBBS Central         900-555-0000  #Y
  614.  
  615. You also have a file called LDAREA.214 that contains two lines :
  616.  
  617. 555
  618. 666
  619.  
  620. When you use the /l:214 and /a:1- options, FONDIR will create phone
  621. numbers that look like this :
  622.  
  623. 1 MY BBS               881-2627
  624. 2 Joe's BBS            1-214-555-1234
  625. 3 RBBS Central         1-900-555-0000
  626.  
  627. Why ?  The first entry was 214-881 and 881 is NOT in the LDAREA.214
  628. file, so it must be local.  FONDIR stripped the area code.  The
  629. second entry was 214-555 and 555 IS in the LDAREA.214 ( remember this
  630. is just an example ).  555 then must be long distance, so FONDIR
  631. prefixed the number using the 1- code.  The third entry is area code
  632. 900 and in not involved with this type of translation.
  633.  
  634. On export, FONDIR will add back the area code to any phone number
  635. which is 8 digits or less, prior to writing to the BBS list file, if
  636. you use the /l: and /a: options.
  637.  
  638. If you use the /s: path option, it affects where FONDIR looks for the
  639. LDAREA exchange file.  Use the /s: option before the /l: option, and
  640. the LDAREA file is searched from the path.  Use the /s: option after
  641. the /l: option, and the LDARDA file is searched from the default
  642. subdirectory.  See the section on the /s: option for more
  643. information.
  644.  
  645.  
  646. ┌───────────────────────────────────────────────────────────────────────┐
  647. │ PREFIX PHONE NUMBER ( /a:  option ).                                  │
  648. └───────────────────────────────────────────────────────────────────────┘
  649.  
  650. The phone numbers in a BBS list may not always be fully dialable
  651. phone numbers.  Some examples of this are 'local 7 digit numbers'
  652. which are not local to you, incomplete phone numbers which are not
  653. stand alone numbers, or when you need to use access codes before you
  654. dial the number, such as the standard 1+ access code.
  655.  
  656. The /a: option, only works on Long Distance numbers outside your
  657. local area code as specified by the /l: option, unless the additional
  658. LDAREA.xxx file has been used.
  659.  
  660. Use /a:  followed by one or more prefix digit codes.  For example,
  661. you need to dial 10288-1- to get the correct long distance carrier :
  662. use /a:10288-1-  to prefix every LD phone number in the BBS list.
  663.  
  664. Most people with standard 10 digit phone lists will use :
  665.   /a:1-
  666.  
  667. The prefix is not recommended for PBX ( dial 9 to get out ) type
  668. functions.  In these cases, where ALL your phone numbers must be
  669. prefixed, use your Comm Program's dialing prefix feature, or set your
  670. modem dial string to something like ATDT9,  which causes every phone
  671. number to begin with the 9.
  672.  
  673.  
  674. ┌───────────────────────────────────────────────────────────────────────┐
  675. │ METRO NUMBER ( /d: option )                                           │
  676. └───────────────────────────────────────────────────────────────────────┘
  677.  
  678. The files METRO.214 and METRO.817 contain sample exchange code
  679. listings.  The sample represents the 214 and 817 area codes.  Each
  680. file can contain none, one or up to 50 'exchange' codes.
  681.   
  682. An exchange is the first three digits of a 7 digit number.  Certain
  683. areas of the country allow callers to dial 'toll free' calls with
  684. 10 digits, ie. using the area code, but not the 1+ format.  These
  685. extended area calls are typically called Metro numbers ( EMS service
  686. ).
  687.  
  688. FONDIR looks for a METRO.xxx file.   The 'xxx' is changed to the
  689. area code digits you specify in the /d: option.
  690.  
  691. If FONDIR finds such a file in the current directory, it will enable
  692. the logic to determine from your /d: option ( a metro area ) and
  693. the /a: option ( the long distance prefix ), whether or not a number
  694. is truly long distance, a metro number, or a local phone call, and
  695. how to encode the number correctly for dialing.
  696.  
  697. Since I don't know all the metro areas and phone exchanges, I leave
  698. it up to you to make your own METRO.xxx files, if you need them.  Just
  699. make sure you use the same format that the files are in now, ie. one
  700. three digit code per line.  You must insure that the 'xxx' extension
  701. matches your /d:xxx code.
  702.  
  703. An example :  You live in the 214 area code and you can dial some 817
  704. area code numbers without dialing 1 first.  Your BBS list looks like
  705. this :
  706.  
  707. |d5   |n20                 |#12          |p4
  708.  
  709. 03/24 MY BBS               214-881-2627  #Z
  710. 03/24 Joe's BBS            817-100-1234  #Z
  711. 03/24 RBBS Central         817-555-0000  #Y
  712.  
  713. You have a file called METRO.817 that contains two lines :
  714.  
  715. 555
  716. 666
  717.  
  718. When you use the /d:817 and /a:1- options, FONDIR will create phone
  719. numbers that look like this :
  720.  
  721. 1 MY BBS               1-214-881-2627
  722. 2 Joe's BBS            1-817-100-1234
  723. 3 RBBS Central         817-555-0000
  724.  
  725. Why ?  Well the first entry was just like the example used in the /l:
  726. option description, but I didn't specify a /l: option !  The second
  727. entry is 817-100, but 100 is not in the METRO.817 file, so FONDIR
  728. translates it as a long distance number.  The third entry is 817-555,
  729. and 555 IS in the METRO.817 file, so FONDIR knows its a metro type
  730. number and does not prefix it with the 1- digits.
  731.  
  732. If you use the /s: path option, it affects where FONDIR looks for the
  733. METRO exchange file.  Use the /s: option before the /l: option, and
  734. the METRO file is searched from the path.  Use the /s: option after
  735. the /l: option, and the METRO file is searched from the default
  736. subdirectory.  See the section on the /s: option for more
  737. information.
  738.  
  739. ┌───────────────────────────────────────────────────────────────────────┐
  740. │ NOTES ON /l, /a, /d OPTIONS                                           │
  741. └───────────────────────────────────────────────────────────────────────┘
  742.   
  743. The use of '-' dash characters is pretty much the norm for a phone
  744. number.  They are transparent to your modem ( yes, you probably send
  745. dashes to your modem all the time ).  You will note that I have
  746. demonstrated the /l, /a, and /d options using the '-' dash symbols.
  747.   
  748. If your particular BBS list format does not use dashes, then you
  749. should not use them in your option parameters.
  750.  
  751. On the off chance that your BBS list format uses the space ' '
  752. character for a separator, you will have to code the options in a
  753. special way, using quotes around the whole option.
  754.  
  755. For example :   "/l:214 "
  756.  
  757. Note the trailing space after the 214 digits.  This coding format
  758. would be used when your phone numbers look like this : 214 881 2627,
  759. instead of like this : 214-881 2627.
  760.  
  761. Because of restrictions imposed by the logic in FONDIR's phone number
  762. functions, only '-' dash or ' ' space or no separator code at all may
  763. be used.  You may use any of these three choices, at any time, but no
  764. other separator codes are useable.
  765.  
  766.  
  767. ┌───────────────────────────────────────────────────────────────────────┐
  768. │ FORMAT SPECIFICATION KEY CHARACTER ( /c  option ).                    │
  769. └───────────────────────────────────────────────────────────────────────┘
  770.  
  771. The Format Specification is a text line that you must place in your
  772. BBS List file.  The Format Specification marks the data columns for
  773. the information fields in each entry.  The default character is the
  774. '|' character.  You may use any marker character by selecting it with
  775. the /c: option, and by using that character within your BBS list
  776. file.
  777.  
  778. See Chapter 7 for more information on the Format Specification and
  779. which programs support which fields.
  780.  
  781.  
  782. ┌───────────────────────────────────────────────────────────────────────┐
  783. │ MODEM SPEED ( /m:  and /b:  options )                                 │
  784. └───────────────────────────────────────────────────────────────────────┘
  785.  
  786. The /m option allows you to specify your modems maximum speed.  For
  787. example, if you have a 2400 bps modem, and your BBS list contains
  788. entries with faster rates, you must use the /m:2  option so that
  789. FONDIR will set the rates for the faster entries back to 2400 bps.
  790.  
  791. The /b option allows you to set ALL entries to a specified speed. 
  792. This is useful for 'locking' your modem rate to a fixed speed,
  793. regardless of the speed of the modem at the other end, or the
  794. connected rate.  For example, if you want to lock your modem at 38400
  795. bps, then use the /b:B option and FONDIR will set all the entries to
  796. 38400 bps, regardless of the speed code in the BBS list.
  797.  
  798. See Chapter 11 for the valid Speed Codes.
  799.  
  800.  
  801. ┌───────────────────────────────────────────────────────────────────────┐
  802. │ EXPORT ( /x  option )                                                 │
  803. └───────────────────────────────────────────────────────────────────────┘
  804.   
  805. The /x option can be used in one of two formats :
  806.   1) /x =  with default Comm Program directory name assumed, or
  807.   2) /x:dirname = specified Comm Program directory name.
  808.  
  809. If you use the /x option with no directory name, FONDIR export
  810. assumes the standard Comm Program directory name, and that file must
  811. be located in the current sub-directory.
  812.  
  813. If you use the /x:dirname option, and specify the directory name,
  814. that file must also be located in the current directory.  Further,
  815. you may NOT specify a drive, path or file extension in the 'dirname'
  816. field.
  817.  
  818. Even though you specify the directory FILENAME, the EXTENSION is
  819. assumed.  This is because certain Comm Programs follow naming
  820. conventions with the directory file name, and/or auxiliary or
  821. secondary file name.
  822.  
  823. Example using BOYA1.FON :
  824.  
  825.   fondir bbs.lst /o:b /x:boya1
  826.   
  827. You can use the /c, /l, /d, /k and /s options with the Export
  828. ( /x ) option.
  829.  
  830. The BBS list filename is mandatory, and must contain a Format
  831. Specification as is the /o: option.
  832.  
  833. See Chapter 3 for more information on Export.
  834.  
  835.  
  836. ┌───────────────────────────────────────────────────────────────────────┐
  837. │ SUPPORT FILE PATH ( /s:  option )                                     │
  838. └───────────────────────────────────────────────────────────────────────┘
  839.  
  840. In response to requirements for a multiuser FONDIR, such as with the
  841. online directory creation doors, or for LAN usage, the /s option
  842. allows you to specify a subdirectory where FONDIR support files are
  843. located.
  844.  
  845. The support files include :
  846.   LDAREA exchange file ( if /l specified after /s )
  847.   METRO exchange file ( if /d specified after /s )
  848.   comm program directory ( both import and export )
  849.   auxiliary file ( both import and export )
  850.  
  851. Path information for the BBS text file may be specified in that
  852. filename parameter.
  853.  
  854. FONDIR looks for the LDAREA or METRO exchange files in the current
  855. subdirectory unless the /s:path option is specified before the /l:ddd
  856. or /d:ddd options.
  857.  
  858. On Import :
  859. FONDIR creates the comm program directory files in the /s:path
  860. subdirectory whenever the /s option is used.  In the absence of the
  861. /s: option, the comm program directory files are created in the
  862. current subdirectory.  Same for the auxiliary files.
  863.  
  864. On Export :
  865. FONDIR looks for the comm program directory file ( whether the
  866. default or the /x: specified file ) in the /s:path subdirectory
  867. whenever the /s option is used.  In the absence of the /s: option,
  868. the comm program directory file is searched in the current
  869. subdirectory.  Same for the auxiliary file.
  870.  
  871. For example, suppose you have 2 subdirectories called USER1 and
  872. USER2.  FONDIR.EXE is located in the subdirectory called UTIL, and
  873. the default or current directory is COMM.
  874.  
  875. In order for two users to run the program at the same time, you
  876. would need to code the FONDIR command for each to use the different
  877. subdirectories, as follows :
  878.  
  879. User 1's call :
  880. \util\fondir \user1\bbs.lst /o:q /l:214 /d:817 /a:1- /s:\user1
  881. User 2's call :
  882. \util\fondir \user2\bbs.lst /o:q /l:214 /d:817 /a:1- /s:\user2
  883.  
  884. The users can share the LDAREA and METRO exchange files located in
  885. the COMM directory ( /s is after the /l and /d options ).  The Qmodem
  886. .fon files will be created in each users separate directory.
  887.  
  888. If I put the /s: before the /l: and /d:, then the METRO and LDAREA
  889. files must be located in the \userx directory, as in :
  890.  
  891. \util\fondir \user1\bbs.lst /o:q /s:\user1 /l:214 /d:817 /a:1-
  892.  
  893.  
  894. ┌───────────────────────────────────────────────────────────────────────┐
  895. │ FILTER IMPORT ( /f: option )                                          │
  896. └───────────────────────────────────────────────────────────────────────┘
  897.  
  898. Use the /f: option to select particular types of BBS list records to
  899. import into your dialing directory.
  900.  
  901. When active, the /f: option lets you specify a mask, which must be
  902. found in the BBS list entry.  Most likely, your BBS list has some
  903. kind of 'special character' or 'protocol' field which specifies some
  904. special characteristics of the system.
  905.  
  906. Use the |K format specifier field ID to show FONDIR where this
  907. special data or coding is located in the BBS list.  An example :
  908.  
  909. |d5   |n20                 |#12          |p4  |K4
  910.  
  911. 03/24 MY BBS               214-881-2627  9Z   b
  912. 03/24 Joe's BBS            817-100-1234  2Z   $
  913. 03/24 RBBS Central         817-555-0000  2Y   r
  914.  
  915. where b = 38400 bps, 2 = 2400 bps, $ is commercial BBS, and
  916. r is restricted membership.
  917.  
  918. If you used the /f:$ option, you would only import Joe's ( the 2nd )
  919. entry.  If you used the /f:b option, you would only import MY BBS.
  920.  
  921. Note that if the |K field is not specified, then the /f: option
  922. defaults to using the |p protocol field.  So you could have this :
  923.  
  924. |d5   |n20                 |#12          |p4
  925.  
  926. 03/24 MY BBS               214-881-2627  9Zb
  927. 03/24 Joe's BBS            817-100-1234  2Z$
  928. 03/24 RBBS Central         817-555-0000  2Yr
  929.  
  930. and get the same results.
  931.  
  932. If you use more than one character, like /f:b$, then both characters
  933. ( 'b' and '$' ) must be found before the entry is imported.  In our
  934. example above, NO entries would be imported because no entries
  935. contain both the 'b' and '$' characters.
  936.  
  937.  
  938.  
  939. ╔═══════════════════════════════════════════════════════════════════════╗
  940. ║ 6 -- FONDIR DOS COMMAND SYNTAX EXAMPLES                               ║
  941. ╚═══════════════════════════════════════════════════════════════════════╝
  942.  
  943. >FONDIR bbslist.txt /o:b /s
  944.  
  945.    Import into Boyan from bbslist.txt, using system type for script
  946. name.
  947.  
  948. >FONDIR bbslist.txt /o:+ /b:a
  949.  
  950.    Import into Procomm Plus, make all speeds 19200, typically of
  951. 'locked rate' option.
  952.  
  953. >FONDIR bbslist.txt /o:+ /b:a /l:214
  954.  
  955.    Import, local area code is 214.  LDAREA.214 may contain
  956. exchanges in the 214 area which are still long distance to me.
  957.  
  958. >FONDIR bbslist.txt /o:+ /b:a /l:214 /a:1-
  959.  
  960.    As above, long distance prefix is 1-.
  961.  
  962. >FONDIR bbslist.txt /o:+ /b:a /l:214 /a:1- /d:817
  963.  
  964.    As above, a metro area is 817.  METRO.817 may contain exchanges in
  965. the 817 area which are still local calls to me.  Most people will use
  966. the /l, /a, /d options all the time if they live in a long distance
  967. or metro area.
  968.  
  969. >FONDIR c:\new\bbslist.txt /o:+ /m:2
  970.  
  971.    Import into Procomm Plus from bbslist.txt, max speed of my
  972. modem is 2400 ( over 2400 is changed to 2400 ).
  973.  
  974. >FONDIR bbslist.txt /o:q /k
  975.  
  976.    Import into Qmodem from bbslist.txt, use the date from the list.
  977.  
  978. >FONDIR bbslist.txt /o:g /p:O
  979.    
  980.    Import into GT-Powercomm, default file transfer protocol is 'O'.
  981.  
  982. >FONDIR bbslist.txt /o:g /f:+
  983.    
  984.    Import into GT-Powercomm, only those entries with the '+' mask
  985. present.
  986.  
  987. >FONDIR bbslist.txt /o:p /x
  988.  
  989.    Export from Procomm 2.4 to bbslist.txt.
  990.  
  991. >FONDIR bbslist.txt /o:b /x:boya1
  992.  
  993.    Export from a specified Boyan 5 phone file to bbslist.txt.
  994.  
  995. Yes, you can use this command :
  996.  
  997. FONDIR bbslist.txt /o:+ /b:a /m:a /l:214 /d:817 /a:10777-1- /k /p:Z /f:+
  998.  
  999.    The above command Imports from the text file bbslist.txt into
  1000. Procomm Plus format.  All modem speeds are set to 19200.  My area
  1001. code is 214 and I have a metro area 817.  Both my LDAREA.214 and
  1002. METRO.817 files are present. True long distance calls will use the
  1003. 10777-1- prefix.  I want to stuff the date from the bbslist.txt file
  1004. into Procomm Plus, and I want the default file transfer protocols to
  1005. be 'Z' type.  I only want to import entries with a '+' identifier.
  1006.  
  1007.  
  1008. ┌───────────────────────────────────────────────────────────────────────┐
  1009. │ TRANSFORM EXAMPLE.                                                    │
  1010. └───────────────────────────────────────────────────────────────────────┘
  1011.   
  1012.  
  1013. FONDIR hcc.lst /o:b /l:214 /a:1- /d:817 /k /x
  1014. FONDIR hcc.lst /o:q /l:214 /a:1- /d:817 /k
  1015.  
  1016.   The above two commands will export from Boyan format, writing
  1017. the text file hcc.lst and import that text file into Qmodem format.
  1018. The file hcc.lst is included with the FONDIR release.  It looks like
  1019. this :
  1020.  
  1021. |n30                          |#16             |p8      |d8      |f8      |i25
  1022. MY BBS                        214-881-2627     bZ       01/01/92 OPUS     Home of FONDIR
  1023.  
  1024. ┌───────────────────────────────────────────────────────────────────────┐
  1025. │ ERROR CHECKING OF INPUT ( SEMANTIC ).                                 │
  1026. └───────────────────────────────────────────────────────────────────────┘
  1027.  
  1028. FONDIR pretty much validates everything you enter, and it HAS to be
  1029. valid or FONDIR will generate a message, usually telling you ( by
  1030. re-displaying your input ) the part which FONDIR did not understand.
  1031.  
  1032.  
  1033. ┌───────────────────────────────────────────────────────────────────────┐
  1034. │ ERROR ON INPUT ( LOGICAL ).                                           │
  1035. └───────────────────────────────────────────────────────────────────────┘
  1036.  
  1037. FONDIR does not know what protocol letter you need to use, so it
  1038. allows you to input any character.  FONDIR will ignore otherwise
  1039. valid options which can not be implemented for a particular Comm
  1040. Program.
  1041.  
  1042. For example, you could specify /p:} and FONDIR will merrily put the
  1043. '}' character into your dialing directory's transfer protocol field.
  1044. I don't know that your comm program will do with that.
  1045.  
  1046.  
  1047.  
  1048. ╔═══════════════════════════════════════════════════════════════════════╗
  1049. ║ 7 -- BBS LIST FORMAT SPECIFICATION KEYS                               ║
  1050. ╚═══════════════════════════════════════════════════════════════════════╝
  1051.  
  1052. Most any BBS list can be supported.  What FONDIR is looking for in
  1053. the text list file is a Format Specification which tells FONDIR where
  1054. the information fields are for each entry.
  1055.  
  1056. YOU MUST SUPPLY THE FORMAT SPECIFICATION, if it is not already in the
  1057. BBS List file you are working with.
  1058.  
  1059. The Format Specification works best with columnar ( readable )
  1060. fields, arranged with one list entry per text line.
  1061.  
  1062. As an example, here is the format of a full featured BBS list.  Note
  1063. that the following text lines are longer than 80 characters, so an 80
  1064. column display or printer will not allow you to see it as a single
  1065. line.  But it IS a single line, and you should obtain a text editor
  1066. that supports line lengths greater than 80 characters if you want all
  1067. the information available all the time.
  1068.  
  1069. |n32                              |f4  |i8      |#15          |p4  |c5   |t5   |m8
  1070.  
  1071. MY BBS Henry Clark                OPUS 124/6119 214-881-2627  2U Z 04/21 23:31 PASSWORD
  1072. MY Other BBS Henry Clark          OPUS          214-555-1212  9U Z 04/21 23:42 PASSWORD
  1073. Joe's Board                       TBBS          212-999-9999  AU Z 04/21 23:31 PASSWORD
  1074. Ed's Mobile BBS                   QUIC 124/120  805-555-5555  9H Z                              
  1075.  
  1076. The first line is the Format Specification.  The remaining lines are
  1077. BBS List entries.  Note that each '|' character is placed directly
  1078. above the start of column data in the list entry. Some entries do not
  1079. have all available data, that's ok.  Most Comm Programs do not
  1080. support all the fields.  That's OK too.
  1081.  
  1082. Your BBS list file MUST contain a Format Specification.  This
  1083. includes the file that you will EXPORT to.  A brand new Export file
  1084. will have to contain the one line of Format Specification, as this is
  1085. the only place FONDIR will look for it.
  1086.  
  1087. WARNING :  Inconsistent results occur when the text line length is
  1088. less than the format specification position.  Make sure that empty
  1089. columns of data are SPACE FILLED out to the end of the format
  1090. specification.  FONDIR export does this.
  1091.  
  1092.  
  1093. ┌───────────────────────────────────────────────────────────────────────┐
  1094. │ FORMAT SPECIFICATION CODING                                           │
  1095. └───────────────────────────────────────────────────────────────────────┘
  1096.  
  1097. Each field contains three parts, all of which are required.  They are :
  1098.  
  1099.     Field-separator Code Length
  1100.     (1)             (2)  (3)
  1101.  
  1102. '|' is the default field separator key.  It appears in the same
  1103. column as the applicable list entry data.  Think of it as a marker
  1104. or position indicator.  You can use any character by selecting the
  1105. /c:  option on the FONDIR command line.
  1106.  
  1107. Code is one of the field codes listed below.
  1108.  
  1109. Length number is a decimal value from 2 to 255.
  1110.  
  1111. The field identifier codes are :
  1112.  
  1113.  n - BBS Name, any ascii characters
  1114.  i - ID or Info, additional description of BBS, ascii characters
  1115.  # - Dial Digits, 0-9, -, etc., must begin with a digit 0 through 9
  1116.  p - Protocol Modifier Codes, see protocol codes below.
  1117.  d - Last Call Date, mm/dd/yy
  1118.  t - Last Call Time, hh:mi:ss
  1119.  f - Script File name, typically a logon script
  1120.  g - Log File name or Macro File name
  1121.  w - Password
  1122.  e - Emulation type, such as ANSI or VT100
  1123.  c - Call count, numbers of times connected
  1124.  o - Hours of operation, when the BBS is available
  1125.  h - elapsed hours online
  1126.  m - elapsed minutes online
  1127.  $ - elapsed total hours online
  1128.  r - uploads received count
  1129.  x - downloads transmitted count
  1130.  @ - comm port, first character 0 ( default ), 1 or 2
  1131.  y - city code, useful for network dialing
  1132.  ( - Dialing script or Keyboard file
  1133.  K - mask for /f: option  ( defaults to p field )
  1134.  
  1135. For example,   |n32
  1136.  
  1137.   means the following :
  1138.  
  1139. the | character is positional, it shows where the column containing
  1140. the BBS name is located.  The n character, specifies that this is the
  1141. BBS name.  The 32 is the total length of the BBS name field.
  1142.  
  1143. The |# phone number field is REQUIRED and a valid entry is a line of
  1144. text that has a numeric digit ( 0 through 9 ) in the first character
  1145. of the phone number field.
  1146.  
  1147. The Format Specifiers are based upon the available fields in the comm
  1148. programs that FONDIR supports, except for the |k, which is the filter
  1149. mask field :  see the section on /f: filter option.
  1150.  
  1151.  
  1152. ┌───────────────────────────────────────────────────────────────────────┐
  1153. │ FORMAT SPECIFIER STACKING                                             │
  1154. └───────────────────────────────────────────────────────────────────────┘
  1155.  
  1156. If a column of BBS list data is to be used as more than one field,
  1157. you may 'stack' the specifiers behind a single | character.  For
  1158. example, suppose you want a script file ( |f option ) to be the
  1159. first four characters of the BBS name ( |n option ).  Stack the
  1160. format specifiers like this :
  1161.  
  1162. |n32f4                                 |#15          |p4  |c5   |t5   |m8
  1163.  
  1164. OPUS MY BBS Henry Clark                214-881-2627  2U Z 04/21 23:31 PASSWORD
  1165. OPUS MY Other BBS Henry Clark          214-555-1212  9U Z 04/21 23:42 PASSWORD
  1166. TBBS Joe's Board                       212-999-9999  AU Z 04/21 23:31 PASSWORD
  1167. QUIC Ed's Mobile BBS                   805-555-5555  9H Z
  1168.  
  1169.  
  1170. WARNING : Do not use a width longer than the actual width of the
  1171. column of data.  This is important for both import and export.  A
  1172. larger width specification will result in 'spill' from the next
  1173. column of data into this column, and will cause extra ( usually
  1174. unwanted ) data to be placed in your Comm Program directory file.
  1175.  
  1176.  
  1177. ┌───────────────────────────────────────────────────────────────────────┐
  1178. │ FORMAT FIRST WORD LENGTH                                              │
  1179. └───────────────────────────────────────────────────────────────────────┘
  1180.  
  1181. Some of the Comm Program directory fields specify file names.  These
  1182. include :
  1183.  
  1184.    |f - Script File
  1185.    |g - Log File or Macro File
  1186.    |( - Dialing Script File or Keyboard Map File
  1187.  
  1188. It is not useful to have a file name with a space character it.  For
  1189. example, |f8 on the field "OPUS MY BBS", would normally generate a
  1190. script file named "OPUS MY ", which is not valid file name.
  1191.  
  1192. To avoid these problems, FONDIR automatically translates only the
  1193. first whole word of the BBS list field for the above three format
  1194. keys.  The field length in the format key becomes a maximum length,
  1195. and not a specific length.
  1196.  
  1197. "OPUS MY BBS" using |f8 translates to "OPUS", the first word, and a
  1198. useful script file name.  "PCBOARD Joe's BBS" using |f4 translates to
  1199. "PCBO", since the maximum length is 4.
  1200.  
  1201.  
  1202. ┌───────────────────────────────────────────────────────────────────────┐
  1203. │ FORMAT HEADER SPECIFICATION                                           │
  1204. └───────────────────────────────────────────────────────────────────────┘
  1205.  
  1206.  L - long distance area code
  1207.  
  1208. During processing of the BBS list file, FONDIR will look for the
  1209. |L characters in the first column of each line.  If this is found,
  1210. FONDIR looks further in the line for an Area Code of three digits.
  1211. If the area code is found, FONDIR assumes that this area code applies
  1212. to all subsequent phone number entries until a new |l is found.
  1213.  
  1214. For example :
  1215.  
  1216. |d5   |n20                 |#12          |p2 
  1217.  
  1218. 03/24 MY BBS               214-881-2627  #Z
  1219. 03/24 MY BBS               214-881-2627  #Z
  1220. 03/24 MY BBS               214-881-2627  #Z
  1221.  
  1222. could be listed as :
  1223.  
  1224. |d5   |n20                 |#12      |p2 
  1225.  
  1226. |L Dallas 214
  1227. 03/24 MY BBS               881-2627  #Z
  1228. 03/24 MY BBS               881-2627  #Z
  1229. 03/24 MY BBS               881-2627  #Z
  1230.  
  1231. This encoding format is useful when the BBS list entries are very
  1232. wide.  FONDIR does not support this convention on export to the BBS
  1233. list file.
  1234.  
  1235.  
  1236. ┌───────────────────────────────────────────────────────────────────────┐
  1237. │ COMM PROGRAM FIELD SUPPORT                                            │
  1238. └───────────────────────────────────────────────────────────────────────┘
  1239.  
  1240. The following table shows which format key fields are used by each of
  1241. the supported programs.  You may specify a field in your BBS list,
  1242. that is not supported by your Comm Program.
  1243.  
  1244. Note that the last date |d, and last time |t fields are only modified
  1245. when you use the /k 'keep date' command line parameter.
  1246.  
  1247.                  .-- Name |n
  1248.                  |   .-- Phone |#
  1249.                  |   |   .-- Script |f
  1250.                  |   |   |   .-- Speed |p
  1251.                  |   |   |   |   .-- Parity |p
  1252.                  |   |   |   |   |   .-- Xfer protocol |p
  1253.                  |   |   |   |   |   |   .-- Emulation |e
  1254.                  |   |   |   |   |   |   |   .-- Last Date |d
  1255.                  |   |   |   |   |   |   |   |   .-- Call count |c
  1256.                  |   |   |   |   |   |   |   |   |   .-- Password |w
  1257.                  |   |   |   |   |   |   |   |   |   |
  1258.  
  1259. Boyan 5.0        x   x   x   x   x   x   x   x
  1260. Procomm 2.4.3    x   x   x   x   x
  1261. Procomm + 1.1    x   x   x   x   x   x   x   x   x
  1262. Procomm + 2.0    x   x   x   x   x   x   x   x   x   x
  1263. Qmodem 5.0       x   x   x   x   x   x   x   x   x   x
  1264. Qmodem 4.5       x   x   x   x   x   x       x   x   x
  1265. GT 17.00         x   x   x   x   x   x   x   x   x   x
  1266. Telix 3.15       x   x   x   x   x   x   x   x   x   x
  1267. Pibterm 4.1      x   x   x   x   x   x   x   x
  1268. Telemate 3.01    x   x   x   x   x   x   x   x   x   x
  1269. PC-Talk4 1.39    x   x       x   x
  1270. Rcomm 2.1        x   x       x   x
  1271. K9-Express 8.8   x   x   x   x   x   x       x
  1272. Mirror 3 1.01    x   x   x   x   x       x   x   x
  1273. PCAnywhere 3.11  x   x
  1274. CC Plus 4.01     x   x                               x
  1275. A Dialer 2.0     x   x   x                   x       x
  1276. Commo 5.0        x   x                       x       x
  1277. Unicom 3.0       x   x   x   x   x   x   x       x   x
  1278. Ultiterm 2.0     x   x   x   x   x   x   x   x   x   x
  1279. Pilot 2          x   x   x   x   x
  1280.  
  1281.  
  1282.                  .-- Macro file |g
  1283.                  |   .-- Keyboard file |(
  1284.                  |   |   .-- Comm Port |@
  1285.                  |   |   |   .-- Information |i
  1286.                  |   |   |   |   .-- Last Time |t
  1287.                  |   |   |   |   |   .-- Log File |g
  1288.                  |   |   |   |   |   |   .-- Hours |o
  1289.                  |   |   |   |   |   |   |   .-- Minutes |m
  1290.                  |   |   |   |   |   |   |   |   .-- Elapsed |$
  1291.                  |   |   |   |   |   |   |   |   |   .-- Uploads |r
  1292.                  |   |   |   |   |   |   |   |   |   |
  1293.  
  1294. Boyan 5.0
  1295. Procomm 2.4.3
  1296. Procomm + 1.1
  1297. Procomm + 2.0    x   x   x
  1298. Qmodem 5.0           x   x
  1299. Qmodem 4.5
  1300. GT 17.00             x       x   x       x   x       x
  1301. Telix 3.15
  1302. Pibterm 4.1                      x
  1303. Telemate 3.01            x   x       x
  1304. PC-Talk4 1.39
  1305. Rcomm 2.1
  1306. K9-Express 8.8                   x
  1307. Mirror 3 1.01                x   x           x   x
  1308. PCAnywhere 3.11                      x
  1309. CC Plus 4.01
  1310. A Dialer 2.0
  1311. Commo 5.0        x
  1312. Unicom 3.0
  1313. Ultiterm 2.0
  1314. Pilot 2                  x
  1315.  
  1316.  
  1317.                  .-- Downloads |x
  1318.                  |   .-- City Code |y
  1319.                  |   |
  1320.                  |   |
  1321.      
  1322. Boyan 5.0
  1323. Procomm 2.4.3
  1324. Procomm + 1.1
  1325. Procomm + 2.0
  1326. Qmodem 5.0
  1327. Qmodem 4.5
  1328. GT 17.00         x   x
  1329. Telix 3.15
  1330. Pibterm 4.1
  1331. Telemate 3.01
  1332. PC-Talk4 1.39
  1333. Rcomm 2.1
  1334. K9-Express 8.8
  1335. Mirror 3 1.01
  1336. PCAnywhere 3.11
  1337. CC Plus 4.01
  1338. A Dialer 2.0         x
  1339. Commo 5.0
  1340. Unicom 3.0
  1341. Ultiterm 2.0
  1342. Pilot 2
  1343.  
  1344.  
  1345.  
  1346. ╔═══════════════════════════════════════════════════════════════════════╗
  1347. ║ 8 -- BBS LIST CONTENTS                                                ║
  1348. ╚═══════════════════════════════════════════════════════════════════════╝
  1349.  
  1350. ┌───────────────────────────────────────────────────────────────────────┐
  1351. │ PROTOCOL FIELD FORMAT                                                 │
  1352. └───────────────────────────────────────────────────────────────────────┘
  1353.   
  1354. The protocol field is specially coded, and contains several
  1355. characters of information, including modem speed, parity, file
  1356. transfer protocol and modem type.
  1357.  
  1358. Some examples :
  1359.  
  1360. |p5
  1361. 2 EX
  1362.  
  1363. The above specifies a 2400 bps, Even parity connection using Xmodem
  1364. for a file transfer protocol.
  1365.  
  1366. |p5
  1367. BZ
  1368.  
  1369. The above specifies 38400 bps and Zmodem protocol.
  1370.  
  1371. The protocol modifier codes are described in the following sections.
  1372. Support for protocol modifiers will be based on these lists.
  1373. Trademarks and Copyrights exists for several of the names included below.
  1374.  
  1375.  
  1376. ┌───────────────────────────────────────────────────────────────────────┐
  1377. │ THE BPS MODEM RATE.                                                   │
  1378. └───────────────────────────────────────────────────────────────────────┘
  1379.  
  1380. ! or 3       - 300 bps
  1381. @ or 1       - 1200 bps
  1382. # or 2       - 2400 bps  ( the default )
  1383. 4            - 4800 bps
  1384. ^ or 9       - 9600 bps
  1385. a or A       - 19200 bps
  1386. 8 or b or B  - 38400 bps
  1387. c or C       - 57600 bps
  1388. d or D       - 115200 bps
  1389.  
  1390. ┌───────────────────────────────────────────────────────────────────────┐
  1391. │ MODEM TYPE                                                            │
  1392. └───────────────────────────────────────────────────────────────────────┘
  1393.   
  1394. This field is reserved but presently not used by any Comm Program. 
  1395. I'm trying to avoid the use of these characters in the protocol
  1396. field.
  1397.  
  1398. U  - U.S. Robotics
  1399. H  - Hayes
  1400. F  - Fastcomm
  1401. T  - Trailblazer
  1402. V  - any V.32
  1403.  
  1404. ┌───────────────────────────────────────────────────────────────────────┐
  1405. │ PARITY INDICATOR.                                                     │
  1406. └───────────────────────────────────────────────────────────────────────┘
  1407.   
  1408. e or E - Even parity
  1409.  
  1410. ┌───────────────────────────────────────────────────────────────────────┐
  1411. │ FILE TRANSFER PROTOCOL TYPE.                                          │
  1412. └───────────────────────────────────────────────────────────────────────┘
  1413.   
  1414. The following are only a few of the many available.
  1415.  
  1416. Z - Zmodem
  1417. X - Xmodem
  1418. Y - Ymodem
  1419. K - Kermit
  1420. I - Imodem
  1421. G - Ymodem-G
  1422. T - Telink
  1423. S - SeaLink
  1424. 7 - Modem 7
  1425.  
  1426. ┌───────────────────────────────────────────────────────────────────────┐
  1427. │ TERMINAL EMULATOR MODE CODES                                          │
  1428. └───────────────────────────────────────────────────────────────────────┘
  1429.  
  1430. The following are the supported terminal emulator codes.
  1431.  
  1432. TT   - TTY
  1433. AN   - ANSI
  1434. VT   - VT100
  1435. TV   - Televideo
  1436. HE   - Heath
  1437. AD   - AD
  1438. 31   - Model 31
  1439. 32   - 3270
  1440. WY   - Wyse
  1441.  
  1442.  
  1443. Register if you want custom BBS list translations.
  1444.  
  1445.  
  1446. ┌───────────────────────────────────────────────────────────────────────┐
  1447. │ Examples of BBS Lists                                                 │
  1448. └───────────────────────────────────────────────────────────────────────┘
  1449.  
  1450. A few BBS list Format Specifications are presented for examples. 
  1451. Many of these are longer than 80 characters.
  1452.  
  1453. This first list, HCC.LST, is included with the FONDIR release
  1454. archive.
  1455.  
  1456. Henry's List Format
  1457. |n30                          |#16             |p8      |d8      |f14          |i25
  1458. MY BBS                        214-881-2627     bZ       01/17/92 OPUS          Home of FONDIR
  1459.  
  1460. Darwin National BBS List :
  1461. |#12                                         |f1  |p2     |n20
  1462. 214-881-2627                                 O    bZ      MY BBS
  1463.  
  1464. Fido Nodelist ( use COMCOL /m:15 /c:; to convert to vertical column format ) :
  1465.                |n15                                               |#15             |p1
  1466.                MY BBS                                             214-881-2627     9
  1467.  
  1468. XLATLIST Text Output of Nodelist :
  1469.                 |n20                 |#14                                  |p1
  1470.                 MY BBS               214-881-2627                          9
  1471.  
  1472. Carr/Farmer Dallas/Ft. Worth BBS List :
  1473. |L area code header 214
  1474. |n29f8                        |#8      |P9       |I24                     |d5
  1475. OPUS MY BBS                   881 2627 bZ        Home of FONDIR           01/17
  1476.  
  1477.  
  1478.  
  1479. ╔═══════════════════════════════════════════════════════════════════════╗
  1480. ║ 9 -- PROGRAM SWITCHES AND DEFAULTS                                    ║
  1481. ╚═══════════════════════════════════════════════════════════════════════╝
  1482.  
  1483. The default protocol is 'Z', Zmodem ( thanks Chuck. )
  1484.  
  1485. The default bps rate is 2400 bps (2).
  1486.  
  1487. The default maximum rate is 38400 (b).
  1488.  
  1489. The default I/O port number is 0 ( not COM1, Telemate only ).
  1490.  
  1491. The default Format Specification Field Separator key character is
  1492. '|'.
  1493.  
  1494. The default last date called is blank ( today's date, Qmodem only ).
  1495.  
  1496. The maximum line length of a BBS text file is 255 characters.
  1497.  
  1498.  
  1499. ┌───────────────────────────────────────────────────────────────────────┐
  1500. │ Comm Program Type Codes                                               │
  1501. └───────────────────────────────────────────────────────────────────────┘
  1502.   
  1503. Here are the valid program type codes used in the /o:   parameter.
  1504.  
  1505. 'B'     Boyan 5.0
  1506. 'P'     Procomm 2.4.3
  1507. '+'     Procomm Plus 1.1
  1508. '2'     Procomm Plus 2.0
  1509. 'Q'     Qmodem 5.0
  1510. '4'     Qmodem 4.5
  1511. 'G'     GT-Powercomm 17.00
  1512. 'T'     Telix 3.15
  1513. 'I'     Pibterm 4.1
  1514. 'M'     Telemate 3.01
  1515. 'C'     PC-Talk4 1.39
  1516. 'R'     Rcomm 2.1
  1517. 'K'     K9 Express 8.8
  1518. 'O'     Mirror 3 1.01
  1519. 'A'     PC Anywhere 3.11
  1520. 'Y'     Carbon Copy Plus 4.01
  1521. 'D'     A Dialer 2.0
  1522. 'F'     Commo 5.0
  1523. 'U'     Unicom 3.0
  1524. 'L'     Ultiterm 2.0
  1525. 'E'     Pilot 2.0
  1526.  
  1527. Upper or lower case letters are acceptable.  As you can see, I'm
  1528. running out of matching letters <grin>.
  1529.  
  1530. If you don't use something, you will see an error message.  The Comm
  1531. Program type field is REQUIRED.  You can use an upper or lower case
  1532. letter to specify your Comm Program.
  1533.  
  1534.  
  1535.  
  1536. ┌───────────────────────────────────────────────────────────────────────┐
  1537. │ Speed Code Parameters                                                 │
  1538. └───────────────────────────────────────────────────────────────────────┘
  1539.  
  1540. The valid speed codes for use with the /m: and /b: parameters are :
  1541.  
  1542. 3       - 300 bps
  1543. 1       - 1200 bps
  1544. 2       - 2400 bps  ( the default )
  1545. 4       - 4800 bps
  1546. 9       - 9600 bps
  1547. A       - 19200 bps
  1548. B       - 38400 bps
  1549. C       - 57600 bps
  1550. D       - 115200 bps  ( not fully supported )
  1551.  
  1552. Upper and lower case letters are acceptable.
  1553.  
  1554.  
  1555. ┌───────────────────────────────────────────────────────────────────────┐
  1556. │ Warnings and Other Notes                                              │
  1557. └───────────────────────────────────────────────────────────────────────┘
  1558.  
  1559. GT 17.00 modifies the phone directory header record after every
  1560. use of the program. FONDIR sets the phone directory header to the same
  1561. values generated by use of the GT_UTIL program when upgrading from
  1562. version 16.
  1563.  
  1564.  
  1565.  
  1566.  
  1567. ╔═══════════════════════════════════════════════════════════════════════╗
  1568. ║ 10 -- SHAREWARE REGISTRATION                                          ║
  1569. ╚═══════════════════════════════════════════════════════════════════════╝
  1570.  
  1571. Print out this following page. Write a check. Address an envelope.
  1572. Mail it.  You will feel really good when that new program or version
  1573. of your favorite is released, and FONDIR is right there, ready to
  1574. support your upgrade.
  1575.  
  1576.  
  1577.  
  1578.  
  1579. ╔═══════════════════════════════════════════════════════════════════════╗
  1580. ║                                                                       ║
  1581. ║ FONDIR Phone List Translator Utility Registration Form and            ║
  1582. ║ Payment Invoice #921001 for Version 5.9                               ║
  1583. ║                                                                       ║
  1584. ║ License for use is granted under the terms of the FONDIR              ║
  1585. ║ License Agreement.                                                    ║
  1586. ║                                                                       ║
  1587. ║                                                                       ║
  1588. ║ Name    ───────────────────────────────────────                       ║
  1589. ║                                                                       ║
  1590. ║ Address ───────────────────────────────────────                       ║
  1591. ║                                                                       ║
  1592. ║         ───────────────────────────────────────                       ║
  1593. ║                                                                       ║
  1594. ║         ───────────────────────────────────────                       ║
  1595. ║                                                                       ║
  1596. ║ Phone   ───────────────────────────────────────                       ║
  1597. ║                                                                       ║
  1598. ║                                                                       ║
  1599. ║ Version ────────────────  Date Received ────────────────              ║
  1600. ║                                                                       ║
  1601. ║                                                                       ║
  1602. ║ Check one :                                                           ║
  1603. ║                                                                       ║
  1604. ║ (  )  Enclosed is U.S. ──────────── Dollars for ─────────── copies    ║
  1605. ║                                                                       ║
  1606. ║       at U.S. 20 Dollars each.                                        ║
  1607. ║                                                                       ║
  1608. ║                                                                       ║
  1609. ║ (  )  Enclosed is U.S. ──────────── Dollars for ─────────── copies    ║
  1610. ║                                                                       ║
  1611. ║       of customized versions at U.S. 40 Dollars each.                 ║
  1612. ║                                                                       ║
  1613. ║                                                                       ║
  1614. ║       Enter customization parameters : ────────────────────────────── ║
  1615. ║                                                                       ║
  1616. ║       ─────────────────────────────────────────────────────────────── ║
  1617. ║                                                                       ║
  1618. ║       ─────────────────────────────────────────────────────────────── ║
  1619. ║                                                                       ║
  1620. ║ (  )  Enclosed is U.S.  200        Dollars for  10 or more users      ║
  1621. ║                                                                       ║
  1622. ║       on a site license ( make your own copies, documents ).          ║
  1623. ║                                                                       ║
  1624. ║ Send this form with check or money order,                             ║
  1625. ║ payable to Hershel Enterprises, Inc. to :                             ║
  1626. ║                                                                       ║
  1627. ║   Software Mechanics, FONDIR                                          ║
  1628. ║   P.O. Box 832052                                                     ║
  1629. ║   Richardson, TX 75083-2052                                           ║
  1630. ║   U.S.A.                                                              ║
  1631. ║                                                                       ║
  1632. ╚═══════════════════════════════════════════════════════════════════════╝
  1633.  
  1634.  
  1635.  
  1636. ╔═══════════════════════════════════════════════════════════════════════╗
  1637. ║ 11 -- LICENSE AGREEMENT                                               ║
  1638. ╚═══════════════════════════════════════════════════════════════════════╝
  1639.  
  1640. The SOFTWARE is FONDIR, the Phone Directory Translate Utility,
  1641. Copyright (C) 1988-1991 Henry C. Clark, Hershel Enterprises, Inc. and
  1642. FONMAN, the Phone Dear Interactive Interface.
  1643.  
  1644.   By using or distributing, or allowing to be distributed, this
  1645. SOFTWARE, you are agreeing to be bound by the terms of this
  1646. agreement.
  1647.  
  1648.   If you do NOT agree to the terms of this agreement, promptly
  1649. destroy any and all copies of the SOFTWARE that you may have.
  1650.  
  1651. ┌───────────────────────────────────────────────────────────────────────┐
  1652. │ The Terms of this Agreement :                                         │
  1653. └───────────────────────────────────────────────────────────────────────┘
  1654.  
  1655. 1
  1656.    You may NOT accept money, or otherwise charge a fee for the
  1657. SOFTWARE because you transfer a copy of the SOFTWARE to another party. 
  1658. You may NOT alter the SOFTWARE files, nor distribute the files using
  1659. a file name other than that name which you received, except for the
  1660. extension as relates to compression techniques.  The SOFTWARE
  1661. may be compressed using different techniques, only if all the
  1662. component files of the original package are included.  You may NOT
  1663. decompile or reverse engineer the SOFTWARE.
  1664.  
  1665.    You may NOT include the SOFTWARE in another work, without written
  1666. permission from Hershel Enterprises, Inc. dba Software Mechanics.
  1667.  
  1668. 2
  1669.    You may NOT accept money, or otherwise charge a fee for ANY usage
  1670. or operation of the SOFTWARE,  without written permission from
  1671. Hershel Enterprises, Inc. dba Software Mechanics.
  1672.  
  1673. 3
  1674.    You may NOT accept money, or otherwise charge a fee for ANY medium
  1675. upon which the SOFTWARE is transferred, including but not limited to
  1676. modem carrier, diskettes, CD-ROM, magnetic tape, etc. without written
  1677. permission from Hershel Enterprises, Inc. dba Software Mechanics.
  1678.  
  1679.    We invite your requests to include our SOFTWARE in your
  1680. compilations.
  1681.  
  1682. 4
  1683.    You may NOT use or distribute the Software in ANY manner for or by
  1684. commercial or governmental entities without first correctly filling
  1685. out and sending the registration agreement and payment.
  1686.  
  1687.    US Government restricted rights are set forth in subparagraph
  1688. (c)(1)(ii) of the Rights in Technical Data and Computer Software
  1689. clause at DFARS 252.227-7013(Oct. 1988) and FAR 52.227-19(June 1987). 
  1690. Contractor is Hershel Enterprises, Inc.
  1691.  
  1692. 5
  1693.    You accept and understand that NO warranty is expressed or implied.
  1694. The person using the SOFTWARE bears all risk as to the quality and
  1695. performance of the SOFTWARE.   In no event shall Hershel Enterprises'
  1696. liability for any damages ever exceed the price paid to Hershel for
  1697. the license to use the SOFTWARE, regardless of the form of the claim,
  1698. even if Hershel Enterprises has been notified of such a possibility.
  1699.  
  1700. 6
  1701.    You MAY freely distribute the Software within the above license
  1702. restrictions.  You may use the Software on a trial basis, and you are
  1703. required to pay for the Software if you use it on a regular basis.
  1704.  
  1705.  
  1706. ┌───────────────────────────────────────────────────────────────────────┐
  1707. │ Note from the Author :                                                │
  1708. └───────────────────────────────────────────────────────────────────────┘
  1709.   
  1710. As the task of keeping up with the latest Comm Programs increases,
  1711. take time to reflect on the effort expended to produce this program.
  1712.  
  1713. When you run this program, watch how fast it finishes.  This program
  1714. is not the type you run everyday, but it will save you countless
  1715. hours of manual data entry, and open up the door to the modem world
  1716. for you.
  1717.  
  1718. When you fill out the registration slip, write a check and use an
  1719. envelope, you ensure that improvements are made before you need
  1720. them.  My compilers, software tools, PCs, modems and especially
  1721. my time, are not free.
  1722.  
  1723. Shareware is not a type of software, it is a form of distribution.
  1724. You get to make sure this program works for you before you pay for
  1725. you license to use it.
  1726.  
  1727.