home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / textutil / tabs / !Tabs / !Help < prev    next >
Encoding:
Text File  |  1992-12-21  |  4.1 KB  |  113 lines
  1.  
  2.  Tabs utility
  3.  ------------
  4.  
  5.  This utility generates an output file from an input
  6.  file by either inserting tab characters into the file
  7.  or removing them.
  8.  
  9.  It has two basic modes of operation "standard mode" and
  10.  "import mode".
  11.  
  12.  Standard mode follows the normal conventions used for
  13.  tabs. That is TAB characters are used to replace one or
  14.  more blanks in the text and to align the text on
  15.  specific columns. If a blank does not occur in the
  16.  right place, the corresponding tab setting is just
  17.  ignored and no TAB character inserted.
  18.  
  19.  Import mode is intended for generating files to be
  20.  imported into packages such as PipeDream where the text
  21.  has to be split up into columns, or for processing
  22.  files exported from such packages where columns are
  23.  separated by TAB characters. In this mode, tab settings
  24.  cannot simply be bypassed. If text overflows a column
  25.  boundary, then an extra tab character is inserted at
  26.  the next column boundary as an attempt at maintaining
  27.  the correct column alignment.
  28.  
  29.  How to use Tabs
  30.  ---------------
  31.  Install the Tabs icon on the icon bar in the usual way.
  32.  Click select once on the icon to open the setup dialog
  33.  box. Drag the input file to the box labelled 'Input
  34.  file', select required options, chose the tab settings
  35.  and click on 'Run'.
  36.  
  37.  When Tabs has finished, a save box will be displayed
  38.  allowing you to drag the output file to your
  39.  destination of choice. By default, the output file
  40.  name will be formed by prefixing the input file name
  41.  with '_'.
  42.  
  43.  Processing options
  44.  ------------------
  45.  The setup dialog box contains six option buttons which
  46.  are divided into three pairs:
  47.  
  48.  - 'Blanks to tabs' and 'Tabs to blanks':  use these to
  49.    to select whether tabs are to be inserted or removed
  50.  
  51.  - 'Standard mode' and 'Import mode':  use these to
  52.    chose one of the two basic modes of operation (as
  53.    described above)
  54.  
  55.  - 'Verbose' or 'Quiet':  use these to control display
  56.    of warning messages issued in 'import' mode when
  57.    text goes beyond a tab column (these options are
  58.    not selectable unless 'import mode' is selected).
  59.  
  60.  Specifying the tab settings
  61.  ---------------------------
  62.  The setup box allows to select one of four ways to
  63.  specify the tab setting values and provides a box for
  64.  entering the actual values:
  65.  
  66.  - 'columns':  select this if you want to specify a
  67.    list of numeric tab settings separated by commas 
  68.    (e.g. 10,16,41,72). The list must contain no blanks.
  69.    Individual numbers in the list may be followed by
  70.    '/F' (e.g. 10,16,41,72/F) to indicate that a tab
  71.    must always be inserted at this setting even in the
  72.    middle of a word ('F' stands for 'fixed' tab)
  73.  
  74.  - 'width':  select this if you want regularly spaced
  75.    tabs; you must then specify a single number giving
  76.    the spacing
  77.  
  78.  - 'ruler':  select this if you want to specify the tab
  79.    settings in the form of a ruler which is either the
  80.    first line of the input file (in which case you make
  81.    sure the 'values' box is empty), or the first line
  82.    of a special ruler file (in which case you drag this
  83.    file to the 'values' box).
  84.    
  85.    "@" characters in the ruler indicate normal tab
  86.    positions and "|" characters indicate 'fixed' tab
  87.    positions ('fixed' tab means insert a tab character
  88.    at this position even if this is in the middle of a
  89.    word)
  90.  
  91.  - 'profile':  select this if you intend to specify a
  92.    tabs profile name. A tabs profile is a list of tabs
  93.    settings (and other options) stored internally
  94.    within the Tabs program. This internal list can be
  95.    updated using the TabsCfg application. To see a list
  96.    of the currently defined profiles, press F12 and
  97.    enter 'Tabs' at the '*' command prompt.
  98.  
  99.  Menu options
  100.  ------------
  101.  Clicking MENU over the setup dialog box will display a
  102.  menu with options in addition to the standard 'Command
  103.  line' entry:
  104.  
  105.  - 'Exclude':  allows you to specify a string of line
  106.    exclusion characters. Any line starting with one of
  107.    these characters will just be copied 'as is' from
  108.    the input to the output file
  109.  
  110.  - 'Max warnings':  allows you to specify a warning
  111.    message cut-off. Once reached, no more warning
  112.    messages are issued.
  113.