home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / graphics / demos304.zip / DEMO.DOC < prev    next >
Text File  |  1993-03-26  |  13KB  |  286 lines
  1.                                 The DEMO System
  2.  
  3.                                  Wayne Software
  4.                                113 Sheffield St.
  5.                             Silver Spring, MD 20910
  6.  
  7.                      42 61 74 6D 61 6E 20 4C 69 76 65 73 21
  8.  
  9.                               Fax:  (301) 588-8986
  10.  
  11. This file is a miscellaneous grab-bag of textual information.  Sections:
  12.  
  13.     *   The various files included here
  14.     *   Think about the future!  Future plans to The DEMO System
  15.     *   Revision history
  16.  
  17. If you're desperately looking for the description of what The DEMO System is,
  18. read the DEMOSYS.DOC documentation.
  19.  
  20. --------------------------------------------------------------------------------
  21.  
  22.                         The various files included here
  23.  
  24. The DEMO System comes in a ZIP file with the following files:
  25.  
  26.   * DEMO.DOC:  This file.
  27.   * DEMOMAKE.EXE:  The DEMO System screen compiler.  Creates the self-viewing
  28.     demonstration screen.
  29.   * DEMOSYS.DOC:  Documentation on how to create and use control files used
  30.     by The DEMO System.
  31.   * DEMOSYS.REF:  Reference manual detailing every command in The DEMO System.
  32.     (Excludes documentation on the DEMOSAVE.EXE program.)
  33.  
  34.   * DEMODEMO.EXE: The DEMO System sampler, showing various features
  35.   * DEMODEMO.CTL: Control file used to create DEMODEMO.EXE.
  36.   * DEMOSCRS.EXE: TSR that saves screens in a file that can be processed by
  37.     the DEMOSCRX.EXE program.
  38.   * DEMOSCRS.DOC: Documentation for the DEMOSCRS.EXE program.
  39.   * DEMOSCRX.EXE: Program that takes screen files saved by DEMOSCRS.EXE TSR and
  40.     converts them into control files for The DEMO System or regular ANSI.SYS-
  41.     compatible files.
  42.   * DEMOSCRX.DOC: Documentation for the DEMOSCRX.DOC program.
  43.   * SAMPLES.ZIP:  Contains all sample control files in the tutorial.
  44.   * TSHOW.EXE: Free GIF viewer required by the DEMODEMO.EXE program.
  45.   * WAYNESOF.GIF: GIF file required by the DEMODEMO.EXE program.
  46.  
  47. Registered users get the following two extra files:
  48.  
  49.   * DEMOSAVE.DOC:  Documentation for the DEMOSAVE.EXE program (available to
  50.     registered users only).
  51.   * DEMOSAVE.EXE:  The DEMO System decompiler.  Available to registered users
  52.     only.
  53.  
  54.  
  55. --------------------------------------------------------------------------------
  56.  
  57.                             Think about the future!
  58.  
  59.  
  60. Well, I've been adding stuff like mad to The DEMO System.  Most of the
  61. enhancements I can't justify for real work-related reasons.  The previous
  62. version had enough features to allow me to write the menu program for the U.S.
  63. Department of Commerce's diskette version of Clinton's Economic Plan with it.
  64. (If you'd like to see that, call 1-800-647-6329  with a credit card and ask for
  65. the diskette.  It's $12 and you'll get it within a couple of days.) It also
  66. worked fine for the full-screen menu system for our compact disc product the
  67. National Trade Data Bank (1-202-482-1986, $35 for a double-disc issue).
  68.  
  69. The changes that came out with the current (DEMOS304.ZIP) version in part sprung
  70. from related work I had to do for the diskette as well as a waiting laundry list
  71. of features that couldn't be implemented until I had more symbol table space to
  72. play with.  I finally unwrapped VisualBASIC for DOS and suddenly I had space.
  73.  
  74. In any case, I (once again) plan to stop making revisions to this product and
  75. wait for it to generate some revenue.  (Do people actually pay for software?)
  76. I'd like to hold off on the next release until I get at least 10 paid
  77. registrations for the product.  I have no idea if that's a ridiculously high
  78. number or not but $500 would justify buying a CD-ROM drive and some other stuff
  79. so that sounds like a good number to me.  Still won't buy me a social life but
  80. hey...
  81.  
  82. This sounds a little like pledge week on PBS.
  83.  
  84. Anyway, I'd like to add the following:
  85.  
  86. * The ability to view screens that are longer than 25 lines.  These screens
  87.   would automatically support (UP), (DOWN), (HOME), (END), (PGUP), and (PGDN).
  88.   An additional VIEW command would be added for this function for label pages.
  89. * A more universal IF test with ELSE, multiple statements, etc.
  90. * Allow variable length cursor input lengths on a single screen.
  91. * Ability to display some user-defined pop-up menus.  For example, have someone
  92.   be able to establish a pull-down menu that, at any point, lets the user go
  93.   back to the start, end, turning sound on/off, etc.  This will make more sense
  94.   if it ever gets implemented!
  95.  
  96. * Other suggestions are welcome.  Registered users will get more consideration
  97.   of course.
  98.  
  99.  
  100.  
  101. --------------------------------------------------------------------------------
  102.  
  103.                                 Revision history
  104.  
  105. Release DEMOS304:
  106.  
  107. Much to my chagrin, I found I had uploaded an older infinite loop version of The
  108. DEMO System on one BBS as DEMOS303.ZIP.  I tried to put out a quickie fix
  109. (DEMOX303.ZIP) and then decided to just hold off and put out a more stable
  110. DEMOS304.ZIP release.  So DEMOS304 is the same as DEMOS303 with a few bugs fixed
  111. up.
  112.  
  113. -----------------
  114. Release DEMOS303:
  115.  
  116. Boy!  And I thought I did a lot of work to get DEMOS302 out!
  117.  
  118. Shifted the code from being compiled in QuickBASIC 4.5 to being compiled in
  119. VisualBASIC for DOS 1.0.  The result is a somewhat larger program that may
  120. run slower because VBDOS uses far strings for everything.  On the other hand,
  121. the number of features in the old version was pushing the QB limits so the
  122. shift was necessary.  In general, you won't see any GUI functions from VBDOS
  123. in this program; most of the standard functions don't have as much flexibility
  124. as The DEMO System already had.
  125.  
  126. Split environmental variables into three logical groups:
  127. * ^Uvar^:  User-defined variables.  Can be used in most places and can have
  128.   their values reassigned.  These are the variables that have to be on the
  129.   receiving end of an ASSIGN, PROMPT, or LOADLOGO statement.
  130. * %func%:  System-defined functions.  60+ functions have been added
  131.   to the system, replacing the 13 (previously) environmental variables and
  132.   four PROMPT patterns that used to be required for verification and display
  133.   purposes.  Functions all return a value.  The functions are documented in
  134.   the DEMOSYS.REF manual.
  135. * ^Evar^:  True DOS-defined environmental variables.  These can be displayed
  136.   and used on the sending end of an ASSIGN statement but they can't have their
  137.   value reassigned.
  138. This change required a whole mess of changes to the program and in control files
  139. themselves so be prepared to make some changes if you used ^Evar^ under the
  140. older versions.  The changes:
  141.         ^ECOL^            becomes %Col%
  142.         ^EDATE^           becomes %Date%
  143.         ^EDIR^            becomes %Dir%
  144.         ^EDISPLAY^        becomes %Display%
  145.         ^EDISPLAYN^       becomes %DisplayNum%
  146.         ^EETIME^          becomes %TimeElapsed%
  147.         ^EFIELD^          becomes %FieldNum%
  148.         ^EFDESC^          becomes %PageDesc%
  149.         ^EFNAME^          becomes %PageName%
  150.         ^EFSCR^           becomes %PageNum%
  151.         ^EINITDIR^        becomes %DriveDirOrig%
  152.         ^EROW^            becomes %Row%
  153.         ^ETIME^           becomes %Time%
  154.         ^E1^ to ^E9^      becomes %1% to %9%
  155.         FILESPEC pattern  becomes %FileValid%(s)
  156.         MM/DD/YY pattern  becomes %DateValid%(s)
  157.         PATH pattern      disappears
  158.         VFILESPEC pattern becomes %FileExist%(s)
  159.         VPATH pattern     becomes %PathExist%(s)
  160.  
  161. Added the ability to specify repetition factors in PROMPT patterns.  You can now
  162. specify the number of times to repeat the pattern character right before the
  163. character so "10X" translates as "XXXXXXXXXX".
  164.  
  165. Totally recoded the prompting module.  Previously, the PROMPT command syntax
  166. was:
  167.         PROMPT/PROMPTA ^Evar^ pattern prompt
  168. The new syntax is:
  169.         PROMPT/PROMPTA ^Uvar^ "pattern" [ LEN=n ] [ RANGE=n-n ] [ DEF=s ]
  170.            [ TEST=cond [rel cond] ] [ QUIT=key ] [ VQUIT=key ] [ HELP=key ]
  171.            [ COLOR=n ] [ REQ ] [ NOESCAPE ] [ QUIET | -QUIET ]
  172. Note that this is almost identical to the syntax being used in the new data
  173. entry form command "@".  Also note that the prompt itself now has to be issued
  174. as part of a prior ECHO/ECHOA statement.  The use of patterns like "MM/DD/YY"
  175. has been replaced by the new TEST parameter.  You can recode the following:
  176.         PROMPT ^Evar^ MM/DD/YY
  177.         PROMPT ^Evar^ FILESPEC
  178.         PROMPT ^Evar^ VFILESPEC
  179.         PROMPT ^Evar^ VPATH
  180. as (in order):
  181.         PROMPT ^Uvar^ "NN/NN/NN" TEST=%DateValid%(^Uvar^) <> 0
  182.         PROMPT ^Uvar^ "25!" TEST=%FileValid%(^Uvar^) <> (NULL)
  183.         PROMPT ^Uvar^ "25!" TEST=%FileExist%(^Uvar^) <> 0
  184.         PROMPT ^Uvar^ "25!" TEST=%PathExist%(^Uvar^) <> 0
  185.  
  186. Added a new data entry form command @.  Using this will turn your screen into a
  187. full-screen entry form (without mouse support unfortunately).
  188.  
  189. Added HOP and DROP commands.  The words are certainly unusual.  The logical ones
  190. like GOTO and POP were already in use so I couldn't use them to tell the system
  191. to branch somewhere.  And labels and colons already had some meaning so I
  192. couldn't use them as places where you'd end up.  Embarassingly, HOP and DROP
  193. comes from a Rick Springfield song that I personally detested but it kept coming
  194. back to me:  "Bop 'Til You Drop".  That title was probably based on "Shop 'til
  195. you drop".  In any case, in The DEMO System you now "HOP to a DROP"...  This
  196. lets you do looping.
  197.  
  198. Added an (admittedly primitive) IF statement.  You can now do (again, primitive)
  199. iterative loops and a mess of other things.
  200.  
  201. Added SET SETTINGS CLEAR which resets all SET statements to the system defaults.
  202.  
  203. Added MSGBOX and MSGBOXA action commands.
  204.  
  205. Added CLSA action command.
  206.  
  207. Added "- (GLOBALNC)" page reference which works like (GLOBAL) but doesn't clear
  208. the key assignments when it starts ("Global No Clear").  You can use SET KEYS
  209. CLEAR and SET SETTINGS CLEAR if you want.
  210.  
  211. Used Spectra Publishing's PowerBASIC 3.0 compiler to create the DEMOSCRS TSR
  212. program which is used in conjunction with new DEMOSCRX.EXE program to create
  213. control files for The DEMO System or regular ANSI.SYS-compatible files.
  214.  
  215. Now allow an optional "=" in ASSIGN commands: "ASSIGN ^UTest^ = Testing".
  216.  
  217. Changed PROMPT so it resets the colors after the user input.
  218.  
  219. Added the ability to pass multiple-word parameters into CALL, GOTO, and the
  220. DEMOMAKE program itself by enclosing the words in quotes.
  221.  
  222. Removed case sensitivity for most control codes and variable names.  Previously,
  223. the program wouldn't recognize a variable as "^etest^", it had to be "^Etest^".
  224.  
  225. Fixed up bug with FIELD @n command.
  226.  
  227. Added code to clear up temporary files when bad control cards are encountered.
  228. Previously, just left them around.
  229.  
  230. Fixed more errors in the documentation.  Added others of course.
  231.  
  232. A lot of internal restructuring went on this time.  Again.
  233.  
  234.  
  235. -----------------
  236. Release DEMOS302:
  237.  
  238. Added mouse support (SET MOUSE ON, SET MOUSE OFF, and SELECT action verb).
  239.  
  240. Previously, the ECHO and ECHOA commands removed leading spaces.  Stopped this.
  241.  
  242. Added SET BASE n command to allow you to specify the base color for a given
  243. screen.  Previously, all screens were done in color set 0.
  244.  
  245. Added /-OVERWRITE and /OVERASK parameters to DEMOMAKE.EXE.  Made the exename
  246. optional (defaults to the input file with an .EXE extension).  The /OVERxxx
  247. parameters are now CONFIGWS-able.
  248.  
  249. The ^EFNAME^ variable will now reflect the original name for *ref files;
  250. previously indicated ~DEMOINT.nnn.
  251.  
  252. Added ability to pass in parameters resolved as &P1 to &P9 during compilation
  253. time (not viewing time).  These can be used to change your program without
  254. editing the source files.
  255.  
  256. Added ability to specify the absolute field or screen by using of @1 to @999 in
  257. the FIELD command.
  258.  
  259. Added ability to turn off the "Wayne Software" copyright notice for registered
  260. users only.
  261.  
  262. Internally:  Lots of internal recoding, in part to prepare for other changes.
  263. Lots of other bug fixes too.
  264.  
  265. Made SCREEN and GOTO virtually synonymous.
  266.  
  267. Documentation:  Fixed up some typoes and worse in the documentation too (I kept
  268. talking about "SET KEY key" instead of "KEY key"; that was one of the last
  269. minute changes that didn't quite get worked into the brain).  Added a section on
  270. mouse support.
  271.  
  272. Samples:  Replaced BUGS.GIF with WAYNESOF.GIF.  The latter was created in
  273. Windows and includes a "drawing".  Artists have described drawing with a mouse
  274. to be like painting with a brick.  Wayne Software doesn't have any artists
  275. (any volunteers?) so don't expect much.  Renamed the DEMO4.* stuff to be
  276. DEMODEMO.* (the original name was a working title that never got changed).
  277.  
  278. Thanks:  Thanks to Thomas G. Hanlin III for comments and suggestions (and for
  279. PBClone of course).
  280.  
  281. -----------------
  282. Release DEMOS301:
  283.  
  284. First release.  Just glad it made it out the modem!
  285.  
  286.