home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / KN141-3.ZIP / KNEWS141.DOC < prev    next >
Text File  |  1993-12-21  |  40KB  |  1,108 lines
  1.  
  2.   Kinetic News Generator for RemoteAccess/Openlink/Maximus/PCBoard:
  3.  
  4.  
  5.            ██┐ ███┐ ████┐██████┐ ██┐ ███████┐ ████████┐ ████┐███████┐
  6.            ██│ ██┌┘ └██┌┘██┌─██│ ██│ ██┌────┘ └──██┌──┘ └██┌┘██┌────┘
  7.            ███████┐  ██│ ██│ ██│ ██│ █████┐      ██│     ██│ ██│
  8.            ██┌──██│  ██│ ██│ ██│ ██│ ██┌──┘      ██│     ██│ ██│
  9.            ██│  ██│ ████┐██│ ██████│ ███████┐    ██│    ████┐███████┐
  10.            └─┘  └─┘ └───┘└─┘ └─────┘ └──────┘    └─┘    └───┘└──────┘
  11.  
  12.                    ██████┐ ██┐ ███████┐ ██┐ ██┐ ██┐ ███████┐
  13.                    ██┌─██│ ██│ ██┌────┘ ██│ ██│ ██│ ██┌────┘
  14.                    ██│ ██│ ██│ █████┐   ██│ ██│ ██│ ███████┐
  15.                    ██│ ██│ ██│ ██┌──┘   ██│ ██│ ██│ └────██│
  16.                    ██│ ██████│ ███████┐ ██████████│ ███████│
  17.                    └─┘ └─────┘ └──────┘ └─────────┘ └──────┘
  18.  
  19.  
  20.   Copyright (C) 1992,1993
  21.   Yeo Chit Loong, All Rights Reserved.
  22.  
  23.  
  24.   
  25.   Kinetic News Generator is
  26.   a product of:
  27.  
  28.            ██┐ ███┐ ████┐██████┐ ██┐ ███████┐ ████████┐ ████┐███████┐
  29.            ██│ ██┌┘ └██┌┘██┌─██│ ██│ ██┌────┘ └──██┌──┘ └██┌┘██┌────┘
  30.            ███████┐  ██│ ██│ ██│ ██│ █████┐      ██│     ██│ ██│
  31.            ██┌──██│  ██│ ██│ ██│ ██│ ██┌──┘      ██│     ██│ ██│
  32.            ██│  ██│ ████┐██│ ██████│ ███████┐    ██│    ████┐███████┐
  33.            └─┘  └─┘ └───┘└─┘ └─────┘ └──────┘    └─┘    └───┘└──────┘
  34.  
  35.  
  36.   ███████┐ ███████┐ ███████┐ ████████┐ ██┐ ██┐ ██┐ ███████┐ ███████┐ ███████┐
  37.   ██┌────┘ ██┌──██│ ██┌────┘ └──██┌──┘ ██│ ██│ ██│ ██┌──██│ ██┌──██│ ██┌────┘
  38.   ███████┐ ██│  ██│ █████┐      ██│    ██│ ██│ ██│ ███████│ ███████│ █████┐
  39.   └────██│ ██│  ██│ ██┌──┘      ██│    ██│ ██│ ██│ ██┌──██│ ██┌─██┌┘ ██┌──┘
  40.   ███████│ ███████│ ██│         ██│    ██████████│ ██│  ██│ ██│ ███┐ ███████┐
  41.   └──────┘ └──────┘ └─┘         └─┘    └─────────┘ └─┘  └─┘ └─┘ └──┘ └──────┘
  42.  
  43.   Copyright (C) 1992,1993
  44.   Yeo Chit Loong, All Rights Reserved.
  45.  
  46.   
  47.  
  48.           ┌─────────────────────────────────────────────────╖
  49.           │       (*)-=] Author's Note-Pad [=-(*)           ║ █
  50.           ╘═════════════════════════════════════════════════╝ █
  51.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  52.  
  53.   o KNews Archive   : KN141-3 [.Arj]
  54.  
  55.   o Executable File : KNews   [.Exe]
  56.   o News Data File  : KNews   [.Txt]  o KNews Config File     : KNews   [.Cfg]
  57.   o KNews Sheller   : KShell  [.Exe]  o KNews Maintenance     : KMaint  [.Exe]
  58.   o Document File   : KNews141[.Doc]
  59.  
  60.   o KNews Version   : Ver.1.41. Rel 3.00    Total:(26 versions) (8 rel )
  61.   o KNShell Version : Ver.2.00. Rel 2.00    Total:(2 versions) (1 rel.)
  62.   o KMaint Verion   : Ver.1.00. Rel 1.02    Total:(1 version) (2 rel.)
  63.   o Written by      : Yeo Chit Loong
  64.   o Time Taken      : 0 hours 20 mins (Included to total time)
  65.   o Total Time      : 63 hrs 0 mins (Including releases)
  66.   o Total Updates   :-
  67.         KNews   :> 26 version & 8 release(s) updates to this version.
  68.         KNShell :> 1 version & 1 release(s) updates to this version.
  69.         KMaint  :> 0 version & 2 release(s) updates to this version.
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  [Notice]   : Please do not attempt to reverse engineer, modify, append,
  79.               or/and violate the integrity of this program.
  80.  
  81.               ONLY AN OFFICIALLY REGISTERED USER MAY MAKE USE OF THE
  82.               REGISTERED FEATURES PROVIDED BY KNEWS.
  83.  
  84.               ONLY AN OFFICIALLY APPOINTED BETA TESTER MAY MAKE USE OF
  85.               BETA VERSIONS OF KNEWS.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.           ┌─────────────────────────────────────────────────╖
  100.           │       D  I  S  C  L  A  I  M  E  R              ║ █
  101.           ╘═════════════════════════════════════════════════╝ █
  102.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  103.  
  104.       The author would not be held liable for any direct,indirect or
  105.       consequential damages or/and losses arising from the use (or
  106.       inability to use) this program.
  107.  
  108.       In no event will the author be liable to the user for any damages,
  109.       including any lost profits, lost savings, or other incidental or
  110.       consequential damages arising out of the use or inability to use
  111.       the program, or for any claim by any other party.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.           ┌─────────────────────────────────────────────────╖
  120.           │             W  A  R  R  A  N  T  Y              ║ █
  121.           ╘═════════════════════════════════════════════════╝ █
  122.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  123.  
  124.      Yeo Chit Loong (hereafter referred to as "the author") makes no
  125.      warranty of any kind, expressed or implied, including, without
  126.      limitation, any warranties of merchantability and/or fitness for
  127.      a particular purpose.  The author shall not be liable for any damages,
  128.      whether direct, indirect, special, or consequential arising from a
  129.      failure of this program to operate in the manner desired by the user.
  130.      The author shall not be liable for any damage to data or property which
  131.      may be caused directly or indirectly by use of the program.
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.           
  141.           ┌─────────────────────────────────────────────────╖
  142.           │  II.  Contents                                  ║ █
  143.           ╘═════════════════════════════════════════════════╝ █
  144.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  145.  
  146.        Disclaimers/Copyrights...etc . . . . . . . . . . . . . . . .     I
  147.  
  148.        Contents . . . . . . . . . . . . . . . . . . . . . . . . . .    II
  149.  
  150.        Credits  . . . . . . . . . . . . . . . . . . . . . . . . . .   III
  151.  
  152.        Small note from the author . . . . . . . . . . . . . . . . .    IV
  153.  
  154.       -------------------------------------------------------------------
  155.        Topic(s)                                                     Page
  156.       -------------------------------------------------------------------
  157.        What is Kinetic News Generator?                               1
  158.  
  159.  
  160.        Installing KNews                                              2
  161.  
  162.  
  163.        Configuring KNews - KNShell.Exe                               3
  164.  
  165.                 (KNews.Cfg) . . . . . . . . . . . . . . . . . . . .  3a
  166.  
  167.                 Configuring for your BBS s/w   . . . . . . . . . . . 3b
  168.  
  169.                 (News.Txt)   . . . . . . . . . . . . . . . . . . . .  3c
  170.  
  171.                 (KNewsHdr.Txt)   . . . . . . . . . . . . . . . . . .  3d
  172.  
  173.  
  174.        Running KNews                                                  4
  175.  
  176.                 Using KMaint  . . . . . . . . . . . . . . . . . . .   4a
  177.  
  178.  
  179.        About Registration for KNews                                   5
  180.  
  181.  
  182.        Special Notes                                                  6
  183.  
  184.  
  185.        Current Version/Releases notes                                 7
  186.  
  187.  
  188.        Future developments                                            8
  189.  
  190.  
  191.        The Beta-Testing team                                          9
  192.  
  193.  
  194.        Acknowledgements                                              10
  195.  
  196.  
  197.       ===================================================================
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.           ┌─────────────────────────────────────────────────╖
  210.           │ iii.  Credits / Special Thanks                  ║ █
  211.           ╘═════════════════════════════════════════════════╝ █
  212.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  213.  
  214.         Saying "Thankyou" to :
  215.               My grandparents, my parents, my brother and sister,
  216.               Roger Wilco, Jeff, LCB, Jessie Blue, Maveric Lee, LFM, OYY,
  217.               Joseph Gan, Koh Chin Yee, David Lim, Alvin Teo,
  218.               Lewis Yeo, Vincent Kam, Terence Wong,
  219.               Borland Int'l (For creating T.P),
  220.               my faithful 386DX-40 with 4mb RAM and 242mb HDD,
  221.               Nestle Coffee Delux, Pizza Hut, Miliano, McDonalds,
  222.               SemWare (for QEdit), CRT, Tom Swan... and many more!
  223.  
  224.         To any others which I've not mentioned, had helped and made
  225.      this program possible, please be assured that I appreciate your
  226.      help and assistance.
  227.  
  228.         Most of all, I'd like to thank those who've the patience to put
  229.      up with my pestering (*grin*) while I was trying to grasp the
  230.      concepts of Pascal and programming.
  231.  
  232.  
  233.  
  234.           ┌─────────────────────────────────────────────────╖
  235.           │  iv.  Small note from the author                ║ █
  236.           ╘═════════════════════════════════════════════════╝ █
  237.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  238.  
  239.     KNews is the result of a 2-day project that inevitably extends to a
  240.     2-year project. Since it's humble start, which offers only simple ASCII
  241.     and fixed designs, KNews has evolved to a bulletin generator that
  242.     simply could not be ignored.
  243.                                            --- Yeo Chit Loong, KNews Author
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.           ┌─────────────────────────────────────────────────╖
  258.           │  1.  Description                                ║ █
  259.           ╘═════════════════════════════════════════════════╝ █
  260.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  261.         KNews provides you with full ASCII, ANSI and AVATAR support. With
  262.     a simple, neat and yet informative screen. KNews provides _least_
  263.     interaction from the user.
  264.  
  265.        KNews is powerful and yet simple to configure and run, all versions
  266.     are tested by appointed Beta-Testers for bugs and incompaitability.
  267.  
  268.        KNews offers abilities featured in many other news generators and
  269.     is a total combination of them. Now you can have best of ALL worlds!
  270.  
  271.         Not wanting to lose the flexibility of your control over the news
  272.     data, the KNews news text file is in ASCII form, which means you can
  273.     edit with a simple text editor like EDIT.EXE provided by MS-DOS 5.xx
  274.  
  275.        In summary of the features, KNews gives you :
  276.        (Features marked with a {+} are reserved for registered users only)
  277.  
  278.            ■ ASCII/ANSI/AVATAR standards
  279.              - All 3 news file standards are supported by many BBS Softwares
  280.  
  281.        {+} ■ Unlimited no. of news articles (20 Max for Unreg. users)
  282.              - Unregistered users are limited to 20 articles
  283.  
  284.        {+} ■ Customisable NEWS HEADERS  (Type-4 news format)
  285.  
  286.            ■ 4 Different news header Types to choose from.
  287.              (Type 4 is design and colour customisable)
  288.              - Three (3) neat fixed-formats for you to choose from,
  289.                the fourth (4) allows the powerful feature of self-drawn
  290.                header(colour customisable also).
  291.  
  292.            ■ Customisable news text colours
  293.            ■ Customisable news Header colours
  294.            ■ Customisable news topic colours
  295.              - Headers, topic lines, texts all could be colour changed
  296.                according to your taste!
  297.  
  298.            ■ Supports non-abortable facilities by RA, OPL and PCBoard.
  299.              - Stops the users from skiping important news, no more
  300.                irritating "I didn't saw your news earlier on." excuses
  301.                from users!
  302.              - Identified in the article as "Article locked by SysOp"
  303.  
  304.            ■ Configurable news output file extensions
  305.              - Included for the flexibility of other BBS s/w which may not
  306.                use .ASC/.ANS/.AVT for text extensions.
  307.              - Means multi-BBS s/w support. No converters needed!
  308.  
  309.        {+} ■ Identifies SysOp and BBS name in news header.
  310.              - Identifies your name! You can proudly show it to your users
  311.                that you've registered KNews.
  312.  
  313.            ■ {INCLUDE} feature allows you import text directly from other
  314.              ASCII files.
  315.              - Another powerful feature in KNews, that automatically
  316.                imports other ASCII texts, specified by the user in News.Txt,
  317.                at time of compiling the news.
  318.                You can add in any ASCII text files without importing it
  319.                manually into your KNews.Txt!
  320.                What's more, your ASCII include file can contain colour macros
  321.                used by KNews!
  322.  
  323.            ■ Nice and fast graphics..
  324.              - KNews has nice graphics implemented with little or no
  325.                compremise over speed!
  326.  
  327.            ■ On-Line text file editor! (KNews -Edit parameter)
  328.              - Internal KNews editor allows you to edit the KNews.Txt!
  329.  
  330.            ■ RUN, SILENT, NOPAUSE Command-line parameter feature.
  331.              - Lets you enjoy the maximum speed available. SILENT command-line
  332.                disables all sounds (except errors detection) used by KNews
  333.                and NOPAUSE disables the "Press ESC to quit" window at the
  334.                end of compiling.
  335.              - This allows as a nightly maintenance feature
  336.              - Speeds up compiling time by 2-3 seconds!
  337.  
  338.            ■ Countdown marker feature. (By KMaint.Exe)
  339.              - Allows you to mark how many times KMaint.Exe is ran before
  340.                commenting the news out of your KNews.Txt
  341.              - Means you can remove 'outdated' articles by specifying how
  342.                many days you want to keep it UN-COMMENTED inside KNews.Txt
  343.  
  344.            ■ External Sheller program (By KNShell.Exe)
  345.              - A nice-looking shell program made for KNews, with some
  346.                main configurations and easy loading of KNews.
  347.  
  348.            ■ More to come!
  349.              - Yup! More!
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.           ┌─────────────────────────────────────────────────╖
  373.           │   2.  Installation                              ║ █
  374.           ╘═════════════════════════════════════════════════╝ █
  375.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  376.     As rule of the thumb, it is always advisable for you to backup
  377.     your KNews.Txt and KNews.Cfg before upgrading to a newer version.
  378.  
  379.     Installation is very simple, create a directory for KNews (e.g C:\KNEWS)
  380.     and put the whole KNews package into it. A seperate directory for KNews
  381.     is not entirely necessary, but it is for sake of preventing your
  382.     BBS directory cluttered with the files.
  383.  
  384.     While installing, please note that the following files must exist
  385.     in the SAME directory :-
  386.  
  387.         KNews.Exe, KNews.Ovr, KNews.Txt, KNews.Cfg, KNews.Key
  388.         KMaint.Exe, KNShell.Exe
  389.  
  390.      The configs of KNews.Cfg defaults to RemoteAccess BBS s/w,
  391.      and mimimum changes would be required to suit KNews to your needs.
  392.  
  393.       NOTE To KNews (1.40.Rel 5 and below) Users:
  394.             News.Cfg is now renamed to KNEWS.CFG
  395.             News.Txt is now renamed to KNEWS.Txt for better identification.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.           ┌─────────────────────────────────────────────────╖
  419.           │  3a.  Configuring KNews - KNShell.Exe           ║ █
  420.           ╘═════════════════════════════════════════════════╝ █
  421.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  422.  
  423.                               !!!!! NOTE !!!!!
  424.         This Version of KNews.Cfg is entirely INCOMPATIABLE with
  425.         previous versions of KNews, you'll have to delete the old
  426.         KNews.Cfg and create a new one with KNShell.Exe
  427.                               !!!!!!!!!!!!!!!!
  428.  
  429.     This release sees a binary version of KNews.Cfg, the old KNews.Cfg
  430.     is abandoned as it is rather cumbersome to configure through it.
  431.     KNews now uses the configuration service provided by KNShell.Exe.
  432.  
  433.         Throughout KNShell, several special keys would be used to
  434.         move around :
  435.  
  436.         HOME, PAGEUP   : Moves selection bar to the uppermost option
  437.         END, PAGE DOWN : Moves selection bar to the lowest option
  438.         UP, DOWN       : Moves selection bar up or down by one option
  439.  
  440.  
  441.  
  442.     When KNShell is first loaded, it might not find KNews.Cfg in the
  443.     current directory, you would be given this prompt:
  444.  
  445.                 ┌──────────────────────────────────────┐
  446.                 │  KNews.Cfg Not found! Create? Y/N    │
  447.                 └──────────────────────────────────────┘
  448.  
  449.     Select "Y" to create KNews.Cfg.
  450.  
  451.  
  452.     If KNShell could not find KNews.Key in the current directory, it would
  453.     give you this warning:
  454.  
  455.             ┌────────────────────────────────────────────────┐
  456.             │ KNews.Key corrupted or not found! Exiting..    │
  457.             └────────────────────────────────────────────────┘
  458.  
  459.     Please make sure that the key is in the directory.. contact the
  460.     author if you could not find the evaluation key within the
  461.     KNews package.
  462.  
  463.           ┌─────────────────────────────────────────────────╖
  464.           │   3a. Configuring for you BBS s/w               ║ █
  465.           ╘═════════════════════════════════════════════════╝ █
  466.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  467.       Basically, KNews supports all BBS s/w that can display ASCII, ANSI and
  468.     AVATAR files to the remote side.
  469.  
  470.       However, KNews is written to support 3 types of BBS s/w macros, and to
  471.     use the "non-abortable" feature, your BBS s/w has to be one of the
  472.     listed below:
  473.              Remote Access(RA)     PCBoard(PCB)     OpenLink(OPL)
  474.  
  475.       Configurations for RA, PCB and OPL are rather simple, just
  476.     specify the filenames and extentions (you can also use the defaults)
  477.     and display it using the appropriate functions in the BBS s/w.
  478.  
  479.       For Maximus users, you need to specify all the extension to .BBS
  480.  
  481.       You do not have to use the ANS2BBS.EXE provided by Maximus.
  482.  
  483.  
  484.  
  485.  
  486.  
  487.           ┌─────────────────────────────────────────────────╖
  488.           │  3b.  Configurating KNews - KNews.Txt           ║ █
  489.           ╘═════════════════════════════════════════════════╝ █
  490.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  491.  
  492.   The KNews.Txt is the data file where KNews gets your news and compile it
  493.  to presentable graphics. You can either load KNews with the parameter /edit
  494.  to use the internal editor or you can use your own favourite ASCII editor.
  495.  
  496.   The 8 colour keywords are now not used for the time being for KNews,
  497.  a feature which now allows you to change colours within your text.
  498.  The colour macro is "~~(XX)" (without the quotes). Whereby the XX stands
  499.  for the colours.
  500.  
  501.  Enter the colour macro like :-
  502.  
  503.                     ~~(XX)
  504.                        ^|
  505.                        |+------- ForeGround 0-9, A-F
  506.                        +======== BackGround 0-9, A-F
  507.  
  508.           0 - Black                8 - Bright or Blinking Grey
  509.           1 - Blue                 9 - Bright or Blinking Blue
  510.           2 - Green                A - Bright or Blinking Green
  511.           3 - Cyan                 B - Bright or Blinking Cyan
  512.           4 - Red                  C - Bright or Blinking Red
  513.           5 - Magenta              D - Bright or Blinking Magenta
  514.           6 - Brown                E - Bright or Blinking Yellow
  515.           7 - White                F - Bright or Blinking White
  516.  
  517.  
  518.  Note : Bright colours only apply to Foreground colours only.
  519.         BackGround colours does not allow Bright colours. It would
  520.         be set to Blinking instead. e.g Blinking Yellow foreground
  521.         on blue background ~~(9E)
  522.  
  523.   In a example News.Txt file, it'll look something like..
  524.   (Anything behind a pair of '/' is commentary for this document.
  525.  
  526.  Remember: Do not specify a colour directly after another macro.
  527.            i.e. ~~(0A)~~(0A)
  528.            colours *MIGHT* not work.
  529.  
  530.  
  531.  
  532.  
  533.  =======(Example)========
  534.  
  535. <Start of KNews.Txt>
  536. @News!                           // This is the topic line (Max 63 chars)
  537. {*} 31/12-99                     // This is the date line (DD/MM-YY)
  538.                                                               // Following
  539.          Presenting ~~(8E)KNews! ~~(07)The News Generator!    // Lines are
  540.                                                               // your own
  541.                                                               // news text.
  542.  
  543. [===]                          // This is to signel the end of your article.
  544. @Hello ~~(0E)world~~(0D)!         // Multi-Coloured topic line.
  545. {*} 31/11-99
  546.         Hello users, the following will be the new listing of rules..
  547.  
  548. {INCLUDE RULES.TXT}            // Includes the ascii file "RULES.TXT" into news
  549.  
  550.       Hope you understand them..
  551. [===]
  552. <End of KNews.Txt>
  553.  
  554.  
  555.  ==========:: Using {INCLUDE XXXXXXXX.XXX} ::============
  556.  
  557.  Syntax :
  558.          {INCLUDE <FILENAME>}
  559.                         ^-------- Filename of the ASCII file to include.
  560.  
  561.  (A more detailed documentation will be available in the next version.)
  562.  
  563.    A more detailed KNews.Txt is included with this package.
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.           ┌─────────────────────────────────────────────────╖
  580.           │  3c.  Configuring KNews - KNewsHdr.Txt          ║ █
  581.           ╘═════════════════════════════════════════════════╝ █
  582.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  583.     The header file allows the user to customise his design of topic
  584.     news header. The file is limited to a max of 5 lines.
  585.  
  586.     Use "@@" to specify where you want the First character of the topic
  587.     to be. The news header also supports colour macros used in KNews.Txt.
  588.  
  589.     {+} This is a registered-only feature
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.           ┌─────────────────────────────────────────────────╖
  603.           │  4.  Execution / Running KNews                  ║ █
  604.           ╘═════════════════════════════════════════════════╝ █
  605.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  606.  
  607.         To compile the news type :-
  608.  
  609.                                 KNEWS
  610.  
  611.       And 3 files, <Filename>.<Ext> will be created. Where
  612.     <Filename> stands for the name of the file you specified in the KNews.Cfg
  613.     and <Ext> stands for the extensions for each format you have configured
  614.     into KNews.Cfg. (Default extensions: .Asc .Ans .Avt )
  615.  
  616.       Please not that if the Pathname is not specified with the FLPATH
  617.     keyword, the 3 files would be created in the CURRENT directory.
  618.  
  619.       A 5 second pause has been added at the end of the program, this is
  620.     for you to read whats written on the screen. To skip it, just press
  621.     any key.
  622.  
  623.  
  624.  
  625.      *=- Running with command-line parameters -=*
  626.  
  627.        A Simple help screen would be shown if you type
  628.  
  629.         "KNews /?" followed by <Enter>
  630.  
  631.       The help screen is self-explaintory (Yeah, it explains itself to you!)
  632.     so I figure it'll be a waste of space to put it here again.
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.           ┌─────────────────────────────────────────────────╖
  649.           │   4a.  Using KMaint.Exe                         ║ █
  650.           ╘═════════════════════════════════════════════════╝ █
  651.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  652.  
  653.         As in chapter 5, just put KMaint.Exe in the same directory with
  654.         KNews.Txt.
  655.  
  656.         KMaint should be run only *ONCE* a day, in order for the
  657.         countdown feature to work properly. (Unless you wanted the
  658.         articles' counter to be reduced other than once a day.)
  659.  
  660.         Put KMaint into your nightly maintenance batch file, along with
  661.         your doors and stuffs. As long as it is ran once a day, the
  662.         counter will be deducted accurately.
  663.  
  664.         Once your got KMaint.Exe defined inside your batch file, you
  665.         would have to add some extra info (meaning, macros) into the
  666.         KNews.Txt.  The macro for countdown counter is :
  667.  
  668.                ! <No of days before article is 'commented'>
  669.  
  670.           e.g.
  671.               To comment-out a article after 200 days.
  672.  
  673.               ! 200
  674.  
  675.          NOTE: The "! "macro is to be added on the line BEFORE your
  676.                "@ " (topic) macro!
  677.  
  678.          example of <KNews.Txt> :-
  679.  
  680.          <Start of KNews.Txt>
  681.          .
  682.          .
  683.          .                   // Previous article's text
  684.          [===]               // Previous article Ending macro
  685.          ! 100               // THIS is the counter macro line
  686.          @ Hello World!      // This is the topic macro line
  687.          {*} 31/12-93        // This is the date macro line
  688.          .
  689.          .
  690.          .
  691.          [===]               // Current article ending macro
  692.          .
  693.          <End of KNews.Txt>
  694.  
  695.  
  696.  
  697.          When the counter hits zero (0), ("! 0") you'll see something like:
  698.  
  699.  
  700.          <Start of KNews.Txt>
  701.          .
  702.          .
  703.          .                   // Previous article's text
  704.          [===]               // Previous article Ending macro
  705.          #! 0                 // THIS is the counter macro line
  706.          #@ Hello World!      // This is the topic macro line
  707.          #{*} 31/12-93        // This is the date macro line
  708.          #.
  709.          #.                    // Article texts
  710.          #.
  711.          #[ ===]               // Current article with broken ending macro
  712.          .
  713.          <End of KNews.Txt>
  714.  
  715.          Note the commented out article and the ending macro, if you want
  716.          to post the article back, all you need is to remove the "#"s
  717.          and join back the "[" to the "===]" and add a new value for
  718.          the "! " (or even just remove it.) Simple?
  719.  
  720.          A advantage of commenting out your news article instead of
  721.          deleting it is that you can refer back to what you've said
  722.          at that time. Whats more, users would not be able to see it
  723.          in the final compiled news file.
  724.  
  725.          This feature stands out particularly among other generators
  726.          which deletes the news article (sometimes, pre-maturely due to
  727.          corrupted cmos clocks.).
  728.  
  729.          This is not possible as the 'life' of your news article is
  730.          based on how many times you run KMaint.Exe (Meaning, if you
  731.          run it 100 times, a article with "! 100" will be commented
  732.          out on the 100th time.)
  733.  
  734.      NOTE: If somehow or another KMaint aborted halfway, and you find
  735.            KNews.Txt 'missing', chances are it is renamed to "KNewstxt.$$$".
  736.            But I suggest you to have an extra copy of KNews.Txt everytime
  737.            you run KMaint.Exe - This is for extra precautionary purposes.
  738.  
  739.           ┌─────────────────────────────────────────────────╖
  740.           │   5.  Registration                              ║ █
  741.           ╘═════════════════════════════════════════════════╝ █
  742.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  743.  
  744.       In the unregistered version, there are some drawbacks :
  745.        1) A 5 second pause when KNews is ran
  746.        2) The total number of main articles are limited to 20
  747.        3) Execution time would be slowed (due to the 5 second pause)
  748.        4) Sleepless days/nights due to your conscience
  749.        5) Cannot enjoy any features marked {+}
  750.  
  751.       In the Registered version, users will be able to :
  752.        1) Enjoy the true fast speed of compiling
  753.        2) Write unlimited number of articles
  754.        3) Know optimum compiling speed in action
  755.        4) Know that your contribution is very much appreciated
  756.        5) Use future versions that I would write, due to your support
  757.        6) Enjoy any features marked {+}
  758.        7) User Support (Applies to Singapore only)
  759.        8) KNews will identify itself with a "+" in the output newsfile to
  760.           show it is registered.
  761.  
  762.       The registration fee is a meer S$5/= worth phone card. I believe
  763.      this is not too high a fee for a nice program such as KNews, as
  764.      this program is the result of the many hours drained from a college
  765.      student trying to learn programming.
  766.  
  767.        I would definately (gladly) appreciate any support, registrations
  768.      or contributions to keep me going. Remember! It is your every support
  769.      which motivates programmers like us to achieve to release better
  770.      software!
  771.  
  772.       If you are interested in registering, please refer to the
  773.     registration details as included with the archive.
  774.  
  775.       Registered users who've encountered any problems in using KNews,
  776.     don't to hesitate to contact me. I'd appreciate your comments and
  777.     feedback.
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.           ┌─────────────────────────────────────────────────╖
  787.           │   6.  More notes......                          ║ █
  788.           ╘═════════════════════════════════════════════════╝ █
  789.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  790.  
  791.     - S P E E D -
  792.  
  793.     KNews is Tested and timed on:
  794.  
  795.     [386-DX40, 242Mb HDD, 4Mb Ram]
  796.     [MSDOS 5.00, X00.Sys, ZAvt.Sys, Share.Exe, DV.Com, Qemm.Sys, Himem.Sys]
  797.     [4DOS 4.02, Nnansi.Com, Ramdrive (720k)]
  798.  
  799.     Size of KNews.Txt Tested on is :
  800.           20 articles, 40973 bytes, 390 Lines,
  801.           With at least 15 different colour changes per line.
  802.  
  803.       Just in case you want to know about the speed of KNews:
  804.     For the registered version:
  805.      12 seconds in a normal DOS window,
  806.      15 Seconds in a 500k DV 5:5 tick window
  807.  
  808.     For the Unregistered ones:
  809.       just add in 5-12 seconds. ;-)
  810.  
  811.    (To potential hackers trying to register this program unofficially :
  812.      " Forget about cracking this program, it is small and insignificant
  813.        enoungh to disgrace any intellectual stable person." - Author    )
  814.  
  815.    - C O M P A I T A B I L I T Y -
  816.  
  817.     This program has been tested compaitable on the following system(s):
  818.  
  819.         286-12        386SX-25     486SX-25
  820.         286-16        386DX-33     486DX-33
  821.                       386DX-40     486DX2-66
  822.  
  823.  
  824.     This program has been tested to be compaitable on the following
  825.     Environment(s)/Configuration(s):
  826.        1)  4Mb RAM, MS-DOS 5.0, Share, Qemm 7.00, DesqView 2.42
  827.        2)  4Mb RAM, MS-DOS 5.0, Qemm 7.00
  828.        3)  4Mb RAM, MS-DOS 5.0, HIMEM.SYS, EMM386.EXE
  829.        4)  4Mb RAM, MS-DOS 5.0, 4DOS 4.02, X00.SYS/COM v1.24, Share.Exe
  830.            Nnansi.Com, Ramdrive (720k), Qemm 7.00, DesqView 2.42
  831.        5)  4Mb Ram, MS-DOS 6.20, 4dos 4.02, X00.Sys/Com v2.01+, Share.Exe
  832.            Nnansi.Com, Ramdrive (1024k), Qemm 7.03, DesqView 386 2.61
  833.  
  834.  
  835.  
  836.    - R E Q U I R E M E N T S -
  837.  
  838.         IBM 80286 and above. MS-DOS 3.30 and above.
  839.         256 Kb Base RAM and above.
  840.         VGA Card & Monitor.
  841.  
  842.  
  843.    - V E R S I O N   I D E N T I F I C A T I O N -
  844.  
  845.         The version id used by KNews is as the following :-
  846.  
  847.              Ver<Version Number>.Rel<Release Number>.BETA(if any)
  848.  
  849.         Version number is the major updates of KNews, and the larger this
  850.    number, the more updated it is. Do expect to have 'decimel' values of
  851.    versions e.g 1.11 .
  852.  
  853.         Release Number is the minor updates of KNews, meaning small bug
  854.    fixes or small feature additions. It is identified by whole numbers,
  855.    meaning Rel 1 to Rel 9, in EVERY version, there is a minimum of 1 Release
  856.    and a maximum of 9 Releases. So if ver 1.11.rel 9.00 the next KNews
  857.    (no matter Release or version) will be 1.12.rel 1.00
  858.  
  859.         Do take note that I may sometimes skip version numbers.
  860.  
  861.         Sometimes, KNews will be released in BETA test versions, all users
  862.    please take note that from Ver 1.40.Rel.8.00 onwards, all KNews that
  863.    is marked with the word "BETA" or the character "ß" after it's
  864.    version/release number, _do not attempt to use it_.
  865.  
  866.         Beta versions of KNews are meant for Beta Testing by the official
  867.    KNews Beta sites. Usually, Beta versions are unstable, so if you are not
  868.    a beta tester and find beta versions of KNews around, do report the
  869.    uploader and the BBS to me and (if possible) delete the file as soon
  870.    as possible. Your cooperation is greatly appreciated.
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.           ┌─────────────────────────────────────────────────╖
  878.           │  7.  Current Version/Release Notes              ║ █
  879.           ╘═════════════════════════════════════════════════╝ █
  880.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  881.  
  882.       - Version 1.41 / Release 3.00 /
  883.     (Internal Editor):-
  884.     * Removed internal time clock as it has been causing too many systems
  885.       to hang, especially QEMM's famous "Exception #13" error.
  886.  
  887.     (KNews.Exe):-
  888.     * Fixed some cosmetic errors. Removed "pausing" effects.
  889.  
  890.     (KNShell.Exe):-
  891.     * Enlarged space for Sysop name and BBSName data field.
  892.  
  893.  
  894.       - Version 1.41 / Release 2.00 /
  895.     (Internal Editor):-
  896.     * Fixed some bugs in the internal editor which causes the system to
  897.       hang in some QEMM environments.
  898.  
  899.     (KNews.Exe):-
  900.     * .Ovr file removed due to some memory problems caused in some systems,
  901.       replaced back with the good'ol .Exe
  902.  
  903.     (KNShell.Exe):-
  904.     * A complete recode and fully enhanced version of 'Sheller.Exe',
  905.       this version is named "KNShell.Exe".
  906.       It has easy-to use menus with built-in configuration of KNews.Cfg,
  907.       and also enables you to view, edit and compile your news.
  908.  
  909.  
  910.       - Version 1.41 / Release 1.00 /
  911.     (Internal Editor):-
  912.     * Blocking functions in the Internal editor is removed for 'safety'
  913.       as it is known to corrupt some parts of the news file.
  914.     * A 'real-time' clock is added into the internal editor. (I thought
  915.       it might be useful. *Grin*)
  916.  
  917.     (KNews.Exe):-
  918.     * I've ported some parts of KNews's executable into an .Ovr file,
  919.       do not worry if you don't know what it is for, just leave it alone
  920.       with KNews.Exe and it will do what it is supposed to. *Grin*
  921.     * Self-Verification check added. KNews will check itself everytime it
  922.       is ran. (Note: Because of this, please do not rename KNews.Exe or
  923.       KNews.Ovr into any other names, or it will not run!)
  924.  
  925.     (Sheller.Exe):-
  926.     * A first working version of a sheller for KNews. Easily comprehenable.
  927.       First in it's version, do expect unfound bugs.
  928.  
  929.     (Others):-
  930.     * Some minor minor cosmetic changes for the above mentioned programs.
  931.     * CentralNET members who want to use contact me for the special CTN
  932.       member key. (However, I do encourage you to register to enjoy more
  933.       features.)
  934.  
  935.  
  936.       - Version 1.40 / Release 8.00 / - BETA Tester's version -
  937.         This Version is only meant for KNews BETA testers.
  938.         New features includes more detailed registration recognition,
  939.       some screen fixes and added the internal KNews Editor.
  940.  
  941.  
  942.       - Version 1.40 / Release 7.00 / - BETA -
  943.  
  944.         This is a quick replacement for release 6.00. In release 6.00,
  945.       the KMaint.Exe is known to cause some file sharing error, that
  946.       has been fixed.
  947.  
  948.         Some cosmetic changes in this release too. Other than that,
  949.       not much changes or nasty bugs. (Thanks to all my beta testers
  950.       out there! *Grin* )
  951.  
  952.  
  953.       - Version 1.40 / Release 6.00 / - BETA -
  954.  
  955.         A silly boo-boo has been made in rel 5.0, I've forgotten to
  956.      extend the "Outdated" prompt's date checks - so ending up with
  957.      KNews screaming "This version is outdated! Continue [Y/N]?"
  958.      just a few weeks before it is released.
  959.  
  960.         Many recodings are done for this release, KNews now runs much
  961.      more faster than previously, the colour macro is also changed.
  962.      Fix a silly bug that caused funny things in the 'unabortable'
  963.      feature.
  964.  
  965.         Many additions too, they include command-line parameters to
  966.      disable sound, pause prompts and monochrome support (for users
  967.      who somehow faces problems with the graphic routeins used by
  968.      KNews) , countdown feature, support for Maximus.
  969.  
  970.         One of the major changes in KNews is the registration methods,
  971.      from now onwards, KNews will no longer be using registration codes
  972.      in the KNews.Cfg file. A seperate 'key' file is needed to 'unlock'
  973.      registered features. This file is 4321 bytes and a valid Evaluation
  974.      Key file is provided with the KNews package.
  975.      (NOTE!: KNews will *NOT* work without a valid KNews.Key)
  976.  
  977.         A new file is included into the KNews package, KMaint.Exe.
  978.      This is the countdown feature you may want to use with KNews.
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.           ┌─────────────────────────────────────────────────╖
  994.           │   8.  Future Developments                       ║ █
  995.           ╘═════════════════════════════════════════════════╝ █
  996.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  997.     Since it's maiden release somewhere in September 1992, KNews has
  998.   evolved from a inflexible dumb program of 4000+ bytes to a 'impressive'
  999.   40+ Kbytes of codes.
  1000.  
  1001.     However, we are not just stopping here......
  1002.     Look forward to any future features we might provide, but hey,
  1003.     *NO* promises! *Grin*
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.           ┌─────────────────────────────────────────────────╖
  1017.           │   9.  The Beta-Testing team                     ║ █
  1018.           ╘═════════════════════════════════════════════════╝ █
  1019.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1020.  
  1021.  
  1022.     BETA TEST SITES             Hardware/Software Tested on
  1023.     ---------------             --------------------------------
  1024.  1. CyberMatrix BBS             386-DX40, 4Mb Ram, 240mb HDD
  1025.     (65)278-7409                MS-DOS 6.2, DV 2.62, QEMM 7.03
  1026.     24 Hours                    RA 2.00, Maximus 2.01wb
  1027.     CentralNET 1
  1028.  
  1029.     -----
  1030.  2. Line eXchange BBS           486-DX33, 16Mb Ram ,2 Gig HDD
  1031.     (65)352-4658                MS-DOS 6.2, DV 2.42, Qemm 6.04
  1032.     24 Hours                    RA 1.11+
  1033.     CentralNET 200
  1034.  
  1035.     -----
  1036.  3. InfoDataXchange BBS         386-SX20, 2mb Ram, 120Mb HDD
  1037.     (65)256-4772                MS-DOS 5.0, DV 2.42, Qemm 6.04
  1038.     24 Hours                    RA 1.11
  1039.     CentralNET 303
  1040.  
  1041.     -----
  1042.  4. The eXtreme BBs             386-DX25, 4mb RAM, 120mb & 245mb HDD
  1043.     (65)742-8832                MS-DOS 6.0, DV 2.42 ,Qemm 6.03
  1044.     24 Hours                    RA 1.11+
  1045.     CentralNET 202
  1046.  
  1047.   ==========================================================================
  1048.  
  1049.     * Any suggestions/comments/fish/tomatoes, please direct them to :-
  1050.  
  1051.      ■ By modem :
  1052.                            To: Yeo Chit Loong (SysOp) :
  1053.                                CyberMatrix Bulletin Board System
  1054.                                Kinetic Soft. HQ.
  1055.                                (+65)278-7409
  1056.                                300/1200/2400/4800/9600/12000/14400 bps
  1057.                                Mnp 1-5, v.32b, v.42b (whatever)
  1058.                                24 hours!
  1059.  
  1060.      ■ By Netmail :
  1061.                            To: Yeo Chit Loong
  1062.                                CentralNET (200:1000/1.0)
  1063.  
  1064.      ■ By Snail Mail (Postal Service) :
  1065.                            To: Yeo Chit Loong
  1066.                                Kinetic Software Development HQ.
  1067.                                Apt Blk 27, Telok Blangah Way,
  1068.                                #12-1006, Singapore 0409.
  1069.                                Singapore.
  1070.  
  1071.   ==========================================================================
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.           ┌─────────────────────────────────────────────────╖
  1087.           │  10.  Acknowledgments of TradeMarks/Copyrights  ║ █
  1088.           ╘═════════════════════════════════════════════════╝ █
  1089.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1090.    Acknowledgments of TradeMarks and/or Copyrights:
  1091.     ■ \/.News & VNews               \/.Soft. (1992)
  1092.     ■ |<.Soft & Kinetic Soft.       Kinetic Software Development Group.
  1093.     ■ OpenLink                      Lai Zit Seng.
  1094.     ■ Turbo Pascal                  Borland International.
  1095.     ■ RemoteAccess                  Andrew Milner.
  1096.     ■ PCBoard                       Clark Development Corp.
  1097.     ■ PowerBasic                    Robert S. Zale.
  1098.     ■ MS-DOS                        MicroSoft Corp.
  1099.     ■ Qemm & Desqview               QuarterDeck Soft.
  1100.     ■ ZAVT.SYS                      Luns Tee
  1101.     ■ IBM                           International Business Machines Corp.
  1102.     ■ Opus (CBCS)                   Wynn Wagner III
  1103.     ■ X00                           Ray Gwinn
  1104.     ■ Maximus-CBCS                  Scott J. Dudley
  1105.     ■ Spawno                        Ralf Brown
  1106.     ■ (CRT)                         CRT
  1107.   ==========================================================================
  1108.