home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / FONDIR57.ZIP / COMCOL.DOC next >
Text File  |  1990-05-30  |  9KB  |  292 lines
  1.  
  2.  
  3.  COMCOL - Text File Conversion Utility, Comma Separated to Columns
  4.  Copyright (C) 1988, Henry C. Clark, All rights reserved.
  5.  
  6.    Hershel Enterprises, Inc.
  7.    Software Mechanics, FONDIR
  8.    P.O. Box 832052
  9.    Richardson, TX 75083
  10.  
  11.    214-881-2627  14400/9600/2400/1200/300 bps  24hr  124/6119
  12.  
  13.   NO WARRANTY : It works on my Compaq 386-20, with my 10 megabyte ram
  14.                 disk and Compaq 16 bit VGA adapter.  You should get
  15.                 100% compatible with this.
  16.  
  17.  
  18.  
  19. 1 -- FONDIR ARCHIVE.
  20.  
  21. COMCOL is shipped in an archive file, FONDIRxx.ZIP.  The 'xx' is the
  22. version number.  The archive should contain the following files :
  23.  
  24.    COMCOL.EXE          - program to convert comma separated files to
  25.                          the columnar format used by FONDIR,
  26.    COMCOL.DOC          - document file you're reading now.
  27.  
  28.  
  29. COMCOL stands for Comma to Colmun. Un-zip the FONDIRxx.ZIP file and
  30. either :
  31.  
  32.   a.) keep the .exe program with your bbs list files, or
  33.   b.) keep the .exe program with your comm program files.
  34.  
  35. COMCOL will convert a text file with comma separated fields to a
  36. vertical column field text file.
  37.  
  38.  
  39.  
  40. 2 -- ONLINE HELP.
  41.  
  42. You can get the following help information by entering the COMCOL
  43. command with NO parameters, with the /h parameter, or with the /?
  44. parameter.
  45.  
  46.  format : COMCOL comma-filename [/m:15 /s:1]
  47.  
  48.  Converts a comma separated file to a columnar text.
  49.  
  50.   /m:nn option for maximum column width. /s:n  for column divider spaces.
  51.   /c:c  comment character to ignore when first.
  52.  
  53.  Output is to STDOUT, which may be redirected.
  54.  
  55.  Example :   comcol list.txt > newlist.txt
  56.  
  57.  24hr. Help/Register at 124/6119 MY BBS 1-214-881-2627
  58.  
  59.  
  60.  
  61.  
  62. 3 -- THE OPTIONS.
  63.  
  64. MAXIMUM COLUMN WIDTH ( /m  option )
  65.  
  66. Normally COMCOL will set column widths according to the longest data
  67. length contained in each field in every record.  You can set a maximum
  68. column width with the /m:  option.  Specify a decimal number of
  69. characters that no column width shall exceed.
  70.  
  71. For example,  I only want the first 15 characters of each field.  I
  72. would use :
  73.  
  74.   comcol list.txt /m:15 > list.lst
  75.  
  76. Fields which do not contain the /m number of characters are padded
  77. out to /m width, as per normal operation.
  78.  
  79.  
  80. COLUMN DIVIDER SPACES ( /s  option )
  81.  
  82. If you want columns separated by more than 1 space character, use the
  83. /s  option.  Specify a decimal number of character spaces between
  84. each column of data.  The default is one.
  85.  
  86. For example, I want 3 spaces between each column;  I use :
  87.  
  88.   comcol list.txt /m:15 /s:3 > list.lst
  89.  
  90.  
  91. COMMENT CHARACTER ( /c  option )
  92.  
  93. If you want to ignore text records in the input file, each record
  94. line must have a comment character as the first character of the text
  95. line.  You can specify the comment character with the /c  option.
  96. Specify a single character as the comment character.
  97.  
  98. For example,  I have a comma separated file with comment lines ( not
  99. comma separated ) in it.  The comment line begin with the semi-colon
  100. character, ';'.  I want COMCOL to ignore these lines because they
  101. would mess up the column width calculations.  I use :
  102.  
  103.   comcol list.txt /m:15 /c:; > list.lst
  104.  
  105.  
  106.  
  107.  
  108. 4 -- COMCOL CALL SYNTAX.
  109.  
  110. EXAMPLES.
  111.  
  112. COMCOL list.txt
  113. COMCOL list.txt > list.lst
  114. COMCOL list.txt /m:15
  115. COMCOL list.txt /m:50 > list.lst
  116. COMCOL list.txt /s:5
  117. COMCOL list.txt /m:10 /s:2 /c:;
  118. COMCOL list.txt /m:15 /s:4 /c:* >> list.lst
  119. COMCOL list.txt /m:15 /c:; >> biglist.lst
  120.  
  121. Yes, you can use this command :
  122.  
  123. COMCOL list.txt /m:12 /s:2 /c:; >> biglist.txt
  124.  
  125.  
  126. ERROR CHECKING OF INPUT ( SEMANTIC ).
  127.  
  128. COMCOL usually validates everything you enter, and it usually HAS to be
  129. valid or COMCOL will generate a message, usually telling you ( by
  130. re-displaying your input ) the part which COMCOL did not understand.
  131.  
  132.  
  133.  
  134. WHAT TO EXPECT
  135.  
  136. Suppose you have a file containing the following three text lines :
  137.  
  138. MY BBS,214-881-2627,24 hr.
  139. Joe's Health Food,555-1212,8-5 M-F
  140. Download City,817-555-1234,$12.50/hour
  141.  
  142. and you run COMCOL without parms, then your output will look like :
  143.  
  144. MY BBS            214-881-2627 24 hr.
  145. Joe's Health Food 555-1212     8-5 M-F
  146. Download City     817-555-1234 $12.50/hour
  147.  
  148. and if you ran COMCOL /m:13, then :
  149.  
  150. MY BBS        214-881-2627 24 hr.
  151. Joe's Health  555-1212     8-5 M-F
  152. Download City 817-555-1234 $12.50/hour
  153.  
  154. and if you ran COMCOL /m:13 /s:3, then :
  155.  
  156. MY BBS          214-881-2627   24 hr.
  157. Joe's Health    555-1212       8-5 M-F
  158. Download City   817-555-1234   $12.50/hour
  159.  
  160.  
  161.  
  162. 5 -- PROGRAM SWITCHES, MAGIC VARIABLES, AND DEFAULTS.
  163.  
  164. The default column divider space count is 1.
  165.  
  166. The default comment character is '²'.  This character is the
  167. 'squared' symbol, and is used to avoid problems when the user does
  168. not want any comment line handling.
  169.  
  170.  
  171.  
  172. 6 -- REGISTER TO GET UPDATES.
  173.  
  174. Print out this following page. Write a check. Address an envelope.
  175. Mail it.  You will feel really good about yourself.
  176.  
  177. COMCOL is free if you have registered FONDIR.
  178.  
  179. ....... that character is a printer top of form command.
  180. v
  181.  
  182.  
  183.  
  184. COMCOL Phone List Translator Utility Registration Form and
  185. Payment Invoice #900701
  186.  
  187. Name    _______________________________________
  188.  
  189. Address _______________________________________
  190.  
  191.         _______________________________________
  192.  
  193.         _______________________________________
  194.  
  195. Phone   _______________________________________
  196.  
  197.  
  198. Version ________________  Date Received ________________
  199.  
  200.  
  201. Check one :
  202.  
  203. (  )  Enclosed is U.S. ____________ Dollars for ___________ copies
  204.  
  205.       at U.S. 20 Dollars each.
  206.  
  207. (  )  Enclosed is U.S. ____________ Dollars for ___________ copies
  208.  
  209.       of customized versions at U.S. 50 Dollars each.
  210.  
  211.       Enter customization parameters : _______________________________
  212.  
  213.       ________________________________________________________________
  214.  
  215.       ________________________________________________________________
  216.  
  217. (  )  Enclosed is U.S.  400        Dollars for  10 or more  copies
  218.  
  219.       on a site license ( make your own copies, documents ).
  220.  
  221. Send this form with check or money order to :
  222.  
  223.   Hershel Enterprises, Inc.
  224.   Software Mechanics, FONDIR
  225.   P.O. Box 832052
  226.   Richardson, TX 75083
  227.   U.S.A.
  228.  
  229.  
  230.  
  231. 7 -- LICENSE AGREEMENT.
  232.  
  233. The SOFTWARE is COMCOL, Text File Conversion Utility, Comma Separated
  234. to Columns, Copyright (C) 1988 Henry C. Clark, Hershel Enterprises, Inc.
  235.  
  236.   BY USING OR DISTRIBUTING, OR ALLOWING TO BE DISTRIBUTED THE
  237. SOFTWARE, YOU ARE AGREEING TO BE BOUND BY THE TERMS OF THIS
  238. AGREEMENT.
  239.  
  240.   IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, PROMPTLY
  241. DESTROY ANY AND ALL COPIES OF THIS SOFTWARE.
  242.  
  243. The Terms of this Agreement :
  244.  
  245. 1
  246.    You may NOT accept money, or otherwise charge a fee for the
  247. SOFTWARE because you transfer a copy of the SOFTWARE to another party. 
  248. You may NOT alter the SOFTWARE files, nor distribute the files using
  249. a file name other than that name which you received.  The SOFTWARE
  250. may be compressed using different techniques, only if all the
  251. component files of the original package are included.  You may NOT
  252. decompile, reverse engineer or include the SOFTWARE in another work.
  253.  
  254. 2
  255.    You may NOT accept money, or otherwise charge a fee for ANY medium
  256. upon which the SOFTWARE is transferred, including but not limited to
  257. modem carrier, diskettes, CD-ROM, magnetic tape, etc. without written
  258. permission from Hershel Enterprises, Inc.
  259.  
  260. 3
  261.    You may NOT use or distribute the Software in ANY manner for or by
  262. commercial or governmental entities without first correctly filling
  263. out and sending the registration agreement and payment.
  264.  
  265. 4
  266.    You accept and understand that NO warranty is expressed or implied.
  267. The person using the SOFTWARE bears all risk as to the quality and
  268. performance of the SOFTWARE.   In no event shall Hershel Enterprises'
  269. liability for any damages ever exceed the price paid for the license
  270. to use the SOFTWARE, regardless of the form of the claim, even if
  271. Hershel Enterprises has been notified of such a possibility.
  272.  
  273. 5
  274.    You MAY distribute freely the Software within the above
  275. restrictions.  You may use the Software on a trial basis, and you are
  276. required to pay for the Software if you use it on a regular basis.
  277.  
  278.  
  279.  
  280. Note from the Author :
  281.  
  282. When you run this program, watch how fast it finishes.  This program
  283. is not the type you run everyday, but it will save you countless
  284. hours of manual data entry, and open up the door to the BBS world
  285. for you.
  286.  
  287. When you fill out the registration slip, write a check and use an
  288. envelope, you ensure that improvements are made before you need
  289. them.
  290.  
  291.  
  292.