Beijing Paradise BBS Backup/PARADISE.ISO/software/BBSDOORW/GOLD.ARJ/ADDTAG.DOC

Text File | 1994-11-13 | 17.9 KB | 549 lines

  ▄███████▄               ▄███████▄         ▄█▄
 ████▀▀▀████             ████▀▀▀████       █████
 ████▄▄▄████             ███     ███       █████
 ███████████ ╓──┐ ╓─╥─┐  ███     ███ ╥──┐  █████ ╓─╥─┐ ╥──┐ ╥  ┬ ╥    ╓─┐ ╥──┐
 ████   ████ ║      ║    ████▄▄▄████ ╟─    █████ ║ ║ │ ╟──┘ ║  │ ║    ╙─┐ ╟─
 ▀██▀   ▀██▀ ╙──┘   ╨     ▀███████▀  ╨      ▀█▀  ╨ ╨ ┴ ╨    ╙──┘ ╨──┘ ╙─┘ ╨──┘

               P.O. Box 3246,  3502 GE,  Utrecht,  The Netherlands
 .────────────────────────────────────────────────────────────────────────────.



                         Act Of Impulse Add a Tagline

                                    v1.03






       │ What is the Act Of Impulse add tagline ?
──────────────────────────────────────────────────────────────────────
       │

 Simple, it offers you to select the tagline you want at the end
 of your message.

 I was getting tired of the random taglines with GoldEd and the no
 taglines at all of TimEd. So I tried an add a tagline program (TeTag)
 very nice but not what I was looking for besides that it was only
 usable with TimEd, and I normally use GoldEd. So I wrote my own.

 This program allows you to select a tagline from your tagline file
 (Maximum of 5000 taglines!) and put it at the bottom of your
 message.

 I used to work with BlueWave (I guess a lot of us started that way)
 and I made Addtag a bit like the BlueWave tagline selector, ofcourse
 I did a lot of improvement but it has the look of the Bluewave
 tagline selector.

 I have included a small tagline file with some nice taglines!

 This program works for sure with the following programs:

  - TimEd (External editor)
  - GoldEd (Internal editor and external editor)
  - FrontDoor 2.12 or higher (Internal editor)
  - TerMail 1.5x

 I am pretty sure that it will work with other programs, though I
 don't know all mail programs out there at this moment. Neither
 do I have the time to set them all up to test with AddTag.

 I hope you enjoy using this program as much as I enjoyed writing it.

 And remember if you can't get it to work, or have questions don't
 hesitate to send me or one of the support sites a message. I am
 sure we can help you with your problem.

 An OS/2 version might be there soon! Keep looking out for it.


       │ Disclaimer
──────────────────────────────────────────────────────────────────────
       │

 In no event shall Act Of Impulse nor Pascal van Rossum be liable to
 you or anyone else for any special, incidental, consequential,
 indirect or similar damages due to the use of this program even if
 one of our support-sites has advised you to use the program in a
 special way. The program is provided as it is, and you use it on your
 own risk. If your computer starts smoking it is though luck for you

 The exe files nor the Doc files may be changed in any way.


       │ How to use the program
