home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / btag201.zip / bandit.doc < prev    next >
Text File  |  1998-03-12  |  18KB  |  473 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │                          * Bandit Tagger *                                  │
  3. │                            Version  2.01                                    │
  4. │                       ╕FA Partners 1997, 1998                               │
  5. └─────────────────────────────────────────────────────────────────────────────┘
  6.  
  7. Table of Contents
  8. ──────────────────
  9.  
  10. 1.0 Introduction
  11.   1.1 Disclaimer
  12.   1.2 What is new.
  13.   1.3 Installation
  14.     1.3.1 Internet Adventure
  15.     1.3.2 PMMail & PMINews
  16.     1.3.3 Post Road Mailer
  17.     1.3.4 MR/2 Internet Cruiser Edition for OS/2
  18.     1.3.5 Netscape 2.02 for OS/2
  19. 2.0 Taglines
  20.   2.1 Random tags
  21.   2.2 Manual tag
  22.   2.3 Multiple line tags
  23.   2.4 Adding taglines to the tagfile
  24. 3.0 X-Mailer Lines
  25. 4.0 X-Newsreader lines
  26. 5.0 X-Tag
  27. 6.0 User setup.
  28.   6.1 Files
  29.   6.2 User
  30.   6.3 Anonymous
  31.   6.4 Netscape
  32.   6.5 Register
  33. 7.0 In the future.
  34. 8.0 Known problems.
  35. 9.0 Bug Reports / Contacting the author
  36.  
  37.  
  38.   1.0 Introduction:
  39.   ─────────────────
  40.  
  41.   Bandit Tagger is a tool to add taglines to your outgoing mail, and
  42.   newsgroups posts.
  43.   The taglines can be selected random or manually.
  44.   It is also enables you to change the X-Mailer & X-Newsreader line in
  45.   the header section.
  46.  
  47.  
  48.  
  49.     1.1 Disclaimer
  50.     ──────────────
  51.  
  52.     This software is provided "as is". The author are not
  53.     responsible for any damage done to data on your harddrive,
  54.     related to Bandit Tagger, or not.
  55.  
  56.     Bandit Tagger supports :
  57.     Internet Adventure           1.01+
  58.     SouthSide Software - PMMail  1.91+
  59.     SouthSide Software - PMINews 1.00+
  60.     Innoval            - Post Road Mailer   2.00+
  61.     Knight Software    - MR/2 Internet Cruiser Edition for OS/2 v1.30a+
  62.     Netscape           - Netscape 2.02 for OS/2
  63.  
  64.     1.2 What is new.
  65.     ────────────────
  66.     Version 2.01
  67.       NEW:
  68.       - Instead of writing the complete filename with extension, you can new only
  69.         write the filename without extension. Ex. !os2 instead of !os2.tag.
  70.         (Of course you can still use !os2.tag if you want to.)
  71.       - The manual tag can now be any combination you like. Not necessarily a
  72.         *.tag. Ex. !man, !!!! or whatever.
  73.       - Enhanced anonymity, by replacing you name and e-mail address with what you
  74.         specify. (See section 6.3)
  75.     Version 2.00
  76.       NEW:
  77.       - Bandit Tagger now supports Netscape 2.02 for OS/2 completely
  78.         seamless. The installation program asks you, if you want Bandit Tagger
  79.         in your start-up folder.
  80.       - Option to change your X-Tag to be anonymous.
  81.  
  82.     Version 1.27a
  83.       BUG:
  84.       - Thread error. The registration code, wasn't compiled with the multi
  85.         thread option, which caused the program to crash when using threads.
  86.     Version 1.27
  87.       NEW :
  88.       - The possibility to remove the x-mailer or the x-news line in the header.
  89.         This is for those who registered thier e-mailer or news reader only.
  90.       - Register tab in the user setup. If you send us a post card, we'll send you
  91.         a key. (Remember to write your e-mail address on the card.)
  92.         If you do this before PMMail 98 for Windows is released, you will also get
  93.         a key to the Windows version of Bandit Tagger. After the release of
  94.         PMMail 98, Bandit Tagger togther with Bandit Adder will be sold for 10$.
  95.         (Windows version only. The OS/2 version is still free :-)
  96.       - X-Tag: Inserts a X-Tag line in the header. This line will show the version
  97.         number of Bandit Tagger, and who it is registered to. This line will also
  98.         be removed when removing the X-Mailer or X-News line.
  99.     Version 1.26
  100.       BUG :
  101.       - Performance bug. Recounted the tagfile each run. Sorry :-(
  102.     Version 1.25
  103.       NEW :
  104.       - Tag selection method. Tags can be inserted either randomly
  105.         or sequential.
  106.       BUG :
  107.       - Manual selection didn't work properly when using wysiwyg tag files.
  108.       - Manual selected tags, when using on oneline tag files, didn't translate
  109.         the fake newline characters into real newline characters.
  110.       - Displayed the multiple line tags as one line, when using oneline
  111.         tag files.
  112.     Version 1.20
  113.       NEW :
  114.         - Enables the user to have either one line tags in the tag files, or use
  115.         'wysiwyg' tag files, where the tags are separated by a blank line.
  116.         The file 'wysiwyg.ta_' has been include to show the principle behind
  117.         wysiwyg files.
  118.         - Improved installation program.
  119.         (Supports Internet Adventure & MR/2 Internet Cruiser Edition for OS/2)
  120.       BUG :
  121.         - Inserted user defined X-Mailer & X-Newsreader if the user didn't use
  122.         current version of the mail client.
  123.  
  124.     Version 1.10
  125.       NEW :
  126.       - Displays the multiple lines tags with multiple lines in the tag viewer.
  127.       - Add X-Newsreader to the user page.
  128.     Version 1.00
  129.       First release.
  130.  
  131.     1.3 Installation
  132.     ────────────────
  133.  
  134.     To install Bandit Tagger, just run the install.cmd.
  135.     The install.cmd prompt you where to install Bandit
  136.     Tagger. It also creates an icon in either your Internet
  137.     Adventure folder, PMMail folder or desktop.
  138.  
  139.       1.3.1 Internet Adventure
  140.       ────────────────────────
  141.       To use Bandit Tagger with Internet Adventure do the following :
  142.       1. Insert tag(s) from the menu bar.
  143.          When composing a mail insert ex. !os2.tag in the mail then
  144.          File->Run external utility program->
  145.          then insert the path ex. 'E:\TOOLS\INETADV\BANDIT\BANDIT.EXE'
  146.          Which will launch the Bandit Tagger and you can see the result
  147.          before sending the mail.
  148.          It is also possible to create a toobar button, which launches
  149.          Bandit Tagger.
  150.  
  151.       2. Insert tag(s) via a filter.
  152.          Create a new filter and call ex. Bandit. To create a filter do the
  153.          following :
  154.          Settings->Filters->Add->Bandit
  155.          Deselect Incoming news & mail.
  156.          Select Outgoing mail & news.
  157.          Add condition :
  158.            Where to search : Message Body
  159.            What to search for : !
  160.          Actions :
  161.            Select Execute REXX
  162.            insert ex. 'E:\TOOLS\INETADV\BANDIT\BANDIT.CMD'
  163.          You can either create a signature file where ex !os2.tag is in, or you
  164.          can insert the ex. !os2.tag when ever you want a random & manual tag
  165.          inserted.
  166.  
  167.       1.3.2 PMMail & PMINews
  168.       ──────────────────────
  169.       To use Bandit Tagger under SouthSide's PMMail goto the
  170.       main window. Then open Account->Utilities Settings->REXX,
  171.       click the 'Message Send Exit' and insert the path and
  172.       filename of Bandit Tagger. The same procedure goes for PMINews.
  173.       ex. 'E:\TOOLS\PMMAIL\BANDIT\BANDIT.EXE'
  174.  
  175.       1.3.3 Post Road Mailer
  176.       ──────────────────────
  177.       When using Bandit with Innovals Post Road Mailer do the
  178.       following :
  179.       File->Settings->User Exists
  180.       Insert the path and file name :
  181.       ex. 'E:\TOOLS\POSTROAD\BANDIT\BANDIT.EXE'
  182.       Click on exit is active.
  183.  
  184.       1.3.4 MR/2 Internet Cruiser Edition for OS/2 v1.30a
  185.       ───────────────────────────────────────────────────
  186.       When using Bandit Tagger with MR-ICE do the following :
  187.       Utilities->Filer Maintenance->New
  188.       Insert data in the following sections :
  189.       Criteria :
  190.         Description : Bandit Tagger
  191.         Search Areas For : Unclick 'All areas', click 'Body' insert !
  192.       Filer Type :
  193.         Select 'PreSend'
  194.       All other options on this page are valid.
  195.  
  196.       Actions :
  197.         Click 'Link to rexx', insert the path to the bandit.cmd or click
  198.         on browse button to find the bandit.cmd file.
  199.  
  200.       To launch the Bandit Tagger every time you send a e-mail do :
  201.       Utilities->Edit Signature file->
  202.       insert ex. !os2.tag
  203.  
  204.       Or you can insert the !os2.tag manually directly in the mail.
  205.  
  206.       Please notice that Bandit Tagger can't change the X-Mailer in MR/2
  207.       Internet Cruiser Edition for OS/2.
  208.  
  209.       Please start Bandit Tagger from the Internet Adventures, PMMail or desktop
  210.       folder to insert the user preferences. (See section 4.0)
  211.  
  212.       1.3.5 Netscape 2.02 for OS/2
  213.       ────────────────────────────
  214.       To make Bandit Tagger work togther with Netscape/2 you must place the
  215.       file hookdll.dll in your libpath. Then start Bandit Tagger with the
  216.       parameter /n, or use the Bandit Tagger for Netscape icon. That is it.
  217.  
  218.       Use the Bandit Tagger icon to set your preferences. Ex. set
  219.       'Display tag(s) in miliseconds' to 0 to avoid having to wait
  220.       before Bandit Tagger sends your e-mail.
  221.  
  222.       To make Bandit Tagger insert a tagline, you must insert a tag that
  223.       Bandit Tagger can recognize. ex. !os2.tag. Of course, this can
  224.       also be inserted into your signature file.
  225.  
  226.       Bandit Tagger can't change the X-Mailer when using it togther with
  227.       Netscape/2.
  228.  
  229.       Since there is no way to see if your are a registered user when using
  230.       Netscape/2, like the X-Tag when using other e-mail clients, Bandit Tagger
  231.       inserts :
  232.       ** Tag(s) inserted by Bandit Tagger v2.01 - http://www.gbar.dtu.dk/~c918704
  233.       at the bottom of your e-mail. This will disappear when your send us a
  234.       post card, and we send you a registration code :-)
  235.  
  236.  
  237.   2.0 Taglines
  238.   ────────────
  239.  
  240.   Bandit Tagger works by analysing your mail. When it incounters
  241.   tagfilenames with a preceeding ! it insert a tagline (ex. !os2.tag).
  242.   Bandit Tagger is NOT case sensitive.
  243.   This has been done to enable you to group your taglines.
  244.  
  245.   Personally I have :
  246.   'Computer Tags' -> !os2.tag
  247.   'Joke Tags'     -> !my.tag
  248.  
  249.   PLEASE NOTE : The files has to have *.tag extension.
  250.  
  251.   So when inserting a signature write :
  252.   !filename.tag
  253.   Ex. signature :
  254.     --
  255.     -- FA Partners
  256.     -- c918704@student.dtu.dk
  257.  
  258.     !my.tag
  259.  
  260.   Bandit Tagger will replace the '!my.tag' with a line from the
  261.   tagfile 'my.tag'
  262.  
  263.  
  264.   You can insert as many tagfile in your signatures as you want.
  265.  
  266.   The first time you run Bandit Tagger it inserts a number
  267.   in the top of the tagfile. (Unless there is a number already.)
  268.   This number tells how many lines there are in the file. This is
  269.   done for performance reasons. Bandit Tagger also creates a ini
  270.   file. This inifile registers the date, time & size of the tagfile.
  271.   If any of these informantions have changed, the tagfile is
  272.   being recounted.
  273.  
  274.     2.1 Random tags
  275.     ───────────────
  276.     Default is that Bandit Tagger inserts a random tagline from your
  277.     tagfile.
  278.  
  279.     2.2 Manual tag
  280.     ───────────────
  281.     It is posible to select a tag manually. This is done by creating
  282.     a signature with the manual tagname - default is 'manual.tag'
  283.     This will launch a notebook with all the tagfiles in the specified
  284.     tagfiles path.
  285.     Just select the line you want to have inserted.
  286.  
  287.     2.3 Multiple taglines
  288.     ─────────────────────
  289.     It is also possible to have multiple line tags in your tag file.
  290.     In the 'User setup' you specify what the newline character should
  291.     look like. Default is "^".
  292.     Bandit Tagger will change these characters with a real newline charater.
  293.  
  294.     2.4 Adding tagline to the tagfile
  295.     ──────────────────────────────────
  296.  
  297.     Adding new tags to the tagfiles are as easy as using your
  298.     favorite editor. Just open the tagfile and insert the new tag
  299.     line(s). Bandit Tagger will automatically recount the tagfile.
  300.  
  301.     Or you can use Bandit Adder to insert tag lines into your tag files.
  302.  
  303.  
  304.   3.0 X-Mailer
  305.   ────────────
  306.  
  307.   Bandit Tagger also enables you to change the X-Mailer line.
  308.   Just insert the new X-Mailer line in the 'User setup'.
  309.   Bandit Tagger will only insert your new X-Mailer if you have
  310.   registred Internet Adeventure or PMMail. This function will always
  311.   work when using Innvoval PRM. The reason for this is that PRM uses
  312.   the same X-Mailer in the registered version as in the unregisterd version.
  313.  
  314.   4.0 X-Newsreader
  315.   ────────────────
  316.  
  317.   Bandit Tagger also enables you to change the X-Newsreader line.
  318.   The X-newsreader line works exactly like the X-Mailer line.
  319.  
  320.   5.0 X-Tag
  321.   ─────────
  322.  
  323.   If you are a registered user of Bandit Tagger, and do not want your name
  324.   in the X Tag line, write '!anonymous' anywhere in your e-mail. This will
  325.   replace the default -
  326.   X-Tag: Bandit Tagger v2.01 - Registered to : John Doe
  327.   to
  328.   X-Tag: Bandit Tagger v2.01 - Registered user
  329.  
  330.  
  331.   6.0 User setup
  332.   ──────────────
  333.  
  334.   When opening Bandit Tagger from the Internet Adventure, PMMail
  335.   or dekstop folder a notebook appears where you can configure the following :
  336.  
  337.     6.1 Files.
  338.     ──────────
  339.  
  340.     Tagfiles path                       :
  341.  
  342.     Insert the path to your tagfiles. You can select browse and select
  343.     one of your tagfiles. Bandit Tagger will automatically cut the filename
  344.     off.
  345.  
  346.     Multiple taglines                   :
  347.  
  348.     The fake newline character(s). Default "^". When this fake newline charrater
  349.     is encountered in a tagline it's replaced with a real newline character.
  350.  
  351.     Or select "Not me, I'm using multiple lines in my tag files.", to use the new
  352.     'wysiwyg' tag files. Please note it is not possible to use one line tags and
  353.     'wysiwyg' at the same time.
  354.  
  355.     Tag selection method.
  356.  
  357.     Select 'Random' to have the tags inserted randomly (default). 'Sequential'
  358.     will insert the tags from number 1 to the last tag, and then start all
  359.     over.
  360.  
  361.     Manual tagname                      :
  362.  
  363.     Bandit Tagger search for this name in the mail and launches the manual selection.
  364.  
  365.     6.2 User.
  366.     ─────────
  367.  
  368.     Display tag(s) in millisecs         :
  369.  
  370.     The amount of time the selected tag(s) are displayed in milliseconds.
  371.     1000 = 1 secs.
  372.     A value of 0 will disable this feature.
  373.  
  374.     Remove X-Mailer :
  375.  
  376.     When enabled this feature removes the X-Mailer line from the e-mails header.
  377.     It also removes the X-Tag line inserted by Bandit Tagger.
  378.  
  379.     New X-Mailer (Registered e-mail clients only.) :
  380.  
  381.     Insert a new X-Mailer in the mail header.
  382.     Again - this is for registred users of Internet Adventure
  383.     and PMMail only. (PRM Users can always change the X-Mailer)
  384.     NOTICE - Default X-Mailer is either :
  385.  
  386.     For Internet Adventure :
  387.       Internet Adventurer v1.20 for OS/2 with Bandit Tagger v2.01
  388.     or
  389.       Internet Adventurer v1.20 for OS/2 - Unregistered with Bandit Tagger v2.01
  390.  
  391.     For PMMail :
  392.       PMMail 1.95a for OS/2 with Bandit Tagger v2.01
  393.     or
  394.       PMMail 1.95a Evaluation Version For OS/2 (Unregistered) with Bandit Tagger v2.01
  395.  
  396.     Remove X-News :
  397.  
  398.     When enabled this feature removes the X-News line from the news client.
  399.     It also removes the X-Tag line inserted by Bandit Tagger.
  400.  
  401.     New X-Newsreader (Registered news clients only.) :
  402.  
  403.     Insert a new X-Newsreader in the a newsgroup post header.
  404.     (See "New X-Mailer (Registered e-mail clients only.)" for more information.
  405.  
  406.     Advertice for Bandit Tagger:
  407.  
  408.     When enabling this feature, Bandit Tagger inserts a footer in your e-mail.
  409.     It looks somewhat like this :
  410.     "** Tag(s) inserted by Bandit Tagger v2.01 - http://www.gbar.dtu.dk/~c918704"
  411.     Bandit Tagger will always insert a footer into Netscape/2, until you have
  412.     registered Bandit Tagger.
  413.  
  414.     6.3 Anonymous
  415.     ─────────────
  416.  
  417.     If you want to be anonymous, when sending an email or posting to a newsgroup,
  418.     write !anonymous in your mail. This will replace you email address with whatever
  419.     you specify in the e-mail address in the anonymous section. You can also specify a
  420.     name. The anonymous tag will also replace the X-Tag. Ex. :
  421.     X-Tag: Bandit Tagger v2.01 - Registered to : John Doe
  422.       to
  423.     X-Tag: Bandit Tagger v2.01 - Registered user
  424.  
  425.     6.4 Netscape
  426.     ────────────
  427.     If you do not want Bandit Tagger for Netscape in your Window List, go to this
  428.     page and deselect the option :
  429.     'Yes, I want 'Bandit Tagger for Netscape' in my Window List'
  430.  
  431.     6.5 Register
  432.     ────────────
  433.     If you send us a post card, we'll send you a registration code. Insert your
  434.     name and registration code on this page.
  435.  
  436.  
  437. 7.0 In the future
  438. ─────────────────
  439.  
  440. We do not currently have any future plans for Bandit Tagger,
  441. but that is because we personally do not have anymore ideas.
  442. So I you have any ideas please e-mail FA Partners.
  443.  
  444.  
  445. 8.0 Known problems.
  446. ───────────────────
  447.  
  448. Some computers seems to release the cmd file before Bandit Tagger has
  449. completed. This results in the mail being send without a tag.
  450. To solve this problem use the bandit.cmd instead of the bandit.exe
  451. Thanks goes to Valery Kornienkov for supplying St-art for OS/2
  452.  
  453. 9.0 Bug Reports / Contacting the author
  454. ───────────────────────────────────────
  455.  
  456. All Bug reports should be sent to FA Partners.
  457.  
  458. FA Partners :
  459.  
  460. The author of Bandit Tagger : Flemming Bregnvig.
  461. Homepage owner              : Anders Thue Pedersen.
  462.  
  463. Homepage : www.gbar.dtu.dk/~c918704/
  464.  
  465. e-mail   :
  466.  
  467. FA Parterns          - fa-partners@usa.net
  468. Flemming Bregnvig    - bregnvig@usa.net
  469. Anders Thue Pedersen - anderst@usa.net
  470.  
  471. Send a mail to fa-partners@usa.net with subject: Subcribe
  472. to automatically recieve information about FA Partners products.
  473.