; This is a sample QUICK HELP text file. While you'll find creation of "real"
; text files is easy, we've provided extensive tips gleaned from past 
; experience to aid in adding the most polished, professional look possible 
; to your own files.
;
; Let's start with some general "DOes" and "DON'Ts":
;
; 1) ALWAYS work on a COPY of this file, NEVER the original. If you ruin your
; only good copy, that's it....If you plan only one text file to be run by
; QHELP, you might want to name your copy MAINHELP.HLP and rename QHELP itself
; to anything you like (e.g., HELP.EXE--or HELP.COM for some systems). Then, 
; by typing HELP, the MAINHELP.HLP text file will be invoked. (Just remember 
; that any given directory can have only *one* MAINHELP.HLP. So if you use 
; that name, be sure to either rename the MAINHELP.HLP file which came with 
; QHELP, or work in a different directory. Otherwise, you may overwrite--and 
; lose--your copy of the original MAINHELP.HLP.)
;
; 2) As noted, QHELP text files are easy to create. But we've gone to some
; length to provide detailed guidelines so you can create the most aesthetic,
; error-free files possible. We strongly urge first-time users to
; PRINT A COPY OF THIS FILE FOR GUIDANCE BEFORE PROCEEDING. To do so, use
; your favorite printout program (which we hope is our QUICK PRINT program!),
; or simply prepare your printer with continuous-form paper, then use one of 
; the following commands:
; For PC-DOS or MS-DOS:
; PRINT DUMMY.HLP
; For CP/M, after preparing your printer, press Control-P (hold down the Ctrl
; key and simultaneously press P), then enter:
; TYPE DUMMY.HLP
; (then press Control-P again)
;
; 3) Be sure the final version of your text files are in "ASCII" format. (This
; is called "DOS" format by WordPerfect. For WordStar, either "print" to 
; "ASCII" format after creating your file, or create it in "Nondocument" 
; mode.)
;
; 4) Any line in a QHELP text file beginning with a semicolon will be ignored
; by QHELP during execution. But because these lines slow down run-time use,
; you'll want to delete most "comment lines" after you're satisfied everything
; is running properly. (This is a second reason for always working on a copy--
; so your original will retain a full set of comments for later reference.)
; Note: BLANK lines DO mean things to QHELP. You may want them for aesthetic 
; reasons. Also, QHELP inspects the first few lines of text files--excluding 
; "comment lines"--to ensure the file really is one meant for it. And it 
; DOESN'T expect blank lines near the head of a file.)...We often make text 
; more readable (as in the sample "text" sections, below) by having our word 
; processor use left and right margins of about 5 characters each. These 
; margins also help if printout is allowed (discussed below), to allow room
; for stapling. If you use margins, be sure your QHELP's key characters 
; (semicolons, etc.) are NOT indented.
;
; 5) QHELP always looks to the VERY FIRST column(s) of lines for your
; instructions. Like blank lines, blank SPACES in unexpected places near the
; head of the file are no-nos....
;
; 6) That said, after the instruction lines in this first, header section of
; the file, the only key character is a tilde ("~"). In the first position of 
; a line, it separates the header section from the menu section and, 
; thereafter, indicates the end of each of YOUR (chapter-like) sections.
;
; Enough preliminaries....If you aren't SURE you understand the few but
; critical above points, please review them. Otherwise, let's begin....
;
; ----------------------------------------------------------------------------
;
; * FILE REVISION DATE *
; The VERY FIRST "noncomment" line is the file's date. It will be displayed 
; on the screen, and (if printout is allowed by you and and chosen by the
; QHELP user) printed on each page. Format of the date is unimportant. (Note:
; If you ever see "Text File Date:" displayed on screen or "Revision Date:"
; printed on the "cover page" (discussed below) of a QHELP printout, it 
; almost surely means an entirely blank line slipped into your text file 
; ahead of the date line.)
;
22 May 1989
;
; * "TOO MANY SECTIONS" NUMBER *
; The VERY next line must be a number. For example, if your file's menu 
; contains 8 sections, you would enter 9 here. QHELP uses this number for 
; various internal purposes. But the most important is that if a user enters 
; this number or higher, an error message will appear and s/he will be asked
; for a valid response rather than having QHELP run off searching for a 
; section which isn't there.
;
; You may have as many sections as desired (well, up to something
; in excess of 32,000!), but all things being equal, we suggest a maximum of
; 9 (making 10 the suggested "TOO MANY SECTIONS" maximum). The reason is
; two-fold. First, if the highest legal number of sections is 9, QHELP acts
; immediately when a key is pressed. If a greater legal number is used,
; QHELP won't know whether a user plans to type, say, "1" or "10" after
; pressing "1"--so must wait until RETURN is pressed...not as nice. Secondly,
; the text in each section tends to grow over time. And long files mean long
; access time when the program is executed. Our own in-house rule is if it
; takes over 9 sections, first create a PRIMARY text file with a brief 
; introduction to "sub-files." Remember, users can access an unlimited number
; of files with QHELP. So we call the main file MAINHELP.HLP (so it will be
; automatically invoked), then advise users of the command for each sub-file
; in the intro description.
;
4
;
; * PRINTOUT AUTHORIZATION *
; If the next noncomment line is PRINTOK, users will be allowed to select
; output to printer. (In all cases, s/he may select screen output.) If you
; don't want printer output, simply precede the line with a semicolon, like
;PRINTOK
; Note that EXACT spelling and case (upper) ARE significant here and for 
; "TITLE:" below. In this case, we're allowing printer output, so:
;
PRINTOK
;
; * PRINTOUT TITLE FOR PAGE HEADERS *
; If you permit printer output, QHELP will next look for an (optional) line
; beginning with "TITLE:" and print whatever follows it as part of a header
; on every page EXCEPT the "cover page" (described in a moment). The maximum 
; length of the line varies somewhat depending upon length of the date, number
; of sections, total pages, etc. We suggest a maximum of about 25 characters.
; Note that spaces preceding/following any title WILL be printed. We've
; chosen to "indent" the title 5 spaces here, because our printable text also
; is indented five spaces, so will align with the header line. (TITLE: is the
; first printed portion of the header.) A trailing space is NOT needed. As 
; with other output, QHELP handles such details. The title line is ignored if 
; printout is disallowed. QHELP doesn't necessarily know how you have set up 
; your printer, so it doesn't know the maximum length (for header, text, 
; whatever) which will fit on a line. If a line is too long, it generally will
; wrap to the next line--unless your printer truncates long lines. Either way,
; the result ain't all that pretty, guys and gals, so keep the title short....
;
TITLE:     DUMMY QHELP GUIDELINES
;
; * PRINTOUT COVER PAGE TEXT *
; Next, you may (optionally) include information for the "cover page," which
; will be sent (to printer only) if the "All Sections" option is selected by
; the user while executing QHELP. QHELP aides in formatting the page 
; and reducing wasteful lines (which slow down execution) by supplying several
; blank lines preceding and following this information. The cover page also
; will include the date (above) and run-time menu (below). EVERYTHING,
; including blank lines (but excluding comment lines) from the "TITLE:" line
; (above) and the first tilde (below) will be printed. Depending upon the 
; depth of your menu, you'll probably be limited to 15-20 lines here.
;
; Because both the following information and menu are exceptionally short in
; this sample file, we will add a few blank lines.


                         ****************************

                           DUMMY  QHELP  TEXT  FILE

                         ****************************



                         Copyright 1989, J. W. Olsen
                             All Rights Reserved