──────────────────────────────────────────────────────────────────────
       │


 General notes
 ─────────────

 It is difficult to write a good documentation for this program since
 there are a lot of different modes like macro mode and multiple
 tagline mode. However I did my best on it. If you encounter any
 problem or just don't know how to install please do write a message.


 You can start AddTag like this:

 AddTag <Tagline file> <File with the message>    (Normal mode)

 For both file parameters you must include a path if the files cannot
 be found in the current directory. See the chapter extra paramaters
 for more startup methods! Also see the chapter about multiple
 tagline files.

 I have absolutly no idea if it also works with other mail readers.
 I tested it only with TimEd, GoldEd and FrontDoor.
 Please let me know if you were able to run it with an other program,
 please also mention how you did it!

 You can use the following function keys within the program:

 F1  -> Random tagline WITH confirm.
 F2  -> Random tagline WITHOUT confirm.
 F3  -> Add a tagline to the message and the tagline file.
 F4  -> Add a tagline only to the message.
 F5  -> Search a tagline
 F6  -> Search again
 F7  -> Load another tagline file (only when in multiple tagline mode)
 F10 -> Help
 DEL -> Delete current tagline

 Note that it is not mandatory to work with a registered version of
 TimEd, GoldEd or FrontDoor. Though it would be nice if you would
 support the author of the program you use by registering.

 How to change the default colors
 ────────────────────────────────

 You can change most of the default colors. If you don't like the
 default colors you can change them in the 'addtag.col' file, this
 is a normal ascii file which can be edited by using a normal text
 editor. The color numbers you can use can be found in this file.

 If you like the default colors you can erase the addtag.col file
 since it automaticly starts-up with these default colors.

 How to place the tagline anywhere you like
 ──────────────────────────────────────────

 It is possible to add a tagline anywhere you like, for instance
 above your sign-off.

 You can do this by adding:

 @AddTag to your message. Ofcourse you can also add it to your
 template file.

 E.g.:

          _
    Bye, |_|
         |ascal

 @ADDTAG


 ! Note that if you wish to use this function that you must specify
 '/M' as a 3th or 4th parameter! It will not look for a tearline in
 this case but will just replace @AddTag for the choosen tagline.


 Multiple tagline file mode
 ──────────────────────────

 You can use AddTag in the multiple tagline file mode if you
 start AddTag like this:

 AddTag @<file> <File with the message>    (Normal mode)
       !^!

 The <file> should be a textfile (vanilla ascii) with on each line
 a name (with path if the file cannot be found in the current
 directory) of a tagline file, after the filename you can add a
 description.

 Example:

 C:\GOLDED\TAGLINES\GENERAL.TAG     ;General taglines
 C:\GOLDED\TAGLINES\WINDOWS.TAG     ;Windows taglines
 C:\GOLDED\TAGLINES\STTNG.TAG       ;Star Trek taglines
 C:\GOLDED\TAGLINES\ADOPTED.TAG     ;Adopted taglines

 The tagline file on the first line will be automaticly loaded when
 you start up the program (so make sure this is the tagline file you
 use the most).

 If the file is called 'Tagfiles.lst' you start addtag like this:

 AddTag.exe @Tagfiles.lst <file with the message> (/M) (/R or /W) (/C)

 An example is included in the archive.


 Extra parameters
 ────────────────

 Apart from the <Tagline file> and <File with the message> parameters
 you can use the following parameters as EXTRA parameters. These
 parameters are not mandatory, they are here to make your life more
 easy. If you use them though they MUST be supplied after the
 tagline file and file with message parameter (3th, 4th or 5th
 parameter)

 /M -> Put AddTag in macro mode (@ADDTAG)
 /R -> Put AddTag in random with confirm mode
 /W -> Put AddTag in random without confirm mode
 /C -> Put AddTag in the capture mode

 Note that you can only use /R or /W you can't use them both!

 e.g.:

 AddTag <Tagline file> <File with the message> /M     (Macro mode)
 AddTag <Tagline file> <File with the message> /R     (Random mode)
 AddTag <Tagline file> <File with the message> /W     (Random without
                                                       confirm mode)
 AddTag <Tagline file> <File with the message> /M /R  (Macro & random
                                                       mode)
 AddTag <Tagline file> <File with the message> /M /W  (Macro & random
                                                       without confirm
                                                       mode)


 Index Mode
 ──────────

 If you want to index a tagline file that is kinda big you can
 start AddTag in the Index mode. It will look if indexing is
 necessary. If that is the case it will index your tagline file
 and exit to dos after that.

 Tip: If you use large taglines files you could better divide them
 over a few other files and start AddTag in the multiple tagline
 mode!

 Start Addtag like this:

 Addtag.exe <Tagline file> /I

 AddTag now uses a smart indexing method when adding or deleting
 taglines.

 Capture mode
 ────────────

 The current capture mode isn't very good yet but it's a start. It
 reads the message and looks for a ... <tagline>. However it does
 not work if the tagline is quoted so you should unquote the
 tagline which you want to have adopted. I am not experienced
 in writing TSR programs or reading from the screen. If any of you
 know how to write such a tagline grabber let me know and if it
 works I'll include it in the archive. (You'll get a free key for
 AddTag <Grin>)


 How to implent AddTag
 ─────────────────────

 In the following examples it is assumed you don't use the extra
 parameters, but it shouldn't be too hard to 'change' the example
 to your needs. It is also assumed your tagline file is called
 'taglines.txt' Of course this can be any other filename. It is just
 an example.




 With TimEd
 ──────────

 Simple, you must use a batch file to start up your editor

 An example:
 ─────────────────────────────────────────────────────────────────────

 @ECHO OFF
 EDIT.COM TIMED.MSG
 ADDTAG.EXE TAGLINES.TXT TIMED.MSG

 ─────────────────────────────────────────────────────────────────────
 Of course you can use your favourite editor instead of Edit.com
 (Like Qedit or the Vision Editor).

 You must change in TimEd.CFG:

 'Editor Ed.Bat' instead of 'Editor Internal'









 With GoldEd (Internal Editor)
 ─────────────────────────────

 Add this to Golded.Cfg:

 ;   =================================================================
 ;   EXTERNAL UTILS
 ;   =================================================================

 EXTERNUTIL   1 ADDTAG.EXE TAGLINES.TXT @File
 EDITSAVEMENU Yes
 EDITSAVEUTIL 1 "T Add a tagline to the message."

 It's assumed that you don't have any other external utils installed.
 Look in the doc files of GoldEd for more details.







 With Golded (External editor)
 ─────────────────────────────

 Simple, you must use a batch file to start up your editor

 An example:

 ─────────────────────────────────────────────────────────────────────

 @ECHO OFF
 EDIT.COM %1
 ADDTAG.EXE TAGLINES.TXT %1

 ─────────────────────────────────────────────────────────────────────
 Of course you can use your favourite editor instead of Edit.com
 (Like Qedit or the Vision Editor).


 Add this to golded.cfg:


 ;   -----------------------------------------------------------------
 ;   Commandline for an external editor, if any.
 ;   -----------------------------------------------------------------
 EDITOR C:\COMMAND.COM /C ED.BAT @File

 See advanced.cfg included in the GoldEd package for more external
 editor functions.








 With TerMail
 ────────────

 Simple, you must use a batch file to start up your editor

 An example:
 ─────────────────────────────────────────────────────────────────────

 @ECHO OFF
 EDIT.COM %1 %2
 ADDTAG.EXE TAGLINES.TXT %1

 ─────────────────────────────────────────────────────────────────────
 Of course you can use your favourite editor instead of Edit.com
 (Like Qedit or the Vision Editor).

 Add (or change) this to your Tmail.cfg:

 Editor     C:\TERM\TMAIL\TAG.BAT @FILE

 If you do not use the @ADDTAG token you should set the tearline to
 a fidonet tearline.








 With FrontDoor 2.12 (and higher)
 ────────────────────────────────

 File   Global   Mailer   Editor   Terminal   Modem   Printer   Manager
