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