home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / VNEWZ08.ZIP / VNEWZ.DOC < prev    next >
Encoding:
Text File  |  1995-09-23  |  16.7 KB  |  407 lines
  1.  
  2.  
  3.                                                                            
  4.  
  5.  
  6.                               -=- VNewz v.70 -=-
  7.                (C) 1995 by Vision Systems, All Rights Reserved.
  8.      
  9.                ================================================
  10.                           The Easy to Use, Versatile
  11.                          BBS News Bulletin Generator.
  12.                ================================================
  13.               Documentation by Jeremy Gaither and Michael Gedeon
  14.      
  15.      
  16.      -=■[ What is VNewz? ]■=-
  17.      
  18.              VNewz is a highly configurable News Bulletin Generator.  It
  19.      allows the SysOp to enter news bulletins as if they were messages,
  20.      like they should be.  VNewz includes an internal editor, and
  21.      requires no strange, cryptic control files to generate the news.
  22.      VNewz also supports configuration of character colors based on Case
  23.      or Type.  In registered mode, VNews is even more versatile.  It
  24.      supports message expiration, so your news will only run however long
  25.      you want it to run, and allows configuration of the news border
  26.      colors and styles.
  27.      
  28.          Features:
  29.      
  30.          ■ Easy to set up!
  31.          ■ Easy to use!
  32.          ■ Full screen internal message editor with word wrap
  33.          ■ Automatic sorting of messages, newest to oldest
  34.          ■ Move forward or backward in message viewing
  35.          ■ See messages as they will appear to the user
  36.          ■ Select text colors 
  37.          ■ Select frame styles and colors (Reg'd Only)
  38.          ■ Set automatic message expiration (Reg'd Only)
  39.      
  40.      
  41.      -=■[ Legal Stuff ]■=-
  42.      
  43.          1) VNEWZ is copyrighted by Jeremy Gaither, and may only be used
  44.          in accordance with the conditions set forth in this document.
  45.      
  46.          2) VNEWZ is "SHAREWARE".  You may use this software for a period
  47.          NOT to exceed 30 calendar days.  After that time, you must STOP
  48.          using this software, or register it.
  49.      
  50.          3) VNEWZ is provided as-is, without any warranties or guarantees
  51.          of any kind, either expressed or implied.  In no event, shall
  52.          Jeremy Gaither be liable for you or to anyone else for any type
  53.          of damages or costs incurred from the use or inability to use
  54.          VNEWZ.
  55.      
  56.  
  57.  
  58.                                       -1-                                  
  59.  
  60.  
  61.                                                                            
  62.  
  63.  
  64.          4) At no time may compensation for distribution of VNEWZ be
  65.          charged, without prior written permission of Jeremy Gaither.
  66.      
  67.          5) VNEWZ may not be altered, or modified in any way.  Only the
  68.          original, unaltered VNEWZ archive may be distributed.
  69.      
  70.      
  71.      -=■[ Registration ]■=-
  72.      
  73.          VNewz is distributed as Shareware, and as such requires
  74.      registration to obtain the extra features.  VNewz is also
  75.      affordable compared to other news generators, even with its high
  76.      level of abilities.  Registration of VNewz is only $8.00 (US).
  77.      Registration may be sent to the following address:
  78.      
  79.                                 Vision Systems
  80.                               c/o Jeremy Gaither
  81.                             1200 The Meadows Pkwy
  82.                             DeSoto, TX 75115-3516
  83.      
  84.          Included in the archive is a file called 'VREG.DOC'.  This is
  85.      the registration form that should be used when registering VNewz.
  86.      Upon registration, you will receive a KEY file which you must put in
  87.      the same directory as VNewz.  More information about this keyfile
  88.      will be given to you upon registration.
  89.      
  90.          Registration will enable you to do the following:
  91.      
  92.          1) Optional disable for the loader screen in the beginning of
  93.             VNewz.  
  94.          2) Configuration of the border styles and colors.  
  95.          3) Enables expiration support.  
  96.          4) Removes *UNREGISTERED* messages and closing delay.
  97.      
  98.      
  99.      -=■[ StartUp ]■=-
  100.      
  101.          The first part of setting up VNewz is to unzip the archive,
  102.      which you have probably already done if you are reading this.  You
  103.      may put it (VNewz) in a seperate directory or wherever you like.
  104.      VNewz only maintains the executable and a data file, so it will not
  105.      clutter the directory with files.
  106.      {By the next release, ANSi routing for screen display should be
  107.      optional.}
  108.          VNewz requires that an ANSi driver such as ANSI.SYS be loaded
  109.      before the program will run.  If one is not loaded, then it needs to
  110.      be loaded in the CONFIG.SYS file (for most systems).  For
  111.      information on how to do this, consult your Operating System Manual.
  112.          The next step is to load VNewz.  If the data file is not found,
  113.      the configuration program is started.  From here you can configure
  114.  
  115.  
  116.                                       -2-                                  
  117.  
  118.  
  119.                                                                            
  120.  
  121.  
  122.      the options that you will use to run VNewz.  The options are mostly
  123.      self explanatory, but here is some explanation if needed.
  124.      
  125.          1) Path to NEWS files w/o extension:
  126.              This tells VNewz where to put the news files it generates.
  127.              Here's an example:  C:\BBS\TEXT\NEWS
  128.              Do NOT include the extension.  VNewz will tag on the
  129.              extension based on what type of file it is.  
  130.              (ANS, ASC, AVT, PCB, or BBS for example)
  131.      
  132.          2) Pause String:
  133.              This string is something like:
  134.              Press Enter To Continue:
  135.              followed by whatever control code is used to make your BBS
  136.              stop and wait for enter.  (ex:  Ctrl-A) To enter control
  137.              characters, you must press Ctrl-P before the control
  138.              character you wish to type.  (Ctrl-P, Ctrl-A)
  139.      
  140.          3) Reset w/ defaults:
  141.              This is used to re-install all the color defaults.
  142.      
  143.          4) Edit Colors:
  144.              This is used to edit the colors of the text.  The menu
  145.              following it is pretty much self explanatory.
  146.      
  147.          5) Edit Border:
  148.              This is where you edit the border configuration.  This is a
  149.              registered only option.  The sub menu allows you to edit the
  150.              colors of the border, the type of border, the lines used
  151.              to draw the border, the brackets, the bracket colors, and
  152.              subject dithering.  Also included is a quick sample message
  153.              so you can see what your setup looks like easier.  The best
  154.              way to understand this menu is experimentation.     
  155.      
  156.              1,2,3 - Allows you to change the colors of the High, Medium,
  157.                      and Low color dithering of the border.
  158.      
  159.              4 - Changes the color of the brackets
  160.      
  161.              5 - Dither Subject Area - This allows for a nicer color
  162.                  distribution for the subject.
  163.                        
  164.              6 - Changes the border format.  Currently there are three
  165.                  formats :  Plain, Random, and Alternate #1.
  166.      
  167.              7 - Changes the line format.  There are several selectable
  168.                  formats that you have to choose from, and they are all
  169.                  displayed on the screen.
  170.      
  171.              8,9 - Allows you to change the character used for the left
  172.  
  173.  
  174.                                       -3-                                  
  175.  
  176.  
  177.                                                                            
  178.  
  179.  
  180.                    and right brackets.
  181.      
  182.              P - Previews what a sample VNEWZ message would look like
  183.                  according to the configuration you have set up.
  184.      
  185.              Q - Quits the Border and line configuration menu
  186.      
  187.                  There are three different border styles, and four
  188.              different line types, for a total of 12 different borders.
  189.              This does not include the number of possibilities with the
  190.              three different colors within the border itself.
  191.      
  192.          6) Sysop Name:
  193.              When you get your key, this is the field where you need to
  194.              enter your name.  
  195.      
  196.          7) ANSi loader:
  197.              This is a toggle.  If VNewz is registered, then this will
  198.              allow you to turn the ANSi loader off and on at your
  199.              discretion.
  200.      
  201.          8) File Extensions:
  202.              In this sub-menu, you are allowed to define the extensions
  203.              for the different file types.  The file types supported are
  204.              as follows:  ANSi, ASCii, AVaTar, PCBoard, WildCat!.  The
  205.              default extensions are entered when you turn them on.  To
  206.              turn the generation of that screen type OFF, delete the
  207.              extension.  'Inactive' will replace it.
  208.      
  209.      
  210.      -=■[ Operation ]■=-
  211.      
  212.          Now that VNews is all set up, the program will take you to the
  213.      main menu.  Selecting '1' will allow you to read existing messages
  214.      much like a message base, with forward and backward commands.  Here
  215.      is also where you can toggle the Active/Inactivity of a message.
  216.      You may also edit existing messages or delete them from here.  Here
  217.      is a list of the available options while reading messages:
  218.      
  219.              [N] for Next message, 
  220.              [P] for Previous message, 
  221.              [A] to change the activity (status), 
  222.              [E] to edit the current message
  223.              [D] to delete the current message,
  224.              [S] to stop displaying messages.
  225.      
  226.          Option '2' will take you to the editor, where you can enter a
  227.      NEW news message.  The editor uses the standard commands of most
  228.      text editors.  Pressing 'ESC' will allow you to end the session and
  229.      save the message.  When you select to save the message, you will be
  230.  
  231.  
  232.                                       -4-                                  
  233.  
  234.  
  235.                                                                            
  236.  
  237.  
  238.      asked for an expiration date (registered only).  If you want the
  239.      message to expire after a certian date, type the expiration date in
  240.      in a standard format:  07-16-95 ; Month - Day - Year.  You can
  241.      either use dashes, slashes, or spaces to seperate the numbers.
  242.          To get back to the configuration, press 'C'.  To exit, press
  243.      'Q'.  Exiting in this manner will update the news files.  If you do
  244.      NOT want to update the news files, press 'X' to exit, and it will
  245.      bypass that.  After VNewz is done with processing news files and
  246.      closing the data file, you are back at DOS.  Now you can use the
  247.      screens VNewz generated on your BBS.  Now wasn't that simple?
  248.      
  249.      
  250.      -=■[ Color Codes ]■=-
  251.      
  252.          VNews also has the ability to add other colors to the text for
  253.      emphasis.  To insert a color code, add |bf before the text, and |00
  254.      to return it to normal.  The 'bf' in the code is the hex code of the
  255.      color attribute.  Background goes first, and Forground next.  If the
  256.      background color is a 'bright' color, the foreground text will
  257.      blink.  Here is a list of those color codes for your convienience.
  258.      
  259.            ■ Normal ■     ■ Bright ■
  260.            0 - black      8 - bright black
  261.            1 - blue       9 - bright blue
  262.            2 - green      A - bright green
  263.            3 - cyan       B - bright cyan
  264.            4 - red        C - bright red
  265.            5 - magenta    D - bright magenta
  266.            6 - brown      E - yellow
  267.            7 - gray       F - white
  268.      
  269.      
  270.      -=■[ Expiration ]■=-
  271.      
  272.          If VNewz is registered, it will allow you to enter a expiration
  273.      date.  To run the Expiration Maint, add this to your maint batch
  274.      file:  
  275.              VNEWZ /M 
  276.      
  277.          This will start VNews in Maint mode, setting all expired news
  278.      messages to Inactive.  If you want to delete the expired messages
  279.      instead of deleting them, then use the switch /MD.  In Maint mode,
  280.      VNews will not touch any inactive messages, whether they are expired
  281.      or not.  If a message does not include an expiration date, it will
  282.      run until you remove it (or set it inactive).
  283.      
  284.      
  285.      -=■[ VNEWZ.DAT ]■=-
  286.      
  287.          VNEWZ.DAT is the data file file for VNewz.  It contains ALL the
  288.  
  289.  
  290.                                       -5-                                  
  291.  
  292.  
  293.                                                                            
  294.  
  295.  
  296.      news messages, as well as the configuration file.  Deleting this
  297.      file will result in the loss of all your messages, and your
  298.      configuration.  You should NOT do this unless you have been advised
  299.      that the Data file is corrput.
  300.      
  301.      
  302.      -=■[ Closing ]■=-
  303.      
  304.          I have spent many long hours trying to develop a news package
  305.      that would be used by many people.  I have attempted to make it
  306.      bug-free, and compatible with many BBS types.  If you find a bug,
  307.      please tell me about it.  I can be contacted any of the following
  308.      ways.
  309.      
  310.                        NetMail: 1:124/8015@fidonet.org
  311.                     Internet: jeremy.gaither@archives.com
  312.      
  313.                            at my BBS: (214)228-3521
  314.      
  315.                              or by snail-mail at:
  316.      
  317.                                 Vision Systems
  318.                               c/o Jeremy Gaither
  319.                             1200 The Meadows Pkwy
  320.                             DeSoto, TX 75115-3516
  321.      
  322.          Please make all bug reports as thorough as you can.  Detail when
  323.      the problem occurs, what it does and doesn't do, and what it says
  324.      when it happens.  All this information can make it a LOT easier to
  325.      locate and fix the bug.
  326.      
  327.      -=■[ Beta Team ]■=-
  328.      
  329.          Many thanks to my beta team, through MANY beta versions, and
  330.      MANY bugs.  
  331.      
  332.          Beta Team: (in no particular order!)
  333.      
  334.                Malcolm Ramsay    -   Jason Watson
  335.                    Brian Hill    -   Robert Sherrard
  336.                Michael Gedeon    -   David Pellecchia
  337.                     Andy Ziem    -   Bryan Turner
  338.      
  339.          Development Consultation:  David Cauthron of NeXus, Inc.
  340.      
  341.      -=■[ Other Vision Systems products ]■=-
  342.      
  343.          If you enjoyed VNewz, you might want to snag some of our other
  344.      programs.  Here is a list of the current programs.
  345.      
  346.  
  347.  
  348.                                       -6-                                  
  349.  
  350.  
  351.                                                                            
  352.  
  353.  
  354.              Demon Mail v1.3 - The Background Mail Processor.  Demon Mail is
  355.        the answer to all those mail processing problems.  If you have a
  356.        multitasker, you can now process mail in the BACKGROUND!  Demon Mail
  357.        is used to detect inbound mail, outbound mail in your message areas,
  358.        and *.TIC files that need to be processed.  The current version is
  359.        in Alpha testing, and now includes better, more reliable checking
  360.        through semaphore files, and an optional pager contact in case of
  361.        BBS failure.
  362.              Features:
  363.                 - Supports OS/2, DESQview, Windows, and TopView Time Slicing
  364.                 Support.
  365.                 - Checks to see if file is Locked (in use by another program,
  366.                 like your mailer) before it exits.  If it is, Demon Mail
  367.                 doesn't exit; It waits for it to become available.
  368.                 - Only requires a couple of simple changes to your batch
  369.                 files to get it up and running.
  370.                 - Has a configurable delay between checking for files that
  371.                 need to be processed.
  372.       
  373.      
  374.              VCaller v1.2 - Yesterdays and Todays Callers list for
  375.      RemoteAccess without the hassle of midnight events!  VCaller
  376.      generates stylish ANSi, ASCii, & AVaTar screens listing all the
  377.      important information about your callers.  Also currently in Alpha,
  378.      VCaller is being optimized for customiozable colors, total calls
  379.      today, and modified to include such features as 'who is online',
  380.      FrontDoor compatible last inbound/outbound.  
  381.      
  382.          We have other projects planned, such as a user editor door and a
  383.      questionaire door, and if you have suggestions for other projects,
  384.      we would be happy to consider them.  
  385.      
  386.       ========================================================================
  387.         VNewz is Copyrighted (C) 1995 by Vision Systems, All Rights Reserved.
  388.       ========================================================================
  389.      
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.                                       -7-                                  
  407.