home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsf / formtext / !FormText / !Help next >
Encoding:
Text File  |  1996-01-06  |  5.9 KB  |  207 lines
  1.  
  2.  
  3.  
  4.  
  5.                              --oOo-- FORMTEXT --oOo--
  6.  
  7.  
  8.  
  9.     FormText
  10.     ————————
  11.  
  12.     Introduction
  13.     ————————————
  14.     FormText is a utility to reorganise a plain text file so that it has
  15.     regular page breaks, margins, headers, footers and a contents page.
  16.     Files processed in this way can be used as a manual, suitable for
  17.     printing on almost any printer.
  18.  
  19.     The reason for writing it was more to make something useful out of a
  20.     Toolbox tutorial than to provide a brilliant utility. Therefore, the
  21.     formatting code was wriiten for simplicity rather than efficiency.
  22.     Although all formatting is done in RAM it uses a rather slow multi-pass
  23.     process.
  24.  
  25.     This file has been processed by FormText, but without contents because
  26.     it would look silly with a manual this short.
  27.  
  28.     The author
  29.     ——————————
  30.     Tony Houghton
  31.     271 Upper Weston Lane
  32.     Southampton
  33.     SO19 9HY
  34.  
  35.     tonyh@tcp.co.uk             http://www.tcp.co.uk/~tonyh/
  36.  
  37.     Suggestions, presents etc welcome.
  38.  
  39.     Conditions
  40.     ——————————
  41.     The conditions by which FormText is used and distributed are best
  42.     described by the term freeware. This means that it may be freely used
  43.     and distributed, but the author retains copyright. The conditions I
  44.     impose are that the application is distributed without any of its files
  45.     altered, and it is not marketed as a commercial product.
  46.  
  47.     Subscribers to Archive magazine/disc have access to the source code, to
  48.     be used only for tutorial purposes.
  49.  
  50.     Installation
  51.     ————————————
  52.     If you have an OS earlier than RISC OS 3.6 you need the Toolbox modules
  53.     in the supplied copy of !System. If you have RISC OS 3.5 double click
  54.     on !Boot to merge the new system, otherwise run !SysMerge.
  55.  
  56.     Version
  57.     ———————
  58.     This is version 1.01.
  59.  
  60.     Basic use
  61.     —————————
  62.     FormText appears on the icon bar when loaded. To format a file, drag it
  63.  
  64.  
  65.  
  66.  
  67.                                     Page 1
  68.  
  69.  
  70.  
  71.     
  72.  
  73.  
  74.  
  75.                              --oOo-- FORMTEXT --oOo--
  76.  
  77.  
  78.  
  79.     to the FormText icon and a large dialogue box will appear. Fill in the
  80.     details you require and click Format.
  81.  
  82.     While the text is being formatted the Hourglass shows the percentage
  83.     done. This is a very rough guide, based only on how many stages of
  84.     processing the file has gone through so far. The time taken to complete
  85.     each stage can vary widely.
  86.  
  87.     When formatting is complete, the main dialogue box closes and is
  88.     replaced by a Save as dialogue box for you to save the formatted file.
  89.  
  90.     How to set up a text file for formatting
  91.     ————————————————————————————————————————
  92.     FormText splits text up into lines short enough to fit across the
  93.     configured page, so you should only use line-feeds (ie the Return key)
  94.     where you explicitly want them, such as at the end of paragraphs. To
  95.     enter your text you may find it easier to use the SoftWrap mode in Zap,
  96.     or a word processor like Impression that can save plain text without
  97.     line feeds.
  98.  
  99.     Tabs are allowed, these will be expanded with a field of 8 characters.
  100.  
  101.     A line beginning with a certain character is taken to be a heading;
  102.     headings can be underlined and shown in an automatically generated
  103.     table of contents. The 'heading flag' character, which is removed from
  104.     the output file, must have an ASCII value greater than 127; you enter
  105.     which character you want to use in FormText's main dialogue box.
  106.     Recommended characters are ¬ for Risc PC and ¤ for Archimedes, because
  107.     these are available on the keyboard but are rarely used. Do not
  108.     underline your headings, FormText can do this for you.
  109.  
  110.     Settings in the dialogue box
  111.     ————————————————————————————
  112.  
  113.     Page dimensions
  114.     ———————————————
  115.     'Total height' is the total number of lines per page on the printer.
  116.     'Top margin' lines will be left blank at the top of every page, below
  117.     this 'Header lines' are allowed for the header. Then 'Bottom margin'
  118.     lines are left blank above 'Footer lines' allocated to the footer. If a
  119.     header or footer is too long to fit in its space, including a blank
  120.     line, it will be truncated.
  121.  
  122.     The 'Total width' is self-explanatory; 'Left margin' spaces are
  123.     inserted at the start of every line, and room is left for 'Right
  124.     margin' spaces at the end of each line, but these are not actually
  125.     inserted.
  126.  
  127.     For clarity:
  128.  
  129.             Total height =  Top margin + Header lines +
  130.                             text height (implied) +
  131.                             Bottom margin + Footer lines
  132.             
  133.  
  134.  
  135.  
  136.  
  137.                                     Page 2
  138.  
  139.  
  140.  
  141.     
  142.  
  143.  
  144.  
  145.                              --oOo-- FORMTEXT --oOo--
  146.  
  147.  
  148.  
  149.             Total width =   Left margin +
  150.                             text width (implied) +
  151.                             Right margin
  152.  
  153.     Header & footer
  154.     ———————————————
  155.     Text from these fields is entered at the top and bottom of every page
  156.     respectively. Certain pairs of characters have special meanings:
  157.  
  158.     |M inserts a line feed.
  159.     %h inserts the nearest heading (the next one following the header, or
  160.     the last one on the previous page). It is best to confine this feature
  161.     to headers. Even Impression doesn't do this automatically!
  162.     %p inserts the current page number.
  163.  
  164.     To insert a % or |, use %% or || respectively.
  165.  
  166.     Contents
  167.     ————————
  168.     If the 'Generate contents' button is ticked a contents table is
  169.     generated (may be more than one page), consisting of every heading next
  170.     to its page number. The 'Title' is used as the header of contents
  171.     pages, there is no footer. Page numbers are right-aligned, as many of
  172.     'Leadering char' as necessary are inserted between the entry and its
  173.     page number to guide the eye.
  174.  
  175.     Save settings
  176.     —————————————
  177.     This button saves the settings currently entered in the dialogue box to
  178.     be used as the defaults next time you load FormText.
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.                                     Page 3
  207.