home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / mag&info / showv10.zip / SHOW.DOC < prev   
Text File  |  1992-12-17  |  13KB  |  249 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.0 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 LPT1 Printer READY [y/n] -> y
  84.  
  85.    Version 1.0 assumes you are using LPT1 (parallel port address 3BCh).
  86.    However, if you are using LPT2 (parallel port address 378h), or
  87.    LPT3 (parallel port address 278h) this is no problem. SHOW will
  88.    allow you to toggle between these ports by repeatedly hitting the
  89.    PrtSc key. You will note the LPT# will appear to the extreme left
  90.    of the last (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 arrows to toggle through
  106.    your choices. As you toggle the up/dn arrow keys you will see the
  107.    screen change immediately. When you are satisfied with the selected
  108.    color, hit <Esc> and continue enjoying SHOW! There are 128 standard
  109.    choices plus 128 of the same in blinking format.
  110.  
  111.    NOTICE: You may save the new color as a DEFAULT by hitting the "s"
  112.    key AFTER changing colors and using the <Esc> key. Caution: the color
  113.    cloning (saving) feature will not operate if you rename the com
  114.    display file.
  115.  
  116.    The (G)o option request a line number to jump to. You can quickly
  117.    determine the total number of lines in your document by using the
  118.    <End> key after loading and reading the Line counter at the bottom
  119.    right. This feature can save a lot of time in scaning or jumping to
  120.    a particular place in a document.
  121.  
  122.    Tech Stuff: In order to not breach the 64k segment boundry of a dos
  123.    com file and still stuff more text into the wraparound display
  124.    driver, I have elected not to maintain a data array of line numbers
  125.    like most other similar utilities. Rather, SHOW reads line endings on
  126.    the fly, remembers its present position and calculates page and
  127.    line changes from that reference. This saves two bytes per line in
  128.    terms of overall file size and allows you to get over 62k of text
  129.    into the driver. This could be particularly useful for files with
  130.    short lines. On the other hand, there is another limit imposed by the
  131.    use of unsigned word integers as a line count variable, you are
  132.    limited to no more than 64k lines. But, I somehow doubt this will be
  133.    a problem either.
  134.  
  135.    For programmers, I will license the assembly source code for a very
  136.    reasonable fee. Call, write or E-Mail for more details. One fellow
  137.    wanted $500 for his source. By comparison, mine is practically free
  138.    and reasonably commented throughout. Show was written for Isaacson's
  139.    A86 Assembler.
  140.  
  141.    ====================================================================
  142.    V1.0  First release.......................................
  143.    ====================================================================
  144.  
  145.                            ┌─────────┐
  146.                            │ MEMBER  │   Society of
  147.                            │  ┌──────┴──┐ Independent
  148.                            │  │         │   Shareware
  149.                            └──┤    ■    │     Authors
  150.                               │    ║    │
  151.                               └────╨────┘
  152.     This program is produced by a member of the Society of Independent
  153.     Shareware Authors (SISA). The Society wants to ensure that all
  154.     valid shareware principle actually work for you and SISA members.
  155.     The principle behind shareware distribution is simple; try before
  156.     you buy. Society members agree to license all shareware for a minimum
  157.     of 10 days, free of charge, to first time users as an evaluation period.
  158.     After 10 days, buyers are then obligated to license their copy with
  159.     the Society member. Society members are obligated to provide high
  160.     quality, useful shareware, but, are free to choose whatever marketing
  161.     methods suit their specific needs. SISA sanctioned marketing methods
  162.     include: demonstration versions; providing printed documentation
  163.     after purchase; registration keys that unlock additional features
  164.     not necessary to determine basic usefulness; and, providing bug
  165.     fixes free of charge. Any Shareware author may become a member of
  166.     SISA without cost by simply agreeing to the above conditions and
  167.     displaying, at their option, this logo in their documentation.
  168.    ====================================================================
  169.  
  170.     WARRANTY:
  171.     Software:
  172.     Simple Software warrants that the software contained herein will
  173.     perform in substantial compliance with the documentation
  174.     accompanying the software. If you report, in writing, a significant
  175.     defect to us, and we are unable to correct it within 90 days of the
  176.     date you report the defect, you may return the software and
  177.     accompanying materials, and we will refund the purchase price.
  178.  
  179.     Diskette's and Documentation:
  180.     Simple Software, warrants all diskette's and documentation to be
  181.     free of defects in materials for a period of 30 days from the date
  182.     of purchase. In the event of notification within the warranty period
  183.     of defects in any materials, Simple Software will replace the
  184.     defective diskette or documentation.
  185.  
  186.     Remedies:
  187.     The remedy for breach of the warranty shall be limited to
  188.     replacement and shall not encompass any other damages, including but
  189.     not limited to loss of profit, special, incidental, consequential,
  190.     or similar damages, losses, or claims.
  191.  
  192.     DISCLAIMER:
  193.     Simple Software specifically disclaims all other warranties,
  194.     expressed or implied, including but not limited to, implied
  195.     warranties of merchantability and fitness for a particular purpose
  196.     with respect to defects in the diskette and documentation, and the
  197.     program license granted herein, in particular, and without limiting
  198.     operation of the program license with respect to any particular
  199.     application, use, or purpose.  In no event shall Simple Software be
  200.     liable for any loss of profit or any other commercial damage,
  201.     including but not limited to special, incidental, consequential or
  202.     other damages.
  203.  
  204.     GOVERNING LAW:
  205.     This statement shall be construed, interpreted, and governed by the
  206.     laws of the State of Louisiana.
  207.     ====================================================================
  208.  
  209.    Registering your copy will help continue the competitive advantages
  210.    of providing economical shareware. Upon receipt of your payment I
  211.    will provide you with a copy of the latest version and notify you
  212.    of all future upgrades. Your patronage is appreciated.
  213.  
  214.    Our no nonsense license:
  215.    ------------------------
  216.    Your one time registration fee will license you to use SHOW to
  217.    package text files in ANY quantity for private, shareware or
  218.    commercial sales distribution.
  219.  
  220.    Re distribution via electronic transmission, or downloading, is
  221.    allowed without furthur permission. Re distribution of the Shareware
  222.    version of SHOW, for a fee, is also allowed without furthur
  223.    permission as long as that cost is limited to no more than two
  224.    dollars per copy, if supplied on any physical disk media.
  225.  
  226.    Yes Gary, I can really make use of your program and would like to
  227.    register and obtain the latest version as well as get on your mailing
  228.    list for future upgrades and new releases!
  229.  
  230.    Product: SHOWV10.EXE
  231.  
  232.    Name_____________________________________________________________
  233.  
  234.    Mailing Address__________________________________________________
  235.  
  236.    City & State ___________________________________________________
  237.  
  238.    ZIP _____________________________ Phone _________________________
  239.  
  240.    Send $4 + $1 (ship & hand) check or money order to:
  241.  
  242.                               Gary M. Raymond
  243.                                 P.O.Box 8184
  244.                             New Orleans, La. 70182
  245.                                 504-288-6550
  246.                             Compuserve 70613,3165
  247.    ====================================================================
  248.                                      EOF
  249.