home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / NEWS57.ZIP / NEWS.ASC < prev    next >
Encoding:
Text File  |  1995-01-07  |  8.0 KB  |  220 lines
  1.  
  2.  
  3.  
  4.                       NewsDoor 1.0
  5.  
  6.                      (C) Copyright
  7.                 LiveSystems Software 1994
  8.  
  9.  
  10.  
  11.  
  12.  
  13. Table of contents:
  14.  
  15.  
  16. I. Copyright and disclaimer.. . . . . . . . .  Page: 1
  17.  
  18. II. Introduction. . . . . . . . . . . . . . .  Page: 2
  19.  
  20. III. How to install NewsDoor. . . . . . . . .  Page: 3
  21.  
  22. IV. the FILTER.DAT file.. . . . . . . . . . .  Page: 5
  23.  
  24. V. Other features:. . . . . . . . . . . . . .  Page: 5
  25.  
  26. VI. Shareware . . . . . . . . . . . . . . . .  Page: 5
  27.  
  28. I. Copyright and disclaimer.
  29.  
  30. NewsDoor is Copyrighted by LiveSystems Software 1994
  31. ALL RIGHTS RESERVED
  32.  
  33. LiveSystems Software makes no warranty of any kind, either
  34. express or implied, including but not limited to implied
  35. warranties of merchantability and fitness for a particular
  36. purpose, with respect to this software and accompanying
  37. documentation.
  38.  
  39. IN NO EVENT SHALL LIVESYSTEMS SOFTWARE BE LIABLE FOR ANY DAMAGES
  40. RESULTING FROM THE USE OF THIS SOFTWARE.
  41.  
  42. All other productnames found in this document are trademarks of
  43. various companies.
  44. II. Introduction.
  45.  
  46. NewsDoor is an external BBS program which handles the showing of
  47. newsflashes or bulletins on a RemoteAccess 2.0x, SuperBBS 1.1x
  48. or QuickBBS 2.75 BBS.
  49.  
  50. What puts NewsDoor apart from other bulletin programs is that
  51. NewsDoor doesn't make bulletins. It only shows them. The
  52. bulletins are stored as messages in a standard Hudson
  53. messagebase, maintainance is done using you nightly messagebase
  54. maintainance and entering new flashes is done through your
  55. favourite message-editor.
  56.  
  57. Here is a list of features:
  58.  
  59.      ■    NewsDoor is multiline aware
  60.      ■    It supports a number of multitaskers like DesqView,
  61.           OS/2, Windows and PC-MOS.
  62.      ■    NewsDoor has multilanguage support.
  63.      ■    NewsDoor works with QBBS, SBBS and RA 2.0x.
  64.      ■    Users can be asked if they want to read new bulletins
  65.           or they can be forced. Forcing also has a maximal
  66.           number of forced bulletins so the users don't have to
  67.           read hundreds of old bulletins.
  68.      ■    NewsDoor can delay before the user can press continue
  69.           or stop reading. 
  70.      ■    NewsDoor uses the lastread pointers to show only new
  71.           bulletins. 
  72.      ■    Username, mailarea etc. are all installable. 
  73.      ■    Automatic translation of high-ascii to low-ascii when
  74.           needed.
  75.  
  76. Because of the usage of the messagebase, you can share a
  77. newsarea with other nodes, force the users of offline readers to
  78. read them too, send them to your points etc. 
  79. III. How to install NewsDoor.
  80.  
  81. Before you install NewsDoor in your BBS, you first have to
  82. decide which messagearea to use for the newsflashes. Theoretical
  83. it is possible to share an area with some other usage, but in
  84. general you probably like to dedicate an area for this usage. 
  85.  
  86. You also want to decide on a username to use. Default for
  87. NewsDoor is "ALL", messages to all are shown, the others are
  88. ignored. 
  89.  
  90. The most basic installation of NewsDoor is from a Type 7
  91. menuentry with an parameter line:
  92.  
  93.      <Path>\NEWS.EXE -AREA:<AreaNr>
  94.  
  95. for a single node system or
  96.  
  97.      <Path>\NEWS.EXE -AREA:<AreaNr> -P:*P
  98.  
  99. for a multiline system. Using these commandlines, NewsDoor will
  100. show all the messages to ALL in the <AreaNr> area. The user just
  101. gets the first flash but can stop reading immediately.
  102.  
  103. Here is a list of the other possible parameters:
  104.  
  105.      -ASK      Ask the user if he wants to read the new flashes.
  106.                If there are new flashes, the default choice will
  107.                be Yes, otherwise it will be No.
  108.  
  109.      -FORCE[:<Count>] 
  110.                Force a user to read new flashes. If you keep
  111.                many flashes, using the extra :<count> would be a
  112.                good idea. Otherwise a new user will have to read
  113.                ALL the flashes available. For example:
  114.                -FORCE    Forces the user to read ALL the flashes
  115.                          available.
  116.                -FORCE:3  Forces the user only to read the last 3
  117.                          new flashes. After that it's optional.
  118.  
  119.      -T:<Time> This is a leftover from previous version. You can
  120.                use it to limit the time available in the door.
  121.                Normally you would use it as -T:*T, but it is not
  122.                needed anymore.
  123.  
  124.      -N:<Node> If you don't use the new (RA 2.0x) TASK
  125.                environment variable, you need a -N:*N on your
  126.                commandline. Otherwise, it is not needed.
  127.  
  128.      -P:<Port> Only needed in multiline systems. Personally I
  129.                always put it, also on singleline systems.
  130.  
  131.      -AREA:<AreaNr>
  132.                Define the hudsonbase area to use. Has to be in
  133.                the range 1-200. This is the only parameter which
  134.                is obligatory!
  135.  
  136.      -U:<UserName>
  137.                Use this parameter to define the addressee, who's
  138.                messages should be shown. Default is ALL. (Which
  139.                mean that messages you want to show up in
  140.                NewsDoor should be addressed to ALL) Spaces can
  141.                be replaced by underscores. For example: -
  142.                U:Piet_Peut
  143.  
  144.      -SkipOld  Don't do anything when there are no new flashes.
  145.                The user will only see a short "shelling to an
  146.                external program" message.
  147.  
  148.      -Del      Delays the user in breaking of the NewsDoor.
  149.                Whenever a flash is shown the user gets a
  150.                optionline with the options to continue or stop
  151.                reading. Using this option it takes a second
  152.                before this line shows up and the inputbuffers
  153.                are cleaned too before the user regains control.
  154.                An extra way to stimulate reading..
  155.  
  156. Examples:
  157.  
  158.      NEWS.EXE -AREA:200 -SkipOld -NoAsk -Force:3 -N:*N -P:*P
  159.  
  160. Show all messages to ALL in area 200. If there is nothing new,
  161. don't bother the users. If there is something to show, put it on
  162. the screen and force them to read at least the last three new
  163. flashes. This is what I use myself.
  164.  
  165.      NEWS.EXE -AREA:200 -U:News_Flash -N:*N -P:*P
  166.  
  167. Show all the flashes in area 200 addressed to "News Flash" 
  168.  
  169. IV. the FILTER.DAT file.
  170.  
  171. If you write your flashes, chances are that all kind of "noise"
  172. gets into the newsflash. Originlines, tearlines, kludges etc.
  173. To filter all this out, you can use the FILTER.DAT file. This
  174. file contains text-strings which have to be at the beginning of
  175. the lines to filter. For example:
  176.  
  177. 
  178. * Origin:
  179. SEEN-BY:
  180. ---
  181.  
  182. Etc. Every line which starts with one of these strings is not
  183. shown on screen. The FILTER.DAT should be located in the same
  184. directory as the NEWS.EXE file.
  185.  
  186.  
  187. V. Other features:
  188.  
  189. When you write a flash you can use the complete IBM
  190. extended-ascii characterset. NewsDoor knows how to translate
  191. diacritical characters, line and box-symbols and a number of the
  192. other high-ascii characters to low-ascii. Don't use silly
  193. kludges like composed characters systems and such. How a
  194. character is shown on the screen should be handled by the output
  195. system, not during input.
  196.  
  197.  
  198. VI. Shareware
  199.  
  200. NewsDoor is shareware. This means that you have a limited time,
  201. say 30 days, to evaluate the program. After this period you have
  202. to decide if this program is useful for you, and if it is, to
  203. register. Continue to use this program without registering is
  204. illegal.
  205.  
  206. When you register NewsDoor you will get a registration key which
  207. removes the unregistered messages in the flash-screen and which
  208. adds a registered message plus the name to who it was registered
  209. during the program exit.
  210.  
  211. Registration can be done by sending cash, international postal
  212. money-order or by transferring the shareware fee to my giro-account.
  213. Creditcards and cheques are not accepted. After the money and
  214. the registrationform are received a key fill be send using
  215. fidonet fileattach, Internet uuencoded mail or snailmail. Please
  216. include a fidonet or internet address. 
  217.  
  218. See the files ORDER.FRM and SUPPORT.DOC for information on how
  219. to get support and how to register NewsDoor.
  220.