══════════════════════════╔═════════════════╗════════════════════════════
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ Miscellaneous   ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ NetMail folder  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒╔══════════════════════════════════════════════════ Keyboard macros ╗▒▒
▒▒║                                                                   ║▒▒
▒▒║ F1  ~EAddTag Taglines.Txt [FD.MSG;~RFD.MSG;                       ║▒▒
▒▒║ F2                                                                ║▒▒
▒▒║ F3                                                                ║▒▒
▒▒║ F4                                                                ║▒▒
▒▒╚═══════════════════════════════════════════════════════════════════╝▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

 It is not necessary that FD.MSG exists but it could be for instance
 a textfile with your signoff. There is in this situation no need for
 a tearline. Note that FM erases FD.MSG in this case so if you want to
 put a signoff it's probably best to make a batch file that copies
 your signoff to a temporary file that can be erased by FM.EXE.

 In that case you shoud add this to FD:

 File   Global   Mailer   Editor   Terminal   Modem   Printer   Manager
══════════════════════════╔═════════════════╗════════════════════════════
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ Miscellaneous   ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ NetMail folder  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒╔══════════════════════════════════════════════════ Keyboard macros ╗▒▒
▒▒║                                                                   ║▒▒
▒▒║ F1  ~ETag.bat; ~RFD.MSG                                           ║▒▒
▒▒║ F2                                                                ║▒▒
▒▒║ F3                                                                ║▒▒
▒▒║ F4                                                                ║▒▒
▒▒╚═══════════════════════════════════════════════════════════════════╝▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

 Note that you could also use a different filename for FD.MSG, but
 you must specify the '[' in front of the name! (and ofcourse both
 names should be the same)



       │ Registration
──────────────────────────────────────────────────────────────────────
       │

 If you like this software please send me a postcard of your town
 or a picture of you, your sister or the dog ;-) Also if you think
 the program is great you can always send me money.

 You can send it to:

        Pascal van Rossum
        P.O. Box 3246
        3502 GE Utrecht
        The Netherlands

 I will appreciate it if you would send me a postcard (I kinda save
 them), and remember it doesn't cost that much to send one!

 Oh yeah and if you put anything on like: 'Don't know if you already
 received my netmail about ...' put also your fidonet address on the
 card. It's hard to write back if I didn't receive the netmail and
 don't know your fido address.


       │ Suggestions