; The following (FIRST) tilde denotes the end of the header section and
; beginning of the menu. Note that, like comment lines, anything on lines
; BEGINNING with a tilde will be ignored by QHELP. They're a handy way to
; leave comments to yourself for later reference.
;
~ (Menu)
;
; Menus may be in any desired format. Just remember that they will be shown
; to users as-is (and sent to printer likewise if a user requests ALL sections
; of the file printed). Generally, depth should be limited to 13 lines so the
; entire menu and other QHELP data will fit on one screen (and on the printed
; cover page). On some screens you can add an extra line. Likewise, if you
; disable PRINTOK, you gain a line. And, if you DON'T use the filename of
; MAINHELP.HLP, two more lines become available. But remember, blank lines ARE
; significant! We generally urge avoidance of them except for very short 
; menus, such as the one below. Items may appear one per line, in columns,
; whatever. Just be SURE to include the fact that "Q" will Quit the program,
; "A" means All sections. Use the following as a guide.


                   ==== QHELP Dummy File Run-Time Menu ====
                   =                                      =
                   =   Q - QUIT Program                   =
                   =   A - ALL SECTIONS of File           =
                   =                                      =
                   =   1 - Title of your First Section    =
                   =   2 - Title of Your Second Section   =
                   =   3 - Title of Your Third Section    =
                   =                                      =
                   ========================================
; The remainder of the file, except for any "comment" lines and tildes used
; to denote section ("chapter") separations, is entirely the text you want
; to provide users to read (and optionally print). A few of our own tips are
; included as comments (and text), which we suggest you take a moment to read.
;
~ (Section 1) 
;
; The above "Section 1" line of course won't display because its line begins
; with a section-separating tilde. Enter your first text at this point. Note
; that QHELP will properly provide top and bottom margins for each section 
; and its member pages or screens.
;
                           << FIRST TEXT SECTION >>

    This  is the first section of the sample QHELP text file.  Since  these 
    lines (like the line with "<< FIRST TEXT SECTION >>" and the blank line 
    following it--are NOT "comment lines" or lines beginning with  section-
    dividing  tildes)--they  will be displayed to screen  (or  printer,  if 
    PRINTOK has been enabled).

    If  you're  reading  this by browsing  through  supplied  files  BEFORE 
    reading the introductory material, you've missed a LOT of  information. 
    (And, this file, primarily composed of "hidden" comment lines to  serve 
    as a guide to preparing QHELP text files, will behave rather slowly.)

    Because  the first couple of sections are exceptionally short,  if  you 
    use the "Read All Sections" function in QHELP, you may see portions  of 
    more than one section on your screen at the same time. That mode simply 
    scrolls  one,  full screen at a time. The "Print  All  Sections"  mode, 
    however,  will begin a new page with each section. If you read or print 
    sections  INDIVIDUALLY,  of course you'll be offered one section  at  a 
    time. In all cases, as usual spacing is handled appropriately by QHELP.
