home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / p / pcfrm626.zip / PCFORMS.DOC < prev    next >
Text File  |  1993-01-23  |  51KB  |  1,396 lines

  1.  
  2.  
  3.  
  4.             
  5.             
  6.             
  7.             
  8.             
  9.                                           
  10.                                -  P C - F O R M S  -
  11.             
  12.                               DOCUMENT ASSEMBLY SYSTEM
  13.             
  14.             
  15.             
  16.             
  17.             
  18.             
  19.             
  20.             
  21.             
  22.                            (The Electronic Forms Library)
  23.             
  24.             
  25.             
  26.             
  27.                                    USERS' MANUAL
  28.                                           
  29.                                       for the
  30.             
  31.                                   PC-FORMS PROGRAM
  32.             
  33.             
  34.             
  35.             
  36.             
  37.             
  38.             
  39.             
  40.             
  41.                                  Copyright 1990-93
  42.                                William W. Blackledge
  43.                                 3704 Edgewater Drive
  44.                               Oklahoma City, Oklahoma
  45.                                        73116
  46.                                    (405) 840-3563
  47.             
  48.             
  49.                                    _______ 
  50.                               ____|__     |               (R)
  51.                            --|       |    |-------------------
  52.                              |   ____|__  |  Association of
  53.                              |  |       |_|  Shareware
  54.                              |__|   o   |    Professionals
  55.                            -----|   |   |---------------------
  56.                                 |___|___|    MEMBER
  57.             
  58.             
  59.  
  60.  
  61.             
  62.             
  63.             
  64.             
  65.             
  66.             
  67.             
  68.                        *********************************
  69.                        **     TABLE OF CONTENTS       **
  70.                        *********************************
  71.                                        
  72.                        Overview . . . . . . . . . . .  1
  73.             
  74.                        Summary of PC-FORMS' Features . 2
  75.             
  76.                        PC-FORMS Startup  . . . . . . . 6
  77.             
  78.                        PC-FORMS Master Menu  . . . . . 8
  79.             
  80.                        Text Menu  . . . . . . . . . . 10
  81.             
  82.                        Variable Input Screen . . . .  11
  83.             
  84.                        Revised Text Screen . . . . .  13
  85.             
  86.                        Output Modes . . . . . . . . . 14
  87.             
  88.                        Variable Files . . . . . . . . 15
  89.             
  90.                        Color and Value Billing Codes. 16
  91.             
  92.                        Source Text Rules  . . . . . . 17
  93.             
  94.                        PC-LIBRARY Program . . . . . . 21
  95.             
  96.                        *********************************
  97.             
  98.             
  99.             
  100.             
  101.             
  102.             
  103.             
  104.             WordStar is a trademark of WordStar International Inc.
  105.             WordPerfect is a trademark of WordPerfect Corporation.
  106.             PC-Write is a trademark of Quicksoft.
  107.             FriendlyWriter is a trademark of Friendly Soft Inc. 
  108.             
  109.                                Copyright 1990-91
  110.                              William W. Blackledge
  111.                              3704 Edgewater Drive
  112.                             Oklahoma City, Oklahoma
  113.                                      73116
  114.                                 (405) 840-3563
  115.             
  116.                                PC-FORMS USERS' MANUAL
  117.  
  118.  
  119.             
  120.             
  121.             
  122.                                       OVERVIEW
  123.             
  124.             The PC-FORMS document assembly system consists of two pro-
  125.             
  126.             grams, PC-FORMS and PC-LIBRARY, which automate the assembly 
  127.             
  128.             of legal and business documents.  They permit users to 
  129.             
  130.             choose their own words for computer-prepared documents.
  131.             
  132.             
  133.             
  134.             The PC-FORMS program, PCFM.EXE, lets the user select from a 
  135.             
  136.             text library furnished with the programs, or prepared by the 
  137.             
  138.             user, text to be included in a document.  If the selected 
  139.             
  140.             text contains variable names, the user is prompted for 
  141.             
  142.             variable responses to be inserted in lieu of those names.  
  143.             
  144.             Responses are inserted in the text which is revised and 
  145.             
  146.             displayed for acceptance or rejection.
  147.             
  148.             
  149.             
  150.             PC-FORMS eliminates repeated proof-reading of "boiler-plate" 
  151.             
  152.             text.  Variable information that does change is typed and 
  153.             
  154.             proofed only once, even if used repeatedly in a document.  
  155.             
  156.             The documents can be modified with a word processor for 
  157.             
  158.             unusual situations.  The programs may be linked to WordStar, 
  159.             
  160.             WordPerfect, Microsoft Word, VDE, PC-Write, Friendly-Writer 
  161.             
  162.             or other word processing programs.  When linked, completed 
  163.             
  164.             documents are automatically loaded by PC-FORMS into the 
  165.             
  166.             user's word processor.
  167.             
  168.             
  169.             
  170.             As a document is prepared the program accumulates the re-
  171.             
  172.             vised text in a document file.  It also accumulates, in 
  173.             
  174.  
  175.  
  176.                                        - 1 -
  177.                                PC-FORMS USERS' MANUAL
  178.  
  179.  
  180.             another file, the variable responses entered and a record of 
  181.             
  182.             the text selections made.  This file may be used to "proof" 
  183.             
  184.             the completed document or as a record of its contents.
  185.             
  186.             
  187.             
  188.             The PC-LIBRARY program is a companion program to the PC-
  189.             
  190.             FORMS program.  It assists the user in creating and main-
  191.             
  192.             taining text libraries for the system.  There is a separate 
  193.             
  194.             manual which explains the operation of that program.  After 
  195.             
  196.             sections of text have been entered into a set of library 
  197.             
  198.             files, PC-LIBRARY will prompt the user to enter a prompt for 
  199.             
  200.             each variable name included in that text for which no prompt 
  201.             
  202.             exists in the library variable file and will arrange the 
  203.             
  204.             text headings in numerical and alphabetical sequence for the 
  205.             
  206.             text selection indexes.
  207.             
  208.             
  209.             
  210.             The text library files (with suffixes of .VBL and .LEX) must 
  211.             
  212.             be in the current working file directory.  The program files 
  213.             
  214.             (with the .EXE suffix) and the FMHELP.MSG and ORDER.MSG 
  215.             
  216.             files may be in the same directory or any other directory 
  217.             
  218.             included in the DOS "PATH" command.  If the PCFM.EXE program 
  219.             
  220.             is run from the same directory as WordStar, WordPerfect, 
  221.             
  222.             Microsoft Word, VDE, PC-Write, or FriendlyWriter, it will 
  223.             
  224.             automatically link to the word processing program or it can 
  225.             
  226.             be linked using the Setup Menu.  The program to convert from 
  227.             
  228.             WordStar 3.3 must be in the same directory, for WordPerfect 
  229.             
  230.             - CONVERT.EXE; for Microsoft Word - WS_RTF.EXE and for 
  231.             
  232.             FriendlyWriter - FWCNV.EXE.
  233.  
  234.  
  235.  
  236.  
  237.                                        - 2 -
  238.                                PC-FORMS USERS' MANUAL
  239.  
  240.  
  241.                            SUMMARY OF PC-FORMS' FEATURES
  242.             
  243.             PC-FORMS is started by entering the command "PCFM" at the 
  244.             
  245.             DOS prompt.  The opening screen displays a list of the text 
  246.             
  247.             libraries available in the current directory.
  248.             
  249.             
  250.             
  251.             After entering a library name, the user is prompted to enter 
  252.             
  253.             a filename for the document to be assembled.  This is a 
  254.             
  255.             standard DOS filename of 8 or less characters, a dot, and a 
  256.             
  257.             suffix of 3 or less characters, such as "JOHNSON.WIL".  The 
  258.             
  259.             filename may be preceded by a directory path such as 
  260.             
  261.             "C:\MYDOCS\JOHNSON.WIL" if the user wants it to be stored in 
  262.             
  263.             a specified directory.
  264.             
  265.             
  266.             
  267.             If the filename of a previous document is entered PC-FORMS 
  268.             
  269.             informs the user that the file exists and asks whether to 
  270.             
  271.             overwrite it or append to it.  If neither option is selected 
  272.             
  273.             the user may enter a new filename.
  274.             
  275.             
  276.             
  277.             A proof file is created for each document assembled using 
  278.             
  279.             PC-FORMS.  If there are any proof files for the text library 
  280.             
  281.             selected by the user, the program asks the user if he, or 
  282.             
  283.             she, desires to load the responses from the proof file of a 
  284.             
  285.             previous document.  This feature makes it unnecessary to re-
  286.             
  287.             enter responses for a series of documents for which variable 
  288.             
  289.             responses will not change.
  290.             
  291.             
  292.             
  293.             If the user desires to load the variable responses from a 
  294.             
  295.             proof file, the program displays a list of all previous 
  296.  
  297.  
  298.                                        - 3 -
  299.                                PC-FORMS USERS' MANUAL
  300.  
  301.  
  302.             
  303.             proof files for the selected text library and requests the 
  304.             
  305.             entry of the one from which to load responses.
  306.             
  307.             
  308.             
  309.             When these preliminary entries are completed, the first of 4 
  310.             
  311.             menu screens used to assemble documents is displayed.  These 
  312.             
  313.             screens are:
  314.             
  315.                     1 - The MASTER MENU screen,
  316.             
  317.                     2 - The TEXT SELECTION screen,
  318.             
  319.                     3 - The VARIABLE INPUT screen, and
  320.             
  321.                     4 - The REVISED TEXT screen.
  322.             
  323.             
  324.             There are 9 selections on the MASTER MENU screen which are 
  325.             
  326.             selected by entering the corresponding numeral.
  327.             
  328.             
  329.                     1.  Text Menu (to Start or Continue a Document)
  330.             
  331.                     2.  Help, Order or Setup Menu
  332.             
  333.                     3.  Text Selection Indexes (to Find Text)
  334.             
  335.                     4.  Go to a Text Menu (to Skip to a Menu)
  336.             
  337.                     5.  Display Document (to View the Document)
  338.             
  339.                     6.  Line Spacing Toggle = SINGLE
  340.             
  341.                     7.  Change from <library> to Another Library  
  342.             
  343.                     8.  Exit Program - Skip the Word Processor
  344.             
  345.                     9.  Exit Program to the Word Processor
  346.             
  347.             
  348.             
  349.             Text selections may be made from the current Text Menu or 
  350.             
  351.             from the Text Selection Indexes.  Indexes of text selections 
  352.             
  353.             are displayed in both numeric and alphabetical sequence.  
  354.             
  355.             The numeric sequence is in logical sequence for document 
  356.             
  357.  
  358.  
  359.                                        - 4 -
  360.                                PC-FORMS USERS' MANUAL
  361.  
  362.  
  363.             preparation except that some document headings and closings 
  364.             
  365.             may be at the beginning or end of a text library.
  366.             
  367.             
  368.             
  369.             Each text-entry screen displays a highlighted line at the 
  370.             
  371.             top showing the commands accessible from that screen.  These 
  372.             
  373.             are the commands used to access the menus and enter re-
  374.             
  375.             sponses during document preparation.  The following is a 
  376.             
  377.             summary of these commands:
  378.             
  379.                  TEXT SELECTION screen:
  380.             
  381.                  - (N)ext - to proceed to the next text menu.
  382.                  - (P)revious - to return to a previous text menu.
  383.                  - (ESC)Master Menu - to return to the MASTER MENU.
  384.             
  385.             
  386.                  INPUT VARIABLES screen:
  387.             
  388.                  - (>)Center - to center the response on the page.
  389.                  - (ESC)Menu - to return to the Current Text Menu.
  390.                  - (?)Help - to display help for the variable response.
  391.             NOTE: The user may skip a response by entering a <RETURN>.
  392.             
  393.                  REVISED TEXT screen:
  394.             
  395.                  - (R)eject text - to reject revised text & not store 
  396.                                    responses.
  397.                  - <RETURN>      - to accept the revised text and append 
  398.                                    to document.
  399.             
  400.             At any time during document preparation the user may return 
  401.             
  402.             to the Master Menu screen by entering <ESCAPE> one, or more, 
  403.             
  404.             times.  From that screen the user may view the general 
  405.             
  406.             program help file or the Text Selection Index, skip to a 
  407.             
  408.             menu, display the document being prepared, change to double-
  409.             
  410.             line or single-line spacing or change to a different text 
  411.             
  412.             library.  The latter feature permits the user to begin a 
  413.             
  414.             letter in the library containing forms of address for digni-
  415.             
  416.             taries (LTRADR) and, after entering the address information 
  417.             
  418.  
  419.  
  420.                                        - 5 -
  421.                                PC-FORMS USERS' MANUAL
  422.  
  423.  
  424.             shift over to one of the other letter libraries to complete 
  425.             
  426.             the letter.
  427.             
  428.             
  429.             
  430.             This concludes the summary of PC-FORMS' features.  The 
  431.             
  432.             remainder of this manual consists of detailed instructions 
  433.             
  434.             for the use of PC-FORMS users who want more information 
  435.             
  436.             about how the program works.
  437.             
  438.             
  439.             
  440.                                  PC-FORMS START-UP
  441.             
  442.             PC-FORMS is started by entering PCFM at the DOS prompt.  You 
  443.             
  444.             may also enter the library name, the output file specifica-
  445.             
  446.             tion and a mode character D, N or R for Document, Non-
  447.             
  448.             Document or Right-Justified output.  You will appreciate the 
  449.             
  450.             ability to start the programs with a one-line command con-
  451.             
  452.             taining all of the required start-up information after 
  453.             
  454.             becoming familiar with them.
  455.             
  456.             
  457.             
  458.             When the program is started with the "PCFM" command, the 
  459.             
  460.             program displays a sorted list of the text libraries avail-
  461.             
  462.             able in the current working directory.  A description of the 
  463.             
  464.             libraries is available in the general help file which is 
  465.             
  466.             displayed by selection 2 on the Main Menu.
  467.             
  468.             
  469.             
  470.             Examples of correct start-up entries at the DOS prompt for 
  471.             
  472.             the PC-FORMS program are:
  473.             
  474.                       C:\PCFORMS> pcfm
  475.                       C:\PCFORMS> pcfm wills
  476.                       C:\PCFORMS> pcfm wills testwill.doc
  477.                       C:\PCFORMS> pcfm wills testwill.doc d
  478.             
  479.  
  480.  
  481.                                        - 6 -
  482.                                PC-FORMS USERS' MANUAL
  483.  
  484.  
  485.             
  486.             The program will request input of any of the above informa-
  487.             
  488.             tion not supplied on the command line.  The first menu the 
  489.             
  490.             program looks for is <LIBRARY>01.LEX, where <LIBRARY> is the 
  491.             
  492.             name of the library.  As text selections are made, it pro-
  493.             
  494.             ceeds through the series of text menus as directed by the 
  495.             
  496.             user.
  497.             
  498.             
  499.             
  500.             If the file name entered for the document already exists you 
  501.             
  502.             will be advised of that fact and asked if you want to over-
  503.             
  504.             write it or append your text selections to the end of it.  A 
  505.             
  506.             (N)o answer to this query will allow you to rename the 
  507.             
  508.             proposed document.
  509.             
  510.             
  511.             
  512.             The program maintains a list of the proof files for each 
  513.             
  514.             text library which have not been deleted from the disk in a 
  515.             
  516.             file named with the library name plus the suffix ".VRS".  
  517.             
  518.             When a text library is selected for which proof files exist 
  519.             
  520.             the user is asked whether he, or she, wants to load the 
  521.             
  522.             previous variable responses from one of those proof files.  
  523.             
  524.             If so, the program displays a list of the proof files creat-
  525.             
  526.             ed using that library and prompts the user for the one to 
  527.             
  528.             load.
  529.             
  530.             
  531.             
  532.             This makes it unnecessary to re-enter variable responses for 
  533.             
  534.             a series of documents in which the same responses apply.  
  535.             
  536.             This feature is especially helpful in connection with plead-
  537.             
  538.             ings and related documents in which the parties' names and 
  539.             
  540.  
  541.  
  542.                                        - 7 -
  543.                                PC-FORMS USERS' MANUAL
  544.  
  545.  
  546.             other information does not change.  It is also useful for 
  547.             
  548.             doing different versions of a document for comparison pur-
  549.             
  550.             poses.
  551.             
  552.             
  553.             
  554.             Text selections are made from screen displays of the Text 
  555.             
  556.             Menus or from the Text Selection Indexes.  After inserting 
  557.             
  558.             variable responses in the selected text it is revised and 
  559.             
  560.             displayed.  The user is permitted to either reject the re-
  561.             
  562.             vised text or append it to the output document.
  563.             
  564.             
  565.             
  566.                                 PC-FORMS MASTER MENU
  567.             
  568.             After the PC-FORMS program is started and the preliminary 
  569.             
  570.             entries are completed the following Master Menu appears:
  571.             
  572.                       1.  Text Menu (to Start or Continue Document)
  573.             
  574.                       2.  Help, Order or Setup Menu
  575.             
  576.                       3.  Text Selection Indexes (to Find Text)
  577.             
  578.                       4.  Go to a Text Menu (to Skip to a Menu)
  579.             
  580.                       5.  Display Document (to See Document)
  581.             
  582.                       6.  Line Spacing Toggle = SINGLE
  583.             
  584.                       7.  Change from <FORMNAME> to Another Library
  585.             
  586.                       8.  Exit Program - Skip the Word Processor
  587.             
  588.                       9.  Exit Program to the Word Processor
  589.             
  590.             A highlighted MASTER MENU heading is displayed at the top of 
  591.             
  592.             your screen showing the name of the current text library 
  593.             
  594.             file.  This heading also shows the version of the program 
  595.             
  596.             you are running and the copyright notice.
  597.             
  598.             
  599.             
  600.             Selection 6 on this menu lets you toggle back and forth 
  601.  
  602.  
  603.                                        - 8 -
  604.                                PC-FORMS USERS' MANUAL
  605.  
  606.  
  607.             
  608.             between single and double-line spacing for the document 
  609.             
  610.             being prepared.
  611.             
  612.             
  613.             
  614.             Selection 7 lets you change to a different text library and 
  615.             
  616.             continue the assembly of your document.  For example, this 
  617.             
  618.             feature permits the user to begin a letter using the special 
  619.             
  620.             'forms of address' letter library called LTRADR and then 
  621.             
  622.             switch to another letter library to complete the letter 
  623.             
  624.             being assembled.
  625.             
  626.             
  627.             
  628.             Normally, you will select the first Text Menu.  Before doing 
  629.             
  630.             so you may wish to review the General Program Help screens 
  631.             
  632.             or the Text Indexes.  After these selections you can return 
  633.             
  634.             to the Master Menu by entering <ESCAPE>.
  635.             
  636.             
  637.             
  638.             You can access the text selections in a text library either 
  639.             
  640.             from the Text Selection Screen showing the current Text Menu 
  641.             
  642.             or from the Text Selection Index.  Text selections may be 
  643.             
  644.             reviewed by selecting them and then returning to the current 
  645.             
  646.             Text Menu by pressing <ESCAPE>.
  647.             
  648.                                           
  649.             
  650.                                      TEXT MENU
  651.             
  652.             When you select the Text Menu, the following screen heading 
  653.             
  654.             line will appear:
  655.             
  656.             "TEXT SELECTION -(N)ext -(P)revious -(ESC)Master Menu -Text 
  657.             Menu: 
  658.                 Text Selections for Library: <form>, Menu No.  n -"
  659.             
  660.             
  661.             This will be followed by a display of the text selections in 
  662.  
  663.  
  664.                                        - 9 -
  665.                                PC-FORMS USERS' MANUAL
  666.  
  667.  
  668.             
  669.             the current menu.  This menu describes one or more sections 
  670.             
  671.             of text which may be added to the output document.
  672.             
  673.             
  674.             
  675.             Pressing <ESCAPE> will return you to the Master Menu.  An N 
  676.             
  677.             will select the next Text Menu, a P will select the previous 
  678.             
  679.             one.  The screen heading includes reminders of these com-
  680.             
  681.             mands for the user's convenience.
  682.             
  683.             
  684.             
  685.             After making your text selections from this menu, enter an N 
  686.             
  687.             to continue to the next Text Menu.  Continue this procedure 
  688.             
  689.             until your document is finished.
  690.             
  691.             
  692.             
  693.             At any time you may <ESCAPE> to the Master Menu and display 
  694.             
  695.             the document, switch to double spacing, change to another 
  696.             
  697.             library or review the Text Selection Indexes.  After you have 
  698.             
  699.             become familiar with a particular text library you may 
  700.             
  701.             return to the Master Menu to skip over menus from which no 
  702.             
  703.             text is to be selected by using Option No.  4, - "Go to a 
  704.             
  705.             Text Menu".
  706.             
  707.                                VARIABLE INPUT SCREEN
  708.             
  709.             When you have entered your text selection, the text will be 
  710.             
  711.             displayed with its variable names under a heading, as fol-
  712.             
  713.             lows:
  714.             
  715.             "VARIABLE INPUT -(CTRL-R)edo -(CR)Left Mrgn -(ESC)Menu 
  716.             
  717.             -(>)Center -(?)Help"
  718.             
  719.             If the text contains variable names you will be prompted to 
  720.             
  721.             enter the information you want to replace them in the head-
  722.             
  723.  
  724.  
  725.                                        - 10 -
  726.                                PC-FORMS USERS' MANUAL
  727.  
  728.  
  729.             ing to the bottom window of the screen.  If there is more 
  730.             
  731.             than a full window of text the program will show "- more -" 
  732.             
  733.             at the bottom of the window and wait for a key to be pressed 
  734.             
  735.             to continue scrolling.
  736.             
  737.             
  738.             
  739.             If the characters '->' appear before the cursor the program 
  740.             
  741.             has entered the '>' character for you so that your entry 
  742.             
  743.             will be centered on the page.  This occurs when the variable 
  744.             
  745.             name in the text begins with the '>' character.  The 
  746.             
  747.             '(>)Center' in the screen heading is a reminder that if you 
  748.             
  749.             want to center your response you, or the program, must enter 
  750.             
  751.             the '>' character before entering the response.
  752.             
  753.             
  754.             
  755.             If your response goes beyond the end of the format line the 
  756.             
  757.             program will wrap your entry to the next line automatically.  
  758.             
  759.             Your may use the Arrow and CTRL-Arrow keys to move around in 
  760.             
  761.             that portion of your current response which has not scrolled 
  762.             
  763.             out of the variable input window to make additions or other 
  764.             
  765.             corrections.
  766.             
  767.             
  768.             
  769.             If you decide you do not want to include a particular sec-
  770.             
  771.             tion of text or if you find you have made a mistake in a 
  772.             
  773.             previous entry you may return to the Text Menu by pressing 
  774.             
  775.             <ESCAPE>.  Pressing it twice will return you to the Master 
  776.             
  777.             Menu.  At any time during variable input you may cancel your 
  778.             
  779.             entries and return to the Text Menu by pressing <ESCAPE>.
  780.             
  781.             
  782.             
  783.             "(?)Help" is a reminder that entry of a question mark at a 
  784.  
  785.  
  786.                                        - 11 -
  787.                                PC-FORMS USERS' MANUAL
  788.  
  789.  
  790.             
  791.             variable prompt will result in the display of the help 
  792.             
  793.             message for that variable.
  794.             
  795.             
  796.             
  797.             The prompts for the variable names in the selected text for 
  798.             
  799.             which responses have not been stored in memory will appear 
  800.             
  801.             in sequence.  When all responses have been entered the text 
  802.             
  803.             will be revised and displayed for your acceptance or rejec-
  804.             
  805.             tion.
  806.             
  807.             
  808.             
  809.             You can enter a <RETURN> at a variable prompt to skip over a 
  810.             
  811.             variable name for which you want no response to appear in 
  812.             
  813.             the final document (such as an extra address line in a form 
  814.             
  815.             letter).
  816.             
  817.             
  818.             
  819.                                 REVISED TEXT SCREEN
  820.             
  821.             The heading for the revised text screen is an inverse video 
  822.             
  823.             display followed by the current format line, as follows:
  824.             
  825.                "REVISED TEXT -(R)eject -(Return)Append to Document"
  826.             
  827.             After the revised text is displayed the program will wait 
  828.             
  829.             for you to enter an 'R' to reject it or a Carriage Return to 
  830.             
  831.             add it to the output file.  When a section of text is re-
  832.             
  833.             jected the responses for global variables entered for that 
  834.             
  835.             section of text are deleted.  When a section is added to the 
  836.             
  837.             document that text selection and the responses for any local 
  838.             
  839.             variables in it is saved in a 'proof' file named 
  840.             
  841.             <DOCUMENT>.PRF.
  842.             
  843.             
  844.             
  845.  
  846.  
  847.                                        - 12 -
  848.                                PC-FORMS USERS' MANUAL
  849.  
  850.  
  851.             If it becomes necessary to leave the program in the middle 
  852.             
  853.             of a job, you may come back to it later and begin where you 
  854.             
  855.             left off.  If you load the variable responses in the proof 
  856.             
  857.             file for the document it is unnecessary to re-enter that 
  858.             
  859.             information.
  860.             
  861.             
  862.             
  863.                                     OUTPUT MODES
  864.             
  865.             Three output modes are available: Document, Non-Document and 
  866.             
  867.             Right-Justified.  Document mode text is revised to permit 
  868.             
  869.             printing it right justified using micro-justification with 
  870.             
  871.             the WordStar, Word or WordPerfect word processing program.  
  872.             
  873.             Document mode output files are in WordStar format.  They may 
  874.             
  875.             be converted to the linked word processor format by the 
  876.             
  877.             conversion program furnished with the particular word proc-
  878.             
  879.             essor or by an appropriate program selected by the user in 
  880.             
  881.             the Setup Menu.
  882.             
  883.             
  884.             
  885.             In Non-Document mode the program revises each line of text 
  886.             
  887.             by removing one of any duplicate spaces between words and 
  888.             
  889.             all but two spaces after each punctuation mark.  Each line 
  890.             
  891.             of text is then terminated at the last space or hyphen 
  892.             
  893.             before the right margin marker in the current format line.  
  894.             
  895.             This results in the text having a ragged right margin with-
  896.             
  897.             out extra spaces.
  898.             
  899.             
  900.             
  901.             In Right-Justified mode the output is revised by inserting 
  902.             
  903.             extra spaces to permit printing it right-justified on print-
  904.             
  905.             ers which do not support micro-justification.
  906.  
  907.  
  908.                                        - 13 -
  909.                                PC-FORMS USERS' MANUAL
  910.  
  911.  
  912.             
  913.             
  914.             
  915.             In Document mode the output files contain special non-
  916.             
  917.             printing characters used by WordStar to right-justify the 
  918.             
  919.             text.  They also contain special dot-command lines which are 
  920.             
  921.             used to format the printed documents.
  922.             
  923.             
  924.             
  925.             The output files in both Non-Document and Right-Justified 
  926.             
  927.             mode will contain only printable ASCII characters without 
  928.             
  929.             special formatting characters or dot commands.
  930.             
  931.             
  932.             
  933.             If your printer does not support micro-justification or you 
  934.             
  935.             do not use WordStar, Word or WordPerfect for document print-
  936.             
  937.             ing you will want to output non-document or right-justified 
  938.             
  939.             documents.
  940.             
  941.             
  942.             
  943.                                    VARIABLE FILES
  944.             
  945.             There is one variable file for each text library.  This 
  946.             
  947.             file is named with the formname followed by the suffix 
  948.             
  949.             ".VBL".  The file contains a section of variable prompts 
  950.             
  951.             headed by the dot command ".QN", a section of variable help 
  952.             
  953.             messages headed by the dot command ".HP" and a section of 
  954.             
  955.             the text heading lines in numeric and alphabetical sequence 
  956.             
  957.             headed by the dot command .IX.
  958.             
  959.             
  960.             
  961.             
  962.             Each prompt and help message is entered in this file on the 
  963.             
  964.             line immediately after the line containing the variable name 
  965.             
  966.             in curly braces.
  967.  
  968.  
  969.                                        - 14 -
  970.                                PC-FORMS USERS' MANUAL
  971.  
  972.  
  973.             
  974.             
  975.             
  976.             The help sections of variable files contain brief statements 
  977.             
  978.             for each variable name explaining what data should be en-
  979.             
  980.             tered in response to the prompt for that variable.  These 
  981.             
  982.             messages must also be entered in the file on the line imme-
  983.             
  984.             diately following a line containing the variable name in 
  985.             
  986.             curly braces.  The variable help messages are not required 
  987.             
  988.             for the program to run properly.  If there is no help mes-
  989.             
  990.             sage for a variable name the user will be prompted to enter 
  991.             
  992.             a variable respones to replace the variable name in the 
  993.             
  994.             document.
  995.             
  996.             
  997.             
  998.             A copyright notice for a text library can be displayed by 
  999.             
  1000.             including that notice in the help section of the variable 
  1001.             
  1002.             file under the variable name {~COPYRIGHT}.
  1003.             
  1004.             
  1005.             
  1006.             The tables below show the Background and Foreground colors 
  1007.             
  1008.             and color codes used by IBM compatible computers.
  1009.             
  1010.                             COLOR TABLES FOR BACKGROUND
  1011.                                AND FOREGROUND COLORS:.PS OFF
  1012.             
  1013.                         First HEX Digit = Background Color:
  1014.             
  1015.                       0 =  Black          8 =  Black Blinking
  1016.                       1 =  Blue           9 =  Blue Blinking
  1017.                       2 =  Green          A =  Green Blinking
  1018.                       3 =  Cyan           B =  Cyan Blinking
  1019.                       4 =  Red            C =  Red Blinking
  1020.                       5 =  Magenta        D =  Magenta Blinking
  1021.                       6 =  Brown          E =  Yellow Blinking
  1022.                       7 =  White          F =  White Blinking
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.                                        - 15 -
  1031.                                PC-FORMS USERS' MANUAL
  1032.  
  1033.  
  1034.                              Second HEX Digit = Foreground Color:
  1035.             
  1036.                       0 =  Black          8 =  Gray
  1037.                       1 =  Blue           9 =  Light Blue
  1038.                       2 =  Green          A =  Light Green
  1039.                       3 =  Cyan           B =  Light Cyan
  1040.                       4 =  Red            C =  Light Red
  1041.                       5 =  Magenta        D =  Light Magenta
  1042.                       6 =  Brown          E =  Yellow
  1043.                       7 =  White          F =  Bright White
  1044.             
  1045.             
  1046.                                  SOURCE TEXT RULES
  1047.             
  1048.             The following are the rules which must be followed in the 
  1049.             
  1050.             preparation of the source text section of text files:
  1051.             
  1052.              1.  ASCII CHARACTERS.  The text must be in ASCII charac-
  1053.             
  1054.                  ters.
  1055.             
  1056.             
  1057.             
  1058.              2.  PARAGRAPH TERMINATION.  Paragraphs and lines which 
  1059.             
  1060.                  stand alone, such as formatting lines, MUST BE TERMI-
  1061.             
  1062.                  NATED WITH A CARRIAGE RETURN IMMEDIATELY AFTER the last 
  1063.             
  1064.                  character or punctuation mark.
  1065.             
  1066.             
  1067.             
  1068.              3.  LINE TERMINATION.  Each line within a paragraph, other 
  1069.             
  1070.                  than the last one, MUST END WITH A SPACE BEFORE THE 
  1071.             
  1072.                  CARRIAGE RETURN.
  1073.             
  1074.             
  1075.             
  1076.              4.  TEXT ARRANGEMENT.  The text within a paragraph may be 
  1077.             
  1078.                  arranged for display right-justified by the insertion 
  1079.             
  1080.                  of not more than one extra space between words and an 
  1081.             
  1082.                  unlimited number after any period, colon, exclamation 
  1083.             
  1084.                  mark or question mark.  These extra spaces are removed 
  1085.             
  1086.                  by the revision process.
  1087.             
  1088.             
  1089.  
  1090.  
  1091.                                        - 16 -
  1092.                                PC-FORMS USERS' MANUAL
  1093.  
  1094.  
  1095.             
  1096.              5.  VARIABLE NAMES.  Variable names must be enclosed in 
  1097.             
  1098.                  curly braces and must not exceed 23 characters in 
  1099.             
  1100.                  length, including the curly braces.  There are two 
  1101.             
  1102.                  major types of variable names, GLOBAL and LOCAL, which 
  1103.             
  1104.                  are distiguished by whether the first character after 
  1105.             
  1106.                  the initial curly brace is alphanumeric.  GLOBAL varia-
  1107.             
  1108.                  ble names begin with an alphanumeric character.
  1109.             
  1110.             
  1111.             
  1112.              6.  VARIABLE RESPONSE TREATMENT.  The responses for GLOBAL 
  1113.             
  1114.                  variables are automatically substituted for those 
  1115.             
  1116.                  variable names in all later sections of text selected 
  1117.             
  1118.                  for the document.  The responses for all LOCAL varia-
  1119.             
  1120.                  bles other than those beginning with a question mark or 
  1121.             
  1122.                  tilde will be displayed when the name is encountered in 
  1123.             
  1124.                  later sections of text and the user given an opportuni-
  1125.             
  1126.                  ty to change it for that section of text.  The user 
  1127.             
  1128.                  will always be prompted for a response if the variable 
  1129.             
  1130.                  name begins with a question mark.
  1131.             
  1132.              
  1133.             
  1134.              7.  SPECIAL AND LOCAL VARIABLE USAGE.  The following is a 
  1135.             
  1136.                  summary of how SPECIAL and LOCAL variables are used in 
  1137.             
  1138.                  text libraries:
  1139.             
  1140.             
  1141.             
  1142.                  The latest responses for the following five SPECIAL 
  1143.             
  1144.                  variables are saved in  the proof file of the Document 
  1145.             
  1146.                  being assembled.  These variable names are  used for 
  1147.             
  1148.                  the following purposes:
  1149.             
  1150.  
  1151.  
  1152.                                        - 17 -
  1153.                                PC-FORMS USERS' MANUAL
  1154.  
  1155.  
  1156.                     1st               SPECIAL Variable 
  1157.                     Char              Program Response
  1158.                      >  - Automatically inserts a ">" character to 
  1159.                           center the user response.  (Indicated by -> on 
  1160.                           the variable input screen)
  1161.             
  1162.                      ~  - Displays a 'Standard Response' for the Varia-
  1163.                           ble Name and permits the user to retain it or 
  1164.                           change it.
  1165.             
  1166.                 0 or |  - Adjusts the number of spaces after the varia-
  1167.                           ble response to keep additional information on 
  1168.                           the same line in the same relative position as 
  1169.                           it was in the text library file.
  1170.             
  1171.                      &  - Displays the user's previous response to the 
  1172.                           Variable Prompt, if any, and permits the user 
  1173.                           to retain it or change it.
  1174.             
  1175.                  REGULAR LOCAL variable names are used in sections of 
  1176.             
  1177.                  text where the response usually will not be repeated in 
  1178.             
  1179.                  later sections of text.  The responses to these varia-
  1180.             
  1181.                  ble names are NOT SAVED in the proof file of the docu-
  1182.             
  1183.                  ment being assembled and are used, as follows:
  1184.             
  1185.             
  1186.             
  1187.                     1st             REGULAR LOCAL Variable 
  1188.                     Char              Program Response
  1189.                      ?  - Always displays the prompt for the Variable 
  1190.                           Name, since the previous response was not 
  1191.                           stored.
  1192.             
  1193.                      !  - Displays the user's previous respones to the 
  1194.                           Variable Prompt, if any, and permits the user 
  1195.                           to retain it or change it.
  1196.             
  1197.                  For the "!" character you can substitute any non-
  1198.             
  1199.                  alphanumeric character other than one of those listed 
  1200.             
  1201.                  above.
  1202.             
  1203.             
  1204.             
  1205.              8.  SPECIAL GLOBAL VARIABLE.  There is one special GLOBAL 
  1206.             
  1207.                  variable name available which is begun with the zero 
  1208.             
  1209.                  '0' character after the first curly brace.  It is used 
  1210.             
  1211.  
  1212.  
  1213.                                        - 18 -
  1214.                                PC-FORMS USERS' MANUAL
  1215.  
  1216.  
  1217.                  to adjust the spaces after the variable response in the 
  1218.             
  1219.                  same way as the SPECIAL LOCAL variable beginning with 
  1220.             
  1221.                  the vertical bar '|'.
  1222.             
  1223.             
  1224.             
  1225.               9. FORMAT COMMAND LINE.  The .FT dot command, as explained 
  1226.             
  1227.                  above, is used in text libraries to establish the 
  1228.             
  1229.                  format of the following text.  The characters which may 
  1230.             
  1231.                  be used in a format command line are shown below:
  1232.             
  1233.                      L = Left Margin
  1234.             
  1235.                      P = Paragraph Margin
  1236.             
  1237.                      ! = Ordinary Tab Stop
  1238.             
  1239.                      # = Decimal Tab Stop
  1240.             
  1241.                      R = Right Margin (also a Tab Stop)
  1242.             
  1243.                      - = Spacing (Fill) Characters
  1244.             
  1245.             10.  OTHER WORDSTAR DOT COMMANDS.  Other dot commands may 
  1246.             
  1247.                  appear in the format section of the file or in a text 
  1248.             
  1249.                  section.  Dot commands may not appear within a para-
  1250.             
  1251.                  graph of text since, if placed there, they will be 
  1252.             
  1253.                  merged with the text when it is revised.  If you use 
  1254.             
  1255.                  WordStar for revision and printing, you may use any dot 
  1256.             
  1257.                  command supported by the version being used.
  1258.             
  1259.             
  1260.             If your word processor supports hanging indents, as the 
  1261.             
  1262.             latest versions of WordStar do, you can use the paragraph 
  1263.             
  1264.             margin to begin the first line of each paragraph to the left 
  1265.             
  1266.             of the left margin, leaving the paragraph number in the 
  1267.             
  1268.             margin.  You must remember to re-configure the word proces-
  1269.             
  1270.             sor for this style of paragraphs before revising the docu-
  1271.             
  1272.  
  1273.  
  1274.                                        - 19 -
  1275.                                PC-FORMS USERS' MANUAL
  1276.  
  1277.  
  1278.             ment with it.
  1279.             
  1280.             
  1281.             
  1282.             The numbered paragraphs above are examples of text done with 
  1283.             
  1284.             hanging indents.
  1285.             
  1286.             
  1287.             
  1288.             Sections of repeatable text (such as gifts of personal 
  1289.             
  1290.             property in the wills library) will contain only LOCAL 
  1291.             
  1292.             variable names for which the responses can be changed each 
  1293.             
  1294.             time the text is appended to the document.
  1295.             
  1296.             
  1297.             
  1298.             
  1299.             
  1300.                                  PC-LIBRARY PROGRAM
  1301.             
  1302.             The PC-LIBRARY program may be used to create and update the 
  1303.             
  1304.             variable file for a text library after the numbered text 
  1305.             
  1306.             sections have been entered in a series of .LEX files.  That 
  1307.             
  1308.             program will ask the user to enter the prompt for variable 
  1309.             
  1310.             names in the text files for which no prompt is found in the 
  1311.             
  1312.             variable file.  It will also save the text headings in 
  1313.             
  1314.             numeric and alphabetical sequence and, when requested, will 
  1315.             
  1316.             update the variable file for a library.  See the manual for 
  1317.             
  1318.             that program for an explanation of its operation.
  1319.             
  1320.             
  1321.             
  1322.             This program also generates files for printing the Text 
  1323.             
  1324.             Indexes, the Text Library, the Variable Prompts and Variable 
  1325.             
  1326.             Help messages in a PC-FORMS variable file.  The program is 
  1327.             
  1328.             very useful for those who wish to develop their own Forms 
  1329.             
  1330.             Libraries.
  1331.             
  1332.                                         ###
  1333.  
  1334.  
  1335.                                        - 20 -
  1336.                                 INDEX FOR PC-FORMS MANUAL
  1337.  
  1338.  
  1339.             Acceptance of Revised Text, 12      Overwriting a Document File, 7
  1340.             Accessing Text Selections, 9        
  1341.             Appending Revised Text, 8           PC-FORMS Program, 1
  1342.             Appending to a Document File, 7     PC-LIBRARY Program, 2, 20
  1343.             Arranging Text for Display, 16      Prompts for Variable Names, 12
  1344.                                                 Proof File, 2, 12
  1345.             Changing Libraries, 6               Proof File for Document, 3
  1346.             Changing to a Different Library, 9  
  1347.             Characters in                       Rejecting Revised Text, 8
  1348.                Text Library Files, 16           Rejection of Revised Text, 12
  1349.             Commands                            Renaming the Document File, 7
  1350.               Accessible, 5                     Return to Skip an Entry, 12
  1351.             Command-Line Entries, 6             Returning to Master Menu, 9
  1352.             Copyright Notice, 15                Returning to Text Menu, 11
  1353.                                                 Returning to the 
  1354.             Description of Libraries, 6            Current Text Menu, 9
  1355.             Document File                       Revised Text
  1356.               Naming, 3                           Acceptance, 12
  1357.             Document Mode Output, 13, 14          Rejection, 12
  1358.             Dot Commands in Text Files, 19      Revised Text Screen Commands, 12
  1359.             Double-Line Spacing, 5              Right-Justified Mode 
  1360.                                                    Output, 13, 14
  1361.             Escaping to the Master Menu, 10     
  1362.             Extra Spaces in                     Single-Line Spacing, 5
  1363.                Text Selections, 16              Skipping to a Text Menu, 10
  1364.                                                 Starting PC-FORMS, 3
  1365.             Format Command Line, 19             Starting the Program, 6
  1366.             Full Window of Text, 11             Start-Up Entries, 6
  1367.                                                 
  1368.             Help File, 6                        Terminating Lines 
  1369.             Help Message File, 2                   within Paragraphs, 16
  1370.             Help Messages                       Terminating Paragraphs, 16
  1371.               Variable, 14                      Text Centering Characters ->, 11
  1372.                                                 Text Entries Wrapped 
  1373.             Leaving Program, 13                    to Next Line, 11
  1374.             Libraries                           Text Heading Lines Index, 14
  1375.               Description of, 6                 Text Library files, 2
  1376.             Line Spacing Toggle, 9              Text Menus, 7
  1377.             Linking to Word Processor, 2        Text Selection Menu Commands, 9
  1378.             List of Libraries, 6                Text Selections, 8
  1379.             List of Proof Files, 7              
  1380.             Loading Previous Responses, 7       Use of Hanging Indentation, 19
  1381.             Loading Responses from              Use of ? for Help, 11
  1382.                Previous File, 3, 13             
  1383.                                                 Variable Files, 14
  1384.             Making Text Selections, 4           Variable Help Messages, 14, 15
  1385.             Master Menu, 8                      Variable Input Commands, 10
  1386.             Master Screen                       Variable Names, 17
  1387.               Returning to, 5                   Variable Responses
  1388.             Menu Screens, 4                       Treatment of, 17
  1389.                                                 Variables
  1390.             Non-Document Mode Output, 13, 14      Global, 17
  1391.                                                   Regular Local, 18
  1392.             Output Modes, 13                      Special Global, 18
  1393.             OVERVIEW, 1                           Special Local, 17
  1394.  
  1395.  
  1396.