home *** CD-ROM | disk | FTP | other *** search
/ The Unsorted BBS Collection / thegreatunsorted.tar / thegreatunsorted / programming / misc_programming / abcread.hlp < prev    next >
Text File  |  1996-04-01  |  25KB  |  1 lines

  1. ~   Quick List of Commands for The ABC Reader v1.10      -------------------------------------------------------- ~Load List Mode                                                                                                     /  Scroll Up/Down         F1  On-Line Help             /  Switch Window          F2  Group Search             PgDn Next Page              F3  ABC Reader Setup         PgUp Previous Page          F4  Tally up Totals          Home Goto First Entry       F5  About The ABC Program    End  Goto Last Entry        INS  Add Packet/Code         A..Z Search By Letter       DEL  Delete Packet           ─┘  (ENTER) View           ESC  Exit ABC Reader                                                                  ALT+A About ABC Program     ALT+C ABC Reader Setup       ALT+S Group Search          ALT+T Tally ABC Totals       ALT+X Exit ABC Reader                                                                                           ~Load ABC Snippet Mode                                                                                              /  Scroll Up/Down         F1  On-Line Help             PgDn Next Page              F2  Search Current Packet    PgUp Previous Page          F3  Sort By...               Home Goto First Entry       DEL Delete Code              End  Goto Last Entry        INS Add Code                 ─┘  (ENTER) View Code      SPC Mark Code (SPACE)        /  Toggle Extra Info.     ESC Exit ABC Index                                                                    ALT+S Search For...         ALT+M Move Code                                                                     ~View Snippet Mode                                                                                                  /  Scroll Up/Down         'X' Extract Code             /  Scroll Left/Right      'F' Find Text                PgDn Next Page              'N' Next Code '+'            PgUp Previous Page          'P' Previous Code '-'        Home Goto Top of File       F1  On-Line Help             End  Goto End of File       ESC Exit ABC Viewer                                                                   ALT+H Edit Header           'H' Header Extract                                                                    The next code jumps to any marked snippets first         then performs an increment of messages.                  Press F1 for an explanation of 'H'eader Extract                                                                 ~Program Limitations for The ABC Reader v1.10                                                                         100 Total Packets Allowed                                999 Total Snippets Allowed or Search Totals allowed     5000 Lines of code allowed                                                                                     ~Command line option:                                                                                                You can start up the reader using MONO displays by       typing in the command line /MONO                         ABCREAD /MONO   Forces reader to use MONO displays       ABCMONO.BAT     Batch file to change screen modes                        if ABCREAD /MONO does not work                           Note: this changes your screen mode,                           type COLOR to switch back.                                                               ~Reader Update Notes:                                    --------------------------------------------------------  The ALL BASIC CODE Reader v1.10                                                                                   BUG Fixes:                                                                                                         * Fixed Febuary -> February                              * Fixed mouse click on ESC Exit in the Viewer mode         so it won't mark the snippet when returned to list     * Added Extra Header Info to the List mode                 Left/right keys or center mouse button toggles this    * Fixed comment color on REM alone lines                 * Implemented comment color for assembly ";" comments    * Disabled extraction of snippet when group searched           To prevent accidental hang up of system.           * Fixed MOVE ABC CODE for one snippet packets                  Used to skip transfer and delete packet.           * Fixed clock initializing to 00:00:00 at midnight       * Fixed the Tab Filter when searching                                                                           ~Using the Mouse to its FULL Potential                   --------------------------------------------------------                                                           The Mouse can act as your ENTER/Navigational/ESC keys    RIGHT MOUSE BUTTON acts as an ESC                           Press this button to exit from any menu               LEFT MOUSE BUTTON acts as your ENTER/Navigational keys      Holding down your left mouse button on a scroll          bar will move the text up/down/pageUp/pageDown           Clicking on the buttons will execute the commands        and clicking on certain text areas will select the       text and execute an ENTER.                                                                                    ~Tally Function                                          --------------------------------------------------------                                                           So what does this function do?                           When you first click or execute the command, it will     tally up the totals for the selected packet.  Upon the   second execution of this function, it will tally up      the total number of snippets in all packets for a        whopping grand total.  Execute it again and it will      return to its normal function of displaying the path.                                                            ~About The ABC Program                                   --------------------------------------------------------                                                           This is what you'd call "Wasted Code," but so what if    it adds a couple of KB's to the .EXE, no biggy.          Anyways, FYI, there are four things that clicking on     the face might return:                                       Tongue Sticking Out                                      Disappear            <---- Cool!                         Oh that's smarts                                         Don't get me mad                                     Anyways, the About box doesn't tell you much, so I'll    explain what this ABC Program is all about.                                                                       ALL BASIC CODE is a collection of BASIC Source Codes     (QB/PDS/QBasic/PB/VB/ASIC) and also some assembly        routines.  All codes are released to the public domain.                                                           These codes are obtained from a wide variety of sources  mainly FidoNet and BASIC newsgroups on the internet.     Also from individual programmers who summit their code   via email [voxel@freenet.edmonton.ab.ca]                                                                         ~Special Thanks                                          --------------------------------------------------------                                                           A special thanks to ALL contributors who have donated    their source codes for the benefit of this project and   all BASIC programmers out there.  For without whom,      this project may have never seen the light of day.       Thank you once again for all your contributions.                                                                 --------------------------------------------------------  For more information, please read the ABCREAD.DOC file  -------------------------------------------------------- ~Using The ABC Group Search Method                       --------------------------------------------------------                                                               Search: *.ABC    <--- ENTER to toggle global/select     Subject:          <--- Search Index All upper case        Author:          <--- Search Index of Author               Case:               Sensitive to case or not?         Code Of:          <--- Type of code to look for             Case:               Sensitive to case or not?       Body Text:          <--- Search all text in packets           Case:               Sensitive to case or not?                                                               As you noticed, the SUBJECT field has no case            sensitivity, since it's all in UPPERCASE to begin with.  You DO NOT have to fill in all the empty fields.        ~ NOTE: You MUST have at least ONE ABC Packet in the     ~       residing directory.                              -------------------------------------------------------- ~ ie.  You want to search for all PB Source codes                                                                  Select CODE OF: type PB                                                                                           Start the search and bingo... there you are.                                                                     --------------------------------------------------------  What's great about this group search, is that you can    specify a search down to its core.                                                                               ~ ie.  You want to search for all PDS Codes              ~      And author of JOE BLOW with text matching CD-ROM                                                            Select AUTHOR: type JOE BLOW                             Select CODE OF: type PDS                                 Select BODY TEXT: type CD-ROM                                                                                     Start the search and bingo... there you are again.      --------------------------------------------------------  Now how about searching whole words???                   I have not included a whole word toggle switch           because it can be simply inputed as this:                                                                        ~ ie.  type " WHOLE "   <-- notice the spaces, instead   ~                            of typing "WHOLE"           ~                            The search will ignore the  ~                            commas and periods.         --------------------------------------------------------  Can I search using multiple words?  Such that both       GRAPHICS and SVGA are both included in the code?                                                                  Yes, but only for the BODY TEXT field.  So don't try     this on the subject/author/code of field.                To do this, you would type:                                                                                      ~ ie.  BODY TEXT:  Graphics&SVGA                                                                                   '&' = AND,  '|' = OR                                                                                              So what does this search do?                                                                                     ~ ie.  Mouse&Graphics|Mouse&Text                                                                                   Searches for Mouse AND Graphics OR Mouse AND Text                                                                 NOTE: if you use more than one '|' command, it will,           in most cases, not parse properly.  You may use          the '&' command as much as you like.  But note           that it will be a little slower in searching.                                                              -------------------------------------------------------- The ABC Group Search is a very powerful tool.  There's   other searches that can be done individually if you have selected a ABC Packet first.  Using the individual       searches are much faster, but not as powerful.           ~NOTE: If you are using this search method, then the     ~      Deletion option is disabled.                      To abort the searching process, and take whatever that   is found, press ESC.                                     --------------------------------------------------------  For more information, please read the ABCREAD.DOC file  -------------------------------------------------------- ~Setting Up The ABC Reader                               -------------------------------------------------------- Modifying the NEW Config File.  Do not EDIT ABCREAD.CFG                                                           Save Path    : The Path where you wish the extraction to                take place.                               Load Path    : Changes to this directory at startup, but                will retain the original path when you                   exit The ABC Reader.                      Height       : Screen Height (25/43/50)                                 Make sure you have the required adapter                  for it.  Example:  43 - EGA, 50 - VGA                    Screen modes will change the next time                   you run The ABC Reader.                   Sort By      : None     -  no sort                                      Subject  -  Sorts by Subject                             Author   -  Sorts by Author                              # Lines  -  Sorts by number of lines      ~         NOTE: If you are using a sort method, then the ~               Deletion option is disabled.             Color Scheme : Default     -  Look at the source code                                  to change the color values                               for this option only.                     Grey        - Wintery color (Grey/7)                     Cyan        - Summer Blues  (Cyan/3)                     Green       - Spring Color  (Green/2)                    EGADefault  - Same as Grey but with                                    hi-intensity paletted color                EGAFlashy   - Flashy Colors, sort of.                    -----------                               Other Colors?: So what about the RED/PURPLE colors?                     No, it's not because it's a girly color                  or anything childish like that... no, I                  just forgot to implement it, so sue me!                  Anyways, you can modify the colors of the                default using the source code provided to                suit your red/purple needs.                              -----------                               Mouse        : Enable - Detect at startup                               Disable - Bypass detection                Mouse Delay  : <<<< Slower / Faster >>>>  Hold delay     Display      : Displays this at the bottom of the screen                Banner Scroll -  Scroll message                          Date & Time   -  Shows date and time                     Command Keys  -  Display the command keys                                                          SAVE will write to file ABCREAD.CFG                      USE ONLY uses the changed values, but does not save      CANCEL aborts ALL previous modifications made and reads         the original values from ABCREAD.CFG              NOTICE: The path to the ABCREAD.CFG is always the                directory you started the ABCREAD.EXE in.                Meaning if you start changing directories and            drives in the program, it will not affect the            path to which ABCREAD.CFG will be saved.         --------------------------------------------------------  For more information, please read the ABCREAD.DOC file  -------------------------------------------------------- ~Importing Your BASIC Code Into the ABC Packets          --------------------------------------------------------                                                          *Add to       : Refers to the ABC Packet you wish to                     include your source code in.                             You can create a new packet, simply by                   modifying this file name.                ~               NOTE: This function is disabled if you   ~                     have already selected your packet  *File To Add  : Where is your source code located?                       Type in complete path if necessary       *Subject Title: Title the source code as this for easy                   reference.                               *Authors Name : Who wrote this program?                                  Include his/her name here                                Refrain from taking credit for something                 you did not write.  If you don't know                    who wrote it, then please leave it as                    Unknown Author.                           The Origin   : Where did you obtain this program?                       If you haven't a clue, it's alright to                   leave this field blank                    Date & Time  : Format used is MM-DD-YY (hh:mm)                          Choose a format you prefer                Code Of      : What BASIC Language was this program                     written for?  QB/QBasic/PDS/PB/VB/ASIC?                  Or is it just a TEXT file or ASM file?    Extract Name : The File Name that will be used as a                     default extraction name.                  Add Header   : Includes a FULL Header in the extraction                 of this particular source code                           If not, the extracted file will not                      include the FULL Header.                                 This gives a way for users to remember                   what the extracted file does and who                     originally wrote the program.                            This line will appear in the source code             --> 'FULL Header Extraction for this...       Mark Special : Mark your Added Code Snippets so that                    you know which snippets you included and                 if incidentally it turns up in the later                 issues of the ABC Packets, you will know                 which ones to delete quite easily.                                                                ~ * Field MUST be filled, can not leave blank.                                                                     Selecting:                                                 ADD  Will process file and include it into the packet    BROWSE  No, this doesn't bring up a file directory               list, it returns the # lines and bytes in the            Added file.                                      CANCEL  Aborts operation and returns to program          HELP  What you're viewing right this moment           --------------------------------------------------------  For more information, please read the ABCREAD.DOC file  -------------------------------------------------------- ~Commands for Selecting a Code to View                   --------------------------------------------------------                                                            /  Scroll Up/Down         F1  On-Line Help             PgDn Next Page              F2  Search Current Packet    PgUp Previous Page          F3  Sort By...               Home Goto First Entry       DEL Delete Code              End  Goto Last Entry        INS Add Code                 ─┘  (ENTER) View Code      SPC Mark Code (SPACE)        /  Toggle Extra Info.     ESC Exit ABC Index                                                                    ALT+S Search For...         ALT+M Move Code                                                                     ~The Search/Mark/Sort Routines                           --------------------------------------------------------                                                            For the searching routine, it only searches strings      within the ABC INDEX file, so it's quick.                Unfortunately, this means you're limited to searching    Subject, Author, and # Lines.                                                                                     You can TAG a maximum of 100 codes for viewing.          Marking your selected code will cause the (N)ext/+       function on the Code Viewer to jump to the next tagged   code instead of an increment of one.                                                                              Instead of always modifying the config file to sort      your ABC Packets the way you like, SORT BY offers an     alternative.  Remember, once you sort your code, some    functions will be disabled, namely the ones below.                                                              ~More on ADDING/DELETING/TRANSFERING Code                --------------------------------------------------------                                                           Selecting INS will bring up the same inclusion form as   from the one on the Main Menu.  Add to Packet is         disabled because you've already selected a packet to     add to.                                                                                                           Selecting DEL will prompt you to think about it again.   And if you still wish to delete the selected code, then  it will remove the code by doing these three steps:        Create a TEMPORARY file to extract the remaining code    Skip the deleted code                                    Rename the TEMPORARY file to the actual .ABC Packet    If there's only ONE snippet in the ABC Packet, then      selecting DEL will just delete the .ABC Packet.                                                                   ALT+Move is a way for you to organize the snippets as    you see fit.  By transferring the code, it uses the      same routine as the DEL Function, except this time,      it reads the code to be moved and appends it to the      selected .ABC Packet.                                    Again, if there's only ONE snippet in the ABC Packet     then selecting ALT+M will delete the ABC Packet also.    You can NOT move the code into the packet you are        currently viewing.                                                                                               --------------------------------------------------------  For more information, please read the ABCREAD.DOC file  -------------------------------------------------------- ~Commands for viewing the Source Code                    --------------------------------------------------------                                                            /  Scroll Up/Down         'X' Extract Code             /  Scroll Left/Right      'F' Find Text                PgDn Next Page              'N' Next Code '+'            PgUp Previous Page          'P' Previous Code '-'        Home Goto Top of File       F1  On-Line Help             End  Goto End of File       ESC Exit ABC Viewer                                                                   ALT+H Edit Header                                                                                                 The 'N'ext code jumps to any marked snippets first       then performs an increment of messages.                                                                         ~Extracting Code with Headers                            --------------------------------------------------------                                                           Modify the config file if the desired extraction path    does not exist.                                          Extracting files with FULL Header:                         Unfortunately, not everyone prefers to have the FULL     header included in the extraction, therefore, I've       implemented a sneaky extraction process called           'H'eader Extract.  It will Extract the FULL Header       into the source code.  Instead of hitting 'X' type 'H' Mandatory FULL Header:                                      By including you own source codes into the ABC           Packets, there's a function called Include Header,       which will extract the FULL Header into the source       code, no matter what extraction routine you use.         This line will appear at the top of the source code  --> 'FULL Header Extraction for this Source Code Enabled     Extracting full headers will add five extra lines        into your source code, and are commented.                                                                     ~Editing the Header                                      --------------------------------------------------------                                                           I implemented this for people to organize their ABC      Packets as they see fit.  Not to change the credits of   the program to some other name.  Some fields may be      incorrect or you wish to change the Subject Heading,     then you will need this function.  It is especially      true if you have added your own source codes into the    ABC Packets and wish to change the headings.                                                                      NOTE: This function will be disabled if you are in a           group search packet.                                                                                       --------------------------------------------------------  For more information, please read the ABCREAD.DOC file  --------------------------------------------------------