home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / jq15.zip / JQ15.EXE / JQ.DOC < prev    next >
Text File  |  1994-11-08  |  44KB  |  896 lines
  1.     
  2.     
  3.     
  4.     
  5.     
  6.     
  7.     
  8.     
  9.     
  10.     
  11.     
  12.     
  13.     
  14.     
  15.     
  16.     
  17.     
  18.     
  19.     
  20.     
  21.     
  22.     
  23.                                    Jokes & Quotes v1.5
  24.     
  25.     
  26.                     Copyright 1994, M.L. Wester  All rights reserved.
  27.     
  28.     
  29.     
  30.     
  31.     
  32.      INTRODUCTION
  33.     
  34.           Jokes & Quotes is being distributed as Shareware.  Be sure to
  35.     read the license agreement at the end of this document or in the
  36.     ORDER.FRM file.
  37.     
  38.           Jokes & Quotes is a standalone or NETWORK ready, daily message
  39.     display system.  The registered version contains over 6000 jokes,
  40.     quotes, maxims, antecedents, stories, facts, axioms, platitudes and
  41.     more selected from 25 "on screen" categories.  (The shareware version
  42.     now in your possession contains nearly 4000.)  A "broadcast" message
  43.     sent to all users makes up the opening screen while special messages
  44.     can be sent to individuals or groups based on an environment data
  45.     search.
  46.     
  47.           Jokes & Quotes maintains a .SET file for each network user.  No
  48.     user sees the same quote twice and every user sees something
  49.     different.  LAN administrators control display content, number of
  50.     quotes limits and user specific/global messages by editing the JQ.CFG
  51.     file.
  52.     
  53.           Installation on a standalone system consist of copying the files
  54.     to a subdirectory then running the program.  Installing for LAN use
  55.     is just as simple.  Copy the files to a subdirectory in a public area
  56.     on the server then execute the program by running it from the users
  57.     home directory.  Jokes & Quotes will automatically create the SET
  58.     file and determine where it's configuration and data files are
  59.     located.  All you got'ta do is run it.
  60.     
  61.     
  62.     IMPORTANT STUFF
  63.     
  64.           The NUMBER ONE FEATURE of Jokes & Quotes is the content.  As an
  65.     administrator of a 75 user LAN, I know first hand the diversity and
  66.     range of people that inhabit the network world.  Little old ladies,
  67.     college students, attorneys, corporate managers, atheist, christians,
  68.     rednecks and more.  What gets diplayed in a public environment has to
  69.     be priority #1.
  70.           To meet this need I have read every line of text in the Jokes &
  71.     Quotes data files and sought to remove controversial references to
  72.     sex, politics and religion.  These three subjects seem to be the
  73.     easiest to do wrong.  This includes the rewriting of gender or race
  74.     specific text that may be potentially offensive.  You can be certain
  75.     that there will be something, somewhere that will offend someone, but
  76.     I have went to great effort to minimize the chances.
  77.     
  78.           I should also mention that I have tried to include only data
  79.     that is positive in nature.  There is a lot of fun and entertaining
  80.     stuff that promotes the wrong idealogies.  Having said this I realize
  81.     that a lot of people may disagree as to my judgement on what is
  82.     positive or negative, but...such is life.  It should also be noted
  83.     that some of the jokes deal with mature subjects and may not be
  84.     appropriate for children.  This does not mean there are any "dirty
  85.     jokes", it just means that some of the subject matter is beyond a
  86.     pre-adolescent's realm of comprehension.
  87.     
  88.           NOTE: There are certain categories that may not be appropriate
  89.     for all network environments such as Lawyer jokes, (Some attorneys
  90.     have a weak sense of humor) but I have included them for those who
  91.     can appreciate them.  All the jokes and quotes in all categories have
  92.     been censored for sexually explicit content and vulgar language.
  93.     
  94.           Bear in mind that all categories can be selected or deselected
  95.     by individual users so categories that may not appeal to some may
  96.     still be used if they appeal to others.
  97.      The Association of Shareware Professionals
  98.     
  99.                            _______
  100.                       ____|__     |               (R)
  101.                    --|       |    |-------------------
  102.                      |   ____|__  |  Association of
  103.                      |  |       |_|  Shareware
  104.                      |__|   o   |    Professionals
  105.                    -----|   |   |---------------------
  106.                         |___|___|    MEMBER
  107.     
  108.     
  109.           Michael L. Wester is a member of the Association of Shareware
  110.     Professionals (ASP).  The ASP wants to make sure that the shareware
  111.     principle works for you.  If you are unable to resolve a shareware-
  112.     related problem with an ASP member by contacting the member directly,
  113.     ASP may be able to help. The ASP Ombudsman can help you resolve a
  114.     dispute or problem with an ASP member, but does not provide technical
  115.     support for members' products.  Please write to the ASP Ombudsman at
  116.     545 Grover Road, Muskegon, MI 49442-9427 USA, FAX 616-788-2765 or
  117.     send a CompuServe message via CompuServe Mail to ASP Ombudsman
  118.     70007,3536.
  119.     
  120.     
  121.     SHAREWARE
  122.     
  123.           The Jokes & Quotes program is being marketed using the shareware
  124.     method.  This means you are encouraged to share copies of the
  125.     unregistered version for evaluation purposes.  If you wish to use
  126.     Jokes & Quotes on a regular basis either network or stand-alone you
  127.     are required to register with the author.  Please read the futher
  128.     explanation of shareware and the copyright notice near the end of
  129.     this document.
  130.     
  131.     
  132.      VENDOR INFORMATION
  133.     
  134.     One Line Description
  135.     
  136.           Jokes & Quotes - Network ready, daily quote/message program.
  137.     
  138.     Long Description
  139.     
  140.           Jokes & Quotes is a NETWORK ready, daily message display system.
  141.     Nearly 4000 jokes, quotes, stories, maxims and more are selected from
  142.     25 "on-screen" categories.  Users have options to print quotes,
  143.     deselect categories, random select at startup, change colors, enable
  144.     screen blanker, reset category to any record and more.  Network
  145.     features include global messages to all users, special messages to
  146.     selected users, limit number of jokes displayed daily, administrator
  147.     controlled categories and more.  Full mouse support and context
  148.     sensitive help.
  149.     
  150.     
  151.     DISTRIBUTION POLICY
  152.     
  153.           ASP vendor members in good standing are automatically given
  154.     permission to distribute Jokes & Quotes.  Non-ASP vendors are
  155.     required to send notification that you are including my program in
  156.     your collection.  I do not require Non-ASP vendors to send copies of
  157.     their catalogs or meet any specific standards but as I spot check
  158.     vendors to examine their distribution methods, I do reserve the right
  159.     to prohibit distribution by any vendor I deem unworthy.
  160.     
  161.           Distribution on CD-ROM or rack sales is strictly prohibited
  162.     without prior written permission from me, Michael L. Wester.  Contact
  163.     me.  I'll usually give permission.
  164.     
  165.     PROGRAM FEATURES
  166.     
  167.     *     Full NETWORK support.  Jokes & Quotes has been designed with
  168.           features for network administrators and content suitable for the
  169.           various users of network systems.
  170.     
  171.     *     Lots and lots of jokes, quotes, axioms, maxims, stories, facts,
  172.           platitudes, cliches, postulates, proverbs, sayings, adages,
  173.           tales, parables etc.....
  174.     
  175.     *     Full mouse support.  Almost every function of Jokes & Quotes can
  176.           be controlled with a mouse.
  177.     
  178.     *     Entertaining opening display shows the categories as it slows
  179.           down to make it's pick.  Sound on or sound off.
  180.     
  181.     *     Context sensitive HELP.  Every feature is only a keystroke away
  182.           from a concise description of what that feature does.  It even
  183.           has context sensitive information on each category!
  184.     
  185.     *     Ability to print Jokes or Quotes to any supported LPT port
  186.           including logical network ports and disk files.
  187.     
  188.     *     Option to have joke categories randomly selected each time the
  189.           program is run.
  190.     
  191.     *     Adiminstrators can globally set limits on the number of jokes &
  192.           quotes that users can display each day.  Jokes & Quotes will
  193.           refuse to display until the next day once the limit has been
  194.           met.
  195.     
  196.     *     Administrators can give unlimited access to individual users.
  197.           (Handy for yourself, your buddies and the boss.)
  198.     
  199.     *     Displays an "administrator controlled" opening message to every
  200.           user each time it is run.
  201.     
  202.     *     Can optionally search the user's environment for a specified
  203.           string then display a "special" second message.  This allows you
  204.           to send messages to individual users (Like on their birthday.)
  205.           or to entire groups (Like departmental meeting reminders.).
  206.     
  207.     *     User configurable colors.  All configurations are saved
  208.           automatically each time the program is exited.
  209.     
  210.     *     User configurable screen saver. On/off or wait from 1 to 99
  211.           minutes before "blanking" the screen.
  212.     
  213.     *     DEMO mode. Runs the random selection and displays quotes without
  214.           intervention until a key is pressed.
  215.     
  216.     *     Ability to reset a category to any record.  Allows you to review
  217.           a passed joke or quote.
  218.     
  219.     *     Users have the option to deselect any topics in case they prefer
  220.           not view a particular category of jokes.
  221.     
  222.     *     Users can have the joke files repeat once the end is reached or
  223.           have the category "go inactive".
  224.     
  225.     *     Administrators can add to or edit the categories.
  226.     
  227.     *     Registered owners receive more than enough categories of
  228.           different data files for Jokes & Quotes.  Because LAN
  229.           environments differ as much as the people who use them this
  230.           allows you to tailor the contents of Jokes & Quotes to better
  231.           suit your users.
  232.     
  233.     *     Jokes & Quotes uses "compressed data" files to increase response
  234.           time and reduce network traffic.
  235.      INSTALLATION
  236.     
  237.     STANDALONE:
  238.     
  239.           Installing Jokes & Quotes to a standalone computer is as simple
  240.     as copying all the files to a subdirectory on your hard drive.  A
  241.     simple INSTALL program has been included to perform this task.
  242.     
  243.           When you run Jokes & Quotes the first time it will create a
  244.     JQ.SET file that contains user configuration information.  You should
  245.     always run Jokes & Quotes from the same directory or it will create a
  246.     JQ.SET file in any directory it is currently logged to.  You do not
  247.     have to run Jokes & Quotes from the installation directory and it
  248.     does not have to be in the PATH.  The easiest way to run Jokes &
  249.     Quotes is to create a batch file that always changes to the same
  250.     directory.
  251.     
  252.     
  253.     NETWORK:
  254.     
  255.           Installing Jokes & Quotes to a network is as simple as
  256.     installing on a standalone machine.  Copy all the Jokes & Quotes
  257.     files to a subdirectory and installation is complete.  An INSTALL
  258.     program has been included to perform this task.
  259.     
  260.           Running Jokes & Quotes from a network is as easy as running it
  261.     standalone with only minor considerations.  Jokes & Quotes
  262.     automatically creates a JQ.SET file in it's currently logged
  263.     directory the first time it is started.  The program determines the
  264.     drive and path where it and it's data files reside so it does not
  265.     have to be in the PATH and you do not have to run it from it's own
  266.     directory.
  267.     
  268.           For operation on a network you MUST NOT execute Jokes & Quotes
  269.     from the directory it has been installed to.  (If you do it will use
  270.     a single JQ.SET file for every user on the network.  This would cause
  271.     individual user settings to be changed by multiple users and would
  272.     cause a sharing violation if more than one user accessed the JQ.SET
  273.     file at the same time.)
  274.     
  275.           To run Jokes & Quotes on a network:
  276.     
  277.           1.    Change to the user's HOME directory. (Or whatever directory
  278.                 you wish the JQ.SET file to be stored in.)
  279.     
  280.           2.    Execute Jokes & Quotes by supplying the path to where it
  281.                 has been installed.  Example: P:\PUBLIC\JQ\JQ
  282.     
  283.           3.    Jokes & Quotes users require only READ rights to the Jokes
  284.                 & Quotes installation directory.
  285.     
  286.           That's it.  Jokes & Quotes will find it's data, help and
  287.     configuration files in it's installation directory and create an
  288.     individual JQ.SET file in the directory it was logged to when
  289.     executed from the user's machine.  From now on each user can
  290.     configure Jokes & Quotes to suit themselves and the program will
  291.     maintain an "in sequence" history of every quote they see so they
  292.     never see the same one twice.
  293.     
  294.     
  295.      USER MANUAL -     The following text is suitable for supplying network
  296.                       users of Jokes & Quotes with a printed user manual.
  297.     
  298.     USING JOKE & QUOTES
  299.     
  300.           Jokes & Quotes has FULL CONTEXT SENSITIVE HELP.  You can press
  301.     the F1 key anytime to receive helpful information on the currently
  302.     selected item.  You can even receive interesting and descriptive
  303.     information on the individual categories by pressing F1 when a
  304.     category is hi-lited.
  305.     
  306.           Using Jokes & Quotes couldn't get much easier.  Simply run the
  307.     program.  It's default configuration will randomly select a category
  308.     and display a joke or quote.  After the first joke is displayed you
  309.     can select another using the ARROW keys or by clicking a category
  310.     with the mouse.  When you select the SETUP option a second "set-up"
  311.     screen will be displayed.  Following is a description of each of the
  312.     user options on the left side of the setup screen.
  313.     
  314.     
  315.     Random Select Category At Start
  316.     
  317.           This feature gives you the option of having Jokes & Quotes
  318.     randomly select a category and display a quote each time it is run.
  319.     If you execute Jokes & Quotes from your AUTOEXEC.BAT file you would
  320.     probably want to set this feature on.
  321.     
  322.           After the random selection is made and a quote has been
  323.     displayed you may continue to view other quotes by selecting
  324.     categories with the ARROW keys or mouse.  To reselect the current
  325.     category just press ENTER or click the center screen or category with
  326.     a mouse.  You can stop the random selection process at any time by
  327.     pressing a key.
  328.     
  329.     Note:       When running from a network your LAN administrator may have
  330.                 set a limit on the number of quotes displayed per day.  If
  331.                 you see the message "Sorry! That's the limit for today.",
  332.                 you may wish to ask your administrator to increase the
  333.                 limit.
  334.     
  335.     
  336.     Sound On / Off
  337.     
  338.           Jokes & Quotes can make a short clicking sound each time a key
  339.     is pressed or the mouse is clicked if this option is set to ON.  If
  340.     you would rather not hear the sounds set this option to OFF.  (No √
  341.     to the left.)
  342.     
  343.     
  344.     Restart Category When Empty
  345.     
  346.           Each joke or quote file contains a limited number of records.
  347.     Most categories average between 100 and 300 different sayings.  If
  348.     you set this option to ON the category file will restart from the
  349.     beginning when the end is reached.  I you set it to OFF the category
  350.     will go "inactive" and will not be available for viewing.
  351.     
  352.     Run Jokes & Quotes DEMO Mode
  353.     
  354.           For whatever reasons you may wish to have Jokes & Quotes run
  355.     continously with out keyboard interaction.  This option is real handy
  356.     if Jokes & Quotes is displaying as a demo in a public environment.
  357.     When you set this option to ON the DEMO mode will begin immediately
  358.     after you press the ESC key or select EXIT SETUP.  You can exit DEMO
  359.     mode at any time by pressing a key.
  360.     
  361.           When running in DEMO mode Jokes & Quotes counts the number of
  362.     lines being displayed then pauses 2 seconds for each line plus 2
  363.     seconds.  For example: If three lines are displayed Jokes & Quotes
  364.     will wait 8 seconds.  2 seconds for each line + 2 seconds.  This
  365.     formula seems to allow sufficient time to read the text. (Note: If
  366.     the screen contains more than 13 lines Jokes & Quotes will pause only
  367.     enough to allow you to read what's on the screen.)
  368.     
  369.     
  370.     Change Color Configuration
  371.     
  372.           Jokes & Quotes has 8 different color configurations.  You can
  373.     select each one individually by hi-liting this option and pressing
  374.     ENTER or by clicking this option with a mouse.
  375.     
  376.           The number to the left displays the current configuration
  377.     number.  Jokes & Quotes automatically saves all configuration setting
  378.     each time it is exited.
  379.     
  380.     
  381.     Screen Blanker Wait Time
  382.     
  383.           If your computer is sometimes powered on when you are not there
  384.     to press a key Jokes & Quotes could wait infinitely.  If computer
  385.     monitors are left running with an image on the screen it is possible
  386.     for the image to "burn in" so that it can always been seen even when
  387.     the computer is switched off.
  388.     
  389.           The Screen Blanker option will blank the screen after a set
  390.     number of minutes of no keyboard activity.  You can set "wait before
  391.     blanking" time from 1 to 99 minutes.  If you set the wait period to
  392.     0, screen blanking will be disabled.
  393.     
  394.           You can restore a "blanked" screen by pressing a key.
  395.     
  396.     
  397.     Restart Quotes And Reset Configurations
  398.     
  399.           Selecting this option will reset all categories to record 1 and
  400.     all configuration settings to their defaults.  Be very careful when
  401.     using this option as any sayings already viewed will have to be
  402.     reviewed.
  403.     
  404.           The program will prompt you with an "Are You Sure?" message
  405.     before the configuration is reset.
  406.     
  407.     Reset A Category To Any Selected Record
  408.     
  409.           This feature allows you to reset any category to any record
  410.     within the file.  Using this you can return to any joke or quote even
  411.     though you may have already viewed it.  It is also necessary to reset
  412.     a category if it has been replaced with a new one, else you will
  413.     begin viewing the new category at whatever position the old one was
  414.     at.
  415.     
  416.           To use this feature first hi-lite it then press ENTER or click
  417.     it with a mouse.  The scroll bar will appear on the right side.  Now
  418.     use the ARROW keys or mouse to select a category to reset.  When you
  419.     select the category a window showing the current record will be
  420.     displayed.  You can set the record to any number from 1 to 999.  If
  421.     you set it to a number that exceeds the number of records in the
  422.     category the category will reset itself to record number one.
  423.     
  424.     
  425.     Print The Currently Displayed Quote
  426.     
  427.           When you select this option you will be prompted to select the
  428.     printer port to send the data to.  Jokes & Quotes can send data to
  429.     LPT ports one, two and three.  Note:  You can also select this option
  430.     from the main screen by pressing the F7 key.
  431.     
  432.        In addition to printing to a printer, joke data can be sent to an
  433.     ASCII text file.  Select Print To File then enter a valid DOS
  434.     filename.  The Drive letter and PATH are optional.
  435.     
  436.           If you are printing to a network printer make sure it can
  437.     support printing standard ASCII characters.
  438.     
  439.     
  440.     Using The Window On The Right Side Of The Setup Screen
  441.     
  442.           On the right side of the set-up screen a list of all available
  443.     categories is displayed.  You can use the ARROW and ENTER keys to
  444.     select and deselect the various categories.
  445.     
  446.           When a category is selected you will be able to view the jokes
  447.     and quotes it contains.  If it is not selected (The √ is not
  448.     displayed.) it will not show on the main view screen and will not be
  449.     available for viewing.
  450.      NETWORK ADMINISTRATION OF JOKES & QUOTES
  451.     
  452.     THE JQ.CFG FILE...
  453.     
  454.           The network administrator can maintain Jokes & Quotes on several
  455.     levels.  First, you can control the categories of jokes and quotes
  456.     displayed.  Second, you can edit any category data to add your own
  457.     text or create your own text for Jokes & Quotes to display.  Third,
  458.     you can place limitations on the number of jokes a user sees in a day
  459.     and you can send global messages across the network or send special
  460.     messages to selected users.  The ideal use of Jokes & Quotes is as a
  461.     start-up program run from the AUTOEXEC.BAT file or as a network login
  462.     message display system.  It makes for a very conveinent method to
  463.     pass reminders and messages to everyone or to selected departments or
  464.     individuals as they begin their work day.
  465.     
  466.           The network administrator controls Jokes & Quotes by editing the
  467.     JQ.CFG files.  This file will be located in the directory where Jokes
  468.     & Quotes has been installed to.
  469.     
  470.           Inside the JQ.CFG file you will find beginning and ending
  471.     delimiters for each feature.  Example: [MAXTODISPLAY].  Jokes &
  472.     Quotes requires a beginning and ending delimiter for each feature to
  473.     function properly.
  474.     
  475.     [OPENING]
  476.     
  477.           The opening is a broadcast message that will appear to every
  478.     user across the network.  Any text entered between the two [OPENING]
  479.     delimiters will be displayed when the program is first started.  If a
  480.     user has enabled RANDOM SELECTION and the opening message is less
  481.     than 13 lines the message will display only until Jokes & Quotes has
  482.     made it's selection.  This message makes an excellent display for
  483.     company logos or slogans.
  484.     
  485.     
  486.     When entering text for the OPENING message:
  487.     
  488.           1.    If the text exceeds 13 lines a scroll bar will appear on
  489.                 the right of the opening window and the text can be
  490.                 scrolled up and down.
  491.     
  492.           2.    If the text exceeds 48 charcters per line a scroll bar will
  493.                 appear along the bottom of the opening window and the text
  494.                 can be scrolled from left to right.
  495.     
  496.           3.    If text exceeds 13 lines and the user has random selection
  497.                 switched ON, random selection will be disabled until after
  498.                 the ENTER or ESC key is pressed.  If the message displaying
  499.                 is important and less than 13 lines you should add enough
  500.                 blank lines to cause the random selection to pause until
  501.                 after the user has read the message.
  502.     
  503.     
  504.     [MAXTODISPLAY]
  505.     
  506.           The [MAXTODISPLAY] option allows you to limit the number of
  507.     sayings per user that Jokes & Quotes will display in a day.
  508.     Depending on your office environment somewhere between three and ten
  509.     seems to be a good number.  Setting MAXTODISPLAY to 0 will allow an
  510.     unlimited number of jokes to display.
  511.     
  512.           Jokes & Quotes "remembers" how many quotes a user has viewed and
  513.     will allow them to exit and restart Jokes & Quotes as many times as
  514.     they like until their daily limit is met.
  515.     
  516.     
  517.     SPECIAL NOTE:     Jokes & Quotes allows you to give individual users
  518.                       special rights to view an unlimited number of jokes by
  519.                       editing their individual JQ.SET file.  (Real handy for
  520.                       yourself, your buddies or the boss.)  See the section
  521.                       on THE JQ.SET FILE for details.
  522.     
  523.     [ENVIRONMESSAGE]
  524.     
  525.           The [ENVIRONMESSAGE] is a useful feature of Jokes & Quotes that
  526.     allows LAN Administrators to send special messages to selected users
  527.     across the network.
  528.     
  529.           This feature is utilized by first defining a "search string" to
  530.     locate in the user's environment data then a message to display when
  531.     the string is found.  This simple system allows you to send messages
  532.     to individual users (By searching for their user name.) or selected
  533.     groups of users. (By searching for group or print queue
  534.     designations.)
  535.     
  536.           1.    The first line after the [ENVIRONMESSAGE] delimiter should
  537.                 be the @ symbol and the string to search for.  Example:
  538.                 @USER.  The @ symbol tells Jokes & Quotes that the text
  539.                 following is the search string.  This text can include any
  540.                 characters and can be up 79 characters long.  The SEARCH IS
  541.                 NOT CASE SENSITIVE and will find any combination of upper
  542.                 and lower case.
  543.     
  544.           2.    Following the search string should be the text you want
  545.                 displayed.  This text can be any length and up to one
  546.                 hundred lines.
  547.     
  548.           3.    For the best effect you should probably limit messages to
  549.                 13 lines with each being no more than 48 characters.  If
  550.                 you do this the user will be able to view the entire
  551.                 message without having to scroll up and down or left and
  552.                 right.  (My experience has show that a signifigant number
  553.                 of users will read only what's on the screen, then press
  554.                 ESC to get on with their business.  If you must exceed the
  555.                 screen boundries you might want to make the last line on-
  556.                 screen inform the user that more text follows.)
  557.     
  558.           4.    If the text exceeds 13 lines a scroll bar will appear on
  559.                 the right of the opening window and the text can be
  560.                 scrolled up and down.
  561.     
  562.           5.    If the text exceeds 48 charcters per line a scroll bar will
  563.                 appear along the bottom of the opening window and the text
  564.                 can be scrolled from left to right.
  565.     
  566.           6.    If text exceeds 13 lines and the user has random selection
  567.                 switched ON, random selection will be disabled until after
  568.                 the ENTER or ESC key is pressed.  If the message to display
  569.                 is important and less than 13 lines you should add enough
  570.                 blank lines to cause the random selection to pause until
  571.                 after the user has read the message.
  572.     
  573.     
  574.     [CATEGORIES]
  575.     
  576.           Jokes & Quotes has twenty five on-screen categories.  These
  577.     categories can be renamed or replaced by editing JQ.CFG.  Editing the
  578.     category list is very easy but it does have some special
  579.     considerations.  If you are a LAN administrator, you are very familar
  580.     with DOS and probably will not need to read these instructions other
  581.     than to discover the less obvious features.  You might wish to look
  582.     at the JQ.CFG file then make changes in a way that seem most likely.
  583.     You'll probably get it right.
  584.     
  585.     
  586.           1.    DO NOT change the position of the fields within the
  587.                 [CATEGORIES] delimiters.  It is very important the data is
  588.                 read in it's default positions.
  589.     
  590.           2.    The first four categories must always be the first four
  591.                 categories and the SETUP category must always be the
  592.                 twentieth category.
  593.     
  594.           3.    You can move categories around and change their positions.
  595.                 Just make sure the length of the category name does not
  596.                 exceed the length of the display area on the main screen.
  597.                 It will be truncated if it does.
  598.     
  599.           4.    The four corners of Jokes & Quotes main screen have topics
  600.                 that consist of four line categories. All the rest are
  601.                 single line categories.  When editing categories in the
  602.                 JQ.CFG file the first four lines represent the four corners
  603.                 of the main screen.  When you look you will see there are
  604.                 five comma delimited fields for each of the four lines.
  605.                 The first four fields are the text that is displayed for
  606.                 that category.  The last field is the name of the file
  607.                 containing the data.
  608.     
  609.           5.    All the rest of the categories have two comma delimited
  610.                 fields.  The first is the text that is displayed on screen
  611.                 and the second is the category filename.
  612.     
  613.            The following screen shows the order in which the ARROW keys
  614.     move around the screen.  With the exception of the four corners this
  615.     is also the order they appear in the [CATEGORIES] configuration of
  616.     the JQ.SET file.
  617.     
  618.                .---------------------.---------------------.
  619.                |         |     2     |     3     |         |
  620.                |    1    |-----------|-----------|    4    |
  621.                |         |     5     |     6     |         |
  622.                |         |-----------------------|         |
  623.                |---------|                       |---------|
  624.                |    7    |                       |    8    |
  625.                |---------|                       |---------|
  626.                |    9    |                       |   10    |
  627.                |---------|                       |---------|
  628.                |   11    |                       |   12    |
  629.                |---------|                       |---------|
  630.                |   13    |                       |   14    |
  631.                |---------|                       |---------|
  632.                |   15    |                       |   16    |
  633.                |---------|                       |---------|
  634.                |   17    |                       |   18    |
  635.                |---------|                       |---------|
  636.                |   19    |                       |   20    |
  637.                |---------|                       |---------|
  638.                |         |-----------.-----------|         |
  639.                |   21    |     22    |    23     |   24    |
  640.                |         |-----------|-----------|         |
  641.                |         |     25    |    26     |         |
  642.                |_________|___________|___________|_________|
  643.     
  644.     
  645.     THE JQ.SET FILE...
  646.     
  647.           The JQ.SET file is maintained entirely by the Jokes & Quotes
  648.     program and should require no attention on your part.  It does
  649.     however, have one special feature variable that is designed for you
  650.     to edit. See INDIVIDUAL MAX TO DISPLAY for an explaination.
  651.     
  652.           Although it is not necessary I have included the following
  653.     listing of what each variable is just in case you should ever find
  654.     the need to edit some part of the user configuration.
  655.     
  656.     
  657.     0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,  - Category record #
  658.     "11111111111111111111111111"                  - Selected/deselected
  659.     1                                             - Random select off/on
  660.     1                                             - Sound off/on
  661.     1                                             - Restart empty file
  662.     0                                             - Screen blanker wait
  663.     1                                             - Color set
  664.     0                                             - Max to display
  665.     "01-01-1995"                                  - Date program exited
  666.     0                                             - Individual maxdisplay
  667.     
  668.     CATEGORY RECORD # - This set of twenty six variables contain the
  669.     current record number for each category.  Should you ever need to
  670.     reset a category it would be easier to let Jokes and Quotes do it
  671.     from the setup screen.
  672.     
  673.     SELECTED/DESELECTED - This represents categories being switch on or
  674.     off from within the Jokes & Quotes setup screen.  0 = Off  -  1 = On
  675.     
  676.     RANDOM SELECT - Switch to allow Jokes & Quotes to randomly select a
  677.     category at start-up.  0 = Off  -  1 = On
  678.     
  679.     SOUND ON/OFF - Switch to allow Jokes & Quotes to make sound when
  680.     using arrow keys or mouse.  0 = Off  -  1 = On
  681.     
  682.     RESTART EMPTY FILE - Switch to tell Jokes & Quotes to restart or
  683.     deselect a data file that has been viewed completely.  0 = Off  -  1
  684.     = On
  685.     
  686.     COLOR SET - This is a variable representing the currently selected
  687.     color set used by the user.  Always 1 to 8.
  688.     
  689.     SCREEN BLANKER - This is the number of minutes the user has chosen to
  690.     wait before the screen is blanked if no key is pressed.  0 = off.
  691.     
  692.     MAX TO DISPLAY - This is the current count of viewed jokes for the
  693.     current date.  Users can exit and restart Jokes & Quotes as many
  694.     times a day as they like until the administrator set limit is
  695.     reached.
  696.     
  697.     DATE PROGRAM EXITED - This is the date the program was last exited.
  698.     It is used to determine when the limit set by [MAXTODISPLAY] can be
  699.     reset.
  700.     
  701.     INDIVIDUAL MAX TO DISPLAY - This is a special feature!  Jokes and
  702.     Quotes never changes this number, it just reads it and maintains it.
  703.     When you set a [MAXTODISPLAY] number in the JQ.CFG file every user on
  704.     the LAN is affected.  If for some reason you would like to give
  705.     certain users unlimited rights to Jokes & Quotes (Like yourself, your
  706.     buddies or the boss.) you can edit this parameter in their individual
  707.     JQ.SET to give them any number of jokes per day up to 32000.  Jokes &
  708.     Quotes will reset their max to whatever this number is set to.
  709.      CREATING YOUR OWN JOKES & QUOTES DATA
  710.     
  711.           Jokes & Quotes will read standard ASCII text files. It uses a
  712.     very simple look-up system that allows it to maintain record specific
  713.     data for each user.  The following notes are points to consider when
  714.     entering text for Jokes & Quotes to display.
  715.     
  716.           1.    The first line of each quote should be the ~ symbol or the
  717.                 ^ symbol followed by a number.  The numbers should start
  718.                 with one and continue on incrementing one at the time.  The
  719.                 first line must contain nothing but the ~ or ^ and a
  720.                 number.  This number serves as a record number.
  721.     
  722.           2.    Jokes & Quotes uses a "low yield (about 35% compression),
  723.                 lower case only, alpha only, lightning fast (Unnoticable on
  724.                 a 4.77 mhz PC), compression algorithim.  Record numbers
  725.                 starting with ~ will be decompressed, record numbers
  726.                 starting with ^ will not.  If your text contains ANY HIGH
  727.                 ASCII characters DO NOT use decompression.  If your text
  728.                 contains high ASCII characters use the ^ character to turn
  729.                 off decompression.  (See the ASCIIART file for example.)
  730.                 Note: Jokes & Quotes will read standard ASCII text
  731.                 unmodified.  You can even add standard text to one of the
  732.                 compressed files and Jokes & Quotes will display it.
  733.     
  734.           2.    Immediately following the record number should be the text
  735.                 to display.  This text, if less than 13 lines will be
  736.                 automatically centered on the screen.
  737.     
  738.           3.    Jokes & Quotes can display text any length up to 100 lines
  739.                 long by using the PgUp/PgDn and ARROW keys.  It is
  740.                 recommended that text be formatted so that it is not
  741.                 necessary to scroll left and right.
  742.     
  743.           4.    The maximum length of text to display without scrolling is
  744.                 48 characters per line and 13 lines per screen.
  745.     
  746.           5.    Jokes & Quotes uses compressed data but will read standard
  747.                 ASCII text without modification.  The compressed data files
  748.                 included with Jokes & Quotes can be edited to include
  749.                 standard ASCII text.
  750.     
  751.           6.    The filename for the data file must be entered into the
  752.                 JQ.CFG file along with a descriptive title.
  753.     
  754.           7.    Help data for new categories can be created. (See section
  755.                 on Editing the Help File.)
  756.     
  757.      EDITING THE JOKES & QUOTES HELP FILE
  758.     
  759.           The JQ.HLP file contains all the help data used by Jokes &
  760.     Quotes including the background information applied to each category.
  761.     If you add categories to Jokes & Quotes you should add corrosponding
  762.     help data for each new category.
  763.     
  764.           The lookup method employed by the help system is virtually
  765.     identical to the lookup for the data files.  Jokes & Quotes scans the
  766.     help files until it finds a help topic name.  If it does not find a
  767.     matching help topic to reports "No Help Found!".
  768.     
  769.           Note: The JQ.HLP file contains help information on all the
  770.     categories supplied with the Jokes & Quotes program.  For the help
  771.     data on additional topics to be accessable, without editing the
  772.     JQ.HLP file, you should use the names for topics supplied in the
  773.     WHATUGET.LST file.
  774.     
  775.           1.    Enter standard text up to 72 characters long and up to 100
  776.                 lines per topic.
  777.     
  778.           2.    The help topic's "lookup" name must be the same as it's
  779.                 data filename.
  780.     
  781.           3.    Enter the "lookup" name in UPPERCASE beginning it with a ~
  782.                 character.  (View the JQ.HLP file for examples.)
  783.     
  784.           4.    The JQ.HLP file like all of Jokes & Quotes data files must
  785.                 reside in the Jokes & Quotes installation directory.
  786.     
  787.           You are free to add your own or edit any of the existing help
  788.     information as long as it falls within the previous guidelines.
  789.     
  790.     
  791.      WHERE DID ALL THIS STUFF COME FROM?
  792.     
  793.           One of the most common questions I'm asked about Jokes & Quotes
  794.     is where did all the material come from.  Well, the fact is it came
  795.     from a lot of places.  By far, the bulk of it came from public domain
  796.     sources.  Some is original material produced by my wife and myself
  797.     and some has been collected from the many people I have known in my
  798.     life.  There are even some people who will be really surprised to
  799.     find themseleves quoted on things I remember they said from ten or
  800.     more years ago.
  801.     
  802.           Most of this material was a real surprise to me.  Jokes & Quotes
  803.     started out as an extremely simple program I wrote to display a new
  804.     message every day on our network login screen.  The material for this
  805.     "simple" program was typed in by me from old books, magazines and
  806.     things people would tell me.  The original file contained about 100
  807.     jokes and quotes.  It was this data that got me started.
  808.     
  809.           After the concept for Jokes & Quotes began to form it very
  810.     quickly became apparent that I needed more material...so, I started
  811.     looking.  For many moons I roamed the BBS's and CD-ROM collections
  812.     ever searching for the strings "joke" or "quote".  I was overwhelmed.
  813.     What I found was dozens and dozens of text files containing hundreds
  814.     of jokes and scads of quotes.  Bear in mind that I must have searched
  815.     a hundred BBS's all across the nation.  Sometimes different files
  816.     would contain complete segments of the same material. (I also found a
  817.     lot of programs that display quotes similar to the way Jokes & Quotes
  818.     does.  Unless they were public domain or freeware I didn't use their
  819.     material.  I did note however, that most of the material in these
  820.     programs could be found in the same text files that I did use.)  Of
  821.     course all these jokes and quotes were mixed up together.  There were
  822.     very few collections of similar types of material.  After MANY long
  823.     HOURS of sorting and formatting I came up with the various categories
  824.     you find here.
  825.     
  826.           Writing the Jokes & Quotes program and reading the 10,000 or so
  827.     jokes and quotes considered for inclusion has really been an
  828.     enlightning experiance.  I have read so much wit and wisdom that I
  829.     could probably entertain Confucius and talk shop with Aristotle and
  830.     Gandi.  (Yes, I really have read every line of data in Jokes & Quotes
  831.     and several thousand more that were rejected.  There's a tremendous
  832.     amount of dirty jokes that I didn't use.)
  833.     
  834.           I sincerely hope that you will enjoy using the Jokes & Quotes
  835.     program as much as I have enjoyed writing it and collecting the data.
  836.     Besides being entertaining there really is some life enriching
  837.     material to be had here.  So have fun!
  838.      SHAREWARE
  839.     
  840.           Shareware is software marketed on a "Try before you buy" basis.
  841.     
  842.           The price per disk that Shareware distributors charge is a
  843.     distribution fee and not the price of the software.  Shareware
  844.     authors have agreed to allow vendors to recover expenses for copying,
  845.     packaging, and maintaining a shareware library.  This allows you to
  846.     obtain software programs at incredibly low prices to try, then pay
  847.     the registration price for them only if they suit your needs. The
  848.     idea is that after a reasonable trial period, if you find the
  849.     programs to be of use, you are expected to send the author the
  850.     registration fee.
  851.     
  852.           Registration entitles you to various rights and benefits.  These
  853.     range from the legal (and moral) right to continue using the
  854.     software.  In addition many shareware authors offer printed
  855.     documentation and/or higher levels of service and support. Unlike
  856.     Public Domain software, which is free to everyone with no fees asked
  857.     for or expected, shareware programs exist because the authors expect
  858.     and deserve the registration support from people who use their
  859.     programs.
  860.     
  861.     So that's Shareware.  If you like it, support it!
  862.     
  863.     
  864.     REGISTRATION
  865.     
  866.           The shareware message will not be displayed on any registered
  867.     version of Jokes & Quotes.  Registered users will receive the latest
  868.     version of Jokes & Quotes and a printed copy of the manual. (Laser
  869.     printed booklet.)
  870.     
  871.           Registered users of Jokes & Quotes will receive additional data
  872.     files comprising enough categories to allow some selection concerning
  873.     what categories are displayed.
  874.     
  875.     
  876.     DISCLAIMER
  877.     
  878.           Under no circumstances shall Michael L. Wester be liable for any
  879.     damages, including lost profits, savings, or any other incidental or
  880.     consequential damages arising out of the use of or inability to use
  881.     this program even if Michael L. Wester has been notified of the
  882.     possibility of such damages, or for any claims by any other party.
  883.     
  884.     
  885.     COPYRIGHT NOTICE
  886.     
  887.           Jokes & Quotes is copyrighted 1994 by Michael L. Wester.  All
  888.     rights reserved.  The Jokes & Quotes program may not be sold under any
  889.     circumstances.  The shareware version of Jokes & Quotes may be
  890.     distributed for evaluation purposes only.  It cannot be distributed as
  891.     part of a promotional offer or bundled with hardware, software, or
  892.     printed material without the written permission of Michael L. Wester.
  893.     Jokes & Quotes may not be distributed on CD-ROM (Compact Disk Read Only
  894.     Memory) without express written permission from Michael L. Wester.
  895.     
  896.