home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / tos_pm10.zip / readme.txt < prev    next >
Text File  |  1995-11-23  |  16KB  |  332 lines

  1.                  ┌────────────────────────────────────┐
  2.                  │   STAR TREK: The Original Series   │
  3.                  │    Automated Episode Guide v1.0    │
  4.                  │       32 bit OS/2 PM Version       │
  5.                  └────────────────────────────────────┘
  6.  
  7.                       ┌──────────────────────────┐
  8.                       │  What This Program Does  │
  9.                       └──────────────────────────┘
  10.  
  11. This is a full-featured OS/2 PM program that makes it easy to view info
  12. on the original STAR TREK TV series (plus the Star Trek cartoon & movies).
  13.  
  14.  
  15.                      ┌───────────────────────────┐
  16.                      │  How To Run This Program  │
  17.                      └───────────────────────────┘
  18.  
  19. There are two ways to run this OS/2 PM A.E.G. (Both of these methods
  20. assume that you have already unarchived the .ZIP file into a directory
  21. somewhere on your hard drive):
  22.  
  23. USING THE PM A.E.G. FROM AN OS/2 COMMAND LINE SESSION:
  24. ------------------------------------------------------
  25. Simply, CD to the directory that the OS/2 PM A.E.G. .EXE file resides.
  26. Type the filename of the executable file and the PM program window should
  27. appear on your desktop. See the "How To Use This Program" section for
  28. details on maneuvering around the program.
  29.  
  30. USING THE PM A.E.G. FROM AN OBJECT ON YOUR DESKTOP:
  31. ---------------------------------------------------
  32. Create a permanent directory somewhere on your hard drive for the PM A.E.G.
  33. Move the contents of the .ZIP file into this permanent directory (the .EXE
  34. file & the aeg_inst.cmd are the only "required" files, you can delete the
  35. file_id.diz & readme.txt if you want to. But, please read the shareware
  36. notice in this readme.txt before deleting!).
  37.  
  38. From an OS/2 command line session (full screen or window) run the REXX
  39. script named aeg_inst.cmd. It will create a desktop object for the PM A.E.G.
  40. After this desktop object is created, you can move it anywhere you want to
  41. (into a folder, onto your LaunchPad, etc.) Double click on the PM A.E.G.
  42. icon to run the program.
  43.  
  44.                      ┌───────────────────────────┐
  45.                      │  How To Use This Program  │
  46.                      └───────────────────────────┘
  47.  
  48. When you first run the A.E.G., a large PM window will appear on your screen.
  49. It will have the title and version of the A.E.G. on the top border and three
  50. menu titles directly underneath.
  51.  
  52. You choose options from the three menus on the menu bar in order to display
  53. the various information contained in the A.E.G. The four menus are EXIT,
  54. EPISODES and HELP. Each of these will contain at least one option underneath
  55. (but probably more than one). Here's a rundown of each of the three menu
  56. titles and the options that may appear beneath (I have paraphrased some
  57. menu options because they may be different depending on the specific A.E.G.
  58. that you're running):
  59.  
  60.  ------------------------------------------------------
  61.   Exit              Episodes       Help
  62.  ------------------------------------------------------
  63.  | Exit      F9 |  | Season 1 >|  | Useless Help    F1|
  64.  +--------------+  | Season 2 >|  | About Program   F2|
  65.                    | Season 3 >|  | Shareware       F3|
  66.                    +-----------+  | Disclaimer      F4|
  67.                                   | Other SBI Prgs  F6|
  68.                                   +-------------------+
  69.  
  70. You will notice a couple of things (that I can't recreate here because this
  71. is a plain ASCII text file). First, each menu option has *ONE* character
  72. UNDERLINED. This is the KEYBOARD SHORTCUT for that given menu option (See
  73. the section that follows about Keyboard Shortcuts). Second, the MENU OPTIONS
  74. on the EPISODES drop down menu have little arrows pointing to the RIGHT of
  75. each option (I used the > character to represent them on the above diagram).
  76. These arrows mean that each option has ANOTHER sub-menu. You can cascade these
  77. sub-menus by highlighting the menu option (it will automatically pop up to
  78. the right of the drop down menu that you are currently using). You can then
  79. move your mouse to the right in order to highlight the various options on that
  80. sub-menu. Be sure to hold down the left mouse button until you are on the
  81. sub-menu option that you want to choose! It takes a bit of dexterity on the
  82. longer sub-menus. If that's too hard, read the section that follows on using
  83. Keyboard Shortcuts.
  84.  
  85. MENU OPTIONS:
  86. To choose things off any of the three drop down menus, you simply move your
  87. mouse down until the "3D sunken highlight" is over the option that you want.
  88.  
  89. Here is a list of the "general" options that will appear on most of the
  90. A.E.G. program drop down menus.
  91.  
  92. ----------------
  93.  Exit
  94. ----------------
  95. | Exit      F9 | <---   This option quits & exits the A.E.G.
  96. +--------------+        (Note: the F9 function key can be used to exit the
  97.                         program at any time).
  98. -------------
  99.  Episodes
  100. -------------
  101. | Season 1 >|    <---   These menu options will pop up a sub-menu to the
  102. | Season 2 >|    <---   right of each option (notice the little arrow).
  103. | Season 3 >|    <---   On the pop up sub-menu will be a list of the various
  104. +-----------+    <---   episodes of the TV show for that given season.
  105.  
  106.  
  107. ----------------------
  108.  Help
  109. ----------------------
  110. | Useless Help    F1|<-- This will pop up a reminder on how to use the A.E.G.
  111. | About Program   F2|<-- Displays the title, version & programmer of the A.E.G.
  112. | Shareware       F3|<-- A shareware reminder.
  113. | Disclaimer      F4|<-- A disclaimer about the information in the A.E.G.
  114. | Other SBI Prgs  F6|<-- A list of other Snake-Byte programs.
  115. +-------------------+    (Note: the F1 - F6 function keys can used at any
  116.                          time to execute the various menu options).
  117.  
  118. KEYBOARD SHORTCUTS:
  119. Each option on each menu (and the three menu titles on the menu bar) have
  120. *ONE* character UNDERLINED. This represents the keyboard shortcut for THAT
  121. given menu option. Most people prefer to use their mouse pointer to click
  122. on the option, but these keyboard shortcuts perform the same actions as
  123. the mouse. The way to "activate" the keyboard shortcut is to press the
  124. <ALT> key on your keyboard (it should be a small key on either side of
  125. your <SPACE BAR>). When you press the <ALT> key, you will notice that the
  126. first menu title on the menu bar is highlighted in "3D sunken highlight".
  127. This means that the option that is highlighted is now activated and can
  128. be chosen by pressing your <ENTER> key. For example, if you hit <ALT> and
  129. the EXIT menu title is highlighted on the menu bar, if you were to hit
  130. <ENTER> the menu beneath the EXIT title will drop down. You can use your
  131. cursor arrow keys to move the reversed/highlighted area back and forth on
  132. the menu bar (or up and down within a drop down menu).
  133.  
  134. To pick the second episode of the first season of a show in an A.E.G., use
  135. these keystrokes (in order & don't hold any key down during the process):
  136.  
  137. <ALT> E 1 2
  138.  
  139. ACCELERATOR KEYS:
  140. You will also notice that certain items on some of the menus may have an
  141. "F Key" on the far right of a given menu option (F1 on the Help option or
  142. F9 on the Exit option). These are "accelerator" keys that can be used as
  143. an alternative to the above methods of executing menu options. Note: they
  144. can be used at anytime while the program is running.
  145.  
  146.  
  147.            ┌───────────────────────────────────────────────┐
  148.            │  The Harsh Reality of Trickle Down Economics  │
  149.            └───────────────────────────────────────────────┘
  150.  
  151. This program took a lot of hard work to produce (Several weeks of honing
  152. the OS/2 PM code and a week of entering the data and debugging and proof
  153. reading the output). This all resulted in over #### lines of C/C++ code!)
  154.  
  155. And, unfortunately, nothing in life is free. But this nifty little
  156. program almost is! That's right -- you can clear your conscience and
  157. assure that there'll be future updates to this program (as well as
  158. other neato-frito programs from Snake-Byte Inc.) for the ridiculously
  159. reasonable, almost-FREE sum of $5.00. How can we afford to let this
  160. rare jewel of a program go for the piddly little amount of $5.00?!?!
  161.  
  162. Because, here at Snake-Byte Inc., we deal in VOLUME! VOLUME!! VOLUME!!!
  163. We'll eat a bug to make a sale! Come on down to our Midnight Madness
  164. sale and...Wait a minute. Wrong sales pitch. Sorry. Anyway, you get the
  165. picture. <Insert normal shareware begging/pleading/demanding here>.
  166.  
  167. What do you get for your $5.00? That warm-tummy feeling of satisfaction
  168. knowing you did the RIGHT thing. This program is in no way "Crippled". I
  169. detest "CrippleWare" and decided early on that I wouldn't do that kind
  170. of thing. So, there's no "registered version". What you have now is the
  171. fully-functional program. It contains one little shareware notice option
  172. on the Help menu (that you don't even have to look at if you don't want
  173. to) and it shows that "nag" screen ONLY when you exit the program, so
  174. it doesn't inconvenience you before or during the program's execution.
  175. (And if that gets your shorts in a bunch, send me a 3.5 disk plus return
  176. postage and the registration fee and I'll compile you a special version
  177. sans nags!).
  178.  
  179. Here's where to send the cash/check/money order:
  180.  
  181.                               Will Morgan
  182.                               2516 Wood St.
  183.                               Texarkana, Tx   75503
  184.  
  185.  
  186.                ┌───────────────────────────────────────┐
  187.                │  The History of This OS/2 PM Program  │
  188.                └───────────────────────────────────────┘
  189.  
  190. Version 0.999 -  Beta version. Honed the mechanics of the program.
  191.  
  192. Version 1.0w  -  First release version of this 32 bit OS/2 PM program.
  193.  
  194.  
  195.                       ┌─────────────────────────┐
  196.                       │  Known Bugs & Problems  │
  197.                       └─────────────────────────┘
  198.  
  199. There are no known bugs or problems.
  200.  
  201.  
  202.                     ┌──────────────────────────────┐
  203.                     │  Swatting Any Pesky Insects  │
  204.                     └──────────────────────────────┘
  205.  
  206. If you encounter any problems with this program (either bugs in the actual
  207. mechanics of the program, or misspellings and/or incorrect info in the various
  208. episode data fields) please drop me a line at one of e-mail addresses in the
  209. last section of this document. I will try and implement the fix in the next
  210. version of the program that I release.
  211.  
  212.  
  213.                      ┌────────────────────────────┐
  214.                      │  Big Plans For The Future  │
  215.                      └────────────────────────────┘
  216.  
  217. I will update this program if/when new episdes/seasons are completed. If
  218. the show no longer exists on television, the only updating I can do is to
  219. correct any misspellings and other errata. If you spot something that is
  220. wrong, email me and I'll include the correction in the next version.
  221.  
  222. I'll probably add some printing routines so you can print out a brief
  223. episode list, eps by season, a particular episode by itself or a full
  224. blown, everthing-included EpGuide.
  225.  
  226. I want to add some global search routines.
  227.  
  228. I'd really like to add some multi-media stuff to the program, like
  229. sound clips or maybe some pictures but I'll have to hone my chops as
  230. a programmer, first <G>
  231.  
  232. A 32 bit OS/2 TEXT version of this program has already been released. If you
  233. use OS/2, look for TOSOS2##.ZIP at finer FTP sites (clover.cleaf.com
  234. for example).
  235.  
  236. A 32 bit DOS version of this program has also been released. Look for
  237. TOSDOS##.ZIP at finer FTP sites (clover.cleaf.com, for example).
  238.  
  239. A 16 bit Windows version of this program has also been released. Look for
  240. TOSWIN##.ZIP at finer FTP sites (clover.cleaf.com, for example).
  241.  
  242. If/when I get a newer version of my compiler that supports Win95, I may
  243. release a Windows 95 version of this program. I have tested both the 32
  244. bit DOS version and this 16 bit Windows version under Windows 95 and they
  245. both work great!
  246.  
  247. A WinNT version? Not likely, I don't have WinNT on my hard drive and have
  248. no plans to put it there.
  249.  
  250. A MAC version? Even more doubtful, since I don't own a Mac & don't know
  251. anyone who does.
  252.  
  253. A Unix version? Doubtful.
  254.  
  255. An Amiga version? Doubtful. I've had several Amiga users offer to port
  256. the A.E.G.'s over to the Amiga, but since both the OS/2 & DOS versions
  257. are pretty system-specific (read: heavily laced with non-portable non-ANSI
  258. routines), I doubt if they could be ported.
  259.  
  260. A Pet, Vic20 C64, C128, Timex Sinclair, TI or CoCo version? Jeeeez!
  261. It's the 90s, people!!! Isn't it about time you upgraded your computer?
  262.  
  263. Other A.E.G.'s? Yes, TV Buffs and Couch Potatoes! I plan on releasing a
  264. series of A.E.G.'s for various TV shows based on this A.E.G. "engine".
  265.  
  266. Here are the shows that currently have A.E.G.'s available in 32 bit DOS,
  267. 32 bit OS/2 Text *AND* PM versions as well as 16 bit Windows versions.
  268. (check at clover.cleaf.com /pub/mst3k/snake-byte):
  269.  
  270. TV Show Name      DOS Filename    OS/2 Text      OS/2 PM    Win Filename
  271. ========================================================================
  272. Mystery Science   MSTDOS##.ZIP  MSTOS2##.ZIP  MST_PM##.ZIP  MSTWIN##.ZIP
  273. Theater 3000
  274. ------------------------------------------------------------------------
  275. The X-Files       XFLDOS##.ZIP  XFLOS2##.ZIP  XFL_PM##.ZIP  XFLWIN##.ZIP
  276. ------------------------------------------------------------------------
  277. Quantum Leap      QLPDOS##.ZIP  QLPOS2##.ZIP  QLP_PM##.ZIP  QLPWIN##.ZIP
  278. ------------------------------------------------------------------------
  279. Star Trek:        TNGDOS##.ZIP  TNGOS2##.ZIP  TNG_PM##.ZIP  TNGWIN##.ZIP
  280. Next Generation
  281. ------------------------------------------------------------------------
  282. Star Trek:        TOSDOS##.ZIP  TOSOS2##.ZIP  TOS_PM##.ZIP  TOSWIN##.ZIP
  283. Original Series
  284. ------------------------------------------------------------------------
  285. Deep Space 9      DS9DOS##.ZIP  DS9OS2##.ZIP  DS9_PM##.ZIP  DS9WIN##.ZIP
  286. ------------------------------------------------------------------------
  287. The Simpsons      SMPDOS##.ZIP  SMPOS2##.ZIP  SMP_PM##.ZIP  SMPWIN##.ZIP
  288. ------------------------------------------------------------------------
  289. Babylon 5         BA5DOS##.ZIP  BA5OS2##.ZIP  BA5_PM##.ZIP  BA5WIN##.ZIP
  290. ========================================================================
  291. If you're interested in seeing an A.E.G. for your favorite show, contact me
  292. via one of the methods described below. Production of other A.E.G.'s depend
  293. on the availability of information about the show (via Internet) and whether
  294. or not the show's info translates well to a single screen in the A.E.G.
  295.  
  296.  
  297.       ┌─────────────────────────────────────────────────────────┐
  298.       │  Other Programs Available From Snake-Byte Incorporated  │
  299.       └─────────────────────────────────────────────────────────┘
  300.  
  301. 32 bit DOS & 32 bit OS/2 versions of the DALLAS COWBOY FANATIC's Companion.
  302. It's available from clover.cleaf.com /pub/mst3k/snake-byte/NON-MST3K with
  303. the filenames CBYDOS##.ZIP (DOS) or CBYOS2##.ZIP (OS/2). A 16 bit Windows
  304. version and a 32 bit OS/2 Presentation Manager version will be released soon.
  305.  
  306.  
  307.                        ┌────────────────────────┐
  308.                        │  Gratitude Department  │
  309.                        └────────────────────────┘
  310.  
  311. Extra special thanks to Frank Miller, my C programming guru. If it weren't
  312. for Frank, I probably would've given up on C programming within the first
  313. few days. He has helped me solve many of my seemingly endless beginner's
  314. problems.
  315.  
  316.  
  317.                ┌────────────────────────────────────────┐
  318.                │ Contacting the Author of This Program  │
  319.                └────────────────────────────────────────┘
  320.  
  321. Want to thank me for such a fantastic program? Bitch me out for wasting
  322. your download time & hard drive space? Suggest future additions to this
  323. program, corrections on host segments & movie data or ideas for new MST3K
  324. programs? Lonely & just need a cyber-shoulder to cry on? Well, for all
  325. these reasons except that last one there, you can contact me at one of the
  326. following email addresses:
  327.  
  328.                Fidonet   1:3819/128.103
  329.                Internet  wmorgan@clover.cleaf.com
  330.                          will.morgan@p103.f128.n3819.z1.fidonet.org
  331.  
  332.