home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / s / showv14.zip / SHOW.DOC < prev    next >
Text File  |  1993-01-10  |  15KB  |  280 lines
  1.    Slickware is Copy(c)right 1989,1992 by Gary M. Raymond, New Orleans, La.
  2.       Show TEXT Converter (Text to COM) Program V1.4 by Gary M. Raymond
  3.  
  4.                           Simple <Software> Company
  5.                               HOME of SlickWare
  6.  
  7.                               Gary M. Raymond
  8.                                 P.O.Box 8184
  9.                            New Orleans, La.  70182
  10.                                (504) 288-6550
  11.                             Compuserve 70613,3165
  12.  
  13.    ====================================================================
  14.  
  15.    Files Provided:
  16.    SHOW.COM      SHOW Engine used to convert text (ascii) files to COM
  17.    SHOW.DOC      This document.
  18.    README.COM    This document encased by SHOW engine
  19.    REGISTER.COM  Order form
  20.  
  21.    System requirements: PC/XT/AT, DOS 2.1 up, 128k ram up, floppy or
  22.    hard drive, mono or color, any type graphic adapter. Printer optional.
  23.  
  24.    ====================================================================
  25.  
  26.    Why SHOW?  Recently I had need to immediately supply a customer with
  27.    some rather lengthy written instructions. He was in another city, the
  28.    document was over twenty pages, and faxing seemed to be my only
  29.    option. An assistant suggested I use one of a couple of simple
  30.    utilities circulating on the BBS'es that convert text files to self
  31.    displaying executable com files and upload it directly to his home
  32.    computer. This sounded like the perfect solution. It was, and it
  33.    worked. The advantages were obvious. The customer could read the text
  34.    directly on his computer monitor by simple typing the name of the
  35.    text at the dos prompt. The customer did not have to know beans about
  36.    the dos TYPE command, piping, the MORE utility, redirection codes, or
  37.    anything.....and, he didn't! The best part was that the self
  38.    displaying text also had scroll control, with up and down line
  39.    control, pgup and pgdn, along with home and end.
  40.  
  41.    Unfortunately, the utility we used required some sophistication on
  42.    the part of a user involving embedding control characters in his text
  43.    file for color changes etc. I therefore decided to write a more user
  44.    friendly, novice oriented utility, thus SHOW was born. SHOW was
  45.    written in assembler to optimize both speed and utility file size.
  46.    Isaacson's A86 compiler was chosen for power yet ultra simplicity.
  47.  
  48.    To use SHOW, you need only tell it what text file to convert and
  49.    the name of the output com file you desire. (which can be the same
  50.    name as the input file. You have an additional option of giving
  51.    it a third string parameter which will appear as a header on the
  52.    top line of the display window.
  53.  
  54.    Example:
  55.            1st       2nd    3rd parameter
  56.    C:>SHOW INPUT.TXT OUTEXT "Synopsis of board meeting - 2/23/92"
  57.  
  58.    Remember, the 3rd parameter is optional (as are the quotes) and
  59.    notice that a space must delimit (seperate) each parameter. Since
  60.    ascii text files have extensions that generally vary from
  61.    (.ASC),(.TXT),(.DOC), (.BAS),(.PAS), etc,etc, you must provide the
  62.    correct extension for the 1st parameter or input file (assuming it
  63.    has an extension, and it does NOT have to have one!) The output file
  64.    name.extension will always default to .COM if you do not supply it.
  65.  
  66.  
  67.    SHOW incorporates a few features not found in some of the other text
  68.    converters on the market. It is also fairly intuitive to use,
  69.    displaying its entire set of menu choices at the bottom of the screen
  70.    on line 25.
  71.  
  72.    Example:
  73.   <Esc> (W)rite (G)o (C)olor/(S) (P)rint, Home-End-ArUp-ArDn-PgUp-PgDn,  Ln =00
  74.  
  75.    You may <exit to dos> anytime by using the Escape key. The Line counter
  76.    at the far right of the menu bar, always indicates the position of the
  77.    very top line. Hence, if you hit <End> and see 975, there are actually
  78.    998 lines (975 plus 23) in the file.
  79.  
  80.    You can quickly and easily print the document to your line printer by
  81.    selecting (P)rint from the menu.
  82.  
  83.    Prompt> Is Line Printer READY [y/n] -> y
  84.  
  85.    SHOW assumes you are using LPT1 (parallel port address 3BCh).
  86.    However, if you are using LPT2 (parallel port address 378h), or LPT3
  87.    (parallel port address 278h) this is no problem. SHOW will allow you
  88.    to toggle between these ports by repeatedly hitting the Insert key.
  89.    You will note the LPT# will appear to the extreme left of the last
  90.    (25th) line on standard displays.
  91.  
  92.    You can also (W)rite the document back into a standard ascii text
  93.    file if desired. After hitting "w" you will be prompted for a standard
  94.    dos file name or handle.
  95.  
  96.    Prompt> Enter filename to save as   -> minutes.doc
  97.  
  98.    Please observe not to exceed the dos convention of 8.3        8x3
  99.    (eight.three characters allowed for dos files. (Examp: TEXTFILE.DOC)
  100.  
  101.    The display screen will have a pleasant default background color of
  102.    cyan with black lettering. The top border and bottom menu line will
  103.    be blue with white lettering. The (C)olor option allows you to change
  104.    (on the fly), the body color of the document. After hitting the
  105.    letter "c", immediately use the up and down arrow keys to toggle
  106.    through the 255 choices. As you toggle the up/dn arrow keys you will
  107.    see the screen change immediately. When you are satisfied with the
  108.    selected colors, hit <Esc> and continue enjoying SHOW! There are 128
  109.    standard choices plus 128 of the same in blinking format.
  110.  
  111.    Beginning with Version 1.3, the PgUp - PgDn keys are also active
  112.    (along with the Arrow keys) and will toggle the background color for
  113.    immediate rotation to the next background color.
  114.  
  115.    NOTICE: You may save the new color as a DEFAULT by hitting the "s"
  116.    key AFTER changing the color and hitting <Esc>. Caution: the color
  117.    cloning (saving) feature will not operate if you rename the new COM
  118.    text display file.
  119.  
  120.    The (G)o option request a line number to jump to. You can quickly
  121.    determine the total number of lines in your document by using the
  122.    <End> key after loading and reading the Line counter at the bottom
  123.    right. This feature can save a lot of time in scaning or jumping to
  124.    a particular place in a document.
  125.  
  126.    TECH STUFF:
  127.    -------------------------------------------------------------------
  128.    In order to not breach the 64k segment boundry of a dos com file and
  129.    still stuff more text into the wraparound display driver, I have
  130.    elected not to maintain a data array of line numbers like most other
  131.    similar utilities. Rather, SHOW reads line endings on the fly,
  132.    remembers its present position and calculates page and line changes
  133.    from that reference. This saves two bytes per line in terms of
  134.    overall file size and allows you to get over 62k of text into the
  135.    driver. This could be particularly useful for files with short lines.
  136.    On the other hand, there is another limit imposed by the use of
  137.    unsigned word integers as a line count variable, you are limited to
  138.    no more than 64k lines. But, I somehow doubt this will be a problem
  139.    either.
  140.  
  141.    The color atribute is determined by a single byte that can represent
  142.    an integer from 0 to 255. There are eight basic background colors;
  143.    black, blue, green, cyan, red, magenta (purple), brown and white.
  144.    Each background color may have any one of the eight basic colors,
  145.    plus eight more of the same basic colors in lighter or brighter hues,
  146.    as a forground color. So 8x16 = 128 choices of normal color
  147.    combinations plus another 8x16 (128) of equivalent blinking choices.
  148.    Therefore 128 + 128 = 256 choices (0 thru 255). The toggle simply
  149.    increments or decrements the byte starting with decimal 048 (the
  150.    value for producing cyan background with black forground).
  151.    -------------------------------------------------------------------
  152.  
  153.    For programmers, I will license the assembly source code for a very
  154.    reasonable fee. Call, write or E-Mail for more details. One fellow
  155.    wanted $500 for his source. By comparison, mine is practically free
  156.    and reasonably commented throughout. Show was written for Isaacson's
  157.    A86 Assembler.
  158.  
  159.    ====================================================================
  160.    V1.4  Minor cosmetic changes to some menu prompts. Fixed bug on PgUp
  161.          that caused lockup if first line of text was empty. Fixed bug
  162.          that improperly set line 25 Menu when text less than 23 lines.
  163.          Changed the Printer Port Toggle key from PrnSc to Insert.
  164.    ====================================================================
  165.    V1.3  Added an error message if input text file not found. Added
  166.          PgUp & PgDn in addition to Arrow Up,Dn for faster color changes.
  167.    ====================================================================
  168.    V1.2b Replace bios screen writes with direct video to speed up display
  169.          time on old, slower CPU's.
  170.    ====================================================================
  171.    V1.1  12/19/92 Maintenance, reworked all functions, saved a few bytes.
  172.    ====================================================================
  173.    V1.0  12/15/92 First release.......................................
  174.    ====================================================================
  175.  
  176.                            ┌─────────┐
  177.                            │ MEMBER  │   Society of
  178.                            │  ┌──────┴──┐ Independent
  179.                            │  │         │   Shareware
  180.                            └──┤    ■    │     Authors
  181.                               │    ║    │
  182.                               └────╨────┘
  183.     This program is produced by a member of the Society of Independent
  184.     Shareware Authors (SISA). The Society wants to ensure that all
  185.     valid shareware principle actually work for you and SISA members.
  186.     The principle behind shareware distribution is simple; try before
  187.     you buy. Society members agree to license all shareware for a minimum
  188.     of 10 days, free of charge, to first time users as an evaluation period.
  189.     After 10 days, buyers are then obligated to license their copy with
  190.     the Society member. Society members are obligated to provide high
  191.     quality, useful shareware, but, are free to choose whatever marketing
  192.     methods suit their specific needs. SISA sanctioned marketing methods
  193.     include: demonstration versions; providing printed documentation
  194.     after purchase; registration keys that unlock additional features
  195.     not necessary to determine basic usefulness; and, providing bug
  196.     fixes free of charge. Any Shareware author may become a member of
  197.     SISA without cost by simply agreeing to the above conditions and
  198.     displaying, at their option, this logo in their documentation.
  199.    ====================================================================
  200.  
  201.     WARRANTY:
  202.     Software:
  203.     Simple Software warrants that the software contained herein will
  204.     perform in substantial compliance with the documentation
  205.     accompanying the software. If you report, in writing, a significant
  206.     defect to us, and we are unable to correct it within 90 days of the
  207.     date you report the defect, you may return the software and
  208.     accompanying materials, and we will refund the purchase price.
  209.  
  210.     Diskette's and Documentation:
  211.     Simple Software, warrants all diskette's and documentation to be
  212.     free of defects in materials for a period of 30 days from the date
  213.     of purchase. In the event of notification within the warranty period
  214.     of defects in any materials, Simple Software will replace the
  215.     defective diskette or documentation.
  216.  
  217.     Remedies:
  218.     The remedy for breach of the warranty shall be limited to
  219.     replacement and shall not encompass any other damages, including but
  220.     not limited to loss of profit, special, incidental, consequential,
  221.     or similar damages, losses, or claims.
  222.  
  223.     DISCLAIMER:
  224.     Simple Software specifically disclaims all other warranties,
  225.     expressed or implied, including but not limited to, implied
  226.     warranties of merchantability and fitness for a particular purpose
  227.     with respect to defects in the diskette and documentation, and the
  228.     program license granted herein, in particular, and without limiting
  229.     operation of the program license with respect to any particular
  230.     application, use, or purpose.  In no event shall Simple Software be
  231.     liable for any loss of profit or any other commercial damage,
  232.     including but not limited to special, incidental, consequential or
  233.     other damages.
  234.  
  235.     GOVERNING LAW:
  236.     This statement shall be construed, interpreted, and governed by the
  237.     laws of the State of Louisiana.
  238.     ====================================================================
  239.  
  240.    Registering your copy will help continue the competitive advantages
  241.    of providing economical shareware. Upon receipt of your payment I
  242.    will provide you with a copy of the latest version and notify you
  243.    of all future upgrades. Your patronage is appreciated.
  244.  
  245.    Our no nonsense license:
  246.    ------------------------
  247.    Your one time registration fee will license you to use SHOW to
  248.    package text files in ANY quantity for private, shareware or
  249.    commercial sales distribution.
  250.  
  251.    Re distribution via electronic transmission, or downloading, is
  252.    allowed without furthur permission. Re distribution of the Shareware
  253.    version of SHOW, for a fee, is also allowed without furthur
  254.    permission as long as that cost is limited to no more than two
  255.    dollars per copy, if supplied on any physical disk media.
  256.  
  257.    Yes Gary, I can really make use of your program and would like to
  258.    register and obtain the latest version as well as get on your mailing
  259.    list for future upgrades and new releases!
  260.  
  261.    Product: SHOWV14.EXE
  262.  
  263.    Name_____________________________________________________________
  264.  
  265.    Mailing Address__________________________________________________
  266.  
  267.    City & State ___________________________________________________
  268.  
  269.    ZIP _____________________________ Phone _________________________
  270.  
  271.    Send $4 + $1 (ship & hand) check or money order to:
  272.  
  273.                               Gary M. Raymond
  274.                                 P.O.Box 8184
  275.                             New Orleans, La. 70182
  276.                                 504-288-6550
  277.                             Compuserve 70613,3165
  278.    ====================================================================
  279.                                      EOF
  280.