home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / TURBOPAS / FILEUT20.ZIP / FILEUTIL.DOC next >
Encoding:
Text File  |  1985-06-03  |  8.1 KB  |  199 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                               Introducing FILEUTIL 2.0
  10.                               Introducing FILEUTIL 2.0
  11.  
  12.                Looking at   my  QMODEM   directory, I   see  all  sorts  of
  13.           QMODEM utilities.     LU, SQ,  NUSQ and  others.  Some are pretty
  14.           small like  UNWS  and ADDLF.  Well, I thought it would be nice if
  15.           I could  throw   together the   latter two,  add case conversion,
  16.           have full   support  for sub-directories,  allow  back-ups,  etc.
  17.           That product's documentation you are reading right now.  FILEUTIL
  18.           is a  fairly straightforward program.  It's not too big,  easy to
  19.           use, and  pretty much  in the  same format  as the  first   three
  20.           utilities  I mentioned.   Hope you can find some use for it.
  21.  
  22.           Executing FILEUTIL
  23.           Executing FILEUTIL
  24.  
  25.                FILEUTIL be   executed  from   any DOS   prompt  as  long as
  26.           FILEUTIL.COM is   in  the   current sub-directory  on in  the DOS
  27.           path (see  DOS manual  for a  lousy but  accurate description  of
  28.           PATHs).  The format is:
  29.                     
  30.                FILEUTIL param [param..] [dr:][\path\]filename
  31.                     [[dr:][\path\]outfile]
  32.                
  33.                param is one of the following:
  34.                     A  Add linefeeds to the file;
  35.                     W   Convert the   file  from WordStar's  8bit
  36.                          format  to the standard 7 bit ASCII for-
  37.                          mat;
  38.                     U  Convert all  lowercase  letters  to upper-
  39.                          case;
  40.                     L   Convert alluppercase   letters  to lower-
  41.                          case;
  42.                     R  Remove extraneous carriage returns;
  43.                     Q   Do   not    alter   the     case   within
  44.                          quotes.
  45.                [param] is   one of  the  above  parameters.  Any number  of
  46.                     parameters   is allowed,  except that   both  A   and W
  47.                     cannot   be specified  at the  same time,  as  well  as
  48.                     U an L can't.
  49.                [dr:] is  an optional  drive where the fileis to be found.
  50.                [\path\] is   an  optional  path to follow to find the file-
  51.                     name.
  52.                filename is  the name  of the  file to make the changes to.
  53.                [outfile] is  an optional  output file  or device.   If  not
  54.                     specified, output  will go to the original filename and
  55.                     a file  called filename.BAK  will contain  the old ver-
  56.                     sion.  To output to the printer, user outfile PRN:, and
  57.                     CON: to direct to the console, etc.
  58.                
  59.                 Typing illegal  parameters or  FILEUTIL ? will list out the
  60.           options to the screen. An example.   Say  you've just  downloaded
  61.           this   great TURBO  Pascal  library from  a local RCP/M board and
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.           FILEUTIL                                                        2
  73.           FILEUTIL                                                         
  74.  
  75.  
  76.  
  77.           the putz decided to  format his documentation with WordStar.  Say
  78.           the name  of  the doc  file is  TBBS.DOC, to  convert it to ASCII
  79.           type:
  80.                
  81.                     FILEUTIL w tbbs.doc
  82.                
  83.                It will   then rename  tbbs.doc to  tbbs.bak and convert the
  84.           file.    This   way,  if  you didn't  want to do the change after
  85.           all   you still   have  the   original.  FILEUTIL will NOT make a
  86.           backup of a backup!
  87.                
  88.  
  89.           The options
  90.           The options
  91.  
  92.  
  93.           A (add linefeeds)
  94.           A (add linefeeds)
  95.  
  96.                Sometimes you  get a file from a bulletin board or off some-
  97.           one   else's disk   that, when  you TYPE  it,  it seems to  print
  98.           all   the lines   on  top  of one-another.  This is because there
  99.           are no  linefeeds (ASCII  character 10)  to  go  along  with  the
  100.           carriage   returns   (ASCII character 13).  An example of this is
  101.           say you  call some  board and  download a  BASIC program.   A lot
  102.           of BASICs decide, for  some stupid  reason, not to add linefeeds.
  103.           This will help you out cleanly and quickly.
  104.  
  105.           W (convert WordStar to ASCII)
  106.           W (convert WordStar to ASCII)
  107.  
  108.                Despite WordStar   being  a   has-been program on the IBM PC
  109.           (you still   use  it,   huh?   Well, I suggest you take a  lok at
  110.           Microsoft WORD) but still lingers a lot through CP/M.   A  lot of
  111.           these guys  think everyone  in the world  uses and  has WordStar,
  112.           so they   make  their documentation  files   in WordStar's  weird
  113.           format.   This option  will   strip the   strange characters  and
  114.           make it standard ASCII.
  115.  
  116.           R (remove extraneous carriage returns)
  117.           R (remove extraneous carriage returns)
  118.  
  119.                Sometimes you  may output  a file  or a  screen or something
  120.           that you  want to  edit in  your wordprocessor  and format,  etc.
  121.           Well, more  often than not, the tranfer file has carriage returns
  122.           after each  line instead  of after  each paragraph.  The R option
  123.           strips all  carriage returns  and adds a space except if the next
  124.           character is a carriage return or a tab.
  125.  
  126.           L (convert to lower case)
  127.           L (convert to lower case)
  128.  
  129.                Sometimes you  may actually call an Apple Bulletin Board, or
  130.           maybe have  a C  program or  two that  look nicer   in lowercase.
  131.           This  utility will  change the case for you.
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.           FILEUTIL                                                        3
  145.           FILEUTIL                                                         
  146.  
  147.  
  148.  
  149.           U (convert to upper case)
  150.           U (convert to upper case)
  151.  
  152.                Can't really   describe  the usefulness  of this,  but  with
  153.           lower case conversion, thought it best to throw it in.
  154.  
  155.           Q (don't change string within quotes)
  156.           Q (don't change string within quotes)
  157.  
  158.                If you're   using  FILEUTIL on program file you will usually
  159.           not   want to  switch characters inside quotes as they are either
  160.           strings or  comments.   If turned  on that text will  not be  al-
  161.           tered.   The program  considers an end-of-line the  same as  ter-
  162.           mination of  a quote (since in assembler you use the ' to start a
  163.           comment but don't  put a terminator.  EOLN is the terminator).
  164.                
  165.  
  166.           The FILEUTIL package
  167.           The FILEUTIL package
  168.  
  169.                The following  programs should  have  been  in  FILEUTIL.LBR
  170.           (the distribution package):
  171.                
  172.                     FILEUTIL.COM The program
  173.                     FILEUTIL.PAS The Turbo Pascal source
  174.                     FILEUTIL.DOC What you're reading
  175.                     
  176.                FILEUTIL is  placed in  the Public Domain for all you people
  177.           to play  around with  and hopefully get some use out of.  This is
  178.           vital since  there are  so many  bogus programs out there that do
  179.           the same as FILEUTIL or less but cost $30 to $50.  That is stupid
  180.           for such an easy program as this.
  181.                That's about   all  that   I can   think  of.   This  is the
  182.           third product  out of  Sarcastic Software  (the others  were Sar-
  183.           castic Software
  184.                LISTER.LBR  which   would   format   BASIC   listings,   and
  185.           HELPFAST.LBR which added some freindly features to PC-TALK).
  186.                If you have any comments, suggestions or bugs, contact:
  187.                
  188.           Chris Rowley
  189.           11808 Canfield Rd.
  190.           Potomac, MD  20854
  191.           (301) 762-8486 (voice)
  192.           (301) 340-0246 (data)
  193.           (301) 340-8484 (work)
  194.           (301) 340-1376 (work data)
  195.           
  196.           (c)1985 Sarcastic Software by Chris Rowley
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.