home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / inews325.zip / NEWS.DOC < prev    next >
Text File  |  1993-09-26  |  14KB  |  533 lines
  1.  
  2.     ▀▀▀▀▀▀ ▀▀▀▀▀▀  ▀▀▀▀▀▀   ▀▀▀▀▀        ▀▀▀   ▀▀ ▀▀▀▀▀▀▀ ▀▀     ▀▀  ▀▀▀▀▀
  3.       ▀▀   ▀▀   ▀▀ ▀▀   ▀▀ ▀▀            ▀▀▀▀  ▀▀ ▀▀      ▀▀  ▀  ▀▀ ▀▀
  4.       ▀▀   ▀▀▀▀▀▀  ▀▀▀▀▀▀   ▀▀▀▀▀        ▀▀ ▀▀ ▀▀ ▀▀▀▀▀   ▀▀ ▀▀▀ ▀▀  ▀▀▀▀▀
  5.       ▀▀   ▀▀   ▀▀ ▀▀   ▀▀      ▀▀       ▀▀  ▀▀▀▀ ▀▀      ▀▀▀▀ ▀▀▀▀      ▀▀
  6.     ▀▀▀▀▀▀ ▀▀▀▀▀▀  ▀▀▀▀▀▀  ▀▀▀▀▀▀        ▀▀   ▀▀▀ ▀▀▀▀▀▀▀  ▀▀   ▀▀  ▀▀▀▀▀▀
  7.  
  8.  
  9.                  ▀▀   ▀▀▀▀▀  ▀▀      ▀▀   ▀▀▀▀▀   ▀▀▀▀▀  ▀▀▀▀▀▀
  10.                 ▀▀   ▀▀   ▀▀  ▀▀    ▀▀▀  ▀▀   ▀▀ ▀▀   ▀▀     ▀▀▀
  11.                 ▀▀  ▀▀▀       ▀▀     ▀▀   ▀▀▀▀▀▀  ▀▀▀▀▀▀  ▀▀▀▀
  12.                 ▀▀   ▀▀   ▀▀  ▀▀     ▀▀       ▀▀      ▀▀     ▀▀▀
  13.                  ▀▀   ▀▀▀▀▀  ▀▀     ▀▀▀▀  ▀▀▀▀▀   ▀▀▀▀▀  ▀▀▀▀▀▀
  14.  
  15.  
  16.                     ▀▀▀▀▀▀  ▀▀▀▀▀    ▀▀▀▀▀   ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀
  17.                       ▀▀   ▀▀       ▀▀   ▀▀  ▀▀         ▀▀
  18.                       ▀▀    ▀▀▀▀▀  ▀▀▀   ▀▀▀ ▀▀▀▀▀      ▀▀
  19.                       ▀▀        ▀▀  ▀▀   ▀▀  ▀▀         ▀▀
  20.                     ▀▀▀▀▀▀ ▀▀▀▀▀▀    ▀▀▀▀▀   ▀▀         ▀▀
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                         IBBS NEWS GENERATOR V3.25ß
  28.  
  29.  
  30.  
  31.  
  32.                            BY  KRISTINN TOMASSON
  33.  
  34.  
  35.  
  36.                        (C) 1993   INFIDEL SOFTWORKS
  37.  
  38.                    +36 72 81 39 Sapphire Public Network
  39.  
  40.                              ZyXEL 19200 Baud
  41.  
  42.  
  43.                                   24Hrs.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                    - 1 -
  60.  
  61. IBBS NewsGenerator V3.25ß                                           Page  2
  62. ───────────────────────────────────────────────────────────────────────────
  63.  
  64. TABLE OF CONTENTS
  65.  
  66.  
  67.   1.1     Introduction.......................................3
  68.  
  69.   2.1     Installation & Operation...........................4
  70.  
  71.   3.1     History............................................8
  72.  
  73.  
  74.   4.1     Bugs Detected......................................9
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                    - 2 -
  120.  
  121. IBBS NewsGenerator V3.25ß                                           Page  3
  122. ───────────────────────────────────────────────────────────────────────────
  123.  
  124. INTRODUCTION
  125.  
  126.  
  127.  
  128.    The concept of this program started, when I decided I didn't feel like
  129. registering some copy of a News Generator, those 100 D.Kr were more needed
  130. for paying my phone bills, aswell as my 3 Wifes, and 1 Kid, who were almost
  131. starving, so I was forced to start producing my own Software!!!
  132.  
  133.     Infidel BBS has closed, I will though still continue to release shareware
  134. programs. My new support BBS's are:
  135.  
  136.     SAPPHIRE PUBLIC NETWORK - 36 72 81 39
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143. AKNOWLEDGEMENTS
  144.  
  145.  
  146.    Thanks to the following:
  147.  
  148.  
  149.   Henrik Dahm, at the SAPPHIRE PUBLIC NETWORK for testing the program, and
  150.   bearing over with me for sending, BUG Fixes every other day :-). Aswell
  151.   as starting a NewReleases FileRequesting Service!
  152.  
  153.   Same goes to Brian Vinberg, at BKV DATA BBS...
  154.  
  155.   And finally, to my 3 Wifes, 1 son, and my adopted daughter, who, were forced
  156.   to watch Scanned pictures of food, while I was eating, as I am their only
  157.   source of Income...
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                                   - 3 -
  179.  
  180. IBBS NewsGenerator V3.25ß                                           Page  4
  181. ───────────────────────────────────────────────────────────────────────────
  182.  
  183.  
  184. INSTALLATION
  185.  
  186.   Install the software in your SuperBBS / RA Text Directory. Make sure that
  187. the Color.CFG is in the same Directory, as The program will not work without
  188. it. If you run a Registered Version, The NEWS.CFG should also be present,
  189. otherwise you will just get the UNREGISTERED Message!
  190.  
  191.   Now Featured, in version 3.25ß is an internal Text editor! So when you start
  192. NEWS.EXE you will start in a text editor. If you have used IBBS News
  193. generator earlier, then the NEWS.TXT file will be loaded. If it, however,
  194. doesn't exist, the editor will create a new file.
  195.  
  196.   The format of NEWS.TXT is:
  197.  
  198.   dd-mmm                               {The Date                             }
  199.   !NEW INEWS VERSION                   {The Headline, the '!' is IMPORTANT   }
  200.   %02  The [IBBS News Generator V3.22] {The %02 indicates to change color of }
  201.                                        {text inside brackets see below for   }
  202.                                        {Different Colors Availeable          }
  203.     is finished.                       {The News Article                     }
  204.   \$$\                                 {Show END of ARTICLE                  }
  205.   ....
  206.   ....
  207.   \$$\
  208.   ....
  209.   ....
  210.   \$$\                                 {END OF FILE                         }
  211.  
  212.   {!!!!!MAKE SURE THAT THERE ARE NO EMPTY LINES AFTER THE LAST '\$$\'!!!!}
  213.  
  214.   Examine The Enclosed NEWS.TXT.
  215.  
  216.  
  217. THE COLOR.CFG FILE
  218.  
  219.   The Color.cfg File as been set to default Values, however, if you want to
  220. change the color Setup of the News.ANS (The Output) Do The following:
  221.  
  222. Use your favorite Text Editor, and Open COLOR.CFG;
  223.  
  224. 1. TOPBAR COLOR: This is the Bar which appears at the top of the Screen.
  225.    In Version 2.00 There Are only 2 Possible Settings. Blue/Green or
  226.    Green/Blue...
  227.  
  228. 2. HEADLINE COLOR: This is the 'HEADLINES' Title in the News Summary Part
  229.    of the News File, I have only Permitted 4 Different Colors.
  230.  
  231. 3. HEADLINE DATE: This is the Date part of the News Summary, here you have
  232.    8 Colors Availeable.
  233.  
  234. 4. HEADLINE TEXT COLOR: The Headline, Connected to the Above.
  235.  
  236.  
  237.                                 - 4 -
  238.  
  239. IBBS NewsGenerator V3.25ß                                           Page  5
  240. ───────────────────────────────────────────────────────────────────────────
  241.  
  242.  
  243. COLOR.CFG FILE CONT'D
  244.  
  245. 5. UNDERSCORE COLOR: The Underline of all the Titles in the News File
  246.    eg. HEADLINES
  247.     >  ─────────  <-- Here We get a little more Advanced, I have selected
  248.    4 different color shades; blue, Green, Red, and Gray, If you select the
  249.    Blue, the Underline will go from light blue to a deep blue, and then back
  250.    again (To the Light Blue).
  251.  
  252. 6. TOPBOX COLOR: Same as Above, except, The color, of The News Article
  253.    Separator.
  254.  
  255. 7. TOPBOX DATE COLOR: This is the Color of The Date, enclosed in the above
  256.    Separator.
  257.  
  258. 8. NEWSHEADLINE COLOR: This is The color of The NewsHeadline.
  259.  
  260. 9. NEWSTEXT COLOR: This is the Physical News...
  261.  
  262. When you Change The Values, Make Sure there is only ONE Space between the
  263. Color Command, and The Value, only values in the Ranges specified are
  264. accepted.
  265.  
  266.  
  267. THE NEWS TEXT FILE
  268.  
  269.   You can now change the color of text inside the news article, you are
  270. permitted one changing color per line, but as many changes as you desire.
  271. That is:
  272.  
  273.    %01  Hello [How] are [you] this [fine] morning?
  274.  
  275. Will change all the text Inside the brackets to DarkGray, and all the other
  276. text will remain as defined in your Color Config file!
  277.  
  278.  
  279. COLORS AVAILEABLE
  280.  
  281.   %01   - DarkGray          %08   - Blue               %15  - Light Gray
  282.   %02   - Red               %09   - Light Blue
  283.   %03   - Light Red         %10   - Magenta
  284.   %04   - Green             %11   - Light Magenta
  285.   %05   - Light Green       %12   - Cyan
  286.   %06   - Yellow            %13   - Light Cyan
  287.   %07   - Brown             %14   - White
  288.  
  289.   If you Add 20 to the above values, the text will blink.
  290.  
  291. %26  Mary had a [Sheep]
  292.  
  293.   'Sheep' will now be blinking yellow.
  294.  
  295.  
  296.                            - 5 -
  297.  
  298. IBBS NewsGenerator V3.25ß                                           Page  6
  299. ───────────────────────────────────────────────────────────────────────────
  300.  
  301.  
  302. INSTALLATION CONT'D
  303.  
  304.  
  305.  
  306. Save The COLOR.CFG file, and execute NEWS.EXE, you can now view the
  307. generated news files, by typing (For MS-DOS 5.0):
  308.  
  309.  TYPE NEWS.ANS |more
  310.  
  311.  
  312. THE INEWS EDITOR
  313.  
  314.   This Release, 3.25ß, features a plain vanilla, text editor, which allows
  315. you to edit your News file. The Keys of operation are:
  316.  
  317.  <F1> - Will Show These Keys, aswell as the current set of commands availeable
  318.         ie. The ColorCodes, the various command signs (eg. '!', etc...)
  319.  
  320.  <F2> - Will 'compile' the news.txt you are working on, and show the resulting
  321.         ANSI file on the screen, and the return to the editor.
  322.  
  323.  <ESC>- Will Quit the editor, and if you have made changes, ask you if you want
  324.         to save them, press Y-Yes, N-No.
  325.  
  326.         Y- The text will be saved, and the text will be Compiled with changes
  327.            to an ANSI / ASCII file called NEWS.ANS / NEWS.ASC.
  328.  
  329.         N- The old text will be re-compiled til ANSI / ASCII Files.
  330.  
  331.  ^ = <CTRL>
  332.  
  333.  ^N - Insert Line
  334.  ^W - Move Text down                       ^Z - Move Text up
  335.  
  336.  PageDn - Move 1 Page down                 PageUp - Move 1 Page up
  337.  Home   - Move to Home pos. of line        End    - Move to end pos. of line
  338.  ^PgDn  - Move to Bottom pos. of Doc.      ^PgUp  - Move to top Pos. of Doc.
  339.  
  340.  
  341. THE PARAMETERS
  342.  
  343. NEWS.EXE -C : If you for some strange reason don't like the editor in INEWS,
  344.               use the parameter -c, Which starts the compiler straight away,
  345.               and that way skips the Editor. But note: You won't get my
  346.               Excellent Inline Help, nor the preview function :-).
  347.  
  348. NEWS.EXE -V : Instead of typing TYPE NEWS.ANS |more, the function just types
  349.               out the NEWS.ANS onto the screen.
  350.  
  351.  
  352.  
  353.  
  354.  
  355.                                - 6 -
  356.  
  357. IBBS NewsGenerator V3.25ß                                           Page  7
  358. ───────────────────────────────────────────────────────────────────────────
  359.  
  360. If you Have any problems, don't hesitate to write to me, either through
  361. my Support BBS:
  362.  
  363.                 SAPPHIRE PUBLIC NETWORK
  364.                 +36 72 81 39
  365.  
  366.                 Open 24 Hrs
  367.  
  368.                 Or write to me: 2:231/339.30@FidoNet
  369.  
  370. Or:             Kristinn Tomasson
  371.                 ScharlingsVej 16, 4tv
  372.                 2500 Valby
  373.                 Denmark
  374.                 ═══════
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.                                - 7 -
  415.  
  416. IBBS NewsGenerator V3.25ß                                           Page  8
  417. ───────────────────────────────────────────────────────────────────────────
  418.  
  419. HISTORY
  420.  
  421.    V1.00  -  Had no external Features (The color Screen).
  422.              A Bug fixed: If you had an Uneven Number of News Articles
  423.                           The Last was not printed.
  424.  
  425.    V1.10  -  Some People said they wouldn't mind being able to decide
  426.              what colors to use. This Version never made it Past the BETA
  427.              Release, was only used at Beta Sites.
  428.              Main Beta Site:    Sapphire Public Network   36 72 81 39
  429.  
  430.    V2.00  -  This was the official Color Release, which was widely availeable
  431.              One feature missing, was the capability of changing colors inside
  432.              the news Article.
  433.  
  434.    V2.10  -  We now Implemented the feature of changing Colors Inside News
  435.              Articles. After releasing the version, we however discovered that
  436.              the color codes weren't removed, in the ASCII news file!
  437.  
  438.    V2.11  -  The above problem was Corrected, but was however only availeable
  439.              to Registered Users. (One benefit of Registering INEWS, you will
  440.              be informed of BUGS, etc) However, this problem will be corrected
  441.              as of Version 3.00.
  442.  
  443.    V3.0ß  -  A Beta Release, With built in IBBS News Editor <tm> :-)
  444.              and ASCII bug Fix. A small bug in this one :-). For some STRANGE
  445.              reason, the ANSI News file wasn't always created ???
  446.  
  447.    V3.1ß  -  Weeeell fixed that problem, I think, I will now test it for a few
  448.              days...
  449.  
  450.    V3.20  -  Got some complaints about my colorcodes :-) So I have now
  451.              Included an internal help screen which also shows the editor
  452.              keys / Command Symbols etc... Found a bug in this version, if the
  453.              NEWS.TXT didn't exist, the program would crash, and changes would
  454.              not be saved.
  455.  
  456.    V3.21  -  Fixed above Save problem, and I can now, hopefully, take a
  457.              vaccation from all these PROBLEMS :-)
  458.  
  459.    V3.22  -  Some Minor Internal Improvements, such as making the code more
  460.              structured, making it easier to imrpove later on... I also made
  461.              this version ready to be released, world wide...
  462.  
  463.    V3.23  -  Never released...
  464.  
  465.    V3.25ß -  Beta-Release. Added Blink values, and the -C command which
  466.              deisables the editor, and jumps straight to the Compile function
  467.              (For people who don't like my editor, with built in help...)
  468.              I added the View NEWS.ANS function through <F2> or the -V
  469.              command
  470.  
  471.  
  472.  
  473.                                  - 8 -
  474.  
  475. IBBS NewsGenerator V3.25ß                                           Page  9
  476. ───────────────────────────────────────────────────────────────────────────
  477.  
  478.  
  479. BUGS
  480.  
  481.     There are still a few bugs, not very serious, but the time is now
  482.     04:00, and I won't  hav much time, the next couple of weeks, to
  483.     make new versions.
  484.  
  485.     Bugs are:   Do not forget the last \$$\ at the end of the text file
  486.  
  487.                 Do not leave any empty lines after the last \$$\ The
  488.                 program will freeze if you do, I suggest you get a file
  489.                 editor which displays <EOF> at the end of the file.
  490.  
  491.                 Do not leave any blank lines in the NEWS.TXT file, if you use
  492.                 the editor, there should be a '<' at the end of EVERY line,
  493.                 otherwise, the program will mess up a little...
  494.  
  495.     I discovered, by accident, that you can have TWO or more, headlines
  496.     under one day!!!
  497.     Do the following:
  498.     dd-mmm
  499.     !HEADLINE 1
  500.       NEWS TEXT
  501.     {BLANK LINE}
  502.     !HEADLINE 2
  503.       NEWS TEXT
  504.  
  505.     The program will Create two headlines in the Summary, It looks pretty
  506.     neat!!!
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                - 9 -
  533.