T I N T I N ++ v1.5

Written by Bill Reiss, Bill Reiss, Joann Ellsworth, Jeremy C. Jack, and David A. Wagner. Docs written by Joann Ellsworth (c) 1994. The use of this documentation, for other "hacked" versions of Tintin++, without the expressed written consent by Joann Ellsworth, is prohibited.


T I N T I N ++

v1.5 Official Release version
(T)he K(I)cki(N) (T)ick D(I)kumud Clie(N)t

What is TinTin++ ?

TINTIN++ is a client program specialized to help playing muds. This is a souped up version of TINTIN III, many new features have been added since III. We saw room for improvement on the features available from TINTIN, and since we like the format of the program, we decided to use TINTIN as a base for what we hope to make one of the most powerful clients around.

TinTin++. What's new ?

Well, MANY bugs have been fixed. Some of the more significant bug fixes however, are fixes to #loop, #split, suspending a session and coming back with the proper echo. The location of the help file was moved to the $HOME directory, and now tintin++ offers compression of that file to reduce the space consumption.

	  New commands to Tintin++ v1.5:

          retab               tablist             info
	  textin              killall             pathdir
	  suspend             tabadd              tabdelete
	  cr                  wildcard

Giving Credit Where Credit is Due

None of this work would be possible, without the work done by Peter Unold. He was the author of TinTin III, the base of TinTin++. Hats off to ya Peter, You started the ball rolling.

Starting TinTin++

The syntax for starting tintin++ is: tintin++ [-v] [commandfile] If no commandfile is given, tintin++ will look for a default commandfile called .tintinrc in your home directory. Read more about the commandfile in the 'files' section below. Remember one thing though. ALL ACTIONS, ALIASES, SUBSTITUTIONS, VARIABLES, HIGHLIGHTS, and ANTISUBSTITUTES DEFINED WHEN STARTING UP TINTIN ARE INHERITED BY ALL SESSIONS. If you'd like to separate the sessions with different commandfiles, just type tintin++ and you are off and running.

-v is optional, and is used only when reading command files. If verbose is specified, messages concerning reading the files will not be in brief mode.

If you want to get out of t++ after starting it type: #end or control-c

I'll start by explaining some of the very basic and important features:

All TINTIN commands starts with a '#'. (can be changed with #char though, or if you specified a commandfile at startup, the first char in that file will be the tintin command char}
     Example:
     #help    <=#help is a command directed to the client and not
                     the mud.

All TINTIN commands can be abbreviated when typed.
     Example:
     #he           <=typing #he is the same as typing #help

All commands can be separated with a ';'. The ';' is similar to a newline char. This allows you to type multiple commands on one line.
     Example:
     n;l green;s;say Dan Dare is back!    <=do these 4 commands

There is a way the newline-char can be overruled, so that it will appear in the output of a say or tell or whatever. By pre-pending a backslash to the ';', you can do this.
     Example:
     say Hello \;)      <=say Hello ;)

hange in Format

The change in formatting is that arguments for commands are now to be put in braces {}. NO QUOTES are used to enclose arguments now, and braces are not to be used except to enclose arguments. More will be included about the change, but you should just know that the old format from TinTin III will not work with TinTin++. In fact, for most of the commands, you need not use the {} around the arguments. Basically, if the command is simple, it most likely will not need braces (but I'd add them to be on the safe side).

Variables

For those of you familiar with variables in TinTin III, you'll understand this section, except for the fact that variables are no longer in the format of &0, &1, ETC. TinTin++ looks for variables that are prefixed with %'s instead of &'s. Thus, In the following example:

            #action {%0 tells you %1} {say %0 just told me %1}

This action will, when anyone tells you something, echo it out back to all the others in the room, via say.

If you are nesting your statements in the command, you might need to prefix the variable with more that one %. For example: #alias {grimne} {#session {%%0} {129.241.36.229 4000}} This alias will connect you to GrimneMUD. You must supply an argument to the alias grimne (session name). Now, You will notice, that the argument for the #ses command is 1 level below the actual command, thus you will have to place an additional % to the variable %0 if you want the variable to work properly. If you were to just put %0 instead of %%0, the actual text '%0' will be used for the session name. ************ *** NOTE *** ************ Due to the increasing number of problems that have arisen with actions, variables, and the ';' newline, you can, if the action is robotic, use a $ in the second argument of the action, to eliminate the ';'s from the variable. What was happening, is that people would have actions that were auto-splitter on the text "There was %0 coins". The action people were using looked something like this: #action {There was %0 coins} {split %0} People were shouting around something like: Butthead shouts 'There was 0;#sys rm -r *; coins." What Tintin++ would do in such a case, would assign 0;rm -r *; to %0 and send the line: split 0;#sys rm -r *; to the parser for tintin to do it's thing. Hope people see the BAD thing about this.. That same instance would delete every file and all subdirectories from within your current directory.

A solution was created for such harassing instances. By using the $ in the second argument of the action command: #action {There was %0 coins} {split $0} Such shouts or echos would be parsed by tintin++ and sent to the command queue as: split 0. The ;'s would be removed thus not doing harm to your account or other nasty things that people have come up with.

Command Syntax

Here is a list of all commands available in TinTin++ v1.5: action alias all antisubstitute bell boss char cr echo end gag help highlight history if ignore info killall log loop map mark math message nop path pathdir presub read redraw retab return savepath session showme snoop speedwalk split substitute suspend system tabadd tabdelete tablist textin tick tickoff tickon tickset ticksize togglesubs unaction unalias unantisubstitute ungag unhighlight unpath unsplit unsubstitute unvariable variable verbatim version wildcard wizlist write writesession zap


This HTML page is designed for Netscape Navigator by Asko Seeba
Back to Stonia homepage