home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TAGGER37.ZIP / TAGGER.DOC < prev    next >
Text File  |  1990-06-17  |  15KB  |  413 lines

  1.                       TAGGER  (C)  E.J.BLAYER 1989,1990
  2.  
  3.  NEW FEATURES ELSE SKIP TO USING TAGGER
  4.  
  5.  Version 3.7 6/1/90
  6.  Extended Copy Features (Mouse Only)
  7.  When TAGGER is in the Foreground and IF a tagfile is available
  8.  a "c" for copy or Middle button on a three button mouse will present
  9.  an addition Menu with three options:
  10.  
  11.     Filename Drag- A Point,Shoot,drag and release capture of Filename
  12.                to the internal list. Most useful for multiple
  13.                column file lists as the "AUTO" mode will only search
  14.                for the first occurance of a file name per line.
  15.  
  16.     Block         - Mark diagonal corners of a text block and save
  17.                to the tagfile. Messages or any text can be quickly
  18.                "cut" from the screen. Mark ANY starting corner
  19.                and its diagonal to "cut" text.
  20.                This and Screen both append to the TAGFILE.
  21.  
  22.     Screen         - Save the entire screen of text to the tagfile.
  23.  
  24.  The captured text to the tagfile has trailing spaces removed.
  25.  if the Tagfile is not activated by the set option below (from Ver 3.6)
  26.  the "c" or Middle mouse button activates the Filename Drag function
  27.  immediately without a menu.
  28.  The new COPY menu item selection is by mouse movement only. The bottom
  29.  status line will give a more detailed "Help Info" as the items are scrolled.
  30.  The "HELP" on the status line will guide the use of the function when
  31.  selected. As usual the left mouse button selects and the right mouse button
  32.  aborts or exits all functions. The ESC key will also cancel or exit any
  33.  function.
  34.  
  35.  Version 3.6 2/1/90
  36.  ADDED - COMMENT FILE.. if the file name starts in the 1st column
  37.  the entire line is written to a user specified file. This should
  38.  satisfy requests from sysops that need the comment line to update
  39.  there own system . This option is activated by adding a "set" to
  40.  the environment.
  41.         set tagfile=c:\pathname\filename.ext
  42.  This file is appended on each session of TAGGER
  43.  
  44.  Version 3.5 8/23/89
  45.  Fixup for QMODEM'S TSR Trap added, Output filenames wouldn't work.
  46.        This Also fixed same problem With PROCOMM + .
  47.  
  48.  Version 3.4 7/31/89
  49.  Added EGA 43 line and VGA 50 line support ..........
  50.  
  51.  Please DISTRIBUTE this Package INTACT . NO ALTERATIONS AUTHORIZED
  52.  
  53.  NO WARRANTY EXPRESSED OR IMPLIED.
  54.  
  55.  This software has been tested in a number of xt,at machines
  56.  and thought to be bug free. Hardware should be 100% IBM (tm) compatible.
  57.  User Assumes the responsibility for its actions or lack thereof.
  58.  
  59.  END OF MUMBO-JUMBO.
  60.  -----------------------------------------------------------------------
  61.  
  62.  USING TAGGER -Jump start (SEE Mouse Support also)
  63.     A Utility To AID in Selection of Files ON or OFF Line With
  64.     Your Current MODEM Program to PCBOARD (tm) SYSTEMS....
  65.  
  66.     Purpose is to "TAG", or capture, file names on a pcboard (tm) bbs ,
  67.     and output them at at the Zdoor or Prodoor all at once ....
  68.     Tagged file names can also be output selectively one at a time
  69.     if you are not using a batch type receive protocol.
  70.  
  71.     Off Line Selection Can be done with getfiles.bat  . Change to
  72.     suit your current arc,zip,??? utility ,file lister ,and modem
  73.     program.
  74.  
  75.     Basic Use:
  76.     The Modem Pgm is Run as a Child Process ...
  77.     Examples of Command lines for various modem programs:
  78.  
  79.     C:> TAGGER PROCOMM ["options"]
  80.  
  81.     C:> tagger c:\zcomm\zcomm "call stockton"
  82.  
  83.     C:> TAGGER BOYAN
  84.  
  85.     Options must be in quotes....
  86.  
  87.     At this point you would log into your bbs as usual using whatever
  88.     normal faculties of the modem program.
  89.  
  90.     After log in , list files available with normal PCBOARD(tm) commands.
  91.     Examples :
  92.  
  93.     (29 Minutes Left) Main Board Command : N S 20
  94.  
  95.     (28 Minutes Left) Main Board Command : f 30
  96.  
  97.     (27 Minutes Left) Main Board Command : f 1
  98.  
  99.     When You Have a screen full of file names ,HIT ALT-Z
  100.     NOTE: This Hot Key can be user defined if the alt-z combination
  101.       is used by the modem program.
  102.  
  103.     Tagger will then be activated...
  104.     A status line will appear at the bottom of the screen and
  105.     the TOP line will appear reverse video.
  106.  
  107.     Use the arrow keys to move up and down the screen ....
  108.     The keys on the keypad are used to tag file names (+)
  109.  
  110.     Tag a few file names by moving to a line with the arrow keys,
  111.     and then hitting the "+" key. Each time you "TAG" a filename
  112.     a TAG count on the STATUS line will increment
  113.     Up to 20 files can be TAGGED .. Which is the limit of
  114.     number of files you can download in on call from most PCBOARD (tm)
  115.     systems.
  116.  
  117.     At this point you can edit your TAG list by hitting the "e" key.
  118.  
  119.     A window will appear showing the files names you have TAGGED.
  120.     The arrow keys can be used to walk up and down the window.
  121.     If the "d" key is hit the presently highlighted name will be
  122.     deleted from the list.
  123.  
  124.     You exit the EDIT function with ESC.
  125.  
  126.     TAgger is still active and you have TAGGED all you need at this
  127.     point on this "page" of file names.
  128.     Hit the ESC or END key to leave TAGGER.
  129.  
  130.     you are now out of "TAGGER" and back in your modem program.
  131.     Hit return to list more files (if more are available)
  132.  
  133.     Hit alt-Z (HOT KEY) to call up TAGGER and tag more files ....
  134.     END or ESC key to stop......
  135.  
  136.     After selecting (TAGGING) all needed files ..
  137.  
  138.     OPen the PCBOARD's Door 1 and at the prompt enter  D  and ENTER
  139.     The door will then ask for file names .
  140.     To output your TAGGED file names ,
  141.     activate TAGGER with the HOT KEY (default is ALT-Z)
  142.     Then hit the minus key .....
  143.  
  144.     All the file names that were TAGGED will be then be output at the
  145.     DOOR prompt for file names.
  146.     TAGGER has switched off into the background.
  147.     If you now hit the enter key the PCBOARD(tm) will commence download
  148.     of your requested files.
  149.  
  150.     COMMAND SUMMARY WHEN TAG is ACTIVE
  151.  
  152.             + = tag this file
  153.             - = output all file names
  154.             * = clear all file names
  155.  
  156.             E = edit TAGGED list
  157.                  D=delete current item in TAG list
  158.                  ESC= end edit
  159.  
  160.             / = Send Selected single filename from TAG list
  161.                  use up dwn arrows to move to filename.
  162.                  - = send current single filename.
  163.  
  164.             UP and DOWN arrows to move around
  165.  
  166.             END or ESC to deactivate Tag ,and return to modem pgm
  167.  
  168.  
  169.     SETUP - REQUIREMENTS
  170.         100 % true blue or CLONE ,,and About 60k of memory more
  171.         than your Modem program uses.
  172.         Copy TAGGER.EXE to your working path directory.
  173.  
  174.  
  175.     SETTING THE HOT KEY with environment variable TAGKEY..
  176.     In your autoexec.bat ,add a TAGKEY setting to use other than the
  177.     default HOT KEY alt-z.
  178.     EXAMPLE:
  179.  
  180.         set TAGKEY=081c
  181.  
  182.     Makes the ALT-enter key on the keypad the hot key...
  183.              1c is the scan code for that key
  184.              08 is the additional ALT key
  185.  
  186.   -------------------------------------------------------------------------
  187.  
  188.     To determine the key desired, form 4 hex digits from the following:
  189.  
  190.     The First two Digits from this table;
  191.           8 4 2 1    8 4 2 1
  192.           1 . . .    . . . .      Insert locked
  193.           . 1 . .    . . . .      Caps Lock locked
  194.           . . 1 .    . . . .      Num Lock locked
  195.           . . . 1    . . . .      Scroll Lock locked
  196.           . . . .    1 . . .      Alt key is pressed
  197.           . . . .    . 1 . .      Ctrl key is pressed
  198.           . . . .    . . 1 .      Left Shift key is pressed
  199.           . . . .    . . . 1      Right Shift key is pressed
  200.  
  201.      therefore:   0        8          is for alt
  202.  
  203.    Other 2 digits (scan code) are taken from this list:
  204.  
  205.                       TYPE OF KEYBOARD
  206.                    ----------------------------------------
  207.      Keystroke               83/84-Key     101/102-Key    101/102-Key
  208.                    Standard      Standard        Extended
  209.  
  210.      Esc            01         same        same
  211.      1                02         same        same
  212.      2                03         same        same
  213.      3                04         same        same
  214.      4                05         same        same
  215.      5                06         same        same
  216.      6                07         same        same
  217.      7                08         same        same
  218.      8                09         same        same
  219.      9                0A         same        same
  220.      0                0B         same        same
  221.      -                0C         same        same
  222.      =                0D         same        same
  223.      Backspace            0E         same        same
  224.      Tab            0F         same        same
  225.      q                10         same        same
  226.      w                11         same        same
  227.      e                12         same        same
  228.      r                13         same        same
  229.      t                14         same        same
  230.      y                15         same        same
  231.      u                16         same        same
  232.      i                17         same        same
  233.      o                18         same        same
  234.      p                19         same        same
  235.      [                1A         same        same
  236.      ]                1B         same        same
  237.      Enter            1C         same        same
  238.      Ctrl            **         **         **
  239.      a                1E         same        same
  240.      s                1F         same        same
  241.      d                20         same        same
  242.      f                21         same        same
  243.      g                22         same        same
  244.      h                23         same        same
  245.      j                24         same        same
  246.      k                25         same        same
  247.      l                26         same        same
  248.      ;                27         same        same
  249.      ;                27         same        same
  250.      '              28         same        same
  251.      `                29         same        same
  252.      Shift            **         **         **
  253.      \                2B         same        same
  254.      z                2C         same        same
  255.      x                2D         same        same
  256.      c                2E         same        same
  257.      v                2F         same        same
  258.      b                30         same        same
  259.      n                31         same        same
  260.      m                32         same        same
  261.      ,                33         same        same
  262.      .                34         same        same
  263.      /                35         same        same
  264.      Gray *            37         same        same
  265.      Alt            **         **         **
  266.      Space            39         same        same
  267.      Caps Lock            **         **         **
  268.      F1             3B         same        same
  269.      F2             3C         same        same
  270.      F2             3C         same        same
  271.      F3             3D         same        same
  272.      F4             3E         same        same
  273.      F5             3F         same        same
  274.      F6             40         same        same
  275.      F7             41         same        same
  276.      F8             42         same        same
  277.      F9             43         same        same
  278.      F10            44         same        same
  279.      F11            no key         --         85
  280.      F12            no key         --         86
  281.      Num Lock            **         **         **
  282.      Scroll Lock        **         **         **
  283.      White Home         47         same        same
  284.      White Up Arrow        48         same        same
  285.      White PgUp         49         same        same
  286.      Gray -            4A         same        same
  287.      White Left Arrow        4B         same        same
  288.      Center Key         --         --         4C
  289.      White Right Arrow        4D         same        same
  290.      Gray +            4E         same        same
  291.      Gray +            4E         same        same
  292.      White End            4F         same        same
  293.      White Down Arrow        50         same        same
  294.      White PgDn         51         same        same
  295.      White Ins            52         same        same
  296.      White Del            53         same        same
  297.      SysReq            no key         **         **
  298.      Key 45 [5]         no key         56         same
  299.      Enter (number keypad)    no key         1C         E0
  300.      Gray /            no key         35         E0
  301.      PrtSc            no key         **         **
  302.      Pause            no key         **         **
  303.      Gray Home            no key         47         47
  304.      Gray Up Arrow        no key         48         48
  305.      Gray Page Up        no key         49         49
  306.      Gray Left Arrow        no key         4B         4B
  307.      Gray Right Arrow        no key         4D         4D
  308.      Gray End            no key         4F         4F
  309.      Gray Down Arrow        no key         50         50
  310.      Gray Page Down        no key         51         51
  311.      Gray Insert        no key         52         52
  312.      Gray Insert        no key         52         52
  313.      Gray Delete        no key         53         53
  314.                       
  315. --------------------------------------------------------------------------
  316.     FILE SELECTION OFF LINE
  317.  
  318.     Using GETFILES.BAT
  319.     This Utility Shows HOW to automate the process of:
  320.  
  321.      1. Un-archiving the master list such as COMPUDAT.ARC or SSCFILES.ARC.
  322.  
  323.      2. Using a listing program to page through the file lists,
  324.         from which you would use TAGGER to collect file names,
  325.  
  326.      3. Run your modem program and use tagger to send the collected
  327.         file names to the bbs for download.
  328.  
  329.  
  330.        The first time user may wish to use the following:
  331.         c:>TAGGER COMMAND
  332.  
  333.     This will Envoke a new command.com from a shell under TAGGER.
  334.     You can now list the bbs's master file in any way you wish.
  335.     Activate TAGGER at any time with the hot key and TAG file names.
  336.  
  337.     Exit the listing program and run your modem program as usual.
  338.     Tagger is holding your file list .
  339.     Activate Tagger at the door prompt as described in the on line
  340.     procedure and output the file names.
  341.     When you exit the modem program ,at the dos prompt type EXIT
  342.     and hit enter..
  343.     This will dissolve TAGGER and remove it from memory...
  344.  
  345.     MOUSE SUPPORT
  346.     Release 3.0 an up Has mouse support , If You have a mouse driver
  347.     that does not support the "SAVE MOUSE STATE" function ,the
  348.     mouse CANNOT be used ...Try to get an updated mouse driver.
  349.  
  350.     The Functions are used as follows:
  351.         1. With TAGGER activated with the HOT-KEY,click
  352.            the LEFT button on a line with a filename to
  353.            add to the TAG list.
  354.  
  355.         2. Click the LEFT button on any Status line function
  356.            to activate that function.
  357.  
  358.         3. Click the RIGHT mouse button to EXIT the current
  359.            Function ,even tagger itself..
  360.  
  361.         4. An additional Point and Drag FILENAME pickup is
  362.            available only with the mouse.
  363.            It is available by clicking Left button at the
  364.            far left of the STATUS line. Notification that
  365.            this function is active is a Flashing "*" in the
  366.            TAG name on the status line. You can now pickup
  367.            a single filename by placing the mouse cursor on
  368.            the item to be picked up and press the left button,
  369.            hold and drag left or right ,when button is released
  370.            pickup ends..
  371.            This will be most useful in picking file names up in
  372.            messages and on non PCBOARD(tm) systems where several
  373.            columns of file names exist.
  374.            This function is a one shot,your back to the standard
  375.            pickup.Activate it again to point and drag...
  376.            RIGHT button will cancel this mode if you decide not
  377.            to pickup a text block.
  378.            If the area selected is longer than a permissible
  379.            filename length (xxxxxxxx.xxx) the excess is clipped off.
  380.            See New features for ver 3.5 to 3.7 for additional
  381.            information for a mouse at the beginning of this file.
  382.  
  383.  
  384.     PROBLEMS -MACHINE LOCKUPS...ECT...
  385.         This  program acts as a TSR in affect and could conflict
  386.         with other ill behaved TSR programs. Unload ALL other TSR's
  387.         and try them one at a time to locate the culprit...
  388.  
  389.     MODEM PROGRAMS
  390.     Tested with ZCOMM,PROCOMM,TELIX,BOYAN and users report it has worked
  391.     all modem and communications programs available..
  392.     Of course graphic mode systems such as WINDOWS ARE NOT supported...
  393.  
  394.     MEMORY .. TAGGER uses approximatly 45K.
  395.  
  396.     TAGGER was Written in Microsoft "C" 6.0 and assembly.
  397.     BIOS Calls only were purposly used to maintain compatability
  398.          with ALL video systems. This results in a visual slowness
  399.          of reverse video functions, but reduced the size considerably.
  400.          As some MODEM programs are greedy on memory and will drop some
  401.          functions such as scroll back buffers if memory is insufficent,
  402.          this was the only way to go...
  403.  
  404.     OS2-  Works in the DOS BOX ,no problem. Possible version for protected
  405.          mode later.
  406.  
  407.     Need Feedback on any problems .....
  408.     LEAVE msg on Stockton PCBOARD 609-652-4914
  409.  
  410.     ED BLAYER
  411.     1008 W.BAY Ave
  412.     Barnegat,NJ 08005
  413.