home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / packet / gil101 / gil.doc < prev    next >
Text File  |  1991-04-02  |  6KB  |  170 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                   GIL (c)
  18.  
  19.                         GRAPHICS INTERCHANGE LANGUAGE
  20.  
  21.                                  Version 1.01
  22.  
  23.                            A Public Domain Program
  24.  
  25.                    Copyright (c) 1991 by Glenn L. Williams
  26.  
  27.  
  28.                      Protected by Federal Copyright Law.
  29.          Permission granted for non-commercial use and distribution.
  30.         Not to be used for commercial advantage.  All rights reserved.
  31.  
  32.  
  33.  
  34.                This document contains five (5) pages.
  35.  
  36.  
  37.      Disclaimer
  38.      ----------
  39.  
  40. The author shall have no liability or responsibility to user or any other
  41. person or entity with respect to any loss or damage caused or alleged to be
  42. caused directly or indirectly through the use of this documentation or the GIL
  43. program.
  44.  
  45.  
  46.      Distribution and Use of GIL
  47.      ---------------------------
  48.  
  49. GIL is a copyrighted program.  All rights are retained by the author.
  50. GIL is not to be sold; nor is it to be used for commercial purposes.  You
  51. may freely distribute GIL, and you are encouraged to do so, but you may
  52. not charge for doing so.  The following files should be included in any
  53. distribution:
  54.                                  GIL.EXE
  55.                                  GIL.DOC
  56.                                  GILMAIN.DOC
  57.                                  PENG.GIL
  58.                                  QSL.GIL
  59.  
  60. 1. Purpose
  61. ----------
  62.  
  63. The primary purpose behind GIL is to permit a convenient way for radio 
  64. amateurs to send more than just ASCII text messages over the packet or RTTY 
  65. radio links.   Up until GIL was written, amateurs had no way to transmit
  66. reasonably small "files" containing enough information to reconstruct a good
  67. line drawing or cartoon, over the radio.
  68.  
  69.  
  70.  
  71.  
  72.  
  73. 2. Starting GIL
  74. --------------------
  75.  
  76. If you have not already done so, please make a working copy of all GIL 
  77. disk files and store away the disk on which you received GIL for safekeeping,
  78. and use the working copy when you want to run GIL.  You may write protect
  79. the working copy because GIL will not usually write to the disk. (This applies
  80. to version 1.0 only. In the future releases the usage of the disk may change.)
  81.  
  82.  
  83.      Your working disk should contain the following files:
  84.  
  85.           GIL.EXE   (The GIL executable program)
  86.  
  87. and several other  .GIL format files for your enjoyment.
  88.  
  89.  
  90. 2.1  Interactive startup
  91. ------------------------
  92.  
  93. To run GIL in interactive mode, the following command syntax is used:
  94.  
  95. Start from your DOS prompt with the command:
  96.  
  97.     GIL
  98.  
  99. and when you receive the "GIL>" prompt, then type in your ASCII commands. As
  100. each command is typed it will be listed on the screen, and then executed when
  101. you type the ENTER key.  Just above the command line your most recent command
  102. is listed, and just below the command line (in some cases) are error messages.
  103. When you are done and wish to go back to DOS, use the ".bye" command to exit.
  104.  
  105.  
  106. 2.2  Non-interactive startup
  107. ----------------------------
  108.  
  109. For straight ASCII file input, GIL accepts input from "stdin" redirection,
  110. as follows:
  111.  
  112.     GIL  <[drive:][path][filename]
  113.          ^
  114.          |......note this "<" character used for stdin input redirection.
  115.  
  116. At the end of the drawing process, when you are done viewing the drawing,
  117. striking any key will clear the screen and return you to DOS.
  118.  
  119. If you have a TSR utility such as GRAPHICS.COM (usually supplied with your
  120. DOS for CGA adapters), or EGAPRTSC.COM (for EGA adapters)  you can also print
  121. the screen to an IBM or EPSON dot matrix printer, for obtaining a hard copy. 
  122. That is, any TSR screen capture utility or printer utility capable of can
  123. "grab" the screen and "live" as a TSR (Terminate and Stay Resident) utility in
  124. your computer, can print the screen. However, at this time, the author has not
  125. had the time and resources to test all the TSRs's out there for compatibility
  126. with GIL. Nor is it expected at this time for GIL to cooperate with Microsoft
  127. Windows (TM) in any way other than as a "DOS" program. But since GIL interacts
  128. with your video card, it may or may not have a deleterious effect when
  129. operated under programs that use screen graphics as part of a "windows" or
  130. "shell" environment.
  131.  
  132. WARNING: GIL will interact with your screen graphics adapter. As a result
  133. it may "trash" anything else on the screen.  GIL has not been tested with
  134. all the graphics adapters in the world, and especially not with the monochrome
  135. versions of CGA, EGA, and VGA.  The graphics routines are supported via the
  136. Microsoft Corporation "C" library for Quick-C 2.5 (TM) and any artifacts
  137. created by the standard library are not the fault of this author.
  138.  
  139.  
  140. 3.0  Neutral format "GIL" files
  141. -------------------------------
  142.  
  143. Since they are ASCII files, the .GIL type neutral files can be exchanged,
  144. sent to PBBS systems, E-Mailed, etc. to other users.  Once the user has a copy
  145. of GIL.EXE, he/she can view the "drawings" and obtain hardcopies as described
  146. below.
  147.  
  148. It is the author's original intended purpose for amateur radio operators to
  149. freely exchange copies of GIL.EXE and any associated .GIL type neutral files.
  150. GIL.EXE should be exchanged via telephone modem or floppy disk ("Nike Net")
  151. exchange.
  152.  
  153. The ASCII .GIL type neutral files are intended for exchange via packet radio
  154. worldwide.  These files carry the information for making a drawing, but being
  155. ASCII, they contain no information of an encrypted nature which would violate
  156. national or international regulations about exchanging encrypted information
  157. via amateur radio.  Since these files are (usually) short, they will not "hog"
  158. precious radio bandwidth.
  159.  
  160. This utility is being provided free of charge for the main benefit of
  161. amateur radio operators worldwide. In the U.S.A. amateur radio is a hobby
  162. that is infinitely enjoyable for young and old.  We "hams" cannot receive
  163. a profit from anything we do in amateur radio, therefore, this program is
  164. freely available and the author expects no profit from it.  For this reason,
  165. this program and the .GIL file technique are NEVER to be used as a source
  166. of income by any individual or corporation.  The copyrights are not
  167. transferable.  However, this software may be sold on floppy disk by vendors
  168. of freeware and shareware where the floppy disks are sold for no more than
  169. $5.00 each via mail order or at fleamarkets and hamfests.
  170.