;
; We recommend that you avoid ending sections with blank lines. Otherwise, 
; if a section happens to have slightly more lines than will format to fit 
; on its last screen (or printed page)--it happens often!--your readers will 
; be treated to a blank screen or page...not so professional!
;
~ (Section 2)
;
; We often add a section near the end of a QHELP text file something like the 
; following, if we want to encourage the end user to add notes. This is 
; particularly nice if your text file is a "how-to" manual.
;
                         << USER-ADDED INFORMATION >>

    After  using  this  manual, you may want to may  add  notes  and  other 
    information  here  yourself.  Begin  by   following  a  basic  computer 
    precaution of editing  ONLY  a back-up  copy  of this text file. A word 
    processor   capable   of   ASCII output must be  used.  (For  WordStar, 
    select "nondocument" rather than normal  "document" mode from its  main 
    menu when creating your  file. For  WordPerfect,  save the output  file 
    in "DOS" format.)  NOTE:  Be sure all text remains BELOW the line which 
    contains "<< USER-ADDED INFORMATION  >>" and  ABOVE the line  beginning 
    with a tilde. (The tilde doesn't display when running this program, but 
    will  appear  when using a word processor.) Failure  to   follow  these 
    precautions may cause adverse effects when this file is run later.
~ (Section 3)
                          << CREDITS & DISCLAIMER >>

    QHELP.EXE (QHELP.COM for some operating systems), MAINHELP.HLP and  all   
    accompanying  materials   (together referred to as "QHELP"  below)  are  
    copyright  (c)  1986-89, J.W. Olsen / Advocate Enterprises,  Ltd.,  all  
    rights reserved. By use  of  QHELP,  user  agrees  to  all  terms   and 
    conditions  within MAINHELP.HLP, which constitutes our full  agreement. 
    The  instant  file is solely a sample text file for  use  in  preparing 
    files for use by QHELP, and its terms and conditions in no event  shall 
    supersede  or  serve  to  change any of the  terms  and  conditions  in 
    MAINHELP.HLP.
    
    J.W. Olsen / Advocate Enterprises, Ltd. has taken due care in preparing 
    QHELP.  However,  no  expressed or implied  warranty  as  to  accuracy, 
    reliability or suitability for any specific purpose or use is  made. In 
    no event shall J.W. Olsen / Advocate Enterprises,  Ltd. be  liable  for  
    damages,    including   incidental   or    consequential  damages,   in 
    connection with or arising from furnishing, performance, support or use 
    of QHELP.

    You  agree not to distribute any registered (as opposed  to  shareware)  
    version  of  QHELP  without  the  expressed,  written permission of the  
    copyright holder.  Unregistered  users  of any version may not use them 
    for  financial  gain.  Others  may use them  AT ONE   SITE  or  BY  ONE 
    INDIVIDUAL,  but NOT BOTH (unless a corresponding additional  licensing 
    fee has been paid and authorization to more widely distribute QHELP has 
    been expressly provided in writing by the copyright holder). Subject to  
    the   other terms and conditions of use, users are authorized  to  make 
    sufficient  copies of registered copies of QHELP for normal use by  the 
    one individual or at the one site.

    Users  who have received a complimentary copy of the  registered  QHELP 
    may  not sell or otherwise transfer it to  another party.  Other  users 
    may  transfer  QHELP (original disks  only, in the case  of  registered 
    copies)  to  another  party, provided  such users  and  the  subsequent 
    owners  agree  to  all terms and conditions herein, and  in  all  cases 
    provided  all  QHELP  materials are transferred  together  and  without 
    alteration.  Further,  by sale of any copy of QHELP, seller  agrees  to 
    relinquish  any right to further possession, use or ownership  of  said 
    copy or any duplicates made of same.

    For   further  information  and  ordering  (including  bulk  rates   or 
    distributorships), see the QORDER program, or contact:

                    J.W. OLSEN / ADVOCATE ENTERPRISES, LTD.
                       899 S. Plymouth Court, Suite 504
                               Chicago, IL 60605
                             312/939-3300  (voice)
                312/939-4411 (24-hr. modem telecommunications)


    Credits:
    QHELP  and  MAINHELP.HLP  are  trademarks  of  J.W.  Olsen  /  Advocate 
    Enterprises, Ltd. 
;
; Add as many additional sections as desired here. Remember to set them off
; from each other with tildes and adjust the "TOO MANY SECTIONS" number in
; the header section, above.
;
; To avoid run-time errors, QHELP text files must end with a line 
; which 1) begins with a tilde, and 2) is ended by pressing RETURN.
; 
; Enjoy your use of QUICK HELP!
;
~ (Leave "TOO MANY SECTIONS" tilde at end of file, terminated with RETURN)
