home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / printer / dotab10.arc / DOTAB.DOC < prev    next >
Text File  |  1987-03-03  |  5KB  |  109 lines
  1.      DOTAB (do tabs)
  2.      Version 1.00
  3.      Ron Gazaway
  4.      
  5.      Purpose
  6.      ------- 
  7.      
  8.      This utility will insert a user selectable number of spaces at the
  9.      beginning of every line in a document.  This function will be usefull
  10.      to those using printers which do not support a "Set Left Margin"
  11.      escape sequence.The IBM ProPrinter for example.  Without setting the
  12.      left margin in some way, many of the documentation files which are
  13.      provided with Shareware packages will print against the left edge of
  14.      the page.  This leaves no room for punching three ring binder holes. 
  15.      
  16.      Usage
  17.      ----- 
  18.      
  19.      DOTAB  source_file nspaces destination_file
  20.      
  21.      Where: source_file is the name of the text file you need shifted
  22.                     right. Full path names are supported. Wildcard
  23.                     characters are not. 
  24.      
  25.             nspaces is the number of spaces to be inserted at the begining 
  26.                     of each line.  Valid range is 1 to 99  inclusive.
  27.                     DEFAULT = 5.
  28.      
  29.             destination_file is the file which will be used to write the
  30.                     expanded text file.  DEFAULT = source_file (without
  31.                     extension) + .TAB.   IF A FILE WITH THE
  32.                     destination_file NAME EXISTS, IT WILL BE DESTROYED.
  33.      
  34.      Note: Spaces must be used as the parameter delimeters.
  35.      
  36.      Examples
  37.      --------
  38.      
  39.      DOTAB  dotab.doc
  40.           The file dotab.doc will be written to the file dotab.tab with
  41.           five (5) spaces added to the start of each line.
  42.           
  43.      DOTAB  dotab.doc 10
  44.           The file dotab.doc will be written to the file dotab.tab with ten
  45.           (10) spaces added to the start of each line.
  46.           
  47.      DOTAB  dotab.doc 10 junk.txt
  48.           The file dotab.doc will be written to the file junk.txt with ten
  49.           (10) spaces added to the start of each line.
  50.           
  51.      DOTAB  c:\docs\dotab.doc 10 c:\temp\junk.txt
  52.           The file dotab.doc on subdirectory \docs of disk C: will be
  53.           written to the file junk.txt on subdirectory \temp of disk C:
  54.           with ten (10) spaces added to the start of each line.
  55.           
  56.      error codes
  57.      -----------
  58.      
  59.      couldn't open input file "source_file"
  60.      
  61.           There is some problem with opening the specified input file.
  62.      
  63.      couldn't open output file "destination_file"
  64.  
  65.           There is some problem with opening the specified output file.
  66.      
  67.      
  68.      Revision history
  69.      ----------------
  70.      Version 1.00 - 3/3/87 
  71.      Original version  (written using Microsoft C 4.0)
  72.      
  73.      Copyright/License/Warranty
  74.      --------------------------
  75.       
  76.      This document and the program file DOTAB.EXE ("the software") are
  77.      copyrighted by the author.  The copyright owner hereby licenses you
  78.      to: use the software; make as many copies of the program and
  79.      documentation as you wish; give such copies to any one; and distribute
  80.      the software and documentation via electronic means.  There is no
  81.      charge for any of the above. However, you are specifically prohibited
  82.      from charging, or requesting donations, for any such copies, however
  83.      made; and from distributing the software and/or documentation with
  84.      commercial products without prior permission.  An exception is granted
  85.      to not-for-profit user's groups, which are authorized to charge a
  86.      small fee (not to exceed $7) for materials, handling, postage, and
  87.      general overhead.  NO FOR-PROFIT ORGANIZATION IS AUTHORIZED TO CHARGE
  88.      ANY AMOUNT FOR DISTRIBUTION OF COPIES OF THE SOFTWARE OR
  89.      DOCUMENTATION, OR TO INCLUDE COPIES OF THE SOFTWARE OR DOCUMENTATION
  90.      WITH SALES OF THEIR OWN PRODUCTS.  THIS INCLUDES A SPECIFIC
  91.      PROHIBITION AGAINST FOR-PROFIT ORGANIZATIONS DISTRIBUTING THE
  92.      SOFTWARE, EITHER ALONE OR WITH OTHER SOFTWARE, AND CHARGING A
  93.      "HANDLING" OR "MATERIALS" FEE OR ANY OTHER SUCH FEE FOR THE
  94.      DISTRIBUTION.  NO FOR-PROFIT ORGANIZATION IS AUTHORIZED TO INCLUDE THE
  95.      SOFTWARE ON ANY MEDIA FOR WHICH MONEY IS CHARGED.  PERIOD.  There is
  96.      no restriction on the use of this software in commercial or
  97.      institutional environments.  No copy of the software may be
  98.      distributed or given away with out this document; and this notice must
  99.      not be removed.  There is no warranty of any kind, and the copyright
  100.      owner is not liable for damages of any kind.  By using this software,
  101.      you agree to this.
  102.      
  103.      The software and documentation are:
  104.      
  105.      Copyright (c) 1987 by
  106.      Ronald O. Gazaway 
  107.      6-2 King Arthur's Way 
  108.      Newington CT  06111
  109.