home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / GAPNEWS.ZIP / NEWSMAN.DOC < prev    next >
Text File  |  1989-10-05  |  18KB  |  409 lines
  1.  
  2.                              N E W S  M A N A G E R
  3.                                Version 3.20 Beta
  4.                          Release Date: October 5, 1989
  5.  
  6.                 (C) Copyright 1988, 1989 - All Rights Reserved
  7.  
  8.                               a PCBoard/GAP door
  9.  
  10.                              written By Kevin Carr
  11.  
  12.  
  13. ===============================================================================
  14. FEATURES
  15. ~~~~~~~~
  16.   ▐ Allows up to 999 News Entries.
  17.  
  18.   ▐ Support for PCBoard, GAP, or ANY BBS Local Mode.
  19.  
  20.   ▐ Password protection on any or all News Files.
  21.  
  22.   ▐ Support to delete old news.
  23.  
  24.   ▐ Support to make certain News entries expire on a certain date.
  25.  
  26.   ▐ Premanent News entries.
  27.  
  28.   ▐ Color and non-color News files.
  29.  
  30.   ▐ Four different News Styles to choose from.
  31.  
  32.   ▐ Colors of the News are completely definable.
  33.  
  34.   ▐ Support for locked ports up to 38.4K.  Unlimited com ports.
  35.  
  36.   ▐ Many, Many, Many More!
  37.  
  38.  
  39. ===============================================================================
  40. SETUP
  41. ~~~~~
  42.    News Manager needs a configuartion file to operate.  Configuration files
  43.    can be called anything you want, but I will address them as NEWSMAN.CFG.
  44.    A sample NEWSMAN.CFG has been included with this door to serve as a
  45.    guideline.  The format of the NEWSMAN.CFG is as follows:
  46.  
  47. Line #    Example               Description
  48. --------  --------------------  ---------------------------------------------
  49.    1      C:\PCB                The Full Path of PCBOARD.SYS, DOOR.SYS,
  50.                                 or 'LOCAL'
  51.    2      User-To-User          Name of your BBS
  52.    3      1                     '0' = GAP, '1' = PCBoard, '2' = Local
  53.    4      William Pendergast    Sysop's FULL Name
  54.    5      BLUE                  Color of lines in news (borders)
  55.    6      YELLOW                Color of numbers in date of news
  56.    7      MAGENTA               Color of dashes in date of news
  57.    8      WHITE                 Color of text in news
  58.    9      RED                   Color of description in news
  59.   10      2                     Default News Type (1,2,3,4)
  60.   11                            Registration Code or leave it blank
  61.  
  62. The above is the main part of the configuration file.  You must now setup
  63. the News File names.  To support a News File, the door needs to know the
  64. News File Description, Non-Color News Filename, Color News Filename, and
  65. the password required to access the News File (blank=none).  You can have
  66. as little as 1 News File support, or as many as 99 News Files.  You put the
  67. information at the end of the NEWSMAN.CFG file like:
  68.  
  69. Line #    Example               Description
  70. --------  --------------------  ---------------------------------------------
  71.   12      Main Board News       General Description of the News
  72.   13      NEWS1                 Prefix of news data files (MUST BE DIFFERENT
  73.                                 FOR EACH DIFFERENT NEWS FILE!)
  74.   14      M:\PCB\GEN\NEWS       Path/Filename for Non-Color News
  75.   15      M:\PCB\GEN\NEWSG      Path/Filename for Color News
  76.   16      PASSWORD              Password for this news entry (blank=none)
  77.                                 Notice, News Manager compares the
  78.                                 complete line to the one entered, so
  79.                                 watch out for hidden spaces at the end
  80.                                 of this line.
  81.  
  82. For ever extra news file you support, the NEWSMAN.CFG should be increased
  83. by five lines, and include all five lines of the above required information.
  84.  
  85.  
  86. Line #1: If you are running a PCBoard, this line should ONLY include the path
  87.          of the PCBOARD.SYS file, like 'C:\PCB', **NOT** 'C:\PCB\PCBOARD.SYS'!
  88.          (Support for PCBoard 14.x)
  89.  
  90.          If you are running a GAP BBS, this line should ONLY include the
  91.          path of the DOOR.SYS file, like 'C:\GAP', **NOT** 'C:\GAP\DOOR.SYS'!
  92.          (Support for GAP 3.x-4.x)
  93.  
  94.          If you would like to run the door locally, this line can
  95.          contain anything you wish.
  96.  
  97. Line #2: Simply put your BBS name.  If you are a registered News Manager
  98.          user, your BBS *must* be spelled exactly the same way as you gave
  99.          me the information, or News Manager will say 'Un-Registered'.
  100.  
  101. Line #3: Put a '0' if you are running a GAP 4.0+, a '1' for PCB 14
  102.          systems, and a '2' for Local Only mode.
  103.  
  104. Line #4: This is where you tell me the sysops name.  If you are a
  105.          registered NEWSMAN user, your name must be spelled exactly the
  106.          same way as you gave me the information, or News Manager will
  107.          say 'Un-Registered'.
  108.  
  109. Line #5: Your options on this line are either RED, WHITE, BLUE, MAGENTA,
  110.          YELLOW, or GREEN.  The above colors are the brighter (bold) colors.
  111.          If you would like other colors that are not supported here, simply
  112.          put the desired escape code on this line.
  113.  
  114. Line #6: Same as Line #5
  115. Line #7: Same as Line #5
  116. Line #8: Same as Line #5
  117. Line #9: Same as Line #5
  118.  
  119. Line #10: Four News File formats are currently support.  This line should
  120.           contain the DEFAULT News File Style Type, therefore, '1' or
  121.           '2'.  The styles can be found later in the docs.
  122.  
  123. Line #11: Used for Registered News Manager Boards only.  Leave this blank if
  124.           you have not registered News Manager.  Be sure that you put
  125.           the correct code in.  They are tricky little suckers.
  126.  
  127.  
  128. All lines after this configure News Files.
  129.  
  130. You can run News Manager by simply putting the following in your door batch
  131. file, or by typing the following manually:
  132.  
  133.      'NEWSMAN.EXE NEWSMAN.CFG'
  134.  
  135.   Of course, you should replace NEWSMAN.CFG with the name of your
  136.   configuration filename.
  137.  
  138.  
  139. ===============================================================================
  140. NEWS MANAGER FILES
  141. ~~~~~~~~~~~~~~~~~~
  142.    Filename          Description
  143.    ----------------  --------------------------------------
  144.    NEWSMAN.EXE       News Manager Executable Program
  145.    NEWSMAN.DOC       News Manager Documentation
  146.    NEWSMAN.CFG       News Manager Sample Configuration File
  147.    REGISTER.FRM      Registration Form - Please support Shareware!
  148.  
  149. ===============================================================================
  150. DAILY MAINTENANCE (Optional)
  151. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  152.   If you use the expiration dates on News entries & your BBS supports nightly
  153.   events, it is recommended that you read this section of the docs.  If for
  154.   some reason, your BBS does not support nightly events, you should run
  155.   News Manager manually and select the [R]enumber option from the main menu
  156.   of each individual News file.  If you simply do not want to support
  157.   expiration dates, you can totally ignore this section.
  158.  
  159.   The Daily Maintenance routines will go through each News entry that is
  160.   listed in the NEWSMAN.CFG, and process each one.  It will first check
  161.   to see if any old is new, and therefore should be deleted.  It will then
  162.   create the master News files (from information in NEWSMAN.CFG).
  163.  
  164.   You should run the News Manager maintenance by putting the following in
  165.   your nightly event, or running it manually whenever you wish:
  166.  
  167.      NEWSMAN /DAILY:NEWSMAN.CFG
  168.  
  169.   Of course, you should replace NEWSMAN.CFG with the name of your
  170.   configuration filename.
  171.  
  172.  
  173. ===============================================================================
  174. NEWS ENTRY FILENAME FORMAT
  175. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  176.    Each news entry is stored in its own file.  I am taking the time to explain
  177.    all of this to you just in case you ever have the need to make changes
  178.    or additions to the news with using News Manager.
  179.  
  180.    The filename for the news files are as follows:
  181.  
  182.        [prefix].yyy   & [prefix]G.yyy
  183.        (Non-Color)       (Color)
  184.  
  185.    Each News file (five lines of NEWSMAN.CFG) is given a number.
  186.  
  187.    [prefix] stands for the news' unique prefix.
  188.  
  189.    News Manager supports up to 999 news entries in each news file.  Each
  190.    news entry is given a number from 001 to 999.  'yyy' stands for the
  191.    news entry's number.
  192.  
  193.    The first line of each file contains the expiration date for that news
  194.    entry.  Every line after that is the actual news entry.
  195.  
  196.    Both the non-color AND the color news entry files should exist, or problems
  197.    may occur!
  198.  
  199.  
  200. ===============================================================================
  201. PERMANENT NEWS ENTRY (Optional)
  202. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  203.    If you desire to have a News Entry ALWAYS stay on top, this section is for
  204.    you!  This feature can be used if you support Echomail/Netmail and you want
  205.    the last Mail Transfer Date/Time at the top of the News or for any other
  206.    reason which requires a permanent news entry.
  207.  
  208.    The permamnt News entry should be put into the files [prefix].000 &
  209.    [prefix]G.000.  Re-read the section 'NEWS ENTRY FILENAME FORMAT' if you
  210.    have forgotten what the 'x' stands for.  The difference between this file
  211.    and the rest of them is that this one does not have an expiration date on
  212.    the first line.
  213.  
  214.    I use this feature since I am part of the RelayNet.  I put the last
  215.    date/time we did a successful mail transfer at the top of the News file.
  216.    I put the following in my PCRelay batch file:
  217.  
  218.          COPY LASTTIME.TXT D:\NEWSMAN\NEWS1.000
  219.          COPY LASTTIME.TXT D:\NEWSMAN\NEWS1G.000
  220.          D:
  221.          CD\NEWSMAN
  222.          NEWSMAN /DAILY:NEWSMAN.CFG
  223.  
  224.    (Remember that News Manager needs both a color and non-color News 000)
  225.  
  226.  
  227. ===============================================================================
  228. NEWS STYLES
  229. ~~~~~~~~~~~
  230.      ┌──────────┐                                               ┌─────────────┐
  231. ─────┤ 00-00-00 ├───────────────────────────────────────────────┤ Description │
  232.      └──────────┘                                               └─────────────┘
  233.   News Style #1
  234.  
  235.  
  236.       ┌───────────────────────┐
  237.  ┌────┤ Description, 00-00-00 ├───────────────────────────────────────────────┐
  238.  │    └───────────────────────┘                                               │
  239.  │ News Style #2                                                              │
  240.  └────────────────────────────────────────────────────────────────────────────┘
  241.  
  242.  
  243. ===============================================================================
  244. NEWSMAN COMMANDS
  245. ~~~~~~~~~~~~~~~~
  246.    Main Command Menu
  247.    -----------------
  248.    ┌────────────────────────────────────────────────────────────────────────┐
  249.    │     (A)dd News, (H)elp, (G)raphics Toggle, (P)age Sysop, (R)enumber    │
  250.    │            (V)iew/Delete News, (Q)uit to Menu, (QU)it to BBS           │
  251.    └────────────────────────────────────────────────────────────────────────┘
  252.  
  253.     (A): Add News.  This is the command that allows you to add a new News
  254.          entry.
  255.  
  256.     (H): Help.  This gives a short explanation of these commands.
  257.  
  258.     (G): Graphics Toggle.  This will toggle your ANSI support On/Off.
  259.  
  260.     (P): Page Sysop.  Page the sysop to chat.
  261.  
  262.     (R): Renumber.  With this command, you can check for expired news
  263.          files, or just renumber your NEWSxx.yyy and NEWSxxG.yyy files.
  264.  
  265.     (V): View/Delete News.  This is where you can either view the complete
  266.          news file, individual news entries, or delete any news entry.
  267.  
  268.     (Q): Quit to Menu.  This will take you back to the News File selection
  269.          menu.  It will ask you if you would like to create a new news file
  270.          first.
  271.  
  272.     (QU): Quit to BBS.  Exit back to the BBS.  This command also asks you if
  273.           you would like to create a new news file.
  274.  
  275.     (*): Some general information on News Manager.
  276.  
  277.  
  278.     Add News - Message Style - Commands
  279.     -----------------------------------
  280.     (A): Abort.  Abort the news you were typing, and return to the main
  281.          menu.  News will not save.
  282.  
  283.     (C): Continue.  Continue typing news once you are at the Add News prompt.
  284.  
  285.     (D): Delete.  Delete one line out of the news you are typing.
  286.  
  287.     (E): Edit.  Edit one line of the news you are typing.
  288.  
  289.     (F): File Imp.  Import any file into the news you are typing.  If the
  290.          file is too long or too wide, News Manager will chop parts of it
  291.          off and notify you of the problem.
  292.  
  293.     (H): Help.  Short description of these commands.
  294.  
  295.     (I): Insert.  Insert one line before another line.
  296.  
  297.     (L): List.  List what you have typed so far.
  298.  
  299.     (T): Title.  Change the news title (description) or the expiration date.
  300.  
  301.     (S): Save.  Save the news & return to the main menu.
  302.  
  303.  
  304. ===============================================================================
  305. SUBSTITUTION VARIABLES
  306. ~~~~~~~~~~~~~~~~~~~~~~
  307.    Many BBSes now support something called Substitution Variables or
  308.    SmartText (whatever you wish to call it).  With PCBoard 14.2, a variable
  309.    would look something like: "@USER@".  When using the Boxed or Printer
  310.    Paper Style news formats, these variables should NOT be used since the
  311.    variables vary in length depending on who is reading it, and the variables
  312.    are usually different lengths then the actual text it displays.  This
  313.    causes the spacing to be unpredicatable!
  314.  
  315.  
  316. ===============================================================================
  317. HISTORY
  318. ~~~~~~~
  319. (Versions 1.0 to 2.3 were called Newsgen)
  320.  
  321. Ver 3.00 -  Official News Manager Release!  Because this version is
  322.             almost completely different that Newsgen, I will not list
  323.             all of the changes.  You should simply read the docs like
  324.             this was a completely new door.  If you registered NEWSGEN,
  325.             please fill out the REGISTER.FRM and tell me that you have
  326.             already sent money.  I have lost the addresses of a few
  327.             of you.  Enjoy!
  328.  
  329. Ver 3.20 -  News Manager will only update the NEWS/NEWSG file's dates/times
  330.             when new news has been added.  Therefore, no long will the
  331.             NEWS/NEWSG files have the current date/time everytime you create
  332.             it.  It will have the date of the last news entry for that
  333.             NEWS/NEWSG file.  Thanks to Rod Renner for sending me his ASM
  334.             routines to read/write dates from/to files.  You can now import
  335.             a complete file without having to worry about fitting it into
  336.             the 72 character length limit.  You can specify the name of
  337.             an ANSI and an ASCII version of the file.  News Manager now
  338.             supports up to 38.4K and unlimited com ports.  A new line
  339.             has been added to the NEWSMAN.CFG file.  You must now specify
  340.             the type of BBS you are running on line 3.  See above docs
  341.             for more information.  You no longer need the 'SET GAPQBDR='
  342.             variables!
  343.  
  344. ===============================================================================
  345. BETA TESTERS
  346. ~~~~~~~~~~~~
  347.         I would like to thank the beta testers of our software.  Thanks
  348.         for helping make our doors look better!
  349.  
  350.                PCBoard User-To-User
  351.                214-492-6565, 14.4K HST/V32
  352.                Sysop - William Pendergast & Kevin Carr
  353.                Net - RelayNet (UTOU)
  354.  
  355.                PCBoard DFW COM Shop
  356.                817-572-0749, 9600 Hayes
  357.                Sysop - Sonny Maxwell
  358.                Net - RelayNet (DFW)
  359.  
  360.                PCBoard SALEMDUG
  361.                202-646-2887, 9600 HST
  362.                Sysop - Rod Renner
  363.  
  364. If you are interested in being a beta tester, please contact me on the BBS
  365. below.  If you are a beta tester and NOT listed above, please notify me!
  366.  
  367. ===============================================================================
  368. DISTRIBUTION
  369. ~~~~~~~~~~~~
  370.         NEWS MANAGER is Copyrighted by Carr Software & Kevin Carr,
  371.         with all rights reserved.  This program is being distributed
  372.         via the SHAREWARE concept and as such, may be copied freely
  373.         with the following restrictions:
  374.  
  375.                 * The program must be supplied in it's original
  376.                   unmodified form, including documentation.
  377.  
  378.                 * No fee is charged for distribution.
  379.  
  380.                 * NEWS MANAGER may not be distributed as part of any
  381.                   other application or service without the express
  382.                   written consent of the author.
  383.  
  384.    THIS PROGRAM IS NOT A DEMO.  IT INCLUDES NO EXPIRATION OR  "CRIPPLEWARE"
  385.    CODE WHATSOEVER.  REGISTRATION IS OPTIONAL, BUT RECOMMENDED BECAUSE....
  386.  
  387.         NEWS MANAGER represents many hours of programming and the author
  388.         deserves just compensation for his time, efforts and expertise.
  389.         If you find this program to be of some value and you continue
  390.         to use it on your BBS system, you must return the registration
  391.         form provided along with the $15.00+ registration fee.  This small
  392.         fee will ensure future doors/utilities from us.
  393.  
  394.         Authors: I will give registered copies of my software to any
  395.                  author who sends me registered software of his software.
  396.  
  397.       Suggestions, comments, bug notices, etc. may be sent to the address
  398.                           below or via electronic mail.
  399.  
  400.                     (Checks should be made out to Kevin Carr)
  401.  
  402.                                 Kevin Carr
  403.                               P.O. Box 797381
  404.                          Dallas, Texas  75379-7381
  405.  
  406.                         214-492-6565, 14.4K HST/V32
  407.                               RelayNet ID: UTOU
  408.  
  409.