──────────────────────────────────────────────────────────────────────
       │

 I would be glad to hear them! Till now I haven't received many
 suggestions for AddTag so if you want something send me a message.


       │ What might be in the next version
──────────────────────────────────────────────────────────────────────
       │

 - Indexing method will be changed
    - Index file will be according to the number of taglines you have.
    - Probably increase the total taglines (now max. 5000)
    - Perhaps it can be made a great deal faster on the initial
      indexing. But this is quite a lot of work so thats why it is
      not done for this release.

 - Perhaps also adding of a random signature. (Don't know yet if I
   want to add this since it is a tagline program. But if you like
   this feature please do send me a netmail or mention it on your
   card. If a lot of people want this I will probably add it)

 - Sorting of the tagline file

 - An OS/2 version. (there might already be an OS/2 version of
   v1.03 soon, though it will not be released together with
   this dos version).


       │ Contacting the Author
──────────────────────────────────────────────────────────────────────
       │

  Pascal Van.Rossum      The White Room
  P.O.Box 3246           [phone] (v22b,v32b,v42b)
  3502 GE Utrecht          2:281/714    FidoNet
  The Netherlands        234:234/0      ActNet WHq

 I prefer (of course) netmail.


       │ Thanks/Greetings
──────────────────────────────────────────────────────────────────────
       │


 In no particular order I would like to thank and greet:

  - All FileArea Managers who are nice enough to Hatch this program
    in their filenets.

  - You, for reading this and maybe even trying the program.

  - All the people that have suggested features or just told me it
    was a nice program.

  - Michel van Rossum

  - Jan Ubels, without him knowing he gave me the idea for the
    @AddTag function (macro mode).

  - Melle Koning, he suggested (among other things) to include the
    @D@ etc. commands like BlueWave has.

  - A few other people in GoldEd.028 that supplied me with information
    or usefull tips.

  - Daniel Ahlberg for the TerMail batch file.

  - Martin Davies

  - Jochem Valkenburg. He made the color configuration examples

  - Lydia, my great friend. Love you much.

  ! All the people that send me a postcard.

  If I forgot to mention you! please send me a netmail.


       │ Copyrights / Trademarks
──────────────────────────────────────────────────────────────────────
       │

 GoldEd           -> Odinn Sorensen (GoldWare International)
 TimEd            -> Gerard van Essen (ArtWare)
 TeTag            -> Richard Coffee
 FrontDoor        ─> Joaquim H. Homrighausen (Advanced Eng. sarl)
 TerMail          -> Bo Bendtsen
 BlueWave         -> George Hatchew (Cutting Edge Computing)
 Act Of Impulse   -> Pascal van Rossum

 All (other) copyrights and trademarks are of their respective
 owners

 Documentation and Program Copyright 1994
                             Act Of Impulse & Pascal van Rossum.

(EOF)