home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / email / snagtag3.zip / SNAGTAG.DOC < prev    next >
Text File  |  1993-10-25  |  15KB  |  285 lines
  1.                SnagTag Plus - The tagline snagger for 1st Reader
  2.                                  Version 3.00
  3.           Copyright (c) 1993 by Michael Leavitt, All Rights Reserved
  4.  
  5. Features:
  6.         SnagTag Plus is the premium tagline snagger for Sparkware's 1st Reader
  7.         offline mail program.  It interfaces seamlessly with 1st Reader, and
  8.         allows you to snag the tagline from ANY message, edit it, and save it
  9.         directly to your 1st Reader tagline file.  It can also export the
  10.         snagged taglines to a text file for other tagline manager programs to
  11.         import.
  12.         SnagTag Plus even provides Sound Blaster support, and will play a VOC
  13.         file while you snag a tag.
  14.  
  15. Installation:
  16.         When you unzip this ZIP file, you'll find 5 files inside:
  17.  
  18.         SNAGTAG.EXE - the main program
  19.         SNAGTAG.DOC - this file
  20.         $$F1.BAT    - the batch file to start SnagTag Plus from 1st Reader
  21.         $$F1.DOS    - 1st Reader display commands for executing SnagTag Plus
  22.         SNAGTAG.VOC - the VOC (sound) file that SnagTag Plus will play when
  23.                       you snag a tag.
  24.         FILE_ID.DIZ - The BBS file directory entry for this archive.
  25.  
  26.         Of course, the name of the batch file indicates that this utility
  27.         will run when you press <SHIFT F1>.  If you already have something
  28.         assigned to the F1 key, rename the $$F1.* files to compensate...
  29.  
  30.         All ready?  Now just copy all the files into your main 1st Reader
  31.         subdirectory.  That's all there is to installation; SnagTag Plus is
  32.         now ready to run!  Of course, you can delete the FILE_ID.DIZ file;
  33.         it's not needed to run the program.
  34.  
  35. Updating from SnagTag:
  36.         All you need to replace is the SNAGTAG.EXE file - all of the other
  37.         supporting files are unchanged.
  38.  
  39. Using SnagTag Plus:
  40.         When you're reading mail and see a tagline you've just got to add
  41.         to your collection, just use the <SHIFT-F1> (or whatever you've
  42.         changed it to) key to activate SnagTag Plus.
  43.  
  44.         SnagTag Plus will pop up a window showing you the tagline that it
  45.         picked up from 1st Reader - or the one it found if 1st Reader didn't
  46.         find one.  In most cases, this will be the tagline you wanted.
  47.         However, if neither 1st Reader or SnagTag Plus found the tagline on
  48.         the message, SnagTag will automatically jump into ScreenPicker mode
  49.         (more on this later).
  50.  
  51.         Let's assume that 1st passed the tag on OK, and you're looking at
  52.         it in the SnagTag Plus window.  Perhaps there's a misspelled word, or
  53.         you can see how rewording it a little would make it funnier.  Or maybe
  54.         there's some extra stuff in there you'd like to take out...
  55.         You can edit the tag before you save it - or enter one from scratch
  56.         based upon inspiration that you got from the message.
  57.  
  58. The SnagTag Plus Editor:
  59.         SnagTag Plus allows you to edit the snagged tag before you save it.
  60.         All tagline editing is done in the SnagTag Plus window using these
  61.         editing key controls:
  62.  
  63.         Cursor movement commands:
  64.  
  65.         Left Arrow or <Ctrl-S>       - Move cursor one position left.
  66.         Right Arrow or <Ctrl-D>      - Move cursor one position right.
  67.         Ctrl-Left Arrow or <Ctrl-A>  - Move cursor one word left.
  68.         Ctrl-Right Arrow or <Ctrl-F> - Move cursor one word right.
  69.         Home key                     - Move cursor to beginning of line.
  70.         End key                      - Move cursor to end of line.
  71.  
  72.         Text deletion commands:
  73.  
  74.         <Alt-D> or <Ctrl-Y>          - Delete entire line.
  75.         Delete or <Ctrl-G>           - Delete character under cursor.
  76.         Backspace key                - Move cursor one position right and
  77.                                        delete character under cursor.
  78.         <Ctrl-T>                     - Delete from cursor to next word.
  79.  
  80.         Editor commands:
  81.  
  82.         Insert or <Ctrl-V>           - Toggle insert / overwrite mode.
  83.         Up Arrow or <Ctrl-E>         - Jump to ScreenPicker.
  84.         Down Arrow or <Ctrl-X>       - Jump to ScreenPicker.
  85.         Escape key                   - Exit without saving tag.
  86.         Enter key                    - Exit and save tag.
  87.  
  88.  
  89.         You can edit the tagline using the above commands until it's just
  90.         the way you want it.  When you have it just right, press Enter to
  91.         save the tag - or press Escape to throw the tag away and leave SnagTag
  92.         Plus.
  93.  
  94.         One last thing in the editor - if what's in the SnagTag Plus window
  95.         isn't what you wanted because 1st Reader didn't find the right line
  96.         or for whatever other reason you'd like to choose another line from
  97.         the message, you can go to ScreenPicker mode by just pressing the up
  98.         arrow or down arrow key.
  99.  
  100. ScreenPicker:
  101.         If 1st Reader didn't find a tag to give SnagTag Plus and SnagTag Plus
  102.         couldn't find the tag itself, or if you up arrowed out of the editor
  103.         you'll go into ScreenPicker mode.  The SnagTag Plus window will
  104.         disappear, and the ScreenPicker bar will pop onto the screen.  It's
  105.         easy to recognize; that white bar with the red letters in it.  (Unless
  106.         you have a mono monitor - then it's reverse video)
  107.  
  108.         The ScreenPicker bar can only snag tags that are visible on the
  109.         screen, and it will automatically position itself on the tagline if
  110.         it can recognize it.  Lots of weird mail readers out there, and some
  111.         of them produce taglines that defy automatic detection - if SnagTag
  112.         can't find it, the Screen Picker bar will come up in the middle of
  113.         the screen.
  114.  
  115.         ScreenPicker Commands:
  116.  
  117.         Up Arrow                     - Move bar one line up.
  118.         Down Arrow                   - Move bar one line down.
  119.         Left Arrow                   - Move bar one position left.
  120.         Right Arrow                  - Move bar one position right.
  121.         Ctrl-Left Arrow              - Shrink bar one position.
  122.         Ctrl-Right Arrow             - Grow bar one position.
  123.         Page Up                      - Move bar to top of the screen.
  124.         Page Down                    - Move bar to bottom of the screen.
  125.         Home key                     - Move bar to start of line.
  126.         End key                      - Move bar to end of line.
  127.  
  128.         Escape key                   - Exit SnagTag Plus and don't save tag.
  129.         Enter key                    - Place bar contents into editor.
  130.  
  131.         Use the above commands to move the ScreenPicker bar around until
  132.         the line you want is in it and press Enter - the SnagTag Plus editor
  133.         will pop up with that line inside for you to tweak as desired and
  134.         save.
  135.  
  136.         If the tag you're after is mixed in with some other stuff and the
  137.         ScreenPicker bar would get more than you really wanted - you can
  138.         shrink and grow the ScreenPicker bar by holding the Ctrl key down
  139.         and using the left and right arrow keys.
  140.  
  141. Where the tag is saved to:
  142.         Normally, SnagTag Plus will add the snagged tagline to the 1st Reader
  143.         TAGLINES.DAT file, where it's ready for immediate reuse.
  144.  
  145.         However, if the tagline file is full - or if the first line in your
  146.         1st Reader tagline file starts with DOS: - the tagline will instead
  147.         be added to a text file in the 1st Reader main directory called
  148.         SNAGGED.TAG.  This is a standard ASCII text file that you can import
  149.         into 1st Reader's tagline file, or import into the tagline files of
  150.         other tagline manager programs (like JH3 - great program!).  The tags
  151.         will also be saved to SNAGGED.TAG if SnagTag Plus can't find your 1st
  152.         Reader TAGLINES.DAT file.
  153.  
  154.         When you are using SnagTag Plus with 1st Reader version 1.00 or 1.01,
  155.         or if you are using it with the beta versions of 1st Reader version
  156.         1.10, SnagTag Plus will consider your TAGLINES.DAT file to be full
  157.         when it has 200 taglines in it.  Using SnagTag Plus with 1st Reader
  158.         1.10 release or a later version of 1st Reader allows a full 1000
  159.         taglines in the TAGLINES.DAT file.
  160.  
  161. Cute noises:
  162.         If your system is equipped with a Sound Blaster (or compatible) card,
  163.         SnagTag Plus will play the SNAGTAG.VOC file as it snags a tag for you.
  164.         You can replace this VOC file with any VOC file you'd like - just copy
  165.         your new VOC to SNAGTAG.VOC.  This file (like all of the SnagTag Plus
  166.         files) needs to be located in your 1st Reader main directory.
  167.  
  168.         If you don't have a sound card, or if SnagTag Plus can't find the
  169.         SNAGTAG.VOC file - no sound will be produced.
  170.  
  171.         No environment variable or other special configuration is needed for
  172.         SnagTag Plus to use your Sound Blaster - it's quite capable of finding
  173.         it on its own...
  174.  
  175.         If your Sound Blaster is configured to some strange I/O port address,
  176.         or if you're using some 'not quite compatible' sound card, SnagTag
  177.         Plus might 'hang'.  (It's sent a command to the sound card and is
  178.         waiting for a response that never comes.)  If you encounter this,
  179.         just delete the SNAGTAG.VOC file and the program will work just fine
  180.         without the VOC file support.
  181.  
  182. License:
  183.         SnagTag Plus is copyright (c) 1993 by Michael Leavitt - All Rights
  184.         Reserved.
  185.  
  186.         You are granted a limited license to use the unregistered version of
  187.         this program for the purpose of evaluation only.  Any other use of
  188.         this program - including disassembly, reverse engineering or
  189.         decompiling, or any modification or alteration of the program code
  190.         is prohibited.
  191.  
  192.         This program is shareware - not freeware as were the previous versions.
  193.         It is required to register this program with the author if you find it
  194.         useful and make regular use of it.  Unregistered copies of SnagTag
  195.         Plus are fully functional for your complete evaluation - but after
  196.         you've used it few dozen times or so it will start reminding you that
  197.         it's time to register - just in case you forgot.
  198.  
  199.         Future updates to this program will depend upon the response of folks
  200.         like you.  Also, you'll feel lots better about using it if you
  201.         register - I certainly know that I will.
  202.  
  203. Registration:
  204.         You can register your copy of SnagTag Plus by sending $8 (more if you
  205.         want) to:
  206.  
  207.         Michael Leavitt
  208.         2088 West 3825 South
  209.         Roy, Utah  84067
  210.  
  211.         Cash, checks or money orders are gratefully accepted - no credit
  212.         cards.  Please include a note saying 'I want to register SnagTag Plus'
  213.         and include your mailing address so that I can send you a disk
  214.         containing your registered copy of SnagTag Plus (please specify 3.5"
  215.         or 5.25" disk).  Your SnagTag Plus disk will also include a very
  216.         large collection of taglines to get you started on your collection.
  217.         Also, registered SnagTag Plus owners will receive free updates to
  218.         future versions of SnagTag Plus for just the cost of the disk and
  219.         shipping ($3.00) - you only need to register it once!
  220.  
  221.         Orders with cash or money orders will be processed and mailed within
  222.         two business days from the time they're received.  Orders containing
  223.         personal checks will be held for 10 business days to give the check
  224.         time to clear your bank.
  225.  
  226.         These prices are current as of the date of release of this program,
  227.         and are subject to change at any time.
  228.  
  229. Distribution:
  230.         Feel free to give copies of the unregistered version of SnagTag Plus
  231.         to your friends and upload it to BBS systems.  The only restriction
  232.         is that you must include all of the SnagTag Plus distribution files
  233.         in their original and unmodified form, and you may NOT add any
  234.         additional files to the distribution archive.  This ESPECIALLY means
  235.         BBS advertisements!  If your favorite BBS automatically sticks their
  236.         ad into the uploaded files, you might want to drop the sysop a line
  237.         and let him know that he's violating the copyright on this and many
  238.         other programs.  Let's try to put a stop to that annoying practice;
  239.         it wastes time and money every time we download a file stuffed full
  240.         of that trash.
  241.  
  242.         You may NOT distribute the registered version of SnagTag Plus at all!
  243.         Not even one little copy for a friend; please respect the copyright.
  244.  
  245. Problems?
  246.         SnagTag Plus is very easy to install and use, and it's highly unlikely
  247.         that you'll encounter any problems.  If by some chance it's not
  248.         working for you, here's some tips:
  249.  
  250.         If SnagTag Plus doesn't work at all - try reinstalling it.  Unzip the
  251.         SNAGTAG3.ZIP file directly into your 1st Reader main directory
  252.         (usually C:\1ST).  If that doesn't get it working, you probably
  253.         should read these docs over one more time and see if maybe you're
  254.         not using it right.
  255.  
  256.         If the SnagTag Plus editor pops up and then the program just 'hangs',
  257.         try deleting the SNAGTAG.VOC file.  See the discussion about this
  258.         in the 'Cute Noises' section above.
  259.  
  260.         If all else fails - drop me a line in the ILink Qmail conference,
  261.         or on my home board:
  262.  
  263.         The Graphics Connection
  264.         (801) 264-1191
  265.         Salt Lake City, Utah - PCPursuit UTSLC
  266.  
  267.         I'll reply to any request for assistance in either of those places,
  268.         and will respond to written requests for assistance via Snail Mail
  269.         if you include a self-addressed stamped envelope.
  270.  
  271. Disclaimer:
  272.         This program has been thoroughly tested, and I believe it to be safe
  273.         to use.  However, no warranty of any kind either express or implied
  274.         is offered; any risks or losses incurred while using this program are
  275.         solely your own responsibility.
  276.  
  277.         For registered users only: the media (diskette) that your registered
  278.         copy of SnagTag Plus was shipped to you on is warranted for a period
  279.         of 30 days against defects in materials and workmanship.  Diskettes
  280.         found to be defective during that time will be replaced at no charge
  281.         upon receipt of the defective diskette at the author's address.  This
  282.         limited warranty only covers the diskette itself; any and all
  283.         warranties concerning the program code are expressly denied as
  284.         outlined in the previous paragraph.
  285.