annotate docs/manual.sgml @ 1661:076acee63056

Bump docs version.
author Matti Hamalainen <ccr@tnsp.org>
date Fri, 15 Oct 2021 18:28:45 +0300
parents 86f3d10eafec
children 1d2ccadfff2a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1547
8212f5941566 Bump to DocBook 5.
Matti Hamalainen <ccr@tnsp.org>
parents: 1545
diff changeset
1 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN" "/usr/share/xml/docbook/schema/dtd/5.0/docbook.dtd">
624
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
2 <!-- Define some entities
1661
076acee63056 Bump docs version.
Matti Hamalainen <ccr@tnsp.org>
parents: 1651
diff changeset
3 <!ENTITY ggrtfver "0.7.4.2">
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
4 <!ENTITY finger "<ulink url='http://www.bat.org/char/$1'>$1</ulink>">
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
5 <!ENTITY jeskko "<ulink url='http://jeskko.pupunen.net/'>Jarkko Vääräniemi</ulink> (&finger Jeskko;)">
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
6 <!ENTITY ggr "<ulink url='http://tnsp.org/~ccr/'>Matti Hämäläinen</ulink> (&finger Ggr;)">
714
226df322d549 Fix TF homepage URL.
Matti Hamalainen <ccr@tnsp.org>
parents: 711
diff changeset
7 <!ENTITY tfurl "<ulink url='http://tinyfugue.sf.net/'>TinyFugue</ulink>">
1039
f8b0688f9a36 Update some URLs in manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 1011
diff changeset
8 <!ENTITY homeurl "<ulink url='http://tnsp.org/~ccr/ggrtf/'>http://tnsp.org/~ccr/ggrtf/</ulink>">
1650
e3626f2d850e Update to new repository URLs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1645
diff changeset
9 <!ENTITY hgrepourl "https://tnsp.org/hg/batmud/ggrtf/">
e3626f2d850e Update to new repository URLs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1645
diff changeset
10 <!ENTITY hgrepo "<ulink url='https://tnsp.org/hg/batmud/ggrtf/'>Mercurial-repository</ulink>">
1618
2344fa8c992b Update links to Mercurial website.
Matti Hamalainen <ccr@tnsp.org>
parents: 1614
diff changeset
11 <!ENTITY hgurl "<ulink url='http://www.mercurial-scm.org/'>Mercurial</ulink>">
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
12 <!ENTITY batmudurl "<ulink url='http://www.bat.org/'>BatMUD</ulink>">
1343
aa5e08538992 Update Mercurial repo URLs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1340
diff changeset
13 <!ENTITY pupuneturl "<ulink url='http://pupunen.net/'>pupunen.net</ulink>">
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
14 <!ENTITY gnupgurl "<ulink url='http://www.gnupg.org/'>GnuPG</ulink>">
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
15
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
16 <!ENTITY exampletfrc SYSTEM "../example-tfrc.txt">
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
17 <!ENTITY validval "Valid values:">
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
18 <!ENTITY validonoff "<emphasis>on</emphasis>, <emphasis>off</emphasis>">
232
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
19
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
20 <!ENTITY colourexplanation "
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
21 Colours described here may deviate from what you actually
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
22 see due to differences in terminal emulation programs and settings.
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
23 ">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
24
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
25 <!ENTITY sectmacros_1 "<title>Macro commands</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
26 <para>&lt;&gt; = required argument, [] = optional argument">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
27
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
28 <!ENTITY sectmacros_2 "<section>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
29 <title>Macro commands</title>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
30 <para>&lt;&gt; = required argument, [] = optional argument</para>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
31 <table><title>Macro commands</title>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
32 <tgroup cols='2' align='left'>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
33 <thead>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
34 <row>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
35 <entry>Command</entry>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
36 <entry>Description</entry>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
37 </row>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
38 </thead>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
39 <tbody>">
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
40
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
41 <!ENTITY sectmacros_end "</tbody>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
42 </tgroup>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
43 </table>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
44 </section>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
45 ">
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
46
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
47 <!ENTITY paravariables "Variables and user-replaceable macros defined
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
48 by this module are described in a table below. They have specific
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
49 defaults, which you can override in your configuration if you
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
50 re-set/re-define them after loading the module. Please refer to
404
cea945e9a2a0 Bim bim
Matti Hamalainen <ccr@tnsp.org>
parents: 403
diff changeset
51 <link linkend='inst-config'>Setup</link>-section of this manual
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
52 or see the example configuration for this module.
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
53 ">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
54
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
55 <!ENTITY sectvariables "
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
56 <title>Settings and user-replaceable macros</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
57 <para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
58 &paravariables;
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
59 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
60
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
61 <table><title></title>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
62 <tgroup cols='2' align='left'>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
63 <thead>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
64 <row>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
65 <entry>Variable / macro name</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
66 <entry>Description</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
67 </row>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
68 </thead>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
69 <tbody>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
70 ">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
71
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
72 <!ENTITY sectvariablesend "
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
73 </tbody>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
74 </tgroup>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
75 </table>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
76 </section>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
77 ">
251
3765cf197a77 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 250
diff changeset
78
624
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
79 -->
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
80 <book>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
81 <bookinfo>
1052
3f0fec339dcb Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1049
diff changeset
82 <title>The GgrTF v&ggrtfver; User's Guide</title>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
83 <authorgroup>
620
b51e42467f2c Character set conversion ISO-8859-1 -> UTF-8
Matti Hamalainen <ccr@tnsp.org>
parents: 618
diff changeset
84 <author><firstname>Matti</firstname><surname>Hämäläinen</surname></author>
b51e42467f2c Character set conversion ISO-8859-1 -> UTF-8
Matti Hamalainen <ccr@tnsp.org>
parents: 618
diff changeset
85 <author><firstname>Jarkko</firstname><surname>Vääräniemi</surname></author>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
86 </authorgroup>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
87 <copyright>
1645
4e4498b4558c Bump copyright.
Matti Hamalainen <ccr@tnsp.org>
parents: 1640
diff changeset
88 <year>2006-2021</year>
620
b51e42467f2c Character set conversion ISO-8859-1 -> UTF-8
Matti Hamalainen <ccr@tnsp.org>
parents: 618
diff changeset
89 <holder>Matti Hämäläinen (Ggr Pupunen)</holder>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
90 </copyright>
1645
4e4498b4558c Bump copyright.
Matti Hamalainen <ccr@tnsp.org>
parents: 1640
diff changeset
91 <pubdate>2021</pubdate>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
92
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
93 <legalnotice>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
94 <para>
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
95 This document is distributed under
1072
c68c152728d8 Upgrade CC-SA license from 2.5 to version 3.0.
Matti Hamalainen <ccr@tnsp.org>
parents: 1071
diff changeset
96 <ulink url="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution-Share Alike 3.0 license</ulink>,
c68c152728d8 Upgrade CC-SA license from 2.5 to version 3.0.
Matti Hamalainen <ccr@tnsp.org>
parents: 1071
diff changeset
97 of which full version can be found from <ulink url="http://creativecommons.org/licenses/by-sa/3.0/legalcode">Creative Commons website</ulink>.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
98 </para>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
99
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
100 <para>
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
101 THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
102 COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
103 COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
104 AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
105 </para>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
106
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
107 <para>
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
108 BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE
1072
c68c152728d8 Upgrade CC-SA license from 2.5 to version 3.0.
Matti Hamalainen <ccr@tnsp.org>
parents: 1071
diff changeset
109 TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY
c68c152728d8 Upgrade CC-SA license from 2.5 to version 3.0.
Matti Hamalainen <ccr@tnsp.org>
parents: 1071
diff changeset
110 BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED
c68c152728d8 Upgrade CC-SA license from 2.5 to version 3.0.
Matti Hamalainen <ccr@tnsp.org>
parents: 1071
diff changeset
111 HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
112 </para>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
113 </legalnotice>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
114 </bookinfo>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
115
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
116 <!-- *************************************************************** -->
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
117
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
118 <chapter id="preface"><title>Preface</title>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
119
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
120 <section id="whatisggrtf"><title>What is GgrTF?</title>
233
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
121
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
122 <para>
567
82a3def121a8 Updated intro, hopefully now in better linguistic form.
Matti Hamalainen <ccr@tnsp.org>
parents: 555
diff changeset
123 GgrTF is a <emphasis>framework</emphasis> of AND for triggers to
82a3def121a8 Updated intro, hopefully now in better linguistic form.
Matti Hamalainen <ccr@tnsp.org>
parents: 555
diff changeset
124 ease playing of &batmudurl; with &tfurl; MUD-client. GgrTF is designed for
82a3def121a8 Updated intro, hopefully now in better linguistic form.
Matti Hamalainen <ccr@tnsp.org>
parents: 555
diff changeset
125 modularity and easy development. Our primary development goals
82a3def121a8 Updated intro, hopefully now in better linguistic form.
Matti Hamalainen <ccr@tnsp.org>
parents: 555
diff changeset
126 are good overall quality of code and maintainability.
82a3def121a8 Updated intro, hopefully now in better linguistic form.
Matti Hamalainen <ccr@tnsp.org>
parents: 555
diff changeset
127 These are also some of the key elements, that differentiate
82a3def121a8 Updated intro, hopefully now in better linguistic form.
Matti Hamalainen <ccr@tnsp.org>
parents: 555
diff changeset
128 GgrTF from most other publicly available scripts.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
129 </para>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
130
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
131 <para>
862
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
132 GgrTF is being developed for TF5 of &tfurl; MUD client under Linux
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
133 and Solaris platforms. Users of GgrTF are mostly users of UNIX-like
567
82a3def121a8 Updated intro, hopefully now in better linguistic form.
Matti Hamalainen <ccr@tnsp.org>
parents: 555
diff changeset
134 systems, but there are several who run TF under Microsoft Windows
862
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
135 operating system. Version 0.6.9.15 was the last that supported TF4.
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
136 </para>
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
137
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
138 <para>
669
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
139 The current version (as of v&ggrtfver; release) has modules
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
140 for following character classes:
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
141 </para>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
142 <itemizedlist>
711
46b002db0699 Fix some links.
Matti Hamalainen <ccr@tnsp.org>
parents: 710
diff changeset
143 <listitem><para><link linkend="usage-magical">Mages</link> (<ulink url="http://www.bat.org/help/guilds?str=The+Brotherhood+of+Wizardry">The Brotherhood of Wizardry</ulink>)</para></listitem>
46b002db0699 Fix some links.
Matti Hamalainen <ccr@tnsp.org>
parents: 710
diff changeset
144 <listitem><para><link linkend="usage-chann">Channellers</link> (<ulink url="http://www.bat.org/help/guilds?str=The+Guild+of+Channellers">The Guild of Channellers</ulink>)</para></listitem>
46b002db0699 Fix some links.
Matti Hamalainen <ccr@tnsp.org>
parents: 710
diff changeset
145 <listitem><para><link linkend="usage-merchant">Merchants</link> (<ulink url="http://www.bat.org/help/guilds?str=The+Master+Merchants">The Master Merchants</ulink>)</para></listitem>
46b002db0699 Fix some links.
Matti Hamalainen <ccr@tnsp.org>
parents: 710
diff changeset
146 <listitem><para><link linkend="usage-barb">Barbarians</link> (<ulink url="http://www.bat.org/help/guilds?str=Barbarian+Guild">Barbarian Guild</ulink>)</para></listitem>
46b002db0699 Fix some links.
Matti Hamalainen <ccr@tnsp.org>
parents: 710
diff changeset
147 <listitem><para><link linkend="usage-loc">LoCs</link> (<ulink url="http://www.bat.org/help/guilds?str=Lords+of+Chaos">Lords of Chaos</ulink>)</para></listitem>
46b002db0699 Fix some links.
Matti Hamalainen <ccr@tnsp.org>
parents: 710
diff changeset
148 <listitem><para><link linkend="usage-tarma">Tarmalens</link> (<ulink url="http://www.bat.org/help/guilds?str=The+Followers+of+Tarmalen">The Followers of Tarmalen</ulink>)</para></listitem>
46b002db0699 Fix some links.
Matti Hamalainen <ccr@tnsp.org>
parents: 710
diff changeset
149 <listitem><para><link linkend="usage-druid">Druids</link> (<ulink url="http://www.bat.org/help/guilds?str=The+Humble+Druids">The Humble Druids</ulink>)</para></listitem>
46b002db0699 Fix some links.
Matti Hamalainen <ccr@tnsp.org>
parents: 710
diff changeset
150 <listitem><para><link linkend="usage-nun">Nuns</link> (<ulink url="http://www.bat.org/help/guilds?str=Sisters+of+Las">Sisters of Las</ulink>)</para></listitem>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
151 <listitem><para><link linkend="usage-spiders">Spiders</link></para></listitem>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
152 <listitem><para><link linkend="usage-tiger">Tigers</link></para></listitem>
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
153 <listitem><para><link linkend="usage-alchemist">Alchemists</link></para></listitem>
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
154 </itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
155
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
156 <para>
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
157 In non-guild related sense, GgrTF has most of the basics expected from
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
158 such triggerset. There is a <link linkend="usage-general-prots">prot-management and reporting
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
159 system</link>, <link linkend="usage-general-skillspell">skill</link>- and
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
160 <link linkend="usage-magical">spell</link>-handling, way to
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
161 easily <link linkend="usage-general-commands">run commands on each battle round</link>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
162 (and more), plus following special modules:
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
163 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
164
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
165 <itemizedlist>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
166 <listitem><para><link linkend="usage-pssmangle">'pss'-output mangler</link></para></listitem>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
167 <listitem><para><link linkend="usage-hstats">Hit statistics counter</link></para></listitem>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
168 <listitem><para><link linkend="usage-spellnames">Spellchants to names translator</link></para></listitem>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
169 <listitem><para><link linkend="usage-pplacer">Party member autoplacer</link></para></listitem>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
170 <listitem><para><link linkend="usage-ptracker">Party prot tracker</link></para></listitem>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
171 <listitem><para><link linkend="usage-rpouch">Reagent pouch helper</link></para></listitem>
969
88b32a56a75e A bit of documentation for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 956
diff changeset
172 <listitem><para><link linkend="usage-identify">Identify spell beautifier</link></para></listitem>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
173 </itemizedlist>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
174
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
175 <para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
176 And more ...
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
177 </para>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
178 </section>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
179
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
180 <!-- ================================================ -->
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
181
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
182 <section id="isggrtfforme"><title>Is GgrTF for Me?</title>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
183 <para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
184 It is impossible to tell for certain, really. If you are averse
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
185 of doing some digging of your own, or adjusting some trigger code,
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
186 it may not be. GgrTF is meant to work as a "platform" and a base,
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
187 not as a complete bells and whistles-type solution.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
188 In the end, you may have just to give it a try.
555
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
189 </para>
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
190
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
191 <para>
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
192 When I started working on GgrTF,
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
193 I was just "scratching an itch", and that itch still continues,
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
194 though few others have joined my efforts on scratching.
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
195 During the two years I have been developing GgrTF, most of that
555
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
196 time I've been scratching my own back, doing stuff mostly for myself.
284
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
197 Thus, if you like the design decisions and features I like,
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
198 play the same guilds as I (though some guilds which I haven't
555
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
199 ever touched are supported through efforts of other developers)
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
200 it is likely that you will like GgrTF.
284
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
201 </para>
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
202
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
203 <para>
555
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
204 Also GgrTF is not all that well documented (although that is one
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
205 thing we are trying remedy) and <emphasis>requires basic knowledge of
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
206 how &tfurl;</emphasis> and its macro language works. As such GgrTF
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
207 is not a ready out-of-the-box experience for some users and never
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
208 will be. <emphasis>However, if you are able to crank it up and working,
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
209 and are content with what is readily offered, then it might be something
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
210 for you.</emphasis>
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
211 </para>
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
212
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
213 <para>
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
214 All in all, GgrTF <emphasis>might</emphasis> be something for you,
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
215 especially if you like things the way I like them. But on the other
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
216 hand GgrTF might not be for you, and there are several alternatives
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
217 out there for those who do not find it satisfactory. Below I have
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
218 tried to list some pros and cons of using GgrTF.
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
219 </para>
284
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
220
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
221 <itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
222 <listitem><para>Pros:</para>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
223 <itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
224 <listitem><para>Good general quality of code. As somebody put it,
233
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
225 "you do not instantly get a headache from just looking at the code."</para></listitem>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
226 <listitem><para>Modularity, easily extendable for most part.</para></listitem>
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
227 <listitem><para>Updated regularly, most bugs get fixed in upstream.</para></listitem>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
228 <listitem><para>User-level documentation exists.</para></listitem>
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
229 </itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
230 </listitem>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
231
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
232 <listitem><para>Cons:</para>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
233 <itemizedlist>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
234 <listitem><para>Only small number of &batmudurl;'s guilds are specifically supported.</para></listitem>
695
eccaff8ad60f Typofix.
Matti Hamalainen <ccr@tnsp.org>
parents: 670
diff changeset
235 <listitem><para>Requires bit more programming knowledge than some other solutions.</para></listitem>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
236 <listitem><para>Due to nature of the developer's reincs, is biased
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
237 towards caster-type functionality than tanks. Thus the support for tank
695
eccaff8ad60f Typofix.
Matti Hamalainen <ccr@tnsp.org>
parents: 670
diff changeset
238 guilds is not very good, although some guilds are supported.</para></listitem>
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
239 </itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
240 </listitem>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
241
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
242 </itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
243 </section>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
244
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
245 <!-- ================================================ -->
232
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
246
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
247 <section id="ggrtfhistory"><title>History of GgrTF</title>
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
248 <subtitle>As told by Ggr</subtitle>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
249
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
250 <para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
251 <emphasis>Way back in march of 2004, I made one of the worst
669
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
252 mistakes in my life - I created a character in &batmudurl;.</emphasis>
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
253
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
254 I never thought of myself to be much of a gamer, I've always
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
255 been more interested in more technical things, programming
669
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
256 and a little bit of digital electronics and hardware, so
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
257 mostly my gaming experience consisted of some c64 games,
669
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
258 Nethack and some CRPGs like Fallout. I guess the RPG statmania
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
259 was one reason that got me hooked in the first place, plus
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
260 the multiplayer interaction and social aspects.
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
261 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
262
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
263 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
264 Started off playing with plain telnet for the first month or so,
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
265 then installed &tfurl;, because it seemed to be the most popular
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
266 of the clients available for UNIXish platforms. First I didn't use
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
267 any triggers at all, TF was just there to work as better terminal
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
268 and separating the input from output .. and the game was confusing
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
269 enough to start with, triggers would have just complicated things.
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
270 At least I felt so back then.
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
271 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
272
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
273 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
274 At some point, however, my playing style advanced and need for
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
275 automating certain things became apparent. I researched some of
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
276 the available scripts, but most of them were either badly designed,
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
277 full of very apparent mistakes and bugs, or simply not maintained
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
278 anymore. Some people (highbies mainly) seemed to have some good stuff,
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
279 but as usual, they only shared inside small circles of their own.
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
280 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
281
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
282 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
283 Fancying myself as a programmer of some sort, off I went, developing my
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
284 own piece of turf, starting out very simple, expanding and improving
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
285 when needed. That continued for about a year or a bit over, then the
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
286 situation got out of hand - I started "releasing" GgrTF periodically
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
287 on my &batmudurl; related web-page.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
288 </para>
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
289
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
290 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
291 The first ever released version of GgrTF was v0.3.0, which was extremely
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
292 simple and hacky. It supported just channeller/mage stuff and had a broken
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
293 prots management system. The 0.3.x-series continued up to 0.3.13 or so,
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
294 after which some bigger changes were made and 0.4.0 was released.
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
295 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
296
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
297 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
298 At some point of 0.4.x-series development, more people started noticing GgrTF.
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
299 I believe some even started using it, or at least used parts of it in
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
300 their own code. v0.4.x was somewhat short-lived, soon major restructuring
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
301 was done in the prot management system and it was time for 0.5.0. As the
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
302 development progressed, it soon again became apparent that bigger changes
669
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
303 were needed ... v0.5.5 was the last stable release in that series.
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
304 </para>
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
305
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
306 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
307 Development of the new features took somewhat longer time than originally
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
308 expected, there were literally dozens of internal version landmarks
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
309 (v0.5.6.x, v0.5.9.x, v0.5.10.x, v0.5.11.x and finally even v0.6.0-preX
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
310 series), which preceeded the final v0.6.0-release in early august 2006.
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
311
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
312 This new release marked a major improvement in code quality and number of
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
313 features, and also this user's manual was included for the first time.
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
314 It was also the first time when other people joined up and did some work
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
315 on few features.
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
316 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
317
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
318 </section>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
319
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
320 <!-- ================================================ -->
232
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
321
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
322 <section id="license"><title>GgrTF License</title>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
323 <para>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
324 GgrTF is copyrighted (except where mentioned otherwise)
620
b51e42467f2c Character set conversion ISO-8859-1 -> UTF-8
Matti Hamalainen <ccr@tnsp.org>
parents: 618
diff changeset
325 by Matti Hämäläinen (aka Ggr Pupunen) and
232
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
326 distributed under the GNU General Public License version 2.
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
327 </para>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
328
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
329 <para>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
330 Complete text of the GNU GPL v2 is included with the code in a file
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
331 called COPYING.txt, and is also available
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
332 <ulink url="http://www.gnu.org/licenses/gpl.html">here</ulink>.
232
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
333 </para>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
334 </section>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
335
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
336 </chapter>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
337
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
338 <!-- *************************************************************** -->
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
339
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
340 <chapter id="installation"><title>Installation</title>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
341 <para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
342 This chapter assumes that you have already succesfully installed &tfurl;
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
343 in your system and you know how to use it (basic commands, loading of
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
344 macros, etc.) It is also assumed that you know how to use your operating
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
345 system of choice, be it some flavour of UNIX or Windows, although some
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
346 parts of the instructions are given in step-by-step manner.
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
347 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
348
421
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
349 <note>
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
350 <para>
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
351 Throughout this manual, when GgrTF files are referenced in configuration
783
Matti Hamalainen <ccr@tnsp.org>
parents: 781
diff changeset
352 examples etc., I have used "<emphasis>ggrtf/</emphasis>" -directory as path
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
353 where the script files are located relative to your "home directory".
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
354 You may need to substitute it with whatever you have installed your copy of GgrTF
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
355 files in.
421
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
356 </para>
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
357 </note>
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
358
404
cea945e9a2a0 Bim bim
Matti Hamalainen <ccr@tnsp.org>
parents: 403
diff changeset
359 <para>
cea945e9a2a0 Bim bim
Matti Hamalainen <ccr@tnsp.org>
parents: 403
diff changeset
360 There are basically two ways how to get GgrTF, release packages and
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
361 the Mercurial-repository. Releases are considered as stable snapshots,
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
362 which should be relatively bug-free, but releases are done somewhat
281
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
363 infrequently and at least in this phase we don't backport bugfixes to
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
364 release versions.
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
365 </para>
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
366
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
367 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
368 If you are unsure which version to choose, use the latest packaged release.
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
369 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
370
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
371
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
372 <section id="inst-releases"><title>Releases</title>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
373 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
374 To get the latest stable version, head to the downloads-section of
1535
39ceddf54ee3 Fix a link.
Matti Hamalainen <ccr@tnsp.org>
parents: 1534
diff changeset
375 <ulink url="http://tnsp.org/~ccr/ggrtf/">GgrTF's homepage</ulink>
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
376 and pick either the newest tarball (*.tar.gz) or zip-archive (*.zip):
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
377 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
378 <itemizedlist>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
379 <listitem>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
380 <para>*.tar.gz packages are for UNIX-like systems, such as Linux, *BSD,
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
381 etc. Please note that the ZIP-packages are meant for Windows only and WILL
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
382 NOT WORK under UNIX or OS X version of TinyFugue!</para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
383 </listitem>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
384 <listitem>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
385 <para>*.zip packages are for Windows version of TinyFugue (the files
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
386 have been converted to CRLF line endings.)</para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
387 </listitem>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
388 </itemizedlist>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
389 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
390 Both package types also have equivalent PGP/&gnupgurl; signature files
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
391 (*.asc), which can be used to cryptographically
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
392 <link linkend="app-verify-sig">verify the authenticity</link> of files.
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
393 </para>
1574
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
394 <para>
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
395 To "install" the package, you simply unpack it to appropriate directory,
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
396 typically under your home directory. Under UNIX-style system:
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
397 </para>
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
398
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
399 <userinput>cd $HOME</userinput>
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
400 <userinput>tar xzvf ggrtf-&ggrtfver;.tar.gz</userinput>
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
401
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
402
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
403 <para>
1574
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
404 After that, you should have directory $HOME/ggrtf/ with all the *.tf files in it.
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
405 If so, you can continue to the <link linkend="inst-config">configuration part</link>.
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
406 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
407
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
408 </section>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
409
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
410
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
411 <section id="inst-mercurial"><title>Development version</title>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
412 <para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
413 Another way to get GgrTF is to go to the very source, the
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
414 development source repository. This repository contains the latest
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
415 bleeding edge features, but is also a fast moving target. Changes
1557
b922a5f99ad8 Some language improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 1556
diff changeset
416 are directly committed by developers almost in real time,
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
417 sometimes what you download may be severely broken.
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
418 Also the documentation will not be updated for every little change,
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
419 so you may have to figure out and work around possible backward
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
420 incompatibilities yourself.
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
421 </para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
422
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
423 <para>
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
424 New features and bugfixes may sometimes be worth taking the risk.
670
44a490cc41ec Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 669
diff changeset
425 On the other hand, it is all up to what you want and whether you can
44a490cc41ec Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 669
diff changeset
426 manage to handle the possibly arising problems.
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
427 </para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
428
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
429 <para>
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
430 We utilize &hgurl; (Hg) for GgrTF's version management. Mercurial
1557
b922a5f99ad8 Some language improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 1556
diff changeset
431 is a freely available distributed version control system, for which
281
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
432 there are clients available for most common platforms, including
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
433 Windows, Linux and other flavours of UNIX.
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
434 </para>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
435
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
436 <para>
1651
86f3d10eafec Fix reference to old repo location.
Matti Hamalainen <ccr@tnsp.org>
parents: 1650
diff changeset
437 GgrTF's Mercurial repository is hosted at tnsp.org, and is available from following location:
1322
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
438 <ulink url="&hgrepourl;">&hgrepourl;</ulink>.
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
439 The same URL can be used with a web browser to browse version history.
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
440 </para>
281
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
441
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
442 <section id="intro-checking-out"><title>Checking out</title>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
443 <para>
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
444 You can download (aka "clone") the GgrTF repository with command line
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
445 Mercurial client with following command:
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
446
1340
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
447 <userinput>hg clone &hgrepourl; dest_dir</userinput>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
448
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
449 In which <emphasis>"clone"</emphasis> means making a local copy of the
1340
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
450 repository under directory <emphasis>dest_dir</emphasis>.
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
451 </para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
452
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
453 <para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
454 You will most probably want to download the repository to some
1340
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
455 specific place, personally I prefer to use ~/ggrtf/ (aka "ggrtf/"
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
456 under user's home directory) under UNIX.
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
457 Thus typically you would use following command:
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
458
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
459 <userinput>hg clone &hgrepourl; ~/ggrtf</userinput>
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
460
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
461 If you are using Windows, and wish to use the development version, you
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
462 can use the regular Mercurial command line client, or a GUI interface
1533
c9f2913b933a Fix some link tags.
Matti Hamalainen <ccr@tnsp.org>
parents: 1532
diff changeset
463 such as <ulink url="http://tortoisehg.bitbucket.org/">TortoiseHg</ulink>.
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
464 </para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
465
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
466 <para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
467 The procedures for cloning and updating your local copy of the repository
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
468 are otherwise similar, except the directory/folder path is different,
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
469 under Windows XP the path would be <emphasis>C:\Documents and Settings\&lt;username&gt;\ggrtf\</emphasis>.
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
470 For example, if your username is "Ggr", you could use the following command:
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
471
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
472 <userinput>hg clone &hgrepourl; "C:\Documents and Settings\Ggr\ggrtf\"</userinput>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
473
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
474 Under Windows Vista and 7, the path is of the format <emphasis>C:\Users\&lt;username&gt;\</emphasis>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
475 </para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
476
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
477 </section>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
478
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
479 <section id="intro-updating"><title>Keeping up to date</title>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
480 <para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
481 After you have checked out your own copy of GgrTF's code repository,
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
482 you usually wish to periodically update it. This is done easily with
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
483 the following commands:
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
484
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
485 <userinput>cd ~/ggrtf</userinput>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
486 <userinput>hg pull</userinput>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
487 <userinput>hg update</userinput>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
488
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
489 Notice that since Mercurial is a distributed version management system, you can easily
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
490 keep your own local changes by committing them (<emphasis>'hg ci'</emphasis>)
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
491 and then, instead of using 'pull' and 'update', you can use 'hg fetch' to merge
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
492 your local changesets automatically. Refer to Mercurial documentation.
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
493 </para>
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
494 <para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
495 If you plan on making modifications to GgrTF, it is recommended that you familiarize
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
496 yourself with the basics of Mercurial workflow, making commits, fetching, etc. It
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
497 will help you with maintaining your changes locally or sending patches to us.
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
498 </para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
499
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
500
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
501 </section>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
502
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
503 </section>
405
7bdc7ef54e6c Add blockdiagram files.
Matti Hamalainen <ccr@tnsp.org>
parents: 404
diff changeset
504
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
505 </chapter>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
506
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
507 <!-- ================================================ -->
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
508
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
509 <chapter id="inst-config"><title>Configuration</title>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
510 <para>
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
511 After extracting GgrTF files into the appropriate directory folder,
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
512 you will need to create (or change) configuration for &tfurl; to load GgrTF
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
513 modules and possibly change some of your settings in &batmudurl;.
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
514 </para>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
515
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
516 <para>
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
517 If you are upgrading GgrTF from a previous version, it is possible
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
518 that you do not have to change your configuration. But it is neverthless
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
519 recommended that you skim through this section, the ChangeLog and
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
520 module-specific sections of this manual in case of any significant,
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
521 backwards incompatible changes.
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
522 </para>
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
523
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
524
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
525 <section id="inst-config-tf"><title>TF configuration file</title>
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
526 <para>
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
527 Typical way to use GgrTF is to load the script modules at startup.
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
528 This is accomplished via TinyFugue's configuration file, commonly
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
529 referred as "tfrc", location of which depends on your operating
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
530 system and environment.
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
531 </para>
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
532
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
533 <itemizedlist>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
534 <listitem><para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
535 UNIX-like systems, like Linux:
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
536 <emphasis>~/.tfrc</emphasis> or <emphasis>$HOME/.tfrc</emphasis>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
537 (aka a file named ".tfrc" in your user home directory.)
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
538 </para></listitem>
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
539
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
540 <listitem><para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
541 DruWare Win32 port of TF:
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
542 Windows XP/2k/NT - <emphasis>C:\Documents and Settings\username\tfrc</emphasis>,
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
543
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
544 Windows 7/Vista - <emphasis>C:\Users\username\tfrc</emphasis>
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
545 </para></listitem>
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
546 </itemizedlist>
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
547
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
548 <para>
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
549 As a basis for your TF configuration, you can use the example-tfrc.txt
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
550 provided with GgrTF. You will need to edit it to suit your guilds and
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
551 certain settings. However, the example-tfrc is only a suggested layout
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
552 of configuration, mostly to show the order GgrTF requires modules
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
553 and settings to be loaded. It does not contain everything you can possibly
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
554 do with TF.
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
555 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
556
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
557 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
558 Take note of the order of how different parts of GgrTF are loaded and where
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
559 certain variables are set. Important thing is to have the order right, certain
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
560 modules depend on other modules, and while GgrTF will usually print warning message(s)
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
561 if the depencies are not met, sometimes this is not possible and erratic behaviour
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
562 will occur.
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
563 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
564
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
565 <screen>&exampletfrc;</screen>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
566
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
567 <!--
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
568 - layout of recommended configuration
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
569 - discussion about modules
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
570 - bindings or not?
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
571 -->
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
572
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
573 <section id="inst-config-tf-locale"><title>Character set encoding and locales</title>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
574 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
575 One thing that is out of scope of GgrTF itself, is the issue of character set
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
576 translation and locales. This basically means the way different characters
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
577 are encoded and interpreted, how different values map to characters and vice versa,
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
578 for example a simple encoding might be A=1, B=2, C=3, etc.
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
579 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
580
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
581 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
582 One of the first and most widely used character encodings on computer systems
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
583 is known as <ulink url="http://en.wikipedia.org/wiki/ASCII">7-bit ASCII</ulink>.
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
584 This encoding allows 128 symbols or characters, and was commonly used for decades.
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
585 Unfortunately, 128 symbols is nearly not sufficient enough to represent all the
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
586 different alphabets or symbols used around the world (scandinavian characters,
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
587 cyrillic alphabet, etc.) Thus other encodings were invented, most of them
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
588 incompatible with each other, until introduction of Unicode standard and especially
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
589 <ulink url="http://en.wikipedia.org/wiki/UTF-8">Unicode UTF-8</ulink>.
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
590 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
591
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
592 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
593 The de-facto character set used in BatMUD is called "ISO-8859-1" which is
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
594 a 8-bit encoding that allows 7-bit ASCII characters and 8-bit encoding of
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
595 scandinavian characters (A and O with dots, etc). This is mostly due to
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
596 BatMUD's origin in Finland, where ISO-8859-1 has been most deployed.
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
597 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
598
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
599 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
600 However, increasing number of systems are starting to use Unicode "UTF-8"
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
601 encoding, and other encodings are also still used. Unicode is a good thing
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
602 in itself, and UTF-8 allows compatible 7-bit ASCII characters, but 8-bit
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
603 and over are not compatible with ISO-8859-1. This is why if your system
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
604 uses UTF-8, other people in BatMUD may see your non-ASCII characters
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
605 incorrectly.
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
606 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
607
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
608 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
609 Now that we know the issue, what can we do? Sometimes the solution may
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
610 be very simple, but in many cases rather complex and very dependant
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
611 on your setup - e.g. where you run TF, is it a shell or running locally, etc.
1532
b2c4d5d9bed8 We need no stinkin tips.
Matti Hamalainen <ccr@tnsp.org>
parents: 1531
diff changeset
612 Below is a list of tips and pointers, which may be of some help.
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
613 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
614
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
615 <section id="inst-config-tf-locale-unix"><title>UNIX-likes / Linux</title>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
616 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
617 For Linux/UNIX, you need to have the ISO-8859-1 locale installed/configured.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
618 How this is done depends on your OS distribution. For example in Debian,
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
619 you need to use <userinput>dpkg-reconfigure locales</userinput> and add
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
620 some ISO-8859-1 locale, for example <emphasis>en_US.iso88591</emphasis>.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
621 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
622
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
623 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
624 On Ubuntu, things get a bit more complicated:
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
625 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
626 <orderedlist>
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
627 <listitem>
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
628 <para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
629 Edit /var/lib/locales/supported.d/local with your favorite editor,
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
630 and on the last line add: <emphasis>en_US.ISO-8859-1 ISO-8859-1</emphasis>.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
631 It should look something like this:
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
632 </para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
633 <screen>en_US.UTF-8 UTF-8
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
634 en_US.ISO-8859-1 ISO-8859-1</screen>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
635 </listitem>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
636 <listitem>
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
637 <para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
638 Then, run <userinput>sudo dpkg-reconfigure locales</userinput>
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
639 </para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
640 </listitem>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
641 </orderedlist>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
642 <para>
1602
33eab61839a7 Typofix.
Matti Hamalainen <ccr@tnsp.org>
parents: 1601
diff changeset
643 On other Linux distributions and UNIX-like platforms the methods
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
644 for installing locales vary. Your best bet is to
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
645 <ulink url="https://www.google.com/search?q=linux+install+locale+iso-8859-1">Use the Google</ulink>.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
646 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
647 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
648 If your system is using some locale other than ISO-8859-1 such as UTF-8,
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
649 you will need to make the terminal use ISO-8859-1 despite the system-global
1597
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
650 setting, or alternatively use some software like <ulink url="https://www.gnu.org/software/screen/">GNU Screen</ulink>
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
651 to "translate" between your system's and BatMUD's ISO-8859-1. Some
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
652 information about how to make GNU Screen do that, can be found
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
653 from this website: <ulink url="http://aperiodic.net/screen/terminal">http://aperiodic.net/screen/terminal</ulink>.
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
654 </para>
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
655 <para>
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
656 However, if you choose not to use 'screen', you will have to either
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
657 start your terminal program (inside which TinyFugue will run) with the
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
658 locale set to ISO-8859-1, OR if your terminal supports the feature,
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
659 use the following shell script wrapper which will use terminal
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
660 control codes to change the effective character translation.
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
661 <emphasis>This feature is not supported by all terminals, XTerm and
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
662 Rxvt are known to support it, however.</emphasis>
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
663 You will need to copy+paste the script, or download it
d1ea70ae13c9 Updated documentation concerning the character set/locale stuff.
Matti Hamalainen <ccr@tnsp.org>
parents: 1596
diff changeset
664 <ulink url="http://tnsp.org/~ccr/ggrtf/tf5.sh">from here</ulink>.
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
665 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
666 <screen>#!/bin/sh
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
667 SAVE_LANG="$LANG"
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
668 export LANG="en_US.ISO-8859-1"
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
669 printf '\33]701;%s\007' $LANG
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
670
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
671 /usr/bin/tf5 $*
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
672
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
673 export LANG="$SAVE_LANG"
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
674 printf '\33]701;%s\007' $LANG</screen>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
675 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
676 You should place the script in some directory in your $PATH. You
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
677 will also need to modify it to point to the correct TinyFugye executable,
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
678 (e.g. change "/usr/bin/tf5" if needed.) Name the script as something
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
679 like "mytf" or rename the real TinyFugue executable as "tf5-bin" and
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
680 the script as "tf5", changing the script to point to tf5-bin.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
681 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
682 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
683 Remember to set the script executable by changing
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
684 its permissions, '<emphasis>chmod 0755 /some/where/scriptfile</emphasis>'
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
685 should do it.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
686 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
687 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
688 The idea is that you run the script instead of TF directly. The
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
689 script changes your current locale and forces the terminal via
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
690 special terminal control code to use it, and changes it back
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
691 after TF exits.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
692 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
693 </section> <!-- Unix-likes -->
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
694
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
695
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
696 </section>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
697
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
698 <section id="inst-config-tf-term"><title>Terminal/keyboard issues</title>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
699 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
700 You need to make sure that you have the correct keyboard module(s) loaded.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
701 For most Linux/UNIX terminals you want to load EITHER or BOTH
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
702 <emphasis>kbd-xterm.tf</emphasis> and <emphasis>kbd-tf5def.tf</emphasis>.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
703 For TF on Windows and Mac OSX, you may wish to use
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
704 <emphasis>kbd-tf5def.tf</emphasis> only. You may need to experiment.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
705 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
706 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
707 Additionally, it may be necessary to enable the so-called "application mode"
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
708 in your terminal.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
709 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
710 <itemizedlist>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
711 <listitem>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
712 <para>In OSX terminal app, the setting can be found in <emphasis>Terminal /
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
713 Preferences / Setting / Advanced</emphasis> and turn on
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
714 "Allow VT100 application keypad mode".
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
715 </para>
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
716 </listitem>
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
717 <listitem>
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
718 <para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
719 In PuTTY, the application keypad mode should be enabled by default,
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
720 but if it is not, see the Features panel of PuTTY's configuration,
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
721 see <ulink url="http://the.earth.li/~sgtatham/putty/0.60/htmldoc/Chapter4.html#config-appkeypad">PuTTY documentation here</ulink>.
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
722 </para>
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
723 </listitem>
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
724 </itemizedlist>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
725 </section> <!-- Terminal -->
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
726
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
727 </section>
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
728
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
729
404
cea945e9a2a0 Bim bim
Matti Hamalainen <ccr@tnsp.org>
parents: 403
diff changeset
730 <section id="inst-config-batmud"><title>BatMUD settings</title>
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
731 <para>
980
9d3182edd64d Add note about how BatMUD settings should be copypasted exactly as shown.
Matti Hamalainen <ccr@tnsp.org>
parents: 978
diff changeset
732 Next, log on in BatMUD and change following settings. <emphasis>It is
9d3182edd64d Add note about how BatMUD settings should be copypasted exactly as shown.
Matti Hamalainen <ccr@tnsp.org>
parents: 978
diff changeset
733 probably best, if you use direct copy &amp; paste to set these, as most of
9d3182edd64d Add note about how BatMUD settings should be copypasted exactly as shown.
Matti Hamalainen <ccr@tnsp.org>
parents: 978
diff changeset
734 them are required to be set exactly as shown here for GgrTF to work
9d3182edd64d Add note about how BatMUD settings should be copypasted exactly as shown.
Matti Hamalainen <ccr@tnsp.org>
parents: 978
diff changeset
735 correctly.</emphasis>
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
736 </para>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
737
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
738 <itemizedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
739 <listitem><para>Line 'cutter' setting:
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
740 <userinput>cutter 9999</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
741 Theoretically, '<emphasis>cutter off</emphasis>'
453
e7d262fb061c Note about 'cutter' setting was missing, added.
Matti Hamalainen <ccr@tnsp.org>
parents: 449
diff changeset
742 should be better, but in practice I have noticed that
e7d262fb061c Note about 'cutter' setting was missing, added.
Matti Hamalainen <ccr@tnsp.org>
parents: 449
diff changeset
743 in certain things it simply does not work as expected.</para>
e7d262fb061c Note about 'cutter' setting was missing, added.
Matti Hamalainen <ccr@tnsp.org>
parents: 449
diff changeset
744 </listitem>
e7d262fb061c Note about 'cutter' setting was missing, added.
Matti Hamalainen <ccr@tnsp.org>
parents: 449
diff changeset
745
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
746 <listitem><para>Short score format for regular BatMUD:
978
dc8ee5ec3c66 Add @@ to some command examples, because apparently SOME players have aliased these essential BatMUD commands to something else.
Matti Hamalainen <ccr@tnsp.org>
parents: 972
diff changeset
747 <userinput>@@sc set H:{colorhp}/&lt;maxhp&gt; [{diffhp}] S:{colorsp}/&lt;maxsp&gt; [{diffsp}] E:{colorep}/&lt;maxep&gt; [{diffep}] $:&lt;cash&gt; [{diffcash}] exp:&lt;exp&gt; [{diffexp}]</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
748 </para>
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
749 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
750
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
751 <listitem><para>Short score format for HardCore BatMUD (HCBat):
978
dc8ee5ec3c66 Add @@ to some command examples, because apparently SOME players have aliased these essential BatMUD commands to something else.
Matti Hamalainen <ccr@tnsp.org>
parents: 972
diff changeset
752 <userinput>@@sc set H:{colorhp}/&lt;maxhp&gt; S:{colorsp}/&lt;maxsp&gt; E:{colorep}/&lt;maxep&gt; $:&lt;cash&gt; exp:&lt;exp&gt;</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
753 </para>
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
754 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
755
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
756 <listitem><para>Enable automatic short score (required for automatic updating of HP/SP/EP values on statusline):
1448
8d07f07bd72b Clarify in the BatMUD configuration / setup section that "sc" should be turned on.
Matti Hamalainen <ccr@tnsp.org>
parents: 1443
diff changeset
757 <userinput>@@sc on</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
758 </para>
1449
1863c4f2c390 Add note about '/gagsc'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1448
diff changeset
759 <note><para>If you do not wish to not see the 'sc' lines, you can turn on '/gagsc' option.</para></note>
1448
8d07f07bd72b Clarify in the BatMUD configuration / setup section that "sc" should be turned on.
Matti Hamalainen <ccr@tnsp.org>
parents: 1443
diff changeset
760 </listitem>
8d07f07bd72b Clarify in the BatMUD configuration / setup section that "sc" should be turned on.
Matti Hamalainen <ccr@tnsp.org>
parents: 1443
diff changeset
761
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
762 <listitem><para>Prompt:
978
dc8ee5ec3c66 Add @@ to some command examples, because apparently SOME players have aliased these essential BatMUD commands to something else.
Matti Hamalainen <ccr@tnsp.org>
parents: 972
diff changeset
763 <userinput>@@prompt PROMPT:&gt;</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
764 If you wish, you can add any BatMUD specific data to the prompt
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
765 between ":" and "&gt;", this substring will be stored to "status_prompt" TF
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
766 variable, which can be used in /gprompt. Read more in <link
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
767 linkend="usage-general-prompt">prompt setup section</link>.</para>
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
768 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
769
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
770 <listitem><para>Listen to battle round flags:
978
dc8ee5ec3c66 Add @@ to some command examples, because apparently SOME players have aliased these essential BatMUD commands to something else.
Matti Hamalainen <ccr@tnsp.org>
parents: 972
diff changeset
771 <userinput>@@battle rounds</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
772 This setting is a toggle, make sure that you set it ON
345
a53267af3f06 Typofixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 344
diff changeset
773 ("Listening to round flags.") instead of off!
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
774 </para>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
775 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
776
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
777 <listitem><para>Battle listen-level:
978
dc8ee5ec3c66 Add @@ to some command examples, because apparently SOME players have aliased these essential BatMUD commands to something else.
Matti Hamalainen <ccr@tnsp.org>
parents: 972
diff changeset
778 <userinput>@@battle listen all 2</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
779 Listen level should be 2 or 3, if you are using hitstats.
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
780 Otherwise it can be 1 or 0, if you prefer silence.
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
781 </para>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
782 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
783 </itemizedlist>
327
521d0c3233bd v0.5.10.0: Major cleanup of namespace, many functions and variables renamed
Matti Hamalainen <ccr@tnsp.org>
parents: 323
diff changeset
784
521d0c3233bd v0.5.10.0: Major cleanup of namespace, many functions and variables renamed
Matti Hamalainen <ccr@tnsp.org>
parents: 323
diff changeset
785 <para>
521d0c3233bd v0.5.10.0: Major cleanup of namespace, many functions and variables renamed
Matti Hamalainen <ccr@tnsp.org>
parents: 323
diff changeset
786 In case you do NOT want to change your settings to the way GgrTF needs
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
787 them to be, your only option is to change the regex patterns in GgrTF's
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
788 code to match your preferences (and redo the changes each time you
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
789 upgrade GgrTF.)
327
521d0c3233bd v0.5.10.0: Major cleanup of namespace, many functions and variables renamed
Matti Hamalainen <ccr@tnsp.org>
parents: 323
diff changeset
790 </para>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
791 </section>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
792
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
793 <!--
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
794 <section id="inst-config-ggrtf"><title>GgrTF configuration</title>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
795 <para>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
796 </para>
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
797 </section>
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
798 -->
405
7bdc7ef54e6c Add blockdiagram files.
Matti Hamalainen <ccr@tnsp.org>
parents: 404
diff changeset
799
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
800 </chapter>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
801
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
802 <!-- *************************************************************** -->
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
803
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
804 <chapter id="usage-intro"><title>Usage</title>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
805 <para>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
806 This chapter describes the structure of GgrTF, what the
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
807 different modules included in GgrTF are and what functionality
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
808 they provide. There are basically three flavours of modules: generic
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
809 modules that are either required or optional and provide
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
810 functionality unrelated to specific guilds; then there are
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
811 guild-related modules, containing guild-specialties.
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
812 </para>
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
813
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
814 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
815 Each module section has short introduction about what is provided
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
816 and section with macro commands and variables available. Some modules
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
817 also have additional information about usage and configuration
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
818 with examples.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
819 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
820
1263
d56722e12ed8 Remove (comment out) block diagram from documentation, for now.
Matti Hamalainen <ccr@tnsp.org>
parents: 1255
diff changeset
821 <!--
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
822 <para>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
823 Following block-diagram represents the structure of GgrTF and
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
824 how different components approximately relate to each other:
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
825 </para>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
826
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
827 <screenshot>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
828 <mediaobject>
638
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
829 <imageobject><imagedata fileref="blockdiagram.png" format="PNG" /></imageobject>
624
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
830 <imageobject><imagedata fileref="blockdiagram.eps" format="EPS" /></imageobject>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
831 <textobject>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
832 <phrase>GgrTF's internal structure</phrase>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
833 </textobject>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
834 <caption>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
835 <para>Internal structure and relations of GgrTF components represented as
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
836 block-diagram.</para>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
837 </caption>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
838 </mediaobject>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
839 </screenshot>
1263
d56722e12ed8 Remove (comment out) block diagram from documentation, for now.
Matti Hamalainen <ccr@tnsp.org>
parents: 1255
diff changeset
840 -->
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
841
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
842 <!-- ================================================ -->
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
843
340
0bde8b59b02a Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 331
diff changeset
844 <section id="usage-general"><title>GgrTF core (ggrtf.tf)</title>
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
845 <para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
846 This is the main module and core of GgrTF. It contains helper
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
847 macro functions used by all the other modules and is thus
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
848 always required to be loaded.
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
849 It also provides much of the basic functionality, such as:
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
850 </para>
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
851
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
852 <itemizedlist>
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
853 <listitem><para>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
854 <link linkend="usage-general-statusline">Statusline</link>.
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
855 Provides nice, realtimeish view of your character's current
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
856 condition, applied prots and other such information.
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
857 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
858
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
859 <listitem><para>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
860 <link linkend="usage-general-prots">Prot management</link>.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
861 Keeps note of what prots have been cast at you, and provides this
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
862 information in various ways.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
863 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
864
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
865 <listitem><para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
866 <link linkend="usage-general-curses">Curse/degen/etc tracking</link>.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
867 Tracks what handicaps have been cast at enemies (non-partymembers).
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
868 This information is most useful in eq-parties.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
869 </para></listitem>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
870
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
871 <listitem><para>Battle round handling. Enables commands to be
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
872 executed each battle round and autopss functionality.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
873 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
874
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
875 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
876 <link linkend="usage-general-hbtick">Heartbeat and tick prediction</link>.
1443
dc60423b8d4b Change documentation to match the removal of average heartbeat duration field from statusline.
Matti Hamalainen <ccr@tnsp.org>
parents: 1426
diff changeset
877 Display prediction of next "tick" via a heartbeat counter.
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
878 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
879
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
880 <listitem><para>Functions for binding command strings to macros,
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
881 or to cast spells and use skills, with or without reporting to
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
882 party channel. See <link linkend="usage-general-binds">bindings</link>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
883 section for more information.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
884 </para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
885
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
886 <listitem><para>Support for <link linkend="usage-general-saves">
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
887 state-saving</link>. Most GgrTF settings can be saved to files
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
888 and reloaded later (for example at startup) with /gsave and /gload
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
889 commands.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
890 </para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
891
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
892 <listitem><para><link linkend="usage-general-prompt">Prompt
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
893 handling and mangling.</link>
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
894 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
895
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
896 <listitem><para>Automatic "ripaction", which is performed when
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
897 your opponent (monster) dies. This way you can automate small
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
898 inconveniencies like looting and digging of graves.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
899 </para></listitem>
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
900
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
901 <listitem><para>Keyboard movement handling and mapping. Bind your
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
902 numpad keys to move around, either by walking, walking with peering
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
903 in adjacent rooms (useful for merchants) or guiding your ship.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
904 Additional modes may be provided by other optional modules.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
905 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
906
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
907 <listitem><para>Enemy shape string highlighting and reformatting.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
908 You can make GgrTF mangle 'scan' command's output into
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
909 more readable and convenient form.
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
910 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
911
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
912 <listitem><para>Keep and display statistics about skills, spells
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
913 and whatnots. ("/stats" command)
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
914 </para></listitem>
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
915
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
916 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
917 <emphasis>Consider-skill reporting</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
918 Takes output of 'consider' skill and compresses the information
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
919 into one prettyprinted line, which is reported. Output is
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
920 name of the target, estimated experience worth and final
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
921 estimation of target's toughness.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
922 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
923
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
924 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
925 <emphasis>Combat Damage Analysis reporting</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
926 Triggers for reporting results of CDA-skill to party report-channel.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
927 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
928
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
929 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
930 <emphasis>Purse contents prettyprinting</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
931 Highlites and colorizes the output of 'look at purse', and
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
932 calculates total sum of money (in gold) contained in the purse.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
933 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
934
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
935 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
936 <emphasis>Camping status handling and reporting</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
937 Keeps note of whether you can use 'camping' skill. Reports
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
938 the hp/sp/ep gained from resting.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
939 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
940
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
941 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
942 <emphasis>Ceremony status</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
943 Tracks status of ceremony, and provides macro "/ceremony",
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
944 which executes ceremony skill only if ceremony is not active currently.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
945 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
946
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
947 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
948 <emphasis>Path compression for map.tf</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
949 TinyFugue distribution comes with map.tf, which
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
950 enables easy creation of walkpaths (See "/help map" in TF).
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
951 GgrTF adds an special purpose RLE compressor function, which
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
952 reduces the length of the paths. Additional command to output
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
953 the paths in format that is compatible with BatMUD's
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
954 "command"-aliases is also provided.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
955 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
956
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
957 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
958 Plus numerous miscellaneous reporting- and helper-triggers.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
959 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
960
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
961 </itemizedlist>
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
962
278
a06334daf5b0 More updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 277
diff changeset
963
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
964 <section id="usage-general-commands">
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
965 &sectmacros_1;
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
966 </para>
1425
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
967
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
968 <!-- @commands -->
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
969 <!-- @binds -->
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
970
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
971 </section>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
972
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
973 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
974
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
975 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
976
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
977 <section id="usage-general-statusline"><title>Statusline</title>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
978 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
979 Probably one of the first things that you notice in GgrTF
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
980 is the statusline (or "statusbar" as some prefer). In GgrTF the
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
981 &tfurl; statusline is used to display information that we've
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
982 considered to be important enough for nearly real-time view.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
983 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
984
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
985 <para>
862
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
986 The basic one-row statusline of GgrTF is meant for compatibility,
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
987 <link linkend="usage-tf5">TF5 support module</link> provides another
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
988 version, enhanced to take advantage of newer TF5 beta features
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
989 (TF 5.0 beta 7 or later required).
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
990 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
991
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
992 <para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
993 Statusline is updated synchronously at ticks, skill- and spell
1598
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
994 castings and certain other events. <emphasis>This depends on
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
995 your <link linkend="inst-config-batmud">BatMUD settings</link>
1601
fcb56c908184 Oops, 100L.
Matti Hamalainen <ccr@tnsp.org>
parents: 1598
diff changeset
996 being correctly set up.</emphasis> If HP/SP/EP etc. information does
1598
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
997 not appear, most likely your 'sc' setting is "wrong",
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
998 and thus does not get parsed by GgrTF.
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
999 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1000
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1001 <screenshot>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1002 <mediaobject>
624
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
1003 <imageobject><imagedata fileref="statusbar.gif" format="GIF" /></imageobject>
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
1004 <imageobject><imagedata fileref="statusbar.eps" format="EPS" /></imageobject>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1005 <textobject>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1006 <phrase>GgrTF statusline</phrase>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1007 </textobject>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1008 <caption>
862
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
1009 <para>Example of typical basic GgrTF statusline.</para>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1010 </caption>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1011 </mediaobject>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1012 </screenshot>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1013
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1014 <orderedlist>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1015 <listitem><para>Current hit points / hit points maximum.</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1016 <listitem><para>Current spell points / spell points maximum.</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1017 <listitem><para>Current endurance points / endurance points maximum.</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1018 <listitem><para>[2 light green characters] Last moved direction.</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1019 <listitem><para>["C"] Ceremony status. (Dark blue = inactive/no ceremony; White = ceremony active)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1020 <listitem><para>["S"] Spell status. (Dark blue = no spell going; White = spellcasting)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1021 <listitem><para>["K"] Skill status. (Dark blue = no skill going; White = using a skill)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1022 <listitem><para>["c"] Camping status. (Light green = ready to camp; Red = camping active/skill ongoing; Yellow = camping not available, or recovering from previous camping.)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1023 <listitem><para><link linkend="usage-general-prots">Currently active prots</link> in short format.</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1024 </orderedlist>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1025
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1026 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1027 First three elements of the statusbar describe your character's
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1028 current hit-, spell- and endurance-points. These values are
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1029 color-coded for better visual clarity. One element shows
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1030 current value and maximum value, as shown in screenshot below:
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1031 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1032
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1033 <screenshot>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1034 <mediaobject>
624
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
1035 <imageobject><imagedata fileref="statusbar_ep.gif" format="GIF" /></imageobject>
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
1036 <imageobject><imagedata fileref="statusbar_ep.eps" format="EPS" /></imageobject>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1037 <textobject>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1038 <phrase>Endurance Points-part of statusline</phrase>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1039 </textobject>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1040 <caption>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1041 <para>Example of how endurance points are shown. "E:" denotes Endurance,
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1042 "134" is the current value (colorcoded) and "246" is the maximum
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1043 endurance your character has.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1044 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1045 </caption>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1046 </mediaobject>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1047 </screenshot>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1048
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1049 </section>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1050
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1051 <!-- ================================================ -->
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1052
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1053 <section id="usage-general-prompt"><title>Prompt configuration</title>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1054 <para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1055 In addition to basic prompt handling, GgrTF offers very flexible and
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1056 extensible way of presenting the game prompt. Internal TF variables
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1057 can be shown, even simple TF macro snippets executed to show the prompt
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1058 as the user wishes. Also, in GgrTF v0.6.11.3 and later, it is possible to
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1059 have custom BatMUD data in the prompt (see 'help prompt' in BatMUD).
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1060 </para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1061 <para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1062 To get started, you need to have a basic prompt setting in BatMUD,
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1063 as it is required to have GgrTF handle it properly. The basic setting is
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1064 presented below, and we'll get to the more complex ones later.
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1065
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1066 <userinput>prompt PROMPT:&gt;</userinput>
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1067
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1068 After setting the BatMUD prompt, you can start configuring how GgrTF
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1069 "mangles" your prompt. This is done by using "/gprompt" command macro
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1070 (or alternatively editing the saved configuration files and "set_gprompt"
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1071 setting.) There are myriad of ways of how and what things can be done,
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1072 mostly limited by your imagination. Some examples are presented below:
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1073 </para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1074
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1075 <orderedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1076 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1077 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1078 <userinput>/gprompt &gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1079 Set prompt to show only "&gt;" and nothing more.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1080 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1081 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1082 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1083 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1084 <userinput>/gprompt %{status_cast}&gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1085 Show currently in-progress skill or spell in prompt.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1086 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1087 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1088 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1089 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1090 <userinput>/gprompt @{BCred}%{status_cast}@{n}@{BCwhite}&gt;@{n}</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1091 TinyFugue color attributes can be used also.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1092 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1093 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1094 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1095 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1096 <userinput>/gprompt @{$[prgetnlite(status_hp,status_hpm)]}%{status_hp}@{n}@{BCwhite}&gt;@{n}</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1097 Above would print your hp, lited similarly to the statusbar HP/SP/EP display.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1098 It is possible to use almost any kind of substitutions and call TF functions.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1099 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1100 </listitem>
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1101 </orderedlist>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1102
1075
122c463704e1 Add note about /gprompt attribute formatting not working with earlier betas of TF5.
Matti Hamalainen <ccr@tnsp.org>
parents: 1074
diff changeset
1103 <note><para>
122c463704e1 Add note about /gprompt attribute formatting not working with earlier betas of TF5.
Matti Hamalainen <ccr@tnsp.org>
parents: 1074
diff changeset
1104 Using TF attribute formatting (e.g. colours) in prompt only works
122c463704e1 Add note about /gprompt attribute formatting not working with earlier betas of TF5.
Matti Hamalainen <ccr@tnsp.org>
parents: 1074
diff changeset
1105 with TF 5.0 beta 8 and later. If running under earlier version, GgrTF
122c463704e1 Add note about /gprompt attribute formatting not working with earlier betas of TF5.
Matti Hamalainen <ccr@tnsp.org>
parents: 1074
diff changeset
1106 disables this feature.
122c463704e1 Add note about /gprompt attribute formatting not working with earlier betas of TF5.
Matti Hamalainen <ccr@tnsp.org>
parents: 1074
diff changeset
1107 </para></note>
122c463704e1 Add note about /gprompt attribute formatting not working with earlier betas of TF5.
Matti Hamalainen <ccr@tnsp.org>
parents: 1074
diff changeset
1108
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1109 <para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1110 As you can see, lots of things can be done, and only fraction of ideas
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1111 are represented here. However, in addition to what GgrTF and TF offer,
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1112 it is also possible to add BatMUD specific information into the prompt.
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1113 As you remember, we set up the basic prompt above to "PROMPT:&gt;".
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1114 The user definable data can be put between the colon (":") and greater than
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1115 ("&gt;") sign, and it gets parsed by GgrTF. Observe following example:
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1116
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1117 <userinput>prompt PROMPT:&lt;hp&gt;/&lt;sp&gt;/&lt;ep&gt;|&lt;eqset&gt;&gt;</userinput>
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1118
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1119 Above prompt setting would make the BatMUD prompt show something like:
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1120
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1121 <userinput>PROMPT:663/636/333|spr&gt;</userinput>
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1122
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1123 Where the numbers represent your hp, sp and ep, and 'spr' is the work
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1124 eqset, as described by 'help prompt'. This string gets parsed into a TF variable
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1125 called "status_prompt", which can be then used in GgrTF's prompt. Examples
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1126 follow:
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1127 </para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1128
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1129 <orderedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1130 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1131 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1132 <userinput>/gprompt %{status_prompt}&gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1133 This simple example would just prompt the grabbed BatMUD data with
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1134 greater than sign in the end.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1135 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1136 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1137 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1138 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1139 <userinput>/gprompt @{BCgreen}%{status_prompt}@{n}&gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1140 Same as above, but coloured bright green.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1141 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1142 </listitem>
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1143 </orderedlist>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1144
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1145 <para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1146 The prompt can contain any BatMUD data, as long as it is formatted as
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1147 "PROMPT:your data here&gt;".
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1148 </para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1149
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1150 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1151
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1152
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1153 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1154
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1155 <section id="usage-general-saves"><title>State-saving</title>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1156 <para>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1157 State-saving is an awfully awkward name for GgrTF's functionality for
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1158 saving your settings and other interesting data for later
978
dc8ee5ec3c66 Add @@ to some command examples, because apparently SOME players have aliased these essential BatMUD commands to something else.
Matti Hamalainen <ccr@tnsp.org>
parents: 972
diff changeset
1159 retrieval. Settings get saved and thus restored later,
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1160 but this functionality is not automatic by default, you have to set it
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1161 up so if you wish - GgrTF only provides you the functions for loading
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1162 and saving, making it to happen automagically is up to you.
978
dc8ee5ec3c66 Add @@ to some command examples, because apparently SOME players have aliased these essential BatMUD commands to something else.
Matti Hamalainen <ccr@tnsp.org>
parents: 972
diff changeset
1163 How to do this is discussed further below.
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1164 </para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1165
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1166 <section id="usage-general-saves-whatis"><title>What is saved?</title>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1167 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1168 <emphasis>Almost</emphasis> all settings (hidden or visible)
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1169 get saved, but there are certain global settings that you
391
Matti Hamalainen <ccr@tnsp.org>
parents: 390
diff changeset
1170 have to set yourself in your TF configuration. These
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1171 settings are discussed in sub-section below.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1172 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1173
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1174 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1175 It should also be noted, that there are actually <emphasis>two
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1176 different types of data (or variables) that is saved into two
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1177 different files</emphasis>. In GgrTF, these two types of data
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1178 are called <emphasis>pre- and post-init settings</emphasis>, and the
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1179 two savefiles are named accordingly. Pre-init settings are
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1180 variables that need to be defined before the main modules
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1181 of GgrTF are loaded in TF's startup configuration (certain
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1182 functionality depends on this). Post-init variables can
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1183 (and sometimes <emphasis>must</emphasis>) be set after loading
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1184 of all modules.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1185 </para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1186 </section>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1187
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1188 <section id="usage-general-saves-special"><title>Special, non-saved variables</title>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1189 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1190 There are currently three special GgrTF variables, which you have to
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
1191 set yourself in your TF's startup configuration (.tfrc).
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1192 These variables <emphasis>MUST</emphasis> be set before loading
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1193 of ANY GgrTF modules, otherwise things start breaking and the
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1194 state-saving system does not work correctly.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1195 </para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1196
1052
3f0fec339dcb Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1049
diff changeset
1197 <table><title>Special, non-saved variables</title>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1198 <tgroup cols="3" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1199 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1200 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1201 <entry>Variable</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1202 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1203 <entry>Example</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1204 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1205 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1206 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1207 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1208 <entry>set_plrname</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1209 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1210 Your character's name, written in correct case.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1211 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1212 <entry>/set set_plrname=Ggr</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1213 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1214
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1215 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1216 <entry>set_datapath</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1217 <entry>Path to the directory where you want your savefiles to reside. If
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1218 left empty, current working directory is used (the directory you started TF
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1219 from.)</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1220 <entry>/set set_datapath=</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1221 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1222
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1223 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1224 <entry>set_saveprefix</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1225 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1226 This string is used as prefix of the two savefiles, so the actual
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1227 savefiles are "<emphasis>&lt;prefix&gt;pre.tf</emphasis>" and
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1228 "<emphasis>&lt;prefix&gt;post.tf</emphasis>". This is useful,
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1229 if you play regular BatMUD and HCBat, so you can use different values
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1230 for either.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1231 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1232 <entry>/set set_saveprefix=bat-</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1233 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1234
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1235 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1236 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1237 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1238
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1239 </section>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1240
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1241
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1242 <section id="usage-general-saves-setup"><title>How to setup TF for state-saving</title>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1243 <para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1244 Getting GgrTF's state-saving to work requires some changes to your
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1245 TF configuration, and possibly setting up a savefile directory
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1246 </para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1247
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1248 <para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1249 A simplified example configuration layout is presented below with only
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1250 the state-saving related parts, please refer to
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
1251 <link linkend="inst-config-tf">setup</link>-section of this
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1252 manual for a more detailed example. Pay close attention to the order
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1253 how things are done, it is very important!
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1254 </para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1255
950
a6e6295d3557 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 944
diff changeset
1256 <screen>;; Set directory path where savefiles will be stored
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1257 /eval /set set_datapath=%{HOME}/.ggrtf/
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1258
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1259 ;; Set prefix string for savefile names
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1260 /eval /set set_saveprefix=bat-
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1261
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1262 ;; Load the special pre-init module which loads pre-init
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1263 ;; settings from the savefiles. This needs to be done
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1264 ;; before loading any other GgrTF modules.
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1265 /gloadmod ggrtf-pre.tf
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1266
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1267 ;; Load GgrTF core module
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1268 /gloadmod ggrtf.tf
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1269
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1270 ;; Load other additional modules
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
1271 /gloadmod gm-magical.tf
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1272 ; etc etc.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1273
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1274 ;; Load and restore other previously saved settings.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1275 ;; This should be done after loading any GgrTF modules.
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1276 /gload
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1277 </screen>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1278
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1279 <para>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1280 When you have edited your TF configuration, you need to (re-)start
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1281 it, change settings the way you want them to be and finally issue
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1282 "/gsave" command to get settings saved. <emphasis>After saving,
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1283 you may also want to examine the pre-init -savefile, because it
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1284 contains certain settings that cannot be changed run-time
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1285 </emphasis>. So, here are the steps in short again:
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1286 </para>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1287
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1288 <orderedlist>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1289 <listitem><para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1290 <emphasis>Edit TF configuration (see example above)</emphasis>:
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1291 Add <emphasis>set_datapath</emphasis>, <emphasis>set_saveprefix</emphasis>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1292 settings and add commands to load <emphasis>ggrtf-pre.tf</emphasis> module
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1293 and <emphasis>/gload</emphasis> command.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1294 </para></listitem>
1534
ad7cfb90c328 Oops, the manual SGML has been broken for a while due to accidentally
Matti Hamalainen <ccr@tnsp.org>
parents: 1533
diff changeset
1295 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1296 <emphasis>Re-start TF</emphasis>:
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1297 In order to create the initial savefiles with default settings,
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1298 you need to (re-)start TF, so that the save-state system is enabled.
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1299 </para></listitem>
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1300 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1301 <emphasis>Change settings</emphasis>:
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1302 Change GgrTF settings (listed via /opts etc.) to accommodate
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1303 your desires.
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1304 </para></listitem>
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1305 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1306 <emphasis>Save initial settings</emphasis>:
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1307 Issue "/gsave" to get settings saved.
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1308 </para></listitem>
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1309 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1310 <emphasis>Optionally edit pre-init settings</emphasis>:
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1311 Certain settings are saved into the pre-init savefile (actual
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1312 filename is dependant on what you set "set_saveprefix" to).
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1313 GgrTF does not offer any special interface to change these settings,
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1314 you have to edit this file by hand, if you wish to change the defaults.
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1315 </para></listitem>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1316 </orderedlist>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1317
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1318 </section>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1319
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1320 <section><title>How to make state-saving automatic</title>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1321 <para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1322 In previous example, I only described how settings get restored
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1323 (as TF loads and initializes GgrTF), but how to get settings
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1324 saved automatically too?
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1325 </para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1326
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1327 <para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1328 The answer lies in &tfurl;'s event hooks. It is possible to
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1329 define a hook, which is executed when TF disconnects from a world.
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1330 By setting this hook to perform "/gsave", we can automatize the
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1331 process of saving settings. Add following line to your TF configuration:
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1332
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1333 <userinput>/def -hDISCONNECT mydisconnect = /gsave</userinput>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1334
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1335 There is one gotcha: if you don't want to keep saving the statistical
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1336 values, but only the settings, you may want to add a "/greset" in the soup:
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1337
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1338 <userinput>/def -hDISCONNECT mydisconnect = /greset%;/gsave</userinput>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1339
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1340 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1341
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1342 </section>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1343
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1344
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1345 &sectmacros_2;
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1346 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1347 <entry>/gsave</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1348 <entry>
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
1349 Save all GgrTF settings and certain other TF variables.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1350 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1351 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1352 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1353 <entry>/gload</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1354 <entry>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1355 Load GgrTF settings. Only post-init settings get loaded by this command,
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1356 to get pre-init settings in effect, you will have to restart TF.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1357 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1358 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1359 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1360 <entry>/greset</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1361 <entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1362 Reset all skill/spell counters and statistics. Notice that issuing
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1363 this command also requires executing of "/gsave" if you want to save
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1364 the zeroed statistics, otherwise the currently saved statistics will be
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
1365 restored on next /gload.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1366 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1367 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1368 &sectmacros_end;
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
1369
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1370 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1371
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1372 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1373
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1374 <section id="usage-general-binds"><title>Command bindings</title>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1375 <para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1376 GgrTF's core provides few macros for defining "bindings", which
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1377 are a way to create commands that look like normal MUD commands
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1378 but are actually intercepted by &tfurl; and executed appropriately.
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1379 These bindings can be used to easily define shorthands for casting
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1380 spells, using skills, executing macros, etc. GgrTF bindings offer
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1381 an easy way to define skill/spell commands with automatic party
994
c40eabb80393 Add few lines of explanation about bindings.
Matti Hamalainen <ccr@tnsp.org>
parents: 988
diff changeset
1382 reporting (or without it). <emphasis>Simply put, bindings are
c40eabb80393 Add few lines of explanation about bindings.
Matti Hamalainen <ccr@tnsp.org>
parents: 988
diff changeset
1383 similar to BatMUD "command" aliases, but client-side and with
c40eabb80393 Add few lines of explanation about bindings.
Matti Hamalainen <ccr@tnsp.org>
parents: 988
diff changeset
1384 extra abilities (but also with some limitations.)</emphasis>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1385 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1386
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1387 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1388 In GgrTF, there are <emphasis>optional pre-defined bindings</emphasis>,
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1389 which can be enabled at your consideration. These pre-defined bindings
806
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1390 are defined in the relevant modules, and can be enabled at load-time
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1391 with a setting ("opt_bindings"). See below section <link
807
043927590bef Change headlines.
Matti Hamalainen <ccr@tnsp.org>
parents: 806
diff changeset
1392 linkend="usage-general-binds-setup">for enabling bindings</link>.
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1393 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1394
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1395 <para>
994
c40eabb80393 Add few lines of explanation about bindings.
Matti Hamalainen <ccr@tnsp.org>
parents: 988
diff changeset
1396 Now, you might be asking why would anyone need bindings?
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1397 Indeed, you can already use BatMUD's command aliases for such things, but
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1398 the number of command aliases in BatMUD is limited and if you run out of
584
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1399 space, you have to remove some less used ones. Sometimes you have to
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1400 redefine lots just because you are reincarnating... and you can not execute
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1401 macros with command aliases.
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1402 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1403
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1404 <para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1405 There are many benefits to using bindings, but they do have some
584
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1406 drawbacks:
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1407 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1408
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1409 <itemizedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1410 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1411 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1412 <emphasis>Limitations of TF's parsing</emphasis>:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1413 Because of the nature how bindings are defined and parsed,
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1414 you can only use one binded command per line.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1415 For example, let's assume "aoa" is binding to cast Armour of Aether
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1416 and "clair" is a binding to use clairvoyance. Thus, someone
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1417 might want to command:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1418
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1419 <userinput>aoa ggr%;clair</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1420
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1421 Unfortunately, this does not work as might be expected. Because TF does
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1422 not evaluate binding as an expression, the "ggr%;clair"-part
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1423 is used as a literal argument to "aoa" binding. In effect the
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1424 command would try to cast Armour of Aether at player "ggr%;clair".
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1425 </para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1426 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1427
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1428 <listitem>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1429 <para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1430 <emphasis>BatMUD commands and GgrTF bindings cannot be mixed</emphasis>:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1431 Because the bindings are actually intercepted by TF before the line gets
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1432 passed to BatMUD's parser, you can't combine multiple bindings or BatMUD
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1433 commands on the line. For example, assuming "aoa" is again a binding
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1434 and "hop" is an emote:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1435
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1436 <userinput>hop jeskko;aoa ggr</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1437
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1438 One might easily assume, that the result would be to first hop
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1439 around player or thing named Jeskko, and then cast Armour of Aether
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1440 at Ggr. Unfortunately the latter would just produce an error, as
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1441 it would be instead passed to BatMUD's interpreter and not handled
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1442 as a binding by TF!
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1443 </para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1444 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1445
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1446 <listitem>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1447 <para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1448 <emphasis>Limitations of GgrTF's binding system</emphasis>:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1449 There are certain limitations what kind of bindings you can define
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1450 with the current functionality provided by GgrTF. Bindings that
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1451 require complex parameters (more than one optional argument),
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1452 are not possible - you are better off using BatMUD's command
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1453 aliases for those.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1454 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1455 </listitem>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1456 </itemizedlist>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1457
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1458
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1459 <section><title>Defining bindings</title>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1460 <para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1461 Now we know the limitations of this system - let's see how to define some basic
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1462 command bindings!
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1463 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1464
950
a6e6295d3557 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 944
diff changeset
1465 <screen>/prdefgbind -s"cere" -c"/ceremony" -n
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1466 /prdefcbind -s"nf" -c"Neutralize Field" -n
950
a6e6295d3557 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 944
diff changeset
1467 /prdefsbind -s"fire" -c"Fire Building" -n</screen>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1468
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1469 <para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1470 Above we have have listed all three (3) classes of binding defination
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1471 macros supported by GgrTF. First defines a generic command binding
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1472 to execute "/ceremony" macro when user commands "cere".
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1473 Second binding defines a spell casting command to cast "Neutralize Field"
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1474 when user commands "nf". And the third binding defines a skill
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1475 usage command to use "Fire Building". So basically we have
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1476 three types of bindings:
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1477 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1478
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1479 <itemizedlist>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1480 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1481 <emphasis>/prdefgbind</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1482 Defines a generic binding, in which the action ("-c" parameter)
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1483 can be almost anything, like a TF macro, or BatMUD command.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1484 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1485
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1486 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1487 <emphasis>/prdefcbind</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1488 Defines a casting binding, the action is the name of the spell
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1489 to be casted.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1490 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1491
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1492 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1493 <emphasis>/prdefsbind</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1494 Defines a skill usage binding, action argument being name of the
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1495 skill to be executed.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1496 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1497 </itemizedlist>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1498
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1499 <para>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1500 Each of these defination macros require at least two arguments:
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1501 the name for the binding command ("-s" option) and the action ("-c" option).
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1502 There are other optional arguments, which affect aspects of the
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1503 command binding to be defined. The argument options and their
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1504 meanings are listed below:
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1505 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1506
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1507 <table><title>Arguments common to all binding defination macros</title>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1508 <tgroup cols="2" align="left">
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1509 <thead>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1510 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1511 <entry>Option</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1512 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1513 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1514 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1515 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1516 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1517 <entry>-s"name"</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1518 <entry>Specifies the name of the command binding.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1519 This is basically the string you type to use the command,
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1520 after which come the optional arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1521 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1522 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1523 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1524 <entry>-n</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1525 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1526 Tells GgrTF that the binding does NOT accept arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1527 Anything following the command binding invocation is ignored.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1528 This also affects the possible reporting output of the binding.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1529 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1530 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1531 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1532 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1533 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1534
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1535 <table><title>Arguments specific to generic bindings (/prdefgbind)</title>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1536 <tgroup cols="2" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1537 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1538 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1539 <entry>Option</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1540 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1541 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1542 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1543 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1544 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1545 <entry>-c"action"</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1546 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1547 Specifies the action, aka what the binding <emphasis>does</emphasis>.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1548 For generic bindings, the action is a literal, so it can be a
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1549 TF macro or BatMUD command.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1550 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1551 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1552 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1553 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1554 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1555
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1556 <table><title>Arguments specific to spell casting and skill usage bindings (/prdefcbind and /prdefsbind)</title>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1557 <tgroup cols="2" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1558 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1559 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1560 <entry>Option</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1561 <entry>Description</entry>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1562 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1563 </thead>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1564 <tbody>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1565 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1566 <entry>-c"action"</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1567 <entry>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1568 Specifies name of the spell to be cast or skill to be used.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1569 </entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1570 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1571 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1572 <entry>-d"message"</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1573 <entry>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1574 This option overrides the default message string used for reporting
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1575 (see also option "-q" below).
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1576 </entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1577 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1578 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1579 <entry>-q</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1580 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1581 Makes the binding "quiet", suppresses any reporting. By default,
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1582 spell casting binding reports the action on party report-channel,
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1583 but specifying this option disables it.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1584 </entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1585 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1586 </tbody>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1587 </tgroup>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1588 </table>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1589
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1590 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1591 More examples, now with short explanations:
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1592 </para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1593
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1594 <table><title>Binding defination examples</title>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1595 <tgroup cols="2" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1596 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1597 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1598 <entry>Definition</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1599 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1600 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1601 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1602 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1603 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1604 <entry>/prdefgbind -s"repu" -c"/showrep" -n</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1605 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1606 Generic binding, which executes /showrep macro and takes no arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1607 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1608 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1609 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1610 <entry>/prdefsbind -s"er" -c"Enrage" -n</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1611 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1612 Skill binding for barbarian "Enrage" skill. Also takes no
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1613 arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1614 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1615 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1616 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1617 <entry>/prdefcbind -s"shelter" -c"Shelter" -n -d"Sheltering ..."</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1618 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1619 Spell casting binding, for casting conjurer spell "Shelter".
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1620 Takes no arguments and uses specific reporting string (default
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1621 would be "Shelter ...", but since it sounds bit stupid we want to
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1622 use "Sheltering ..." instead.)
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1623 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1624 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1625 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1626 <entry>/prdefcbind -s"dmp" -c"Dispel Magical Protection"</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1627 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1628 Another spell casting binding for a conjurer spell, which takes
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1629 (and requires) a player's name as argument.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1630 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1631 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1632 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1633 <entry>/prdefcbind -s"sl" -c"Star Light" -q</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1634 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1635 Yet another spell casting bind, this time for druid spell "Star Light".
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1636 Since this is a blasting spell, it is not really useful to report
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1637 that we are casting it, so we suppress any reporting. Argument is
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1638 accepted.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1639 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1640 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1641 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1642 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1643 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1644
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1645 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1646 As of now, you should be able to define bindings of your own. You can define
806
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1647 them in your .tfrc or make another file for them.
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1648 </para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1649
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1650 </section>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1651
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1652
807
043927590bef Change headlines.
Matti Hamalainen <ccr@tnsp.org>
parents: 806
diff changeset
1653 <section id="usage-general-binds-setup"><title>Enabling bindings</title>
806
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1654 <para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1655 A special variable called "opt_bindings" controls whether the various
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1656 /prdef*bind macros will actually define any binding at all. If this
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1657 variable is set to value "on", bindings will be defined, otherwise not.
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1658 </para>
806
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1659 <para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1660 This is also the way how pre-defined GgrTF bindings are made optional.
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1661 By defining "opt_bindings" before loading GgrTF modules, user
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1662 can choose to enable or disable the default bindings, even "per-module"
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1663 by changing the value of opt_bindings before each module loading in
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
1664 .tfrc.
806
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1665 </para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1666 <para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1667 It should be noted, that "opt_bindings" is a saveable setting, that gets
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1668 stored by /gsave and restored by ggrtf-pre.tf Please refer to
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1669 <link linkend="inst-config">setup</link>- and <link
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1670 linkend="usage-general-saves">state saving</link>- sections
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1671 for more information.
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1672 </para>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1673 </section>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1674
995
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1675 <section id="usage-general-binds-list"><title>Bindings listing</title>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1676 <para>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1677 All defined GgrTF bindings can be listed via the <emphasis>/binds</emphasis>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1678 command. Below is represented an commented example of such output.
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1679 </para>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1680 <screen>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1681 ,----------------.
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1682 | GgrTF Bindings |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1683 +----------------+----------------------------------------------------.
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1684 | pprots | G | /pprots | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1685 | rpouch | G | /rpouch | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1686 | ad | C | Aura Detection | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1687 | invis | C | Invisibility | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1688 | float | C | Floating | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1689 | ww | C | Water Walking | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1690 | seeinvis | C | See Invisible | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1691 | seemagic | C | See Magic | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1692 | cere | G | /ceremony | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1693 | curses | G | /curses | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1694 | prots | G | /prots | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1695 `---------------------------------------------------------------------'
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1696 </screen>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1697 <itemizedlist>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1698 <listitem><para>1st column lists the binded command name</para></listitem>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1699 <listitem><para>2nd column shows the type of the binding: "G" =
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1700 general (for example a macro invocation); "C" = cast/spell; "K" = skill.</para></listitem>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1701 <listitem><para>3rd column is the performed action, which has varying
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1702 meaning depending on the binding type. For skill and spell bindings,
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1703 corresponding skill/spell name is shown. Generic bindings show the actual
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1704 command executed.</para></listitem>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1705 <listitem><para>4th and last column shows whether the binding produces
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1706 any report output; for generic bindings this is not applicable and shows
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1707 question mark ("?") instead.</para></listitem>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1708 </itemizedlist>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1709
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1710 </section>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1711
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1712 </section>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1713
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1714 <!-- ================================================ -->
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1715
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
1716 <section id="usage-general-prmove"><title>Keyboard numpad hooks</title>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1717 <para>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1718 GgrTF provides a mechanism for routing keyboard numpad bindings so that
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1719 different functionality can be swapped in as needed. Core module offers
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1720 three modes: walk (normal walking around); peer (walking around with
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1721 automatic peering to adjacent directions, useful for <link
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1722 linkend="usage-merchant">merchants</link>; ship (control ship movement).
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1723
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1724 Certain other modules provide additional modes (see <link
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1725 linkend="usage-tgtcast">targetted cast module</link>, utilized by
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1726 <link linkend="usage-tarma">tarmalen</link> and <link linkend="usage-mage">mage</link>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1727 modules, for example.)
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1728 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1729
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1730 <note>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1731 <para>Keyboard hooks require working numpad, etc. key bindings. Modules
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1732 are provided for two most common cases in <emphasis>kbd-*.tf</emphasis>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1733 files. Some terminals may require several kbd-* modules to be loaded,
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1734 you may have to experiment. It is also possible that your terminal
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1735 is not supported by those modules and you have to write your own,
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1736 in such case you may try contacting &ggr; for assistance. However,
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1737 it is also entirely possible that your terminal does not provide
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1738 the required 'application mode' at all, which will make things difficult.
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1739 </para>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1740 </note>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1741
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1742 &sectmacros_2;
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1743 <row>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1744 <entry>/move [setting]</entry>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1745 <entry>Set the mode used for numpad bindings. Valid values are
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1746 shown if command is given without arguments. Core GgrTF module
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1747 provides following three modes: <emphasis>move</emphasis>,
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1748 <emphasis>peer</emphasis> and <emphasis>ship</emphasis>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1749 </entry>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1750 </row>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1751
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1752 <row>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1753 <entry>/peer [regexp]</entry>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1754 <entry>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1755 Set the regular expression used for grepping the output of 'peer'
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1756 command used in "/move peer" mode.
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1757 </entry>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1758 </row>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1759
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1760 <row>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1761 <entry>/cruise</entry>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1762 <entry>Toggle ship cruising speed on/off (off = sail)</entry>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1763 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1764 &sectmacros_end;
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1765
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1766 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1767
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1768 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1769
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1770 <section id="usage-general-prots"><title>Prot management</title>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1771 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1772 One very important aspect of any script is the prot management.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1773 GgrTF contains a flexible and easy to extend prot management system,
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1774 which supports basic, stacking and renewable prots. Special cases
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1775 are also supported, like unstun and conjurer typeprots.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1776 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1777
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1778 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1779 For actually displaying the active prots information, GgrTF offers
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1780 various methods. The <link linkend="usage-general-statusline">
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1781 statusline</link> shows the currently active prots in short form
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1782 (without duration times). Macro command "/prots" can be invoked to
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1783 locally echo the active prots in long form.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1784 Finally, a special BatMUD emote, 'tweak', can be used to trigger
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1785 reporting of active prots to party report-channel (the 'tweak' emote
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1786 was chosen for this purpose due to it being the de-facto standard
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1787 for prot reporting triggers.)
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1788 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1789
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1790 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1791 Classes of prots supported by GgrTF are roughly the following:
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1792 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1793
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1794 <itemizedlist>
584
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1795 <listitem><para>Harmful effects/curses/handicaps</para></listitem>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1796 <listitem><para>Basic utility prots (infravision, water walking, floating, invisibility, etc.)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1797 <listitem><para>Conjurer prots (minor- and major typeprots, stickyness)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1798 <listitem><para>Evil priest (protection from good, paranoia)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1799 <listitem><para>Tarmalen (unpain, blessing of tarmalen, lifelink, enhanced vitality)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1800 <listitem><para>Nun (protection from evil, soul shield, heavenly protection, mana shield)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1801 <listitem><para>Templar (shield of faith, blessing of faerwon)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1802 <listitem><para>Psionicist (levitation, force shield)</para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1803 <listitem><para>Druid (flex shield, earth power, earth skin, earth blood, vine mantle, regeneration)</para></listitem>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1804 <listitem><para>etc...</para></listitem>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1805 </itemizedlist>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1806
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1807 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1808 The string describing active prots consists of entries with
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1809 abbreviated name of the prot, current duration (from casting),
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1810 possible number of stackings and optional stickiness-indicator
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1811 for sticky conjuprots. The entries are separated with vertical
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1812 line character (sometimes called the pipe).
787
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
1813 Some examples of prot entries with explanations are shown in table below.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1814 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1815
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1816 <table><title>Prot entries</title>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1817 <tgroup cols="2" align="left">
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1818 <thead>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1819 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1820 <entry>Entry</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1821 <entry>Description</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1822 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1823 </thead>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1824 <tbody>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1825 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1826 <entry>Unst[1m9s]</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1827 <entry>Unstun with duration of 1 minutes, 9 seconds.</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1828 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1829 <row>
787
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
1830 <entry>+AoA[7m19s]</entry>
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
1831 <entry>Sticky Armour of Aether.</entry>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1832 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1833 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1834 <entry>Infra(2)[0m2s]</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1835 <entry>Infravision stacked at 2 levels.</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1836 </row>
584
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1837 <row>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1838 <entry>Unst&lt;2&gt;[7m19s]</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1839 <entry>Unstun that has been weakened 2 times.</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1840 </row>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1841 <row>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1842 <entry>-Forget[3m5s]</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1843 <entry>'Forget' curse that has been active for 3 minutes and 5 seconds.</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1844 </row>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1845 </tbody>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1846 </tgroup>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1847 </table>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1848
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1849 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1850 Simple example session featuring some protting action in GgrTF:
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1851 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1852
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1853 <screen>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1854 <userinput>tweak jeskko</userinput>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1855
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1856 You tweak Jeskko's nose mischievously.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1857 Jeskko [report]: Unst[1h1m13s]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1858
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1859 <userinput>unp jeskko</userinput>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1860
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1861 Ggr [report]: Unpain -&gt; jeskko
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1862 GgrTF: ---- SPELL START ---- (393)
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1863 GgrTF: 'unpain' -&gt; jeskko
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1864 Unpain: ##### [5]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1865 You skillfully cast the spell with greater haste.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1866 Unpain: ## [2]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1867 Unpain: # [1]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1868 GgrTF: ---- SPELL DONE ---- in [3] rounds! [0m9s]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1869 You utter the magic words (unpain)
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1870 You cast the spell successfully.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1871 H:506/506 [] S:805/941 [-136] E:246/246 [] $:6499 [] exp:68202 []
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1872 Jeskko [report]: Unpain ON!
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1873
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1874 <userinput>tweak jeskko</userinput>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1875
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1876 You tweak Jeskko's nose mischievously.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1877 Jeskko [report]: Unst[1h4m25s] | Unp[2m35s]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1878 </screen>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1879
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1880
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1881 &sectmacros_2;
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1882 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1883 <entry>/prots</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1884 <entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1885 Show any currently active prots on you. The output is only echoed
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1886 locally, use BatMUD 'tweak me' emote to list prots to party
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1887 report-channel.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1888 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1889 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1890 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1891 <entry>/cprots</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1892 <entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1893 This command clears all prots on you. It is meant for those cases
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1894 where GgrTF is either bugging and does not notice a prot dropping,
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1895 or any other reason when you need to remove all prots at your
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1896 discretion.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1897 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1898 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1899 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1900 <entry>tweak &lt;target&gt;</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1901 <entry>
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1902 BatMUD's 'tweak' emote is used to report prots to party
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1903 report-channel.
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1904 </entry>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1905 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1906 &sectmacros_end;
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1907
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1908 </section>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1909
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1910 <!-- ================================================ -->
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1911
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1912 <section id="usage-general-curses"><title>Curse management</title>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1913 <para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1914 Often an important aspect while bashing those nasty eq-monsters dead,
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1915 is to keep track of any handicapping spells or skills cast against the
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1916 said monster. GgrTF's curse handling is made just for that, it
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1917 tracks most common handicaps cast at non-partymembers.
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1918 </para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1919 <para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1920 <emphasis>Notice! To work fully, this feature requires <link
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1921 linkend="usage-pssmangle">PSS-mangler</link> module to be loaded
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1922 and in use.
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1923 </emphasis>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1924 While curse tracking does work without it, curses cast by other
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1925 entities than party members will be counted also, which can be
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1926 counterproductive.
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1927 </para>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1928
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1929 &sectmacros_2;
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1930 <row>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1931 <entry>/curses</entry>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1932 <entry>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1933 Echo status of tracked curses to yourself (e.g. not shown to others.)
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1934 </entry>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1935 </row>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1936 <row>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1937 <entry>twirl &lt;target&gt;</entry>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1938 <entry>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1939 BatMUD's 'twirl' emote is used to report curses to party report-channel.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1940 </entry>
1203
796e24a218a4 Oops, a </row> tag was missing.
Matti Hamalainen <ccr@tnsp.org>
parents: 1202
diff changeset
1941 </row>
1157
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1942 <row>
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1943 <entry>/cursewarn</entry>
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1944 <entry>
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1945 Toggles informing about curses that are soon about to expire. The
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1946 warning occurse when 20% of the "maximum" curse duration is left.
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1947 (These maximum durations are set in GgrTF's main module.)
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1948 </entry>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1949 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1950 &sectmacros_end;
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1951
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1952 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1953
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1954 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1955
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1956 <section id="usage-general-hbtick"><title>Heartbeat and tick prediction</title>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1957
1222
9c89e20131df Comment out a warning.
Matti Hamalainen <ccr@tnsp.org>
parents: 1220
diff changeset
1958 <!--
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1959 <note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1960 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1961 <emphasis>WARNING! There is a high likelihood, that this code may
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1962 not work correctly in all situations.</emphasis> And if it doesn't,
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1963 you can send complaints to nearest trashbin.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1964 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1965 </note>
1222
9c89e20131df Comment out a warning.
Matti Hamalainen <ccr@tnsp.org>
parents: 1220
diff changeset
1966 -->
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1967
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1968 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1969 Since version 0.6.14, GgrTF provides an <emphasis>experimental</emphasis> feature for
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1970 predicting heartbeat duration and ticks. This can be useful if you
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1971 wish to time your regen breaks nicely, or when to enter combat again
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1972 (heartbeat factors in with the so-called initial battle round, or
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1973 so called "zero round").
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1974 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1975
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1976 <para>
1443
dc60423b8d4b Change documentation to match the removal of average heartbeat duration field from statusline.
Matti Hamalainen <ccr@tnsp.org>
parents: 1426
diff changeset
1977 The usage of this feature is simple: There is one new field displayed
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1978 on the <link linkend="usage-general-statusline">statusline</link>, the
1443
dc60423b8d4b Change documentation to match the removal of average heartbeat duration field from statusline.
Matti Hamalainen <ccr@tnsp.org>
parents: 1426
diff changeset
1979 value labeled as "T" shows number of heartbeats from last tick, next tick
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1980 usually occurs at 9 or 10. It should always be 10, but due to how we
1443
dc60423b8d4b Change documentation to match the removal of average heartbeat duration field from statusline.
Matti Hamalainen <ccr@tnsp.org>
parents: 1426
diff changeset
1981 "force" simulated HBs and interaction with fast metabolism, they will
dc60423b8d4b Change documentation to match the removal of average heartbeat duration field from statusline.
Matti Hamalainen <ccr@tnsp.org>
parents: 1426
diff changeset
1982 not always match the real ones.
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1983 <emphasis>First tick after leaving battle will not usually be predicted
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1984 correctly, but the situation should normalize after it.</emphasis>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1985 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1986
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1987 <note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1988 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1989 You can also utilize a stethoscope, and it should, at least theoretically
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1990 make the HB and tick prediction accurate, but who knows... fastmeta is a bitch.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1991 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1992 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1993 <emphasis>Stethoscope is an item, available from Arelium's tinkerer's toolshop.</emphasis>
1443
dc60423b8d4b Change documentation to match the removal of average heartbeat duration field from statusline.
Matti Hamalainen <ccr@tnsp.org>
parents: 1426
diff changeset
1994 You can use it by applying, 'apply stethoscope to ggr'. Easiest way is to
dc60423b8d4b Change documentation to match the removal of average heartbeat duration field from statusline.
Matti Hamalainen <ccr@tnsp.org>
parents: 1426
diff changeset
1995 add that to your eqset swapping commands.
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1996 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1997 </note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1998
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1999
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2000 <section id="usage-general-hbtick-details"><title>Technical details</title>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2001 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2002 One might ask, how does this all work? This is where it gets
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2003 a little bit murky, because we are largely working on assumptions
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2004 on how things like heartbeat work in BatMUD. So it might not be
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2005 correct, there may be things that have been overlooked, etc.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2006 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2007
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2008 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2009 First of all, here are some things that the predictor code assumes:
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2010 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2011
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2012 <itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2013 <listitem><para>Heartbeat duration (delta) is 3.0 seconds to start
1443
dc60423b8d4b Change documentation to match the removal of average heartbeat duration field from statusline.
Matti Hamalainen <ccr@tnsp.org>
parents: 1426
diff changeset
2014 with, we adjust slowly towards the player's "real" average heartbeat
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2015 frequency.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2016 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2017
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2018 <listitem><para>One tick is always 10 heartbeats.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2019 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2020
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2021 <listitem><para>Battle rounds are always around ~3s,
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2022 not withstanding +/- lag and slight variation due to driver issues.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2023 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2024
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2025 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2026 Spell rounds, cast and skill finishes occur on heartbeat.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2027 Thus we can use these to time heartbeats, when filtering out fastmeta.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2028 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2029 </itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2030
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2031 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2032 Basically what we do in the code is as follows:
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2033 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2034
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2035 <orderedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2036 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2037 Start a TF timer that runs gheartbeat_timer() at ~20Hz.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2038 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2039
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2040 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2041 In gheartbeat_sc (ran on each 'sc') we check if we seem to have
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2042 ticked by checking sp/ep deltas against threshold values.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2043 We also try to discard 'sc' events caused by things that
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2044 may not be heartbeats (fires, crystals, heal alls, etc.)
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2045 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2046
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2047 <listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2048
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2049 <para>In gheartbeat_timer() we check for:</para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2050 <itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2051 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2052 Ongoing battle, check when last round went off, disable battle
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2053 if it was "too long" ago.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2054 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2055 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2056 Check when last hb was, simulate / force a hb if it was too
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2057 long ago.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2058 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2059 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2060 Check if we need to "force" a tick, and do that.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2061 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2062 </itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2063
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2064 </listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2065
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2066 </orderedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2067
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2068 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2069 Based on these, we keep a running average of heartbeat duration
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2070 to predict incoming heartbeats and ticks. The average starts at 3s,
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2071 which is the basic BatMUD heartbeat without fast metabolism or such.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2072 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2073
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2074 <note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2075 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2076 If you are interested in some debug-spam produced by the predictor,
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2077 you can enable it via <emphasis>/set hb_debug=1</emphasis>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2078 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2079 </note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2080
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2081 </section>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2082
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2083 </section>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2084
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2085 <!-- ================================================ -->
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2086
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2087 <section id="usage-general-skillspell"><title>Skill handling</title>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2088 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2089 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2090 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2091
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2092 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2093
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2094 <section id="usage-magical"><title>Magical guilds support (gm-magical.tf)</title>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2095 <para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2096 Base module for all things magical. This module is <emphasis>required</emphasis>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2097 for supporting spells/casting. It is not necessary for being the receiving
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2098 end of prots or such. Several modules are dependant on this module, most
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2099 importantly those guild-specific modules that use magic.
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2100 </para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2101
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2102 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2103 Even in the case your guild does not use magic spells (nomad guilds), having
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2104 this module loaded is not harmful, so you can keep it in your configuration
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2105 at all times.
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2106 </para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2107
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2108 <itemizedlist>
890
a864a635d545 Add information about resist reporting, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 889
diff changeset
2109 <listitem><para>Basic code for blast hit and resistance reporting
a864a635d545 Add information about resist reporting, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 889
diff changeset
2110 (some types, such as channeller guild blasts, are added by guild-specific modules).
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2111 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2112 <listitem><para>Spell round reporting. Enables you to optionally
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2113 spam your fellow players with information how many rounds are left
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2114 until your spell goes off.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2115 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2116 </itemizedlist>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2117
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2118 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2119
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2120 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2121
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2122 <section id="usage-pssmangle"><title>PSS-mangler (gm-pssmangle.tf)</title>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2123 <para>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2124 This module provides support for filtering the output of
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2125 <emphasis>pss</emphasis> (<emphasis>party status short</emphasis>)
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2126 -command. It captures the status and prettyprints it out as a
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2127 3x3 table (as 9-man party formation) with player names and their
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2128 status information in compact format.
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2129 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2130
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2131 <para>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2132 The HP/SP/EP values are coloured in accordance to what percentage the
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2133 player currently has of his maximum. Additionally varying colouring of
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2134 player's name is used to indicate possible states of <emphasis>rest,
1596
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2135 unconsciousness, stun, formation, etc.</emphasis>.
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2136 </para>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2137
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2138 <para>There is also an number indicator for <emphasis>number of rescuers
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2139 </emphasis> when in stunned or unconscious state, but this is normally
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2140 hidden. It appears on the left side of player's name, when available.
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2141 </para>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2142
261
2b18754a1f01 Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 260
diff changeset
2143 <para>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2144 This module hooks to GgrTF's autopss-functionality (toggleable with
449
725695d31f21 Updated /pstatus -> pss and /pss -> /autopss accordingly.
Matti Hamalainen <ccr@tnsp.org>
parents: 422
diff changeset
2145 <link linkend="usage-general-commands">/autopss</link> option). A normally issued
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2146 'pss' command does not trigger the mangling functionality, but you can use
449
725695d31f21 Updated /pstatus -> pss and /pss -> /autopss accordingly.
Matti Hamalainen <ccr@tnsp.org>
parents: 422
diff changeset
2147 <emphasis>/pss</emphasis> macro or bind that to 'pss'. (See <link
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2148 linkend="usage-general-binds">Bindings</link>-section for more information.)
261
2b18754a1f01 Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 260
diff changeset
2149 </para>
2b18754a1f01 Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 260
diff changeset
2150
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2151 <screenshot>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2152 <mediaobject>
624
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
2153 <imageobject><imagedata fileref="pss_normal.gif" format="GIF" /></imageobject>
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
2154 <imageobject><imagedata fileref="pss_normal.eps" format="EPS" /></imageobject>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2155 <textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2156 <phrase>Typical first row</phrase>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2157 </textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2158 <caption>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2159 <para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2160 Typical output of PSS-mangler in a party with first row filled. Toivo
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2161 and Jeskko are near their maximum hp/sp/ep, but Ggr has taken some
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2162 damage (yellow HP) and is almost out of endurance points (red EP).
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2163 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2164 </caption>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2165 </mediaobject>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2166 </screenshot>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2167
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2168 <screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2169 <mediaobject>
624
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
2170 <imageobject><imagedata fileref="pss_stun.gif" format="GIF" /></imageobject>
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
2171 <imageobject><imagedata fileref="pss_stun.eps" format="EPS" /></imageobject>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2172 <textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2173 <phrase>Stunned</phrase>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2174 </textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2175 <caption>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2176 <para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2177 In this screenshot example, Jeskko has become stunned (his name is
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2178 coloured in bright red). Also, Jeskko has lost some hitpoints
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2179 (dark green HP) and has only moderate amount of endurance left
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2180 (light yellow EP). <emphasis>(No Jeskkos were actually harmed
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2181 in producing this simulated situation.)</emphasis>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2182 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2183 </caption>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2184 </mediaobject>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2185 </screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2186
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2187 <screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2188 <mediaobject>
624
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
2189 <imageobject><imagedata fileref="pss_uncon.gif" format="GIF" /></imageobject>
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
2190 <imageobject><imagedata fileref="pss_uncon.eps" format="EPS" /></imageobject>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2191 <textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2192 <phrase>Unconscious</phrase>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2193 </textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2194 <caption>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2195 <para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2196 This screenshot shows how Toivo has taken some serious damage from
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2197 a blast to the backrow, and has become unconscious. White on bright
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2198 red background is used to highlight a unconscious player's name,
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2199 hopefully catching your attention.
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2200 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2201 </caption>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2202 </mediaobject>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2203 </screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2204
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2205
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2206 <section><title>HP/SP/EP colours</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2207 <para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2208 List of possible indicator colours and their meanings. &colourexplanation;
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2209 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2210
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2211
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2212 <table><title>List of HP/SP/EP indicator colours</title>
1545
fe83084ff7e1 Fix some table column width.
Matti Hamalainen <ccr@tnsp.org>
parents: 1544
diff changeset
2213 <tgroup cols="3" align="left">
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2214 <thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2215 <row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2216 <entry>Colour</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2217 <entry>Background</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2218 <entry>Explanation</entry>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2219 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2220 </thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2221 <tbody>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2222 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2223 <entry>Bright White</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2224 <entry>Bright Red</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2225 <entry>Negative value (x &lt; 0)</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2226 </row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2227 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2228 <entry>Bright Red</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2229 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2230 <entry>Less than 16% of max</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2231 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2232 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2233 <entry>Red (dark)</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2234 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2235 <entry>Less than 33% of max</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2236 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2237 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2238 <entry>Yellow (dark)</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2239 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2240 <entry>Less than 49% of max</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2241 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2242 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2243 <entry>Bright Yellow</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2244 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2245 <entry>Less than 66% of max</entry>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2246 </row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2247 <row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2248 <entry>Green (dark)</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2249 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2250 <entry>Less than 85% of max</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2251 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2252 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2253 <entry>Bright Green</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2254 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2255 <entry>More than 85% of max</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2256 </row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2257 </tbody>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2258 </tgroup>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2259 </table>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2260 </section>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2261
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2262 <section><title>Player name colours</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2263 <para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2264 List of possible name colours and their meanings. &colourexplanation;
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2265 </para>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2266
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2267 <table><title>List of possible player name lite colours</title>
1545
fe83084ff7e1 Fix some table column width.
Matti Hamalainen <ccr@tnsp.org>
parents: 1544
diff changeset
2268 <tgroup cols="3" align="left">
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2269 <thead>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2270 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2271 <entry>Colour</entry>
272
Matti Hamalainen <ccr@tnsp.org>
parents: 271
diff changeset
2272 <entry>Background</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2273 <entry>State description</entry>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2274 </row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2275 </thead>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2276 <tbody>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2277 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2278 <entry>Bright White</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2279 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2280 <entry>Normal</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2281 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2282 <row>
1596
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2283 <entry>Bright Black</entry>
849
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2284 <entry>-</entry>
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2285 <entry>Idle</entry>
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2286 </row>
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2287 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2288 <entry>Bright White</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2289 <entry>Bright Red</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2290 <entry>Unconscious (unc)</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2291 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2292 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2293 <entry>Bright Red</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2294 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2295 <entry>Stunned (stun)</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2296 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2297 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2298 <entry>Magenta</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2299 <entry>-</entry>
1596
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2300 <entry>In form (form), or member (mbr)</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2301 </row>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2302 <row>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2303 <entry>Cyan</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2304 <entry>-</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2305 <entry>Resting/camping/meditating (rest)</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2306 </row>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2307 <row>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2308 <entry>Bright White</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2309 <entry>Blue</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2310 <entry>"Glaced" (NPC special)</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2311 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2312 &sectmacros_end;
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2313
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
2314 <section>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2315 &sectmacros_1;
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
2316 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2317
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2318 <table><title>Macro commands</title>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2319 <tgroup cols="2" align="left">
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2320 <thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2321 <row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2322 <entry>Command</entry>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2323 <entry>Description</entry>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2324 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2325 </thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2326 <tbody>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2327 <row>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2328 <entry>/prettypss</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2329 <entry>Toggle 'pss' output mangling/prettifying. If set off, normal
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2330 plain 'pss' output is passed through unfiltered.</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2331 </row>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2332 <row>
449
725695d31f21 Updated /pstatus -> pss and /pss -> /autopss accordingly.
Matti Hamalainen <ccr@tnsp.org>
parents: 422
diff changeset
2333 <entry>/pss</entry>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2334 <entry>Show party status.</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2335 </row>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2336 <row>
449
725695d31f21 Updated /pstatus -> pss and /pss -> /autopss accordingly.
Matti Hamalainen <ccr@tnsp.org>
parents: 422
diff changeset
2337 <entry>/autopss</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2338 <entry>Toggle automatic party status reporting. (Defined elsewhere)</entry>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2339 </row>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2340 <row>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2341 <entry>/fullparty</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2342 <entry>If enabled, mangled output always shows full 3x3 party formation,
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2343 even if all rows aren't filled. When disabled, only the first used rows
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2344 are shown.</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2345 </row>
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2346 <row>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2347 <entry>/diffpss</entry>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2348 <entry>Shows diff-values of hp/sp/ep if enabled.</entry>
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2349 </row>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2350 </tbody>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2351 </tgroup>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2352 </table>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2353 </section>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2354
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2355 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2356
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2357 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2358
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2359 <section id="usage-pplacer"><title>Party Placer (gm-pplacer.tf)</title>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2360 <para>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2361 This module provides functionality for saving and restoring
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2362 party formation (placement of members). Two simple to use macros can be
1385
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2363 issued to save the current formation and restore it as needed.
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2364 Current flower BatMUD provides an in-game implementation via
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2365 'party store' and 'party restore' commands, which may be preferable
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2366 over this module for some people.
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2367 </para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2368
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2369 <para>
1385
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2370 <emphasis>However, the functionality of this module is somewhat
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2371 better than the stock BatMUD commands, and will work under certain
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2372 situations when the 'party restore' command does not, for example
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2373 when some party members are missing from the room.
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2374 </emphasis>
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2375 </para>
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2376
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2377 <para>
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2378 NOTICE! This module requires
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2379 <link linkend="usage-pssmangle">PSS-mangler</link> module to be loaded!
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2380 </para>
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2381
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2382 &sectmacros_2;
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2383 <row>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2384 <entry>/ppsave</entry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2385 <entry>Save current party formation. Positions of party members
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2386 in current formation are stored.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2387 </entry>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2388 </row>
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2389 <row>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2390 <entry>/ppreset</entry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2391 <entry>Resets or restores the party formation to the one saved
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2392 previously. Restoring occurs fully automatically.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2393 </entry>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2394 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2395 &sectmacros_end;
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2396
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2397 </section>
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2398
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2399 <!-- ================================================ -->
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2400
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2401 <section id="usage-ptracker"><title>Party Prots Tracker (gm-ptracker.tf)</title>
1166
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2402 <note><para>
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2403 <emphasis>This module is practically obsolete and deprecated in flower BatMUD, because of
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2404 the in-game 'party prots' command that does essentially the same thing.
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2405 </emphasis>
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2406 It is possible that this module will be removed in future.
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2407 </para></note>
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2408
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2409 <para>
1099
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2410 Module for showing prots (and similar effects) affecting your party members.
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2411 Tracking these effects can be done in two separate ways: 1) Old way (compatible
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2412 with HCBat also) is keeping account of different prot up/down messages on the
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2413 party and report channels. 2) New way is via 'show effects' command available
1104
850b0245b763 Add some more notes about ptracker and 'show effects'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1103
diff changeset
2414 in the normal BatMUD. The 'show effects' method is recommended, because of
850b0245b763 Add some more notes about ptracker and 'show effects'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1103
diff changeset
2415 generally better accuracy. <emphasis>It should also be noted that there is a
850b0245b763 Add some more notes about ptracker and 'show effects'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1103
diff changeset
2416 difference in the output between these two methods. "Manually" tracked prots
850b0245b763 Add some more notes about ptracker and 'show effects'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1103
diff changeset
2417 show elapsed time of the effect, but with 'show effects' mode, the remaining
850b0245b763 Add some more notes about ptracker and 'show effects'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1103
diff changeset
2418 time is shown.</emphasis>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2419 </para>
1099
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2420 <note><para>
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2421 Due to the way the up/down message tracking works, it depends on your
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2422 party members to use <emphasis>working, non-broken</emphasis> triggers
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2423 which use up/down messages that are recognizable to the ptracker module.
1225
9157e2a5441e Clarification.
Matti Hamalainen <ccr@tnsp.org>
parents: 1224
diff changeset
2424 However, this does not affect 'show effects' mode in any way.
1099
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2425 </para></note>
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2426
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2427 <screen>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2428 .------------+-----+-----+-----+-----+-----+-----+-----+-----+
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2429 | | Flex|WarEs|EMelo| AoA|MFire| AoH| Uns| Unp|
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2430 +------------+-----+-----+-----+-----+-----+-----+-----+-----+
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2431 |Blayke | 0:07| 1:25| 0:49| 1:55| 1:43| 2:03| | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2432 |Yar | | 1:25| | 1:40| 0:07| |21:34| |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2433 |Kheldor | | 1:24| 0:48| 1:12| 0:41| 2:17|24:40| |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2434 |Alorn | | 1:25| 0:49| | | | | 6:49|
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2435 |Acentaja | | 1:25| 0:49| | | 1:31| | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2436 |Malcom | | 1:25| 0:49| | | 1:10| | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2437 |Jrj | | | | | | 6:22| | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2438 |Daria | | | | | | | | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2439 |Ggr | | 1:25| 0:49| | |20:13| | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2440 `------------+-----+-----+-----+-----+-----+-----+-----+-----+
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2441 </screen>
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2442
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2443 <para>
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2444 <emphasis>NOTICE! This module requires
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2445 <link linkend="usage-pssmangle">PSS-mangler</link> module to be loaded!
1104
850b0245b763 Add some more notes about ptracker and 'show effects'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1103
diff changeset
2446 </emphasis> Also remember to issue at least one "/pss" command after
850b0245b763 Add some more notes about ptracker and 'show effects'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1103
diff changeset
2447 the party is formed, to make the party members known to PSS-mangler
850b0245b763 Add some more notes about ptracker and 'show effects'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1103
diff changeset
2448 and prot tracker.
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2449 </para>
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2450
1103
6100e266c4da Add explanation about not all effects/prots being shown by the prot tracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1101
diff changeset
2451 <note><para>
6100e266c4da Add explanation about not all effects/prots being shown by the prot tracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1101
diff changeset
2452 It should be noted that the prot tracker only supports a limited set of
6100e266c4da Add explanation about not all effects/prots being shown by the prot tracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1101
diff changeset
2453 effects, e.g. it only lists effects/prots that are widely considered to be
6100e266c4da Add explanation about not all effects/prots being shown by the prot tracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1101
diff changeset
2454 of some interest in eq parties. Showing everything would just waste screen
6100e266c4da Add explanation about not all effects/prots being shown by the prot tracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1101
diff changeset
2455 estate and make it less readable.
6100e266c4da Add explanation about not all effects/prots being shown by the prot tracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1101
diff changeset
2456 </para></note>
6100e266c4da Add explanation about not all effects/prots being shown by the prot tracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1101
diff changeset
2457
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2458 <!-- @commands -->
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2459 <!-- @binds -->
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2460 <!-- @keybinds -->
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2461
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2462 </section>
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2463
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2464 <!-- ================================================ -->
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2465
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2466 <section id="usage-spellnames"><title>Spellwords translator (gm-spellnames.tf)</title>
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2467 <para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2468 This module adds in translating of spellwords to actual spell names.
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2469 It is very much based on original work of &finger Cutter; and &finger Dazzt;,
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2470 well known highbie BatMUD players. Their code is used and re-licensed
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2471 under GPL with permission.
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2472 </para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2473
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2474 <para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2475 The translator works by printing the spell name in parentheses
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2476 on the line where the spellwords are. The translated name can
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2477 optionally replace the spellwords or it can be printed after them.
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2478 </para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2479
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2480 <para>
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2481 The spell name can be, if enabled, optionally printed in special
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2482 colour formatting, which is based on the general class/type of the spell.
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2483 This visual hinting can help you to notice if dangerous or
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2484 otherwise interesting spells are cast.
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2485 </para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2486
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2487 <para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2488 Uncolorized examples of spellwords translator's output:
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2489 </para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2490
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2491 <screen>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2492 You utter the magic words (unstun)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2493
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2494 You utter the magic words 'Paxus' (unstun)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2495
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2496 Acolyte waves his index finger while uttering (flame arrow)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2497
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2498 Murrough throws a pinch of magic dust in air and chants (lightning storm)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2499 </screen>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2500
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2501 <!-- @commands -->
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2502
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2503 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2504
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2505 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2506
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2507 <section id="usage-tgtcast"><title>Numpad targetted casting (gm-tgtcast.tf)</title>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2508 <para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2509 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2510
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2511 <note>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2512 <para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2513 This module requires the <link linkend="usage-pssmangle">PSS-mangler</link> module.
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2514 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2515 </note>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2516
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2517 </section>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2518
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2519 <!-- ================================================ -->
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2520
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2521 <section id="usage-hc"><title>HCBat support (gm-hcbat.tf)</title>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2522 <para>
262
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2523 Due to the age of Hard Core BatMUD's current codebase and conceptual
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2524 differences, several exceptions and workarounds are needed to
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2525 improve GgrTF's compatibility with the HCBat environment.
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2526 This module tries to provide the glue to make it happen.
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2527 </para>
262
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2528
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2529 <para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2530 Purpose of this module is dissimilar to others, as it is meant
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2531 to contain almost everything related to peculiarities and
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2532 differences of HCBat. We do not have separate
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2533 guild-specific modules for HCBat, the code needed to
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2534 catch the differences is either in this module or in some
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2535 special cases in the guild-specific modules.
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2536 </para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2537
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2538 <para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2539 At the moment this module is rather simple, only replacing
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2540 GgrTF's output macros to work around the lack of 'party report'
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2541 -channel in HCBat. In future more functionality may be added,
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2542 feel free to report bugs/incompatibilities to us.
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2543 </para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2544
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2545 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2546
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2547 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2548
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2549 <section id="usage-tf5"><title>TinyFugue 5 support (gm-tf5.tf)</title>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2550 <para>
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2551 This is a special enhancement module for those who use GgrTF
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2552 with &tfurl; version 5.0 (beta 7 and LATER). Although GgrTF should work with TF5
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2553 without this module, you may wish to take benefit of the
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2554 enhanced features designed for TF5 this module provides.
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2555 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2556
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2557 <note>
642
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
2558 <para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2559 The code in this module uses features available on TF 5.0 beta 7
642
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
2560 and later, it will NOT work correctly in older betas!
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
2561 </para>
1598
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2562 <para>
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2563 <emphasis>The functionality of the statusline depends on
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2564 your <link linkend="inst-config-batmud">BatMUD settings</link>
1601
fcb56c908184 Oops, 100L.
Matti Hamalainen <ccr@tnsp.org>
parents: 1598
diff changeset
2565 being correctly set up.</emphasis> If HP/SP/EP etc. information does
1598
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2566 not appear, most likely your 'sc' setting is "wrong",
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2567 and thus does not get parsed by GgrTF.
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2568 </para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2569 </note>
642
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
2570
638
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2571 <screenshot>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2572 <mediaobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2573 <imageobject><imagedata fileref="statusbar_tf5.gif" format="GIF" /></imageobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2574 <imageobject><imagedata fileref="statusbar_tf5.eps" format="EPS" /></imageobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2575 <textobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2576 <phrase>GgrTF statusline</phrase>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2577 </textobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2578 <caption>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2579 <para>Example of typical basic GgrTF statusline in TF5.</para>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2580 </caption>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2581 </mediaobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2582 </screenshot>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2583
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2584 <itemizedlist>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2585 <listitem><para>
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2586 Enhanced 2-row statusline: First line contains HP/SP/EP- and
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2587 skill/spell/etc- information as usual. Prot status has been
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2588 moved to the second line.
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2589 </para></listitem>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2590
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2591 </itemizedlist>
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2592
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2593 <!--
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2594 - example configuration
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2595 - document special variables
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2596 -->
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2597 </section>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2598
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2599 <!-- ================================================ -->
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2600
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2601 <section id="usage-rais"><title>Raise/Resurrect/New Body/etc. (gm-rais.tf)</title>
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2602 <para>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2603 This module contains utility functionality for everyone who casts
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2604 different types of dead raising spells, including "raise dead",
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2605 "resurrect", "new body", "reincarnation", etc.
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2606 </para>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2607
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2608 <para>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2609 Automatic list is kept of people who have accepted some such service
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2610 from you, along with information what spell was requested. List can
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2611 be viewed, and you can launch a cast at the latest accept or by
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2612 specifying a player's name, cast his/her request.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2613 </para>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2614
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2615 <para>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2616 You can either directly use the macros or use <link
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2617 linkend="usage-general-binds">command bindings</link>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2618 to have shorthand commands instead.
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2619 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2620
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2621 <screenshot>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2622 <mediaobject>
624
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
2623 <imageobject><imagedata fileref="rais_list.gif" format="GIF" /></imageobject>
cc40c7360880 The manual is now pseudo-XML conformant, you have to use normalizeml.pl to convert to syntactically correct XML.
Matti Hamalainen <ccr@tnsp.org>
parents: 622
diff changeset
2624 <imageobject><imagedata fileref="rais_list.eps" format="EPS" /></imageobject>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2625 <textobject>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2626 <phrase>List of accepts</phrase>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2627 </textobject>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2628 <caption>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2629 <para>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2630 An example output of "/aclist" macro, listing the players
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2631 who have accepted services from you and respective requested
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2632 spells for each. The time field shows how much
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2633 time has passed from the accept.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2634 </para>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2635 </caption>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2636 </mediaobject>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2637 </screenshot>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2638
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2639 <table><title>Macro commands</title>
1545
fe83084ff7e1 Fix some table column width.
Matti Hamalainen <ccr@tnsp.org>
parents: 1544
diff changeset
2640 <tgroup cols="2" align="left">
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2641 <thead>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2642 <row>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2643 <entry>Command</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2644 <entry>Description</entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2645 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2646 </thead>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2647 <tbody>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2648 <row>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2649 <entry>/aclist</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2650 <entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2651 View list of people who have accepted something from you.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2652 </entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2653 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2654 <row>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2655 <entry>/accast [name]</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2656 <entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2657 Cast Last-type functionality. Without arguments casts the LATEST
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2658 requested spell. Optionally you can specify a name of the player
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2659 and the spell requested by him/her is cast.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2660 </entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2661 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2662 <row>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2663 <entry>/acclear</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2664 <entry>
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2665 Clears the list. Useful, if the automatic removal
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2666 malfunctions for some reason. (For example, if target
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2667 uses 'pray' to become alive again, there is no message
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2668 provided to the caster.)
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2669 </entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2670 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2671 </tbody>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2672 </tgroup>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2673 </table>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2674
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2675 <!-- @binds -->
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2676
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2677 </section>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2678
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2679 <!-- ================================================ -->
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2680
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2681 <section id="usage-hstats"><title>Hit Statistics (gm-hitstats.tf)</title>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2682 <para>
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2683 Provides triggers for automatic gathering of melee hit statistics.
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2684 This functionality is not without limitations, in some cases hits may become
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2685 erraneously counted (such as Templar guild 'holy strike' skill being counted
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2686 as bludgeon strike) but it gives you a general impression about what kinds
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2687 of hits you mostly deal out.
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2688 </para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2689
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2690 <para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2691 Only certain weapon/hit types are currently supported by the code.
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2692 In order to get any hit counts, you need to define what weapon types
1224
87ecb4223beb Update description of supported hit types to match the list.
Matti Hamalainen <ccr@tnsp.org>
parents: 1222
diff changeset
2693 you use. Currently following general hit/weapon classes are supported:
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2694 </para>
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2695
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2696 <itemizedlist>
1074
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2697 <listitem><para><emphasis>none</emphasis> - This is just a clear/off setting.</para></listitem>
1562
998654bf0b6c Add missing attack message types to manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 1557
diff changeset
2698
1074
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2699 <listitem><para><emphasis>bash</emphasis> - Blunt weapons (bludgeons, etc.)</para></listitem>
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2700 <listitem><para><emphasis>pierce</emphasis> - Impaling weapons (some polearms, some short blades.)</para></listitem>
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2701 <listitem><para><emphasis>slash</emphasis> - Slashing weapons (long blades, axes, some short blades, some polearms.)</para></listitem>
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2702 <listitem><para><emphasis>shield</emphasis> - Shield bash.</para></listitem>
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2703 <listitem><para><emphasis>whip</emphasis> - Whip hits.</para></listitem>
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2704 <listitem><para><emphasis>tiger</emphasis> - Tiger style martial arts.</para></listitem>
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2705 <listitem><para><emphasis>monk</emphasis> - Monk style martial arts.</para></listitem>
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2706 <listitem><para><emphasis>unarmed</emphasis> - Untrained unarmed attacks.</para></listitem>
1562
998654bf0b6c Add missing attack message types to manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 1557
diff changeset
2707 <listitem><para><emphasis>claw</emphasis> - Natural unarmed claw attacks.</para></listitem>
998654bf0b6c Add missing attack message types to manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 1557
diff changeset
2708 <listitem><para><emphasis>bite</emphasis> - Biting attacks.</para></listitem>
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2709 </itemizedlist>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2710
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2711 <note><para>
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2712 It should be noted, that the code does not differentiate between
1074
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2713 wielded weapons or limbs. <emphasis>This means, that if you are wielding
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2714 multiple weapons of same type, hits from those are counted as one weapon.
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2715 Same applies to unarmed hits too, of course.
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2716 </emphasis>
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2717 </para></note>
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2718
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2719 <para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2720 Example of /hstats output:
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2721 </para>
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2722 <screen>
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2723 ,----------------------.
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2724 | GgrTF Hit Statistics |
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2725 +-----------------------------------------------.
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2726 +-| Axes/Long blades |----------------------|
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2727 |horribly shred : ( 0): 2 ( 11)|
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2728 |shred : ( 0): 7 ( 41)|
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2729 |incise : ( 0): 8 ( 47)|
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2730 |tear : 21 ( 3): ( 0)|
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2731 |cut : 462 ( 72): ( 0)|
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2732 |lightly cut : 157 ( 24): ( 0)|
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2733 | |
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2734 +-----------------------------------------------'
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2735 +-| Totals |-------------------------------------------+
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2736 | Hits..: 640 ( 76%) | Crits: 17 ( 2%) |
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2737 | Misses: 192 ( 23%) | Total hit types: 6 |
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2738 +----------------------------------------------+-------'
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2739 | Dodges..: 3 | Parries..: |
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2740 | Tumbles.: | Stuns....: |
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2741 | Ripostes: | Stun mano: |
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2742 `----------------------------------------------'
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2743 </screen>
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2744
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2745 <para>
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2746 Format of hits described above is:
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2747 | Hit name : number of hits of this type (percentage): number of crits of this type (percentage) |
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2748 </para>
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2749
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2750 <note><para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2751 <emphasis>Hit stats REQUIRES the TF terminal window width
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2752 to be 95 columns or more!</emphasis> If you are using TF in smaller
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2753 smaller window and can't make it wider, then you are out of luck.
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2754 </para></note>
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2755
1074
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2756 <!-- @commands -->
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2757 <!-- @binds -->
832d49b91c3d Moved command documentation to embedded TFDoc; Added whip hit messages; Updated description of supported hit types to match the reality.
Matti Hamalainen <ccr@tnsp.org>
parents: 1072
diff changeset
2758 <!-- @keybinds -->
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2759
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2760 </section>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2761
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2762 <!-- ================================================ -->
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2763
1377
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2764 <section id="usage-identify"><title>Identify output beautifier (gm-identify.tf)</title>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2765 <para>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2766 Provides a simpler and more readable view of 'identify' spell's output.
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2767 Not all information can be caught gracefully, however, and thus you should
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2768 refer to the raw output for details such as "tales" and other special information.
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2769 </para>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2770
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2771 <para>
1563
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2772 The module also supports merchant belt's 'weigh' command for catching
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2773 the item's weight, if the belt is worn and <emphasis>/havebelt</emphasis>
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2774 setting of the merchant module is enabled.
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2775 </para>
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2776
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2777 <para>
1377
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2778 Example of output:
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2779 </para>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2780 <screen>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2781 +-| General |----------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2782 | Item....: a pair of stylish blue breeches |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2783 | Name....: blue breeches |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2784 | Handles.: 'breeches', 'stylish blue breeches', 'silk breeches' and |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2785 | 'pants' |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2786 | Names...: Molotov, Belse and Ekkivekki |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2787 | Slots...: leg and leg |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2788 | Material: silk |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2789 +----------------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2790 | In game.: 2y, 104d, 16h, 13min and 58s | Condition: great |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2791 | Size....: somewhat small | Maxcond..: AWESOME |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2792 | Worth...: 8851 | Quality..: superb |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2793 | Weight..: almost weightless | Weight/kg: 0.050 |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2794 +-| Stats |------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2795 | insignificantly improve your wis |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2796 +-| Misc |-------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2797 | Worn....: Ekkivekki for 48d, 17h, 13min and 9s, Prince charming for 2h, |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2798 | 5min and 44s and Slobber for 157d, 14h, 48min and 52s |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2799 | Wielded.: |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2800 +----------------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2801 </screen>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2802
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2803 <!-- @commands -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2804 <!-- @binds -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2805 <!-- @keybinds -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2806
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2807 </section>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2808
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2809 <!-- ================================================ -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2810
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2811 <section id="usage-rpouch"><title>Reagent Pouch handler (gm-rpouch.tf)</title>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2812 <para>
999
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2813 This module provides utilities for reagent pouch handling, especially useful
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2814 for mages and merchants. It also has a reagent pouch mangler/beautifier,
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2815 which attempts to make the pouch contents more readable.
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2816 </para>
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2817
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2818 <para>
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2819 Example output (uncoloured) of looking at a reagent pouch:
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2820 </para>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2821 <screen>
999
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2822 This is a large pouch for the storing of reagents for spells. You can store
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2823 reagents over reboots in this. It cannot hold anything else.
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2824 Syntax: store &lt;item&gt; in &lt;this&gt;
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2825 extract [amount] &lt;item&gt; from &lt;this&gt; take &lt;power/standard/poor&gt;
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2826 set_default_reagent &lt;this&gt; to &lt;power/standard/poor&gt;
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2827 transfer &lt;number&gt; &lt;reagent&gt; from &lt;here&gt; to &lt;there&gt; [take &lt;power level&gt;]
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2828 Some commands allow the use of 'all' in places.
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2829 It is labeled as 'pussi'.
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2830 The label can be set with 'label' command.
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2831 578 | Acid Blast ( 578, 0, 0) (Olivine powder)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2832 477 | Acid Storm ( 477, 0, 0) (Interlocked rings)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2833 436 | Blast Vacuum ( 436, 0, 0) (Bronze marble)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2834 417 | Lightning Shield ( 417, 0, 0) (Iron rod)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2835 397 | Armour of Aether ( 397, 0, 0) (Highsteel disc)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2836 388 | Magic Eruption ( 388, 0, 0) (Platinum hammer)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2837 341 | Lava Blast ( 341, 0, 0) (Granite sphere)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2838 272 | Electrocution ( 272, 0, 0) (Electrum wire)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2839 263 | Aura of Wind ( 263, 0, 0) (Leather bag)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2840 91 | Golden Arrow ( 91, 0, 0) (Copper rod)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2841 71 | Shield of Detoxification ( 71, 0, 0) (Amethyst crystal)
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2842 It is surrounded by a yellow glow.
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2843 This item is in superb condition.
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2844 It looks very very heavy.
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2845 </screen>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2846
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2847 <note><para>
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2848 Currently only POWER reagents are handled by the /rpouch commands!
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2849 Any standard or poor reagents will not be touched by the code in
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2850 this module.
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2851 </para></note>
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2852
1563
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2853 <!-- @commands -->
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2854
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2855 </section>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2856
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2857 <!-- ================================================ -->
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2858
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2859 <section id="usage-chann"><title>Guild: Channellers (gm-chann.tf)</title>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2860 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2861 Game-elements specific to channellers guild are supported and
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2862 enhanced by this module. At the moment, no special commands are
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2863 provided, all things are automagic. This module requires the generic
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2864 <link linkend="usage-magical">magical guilds support module</link>.
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2865 </para>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2866
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2867 <itemizedlist>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2868 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2869 <emphasis>Channeller aura</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2870 Keeps note of your aura status and duration. If aura is up,
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2871 it is notified in GgrTF's <link linkend="usage-general-statusline">statusline</link>.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2872 If your aura is weakening, that also is noted, reminding you
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2873 to recharge.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2874 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2875 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2876 <emphasis>Blast resistance reporting</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2877 Adds support for channeller blasts into blast resistance
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2878 reporting feature of <link linkend="usage-magical">magical guilds module</link>.
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2879 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2880 <listitem><para>And other miscellaneous lesser features, such as
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2881 fail and fumble handling, mana transfer cap reporting, etc.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2882 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2883 </itemizedlist>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2884
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2885 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2886 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2887 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2888
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2889 </section>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2890
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2891 <!-- ================================================ -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2892
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2893 <section id="usage-mage"><title>Guild: Mages (gm-mage.tf)</title>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2894 <para>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2895 Provides command bindings for all mage blast types (singles and areas)
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2896 and optional key bindings for blasting and conjurer prot casting.
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2897 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2898
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2899 <note><para>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2900 This module requires the generic
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2901 <link linkend="usage-magical">magical guilds support module</link>.
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2902 The keybinds require <link linkend="usage-tgtcast">targetted cast</link> module.
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2903 </para></note>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2904
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2905 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2906 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2907 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2908
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2909 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2910
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2911 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2912
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2913 <section id="usage-merchant"><title>Guild: Merchants (gm-merchant.tf)</title>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2914 <para>
263
Matti Hamalainen <ccr@tnsp.org>
parents: 262
diff changeset
2915 This module provides, in addition to basic skill/spell fail/fumble
233
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2916 handling, several helper macros, which may ease your work as merchant.
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2917 Many of the command macros support "autotargetting", which basically
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2918 means that you can walk in outerworld and just type "/lj" for
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2919 lumberjacking and "/mine" for mining and GgrTF usually knows what
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2920 to do. Some macros require bit more specific arguments.
233
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2921 </para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2922
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2923 <para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2924 There is also support for merchant belt, which can be enabled if
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2925 you have one available. In case your belt is not complete or is
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2926 totally non-existent, the system has semi-automatic tool wielding
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2927 functionality: if you use /lj and then /mine, the macros will
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2928 automagically change to proper tools (saw -&gt; hammer/pick). The
787
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
2929 system is not perfect and sometimes it may fail, however.
233
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2930 </para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2931
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2932 <para>
1071
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2933 Hint: Another useful module for merchants is the
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2934 <link linkend="usage-rpouch">reagent pouch handler</link>. It provides
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2935 several useful functions for handling reagents.
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2936 </para>
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2937
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2938 <para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2939 Notice that you probably MUST redefine some of these
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2940 macros and default settings in your TF configuration file!
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2941 (See <link linkend="usage-merchant-settings">Settings</link>-section below.)
233
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2942 </para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2943
1069
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2944 <note><para>
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2945 In below table: (*) = autotargets, (!) = moves items to item target
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2946 </para></note>
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2947
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2948 <!-- @commands -->
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2949 <!-- @binds -->
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2950 <!-- @keybinds -->
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2951
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2952 <section id="usage-merchant-settings">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2953 &sectvariables;
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2954 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2955 <entry>mtool_mine</entry>
251
3765cf197a77 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 250
diff changeset
2956 <entry>Tool(s) for mining. Example: <emphasis>/set mtool_mine=pick 1,pick 2</emphasis></entry>
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2957 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2958 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2959 <entry>mtool_lj</entry>
251
3765cf197a77 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 250
diff changeset
2960 <entry>Tool(s) for lumberjacking. Example: <emphasis>/set mtool_lj=saw</emphasis></entry>
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2961 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2962 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2963 <entry>mtool_bs</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2964 <entry>Tool(s) for blacksmithing.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2965 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2966 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2967 <entry>mtool_cp</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2968 <entry>Tool(s) for carpentry.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2969 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2970 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2971 <entry>mtool_gc</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2972 <entry>Tool(s) for gem cutting.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2973 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2974 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2975 <entry>mtool_gb</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2976 <entry>Tool(s) for glassblowing.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2977 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2978 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2979 <entry>mtool_ma</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2980 <entry>Tool(s) for masonry.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2981 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2982 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2983 <entry>mtool_sw</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2984 <entry>Tool(s) for sewing.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2985 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2986 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2987 <entry>mtool_sc</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2988 <entry>Tool(s) for sculpture skill.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2989 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2990 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2991 <entry>mforge_*</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2992 <entry>Forges/workbenches for skills (similar to mtool_* variables)</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2993 </row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2994 &sectvariablesend;
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2995
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2996
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2997 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2998
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2999 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3000
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3001 <section id="usage-alchemist"><title>Guild: Alchemists (gm-alchemist.tf)</title>
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3002 <para>
1378
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3003 Alchemist module provides several macros that can be very helpful with
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3004 potion making and other alchemist activities. Commands for easier handling of
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3005 herb jars and organ cans, command macro that automates potion mixing to great degree and
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3006 additional helper for potion research.
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3007 </para>
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3008
1378
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3009 <para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3010 Potion research is a big part of alchemist guild activities, but also one of the more
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3011 tedious ones. It requires juggling with organs, herbs and minerals, keeping book of findings, etc.
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3012 GgrTF alchemist module will come to help, as it automates getting the herb and organ from your containers,
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3013 submitting the finished potion concoction flask to authenticator and stores results in a text file.
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3014 </para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3015
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3016 <para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3017 Furthermore, the said text file is written in a specific format, that can be used with
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3018 an external utility called AlchTool, developed by Jeskko and yours truly (Ggr). This PHP-based
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3019 web utility can greatly increase your potion research efficiency. Currently (as of March 2011)
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3020 AlchTool is in "beta"-phase of version 2, but the code can be retrieved from Pupunen Mercurial
1650
e3626f2d850e Update to new repository URLs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1645
diff changeset
3021 repository at <ulink url="https://tnsp.org/hg/batmud/alchtool/">https://tnsp.org/hg/batmud/alchtool/</ulink>.
1378
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3022 </para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3023
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3024 <para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3025 Default location of the results text file is user's home directory, in file called <emphasis>alch_results.txt</emphasis>,
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3026 but this can be changed by altering <emphasis>galch_file</emphasis> TF variable, for example:
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3027
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3028 <userinput>/eval /set galch_file=%{HOME}/someotherfile.txt</userinput>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3029
1380
27c5c0603192 Add note about setting galch_file variable.
Matti Hamalainen <ccr@tnsp.org>
parents: 1379
diff changeset
3030 You should put this, if you wish to, in your tfrc file AFTER the loading of alchemist module.
27c5c0603192 Add note about setting galch_file variable.
Matti Hamalainen <ccr@tnsp.org>
parents: 1379
diff changeset
3031 </para>
27c5c0603192 Add note about setting galch_file variable.
Matti Hamalainen <ccr@tnsp.org>
parents: 1379
diff changeset
3032
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3033 <!-- @commands -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3034 <!-- @binds -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3035 <!-- @keybinds -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3036
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3037 </section>
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3038
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3039 <!-- ================================================ -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3040
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3041 <section id="usage-barb"><title>Guild: Barbarian (gm-barb.tf)</title>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3042 <para>
263
Matti Hamalainen <ccr@tnsp.org>
parents: 262
diff changeset
3043 Provides a translator for barbarian reputation bar, reputation
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
3044 difference calculator and handler for automated looting and burning.
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3045 </para>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3046
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
3047 <section>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3048 &sectmacros_1;
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3049 </para>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3050
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3051 <table><title>Macro commands</title>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3052 <tgroup cols="3" align="left">
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3053 <thead>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3054 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3055 <entry>Binding</entry>
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3056 <entry>Macro</entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3057 <entry>Description</entry>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3058 </row>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3059 </thead>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3060 <tbody>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3061 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3062 <entry>repu</entry>
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3063 <entry>/showrep</entry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3064 <entry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3065 Prints your current reputation and reputation difference
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3066 from previous invoking of the command.
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3067 </entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3068 </row>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3069 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3070 <entry>lb</entry>
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3071 <entry>/lootburn</entry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3072 <entry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3073 Starts looting and burning skill, lights a torch, waits for couple
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3074 of seconds and drops corpses from inventory. After burning the torch
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3075 is extinguished and current reputation printed out. Then action
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3076 determined by "/burnaction"-setting (see below) is executed.
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3077 If a skillbreak is detected, corpse dropping will be cancelled
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3078 immediately.
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3079 </entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3080 </row>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3081 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3082 <entry></entry>
237
6c495ddc7d4d forgot <action> from burnaction
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 236
diff changeset
3083 <entry>/burnaction &lt;action&gt;</entry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3084 <entry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3085 Sets the action done after finished burning. Available options are:
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3086 <emphasis>none</emphasis>, <emphasis>cash</emphasis> (drop small coins)
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3087 and <emphasis>noeq</emphasis> (drop low coins and noeq).
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3088 </entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3089 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3090 &sectmacros_end;
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3091
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3092 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3093 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3094 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3095
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3096 </section>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3097
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3098 <!-- ================================================ -->
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3099
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3100 <section id="usage-spiders"><title>Guild: Spiders (gm-spider.tf)</title>
239
34b7bb0a3395 Some info about spiders module.
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 238
diff changeset
3101 <para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3102 Provides very basic management help for spider demons, plus lites for
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3103 spider servants.
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
3104 </para>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3105
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3106 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3107 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3108 <!-- @keybinds -->
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
3109
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3110 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3111
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3112 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3113
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3114 <section id="usage-tiger"><title>Guild: Tigers (gm-tiger.tf)</title>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3115 <para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3116 Reporting of succesful and failed 'tiger claw' hits, lites for
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3117 claw and mak reputation gains.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3118 </para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3119
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3120 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3121 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3122 <!-- @keybinds -->
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3123
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3124 </section>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3125
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3126 <!-- ================================================ -->
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3127
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3128 <section id="usage-tarma"><title>Guild: Tarmalens (gm-tarma.tf)</title>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3129 <para>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3130 Provides command bindings for most common tarmalen spells. Triggers
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3131 for tracking latest heal alls cast (of course, only those that have
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3132 'hit' you are counted.) Optional keybindings for heals, party heals, etc.
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3133 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3134
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3135 <note><para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3136 This module requires the generic
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3137 <link linkend="usage-magical">magical guilds support module</link>.
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3138 The keybinds require <link linkend="usage-tgtcast">targetted cast</link> module.
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3139 </para></note>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3140
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3141 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3142 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3143 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3144
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3145 </section>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3146
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3147 <!-- ================================================ -->
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3148
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3149 <section id="usage-druid"><title>Guild: Druids (gm-druid.tf)</title>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3150 <para>
394
ed989c51b94e v0.5.11.3: Moved functionality from temp to tarmalen module and
Matti Hamalainen <ccr@tnsp.org>
parents: 393
diff changeset
3151 Barebones module with default bindings for some druid spells and
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3152 support for fails/fumbles. You will probably also want to use
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3153 the <link linkend="usage-rais">raise module</link>, which provides
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3154 help for casting reincarnations (along with raises, resurrects, etc.)
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3155 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3156
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3157 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3158 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3159 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3160
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3161 </section>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3162
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3163 <!-- ================================================ -->
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3164
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3165 <section id="usage-nun"><title>Guild: Nuns (gm-nun.tf)</title>
489
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3166 <para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3167 Includes several useful functions for nuns, such as relic identification messages
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3168 translator, useful command macros, prayer hour reminder (acts as a "prot"),
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3169 simple task status keeper, counter+lite for accomplished tasks, turn message
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3170 translator, etc.
489
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3171 </para>
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3172
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3173 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3174 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3175 <!-- @keybinds -->
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
3176
489
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3177 </section>
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3178
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3179 <!-- ================================================ -->
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3180
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3181 <section id="usage-loc"><title>Guild: (Old) Lords of Chaos (gm-oldloc.tf)</title>
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
3182 <para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3183 Very barebones module with support for "blood" ripaction and
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3184 fail/fumble handling.
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3185 </para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3186
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3187 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3188 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3189 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3190
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3191 </section>
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
3192
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3193 </chapter>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3194
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3195 <!-- *************************************************************** -->
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3196
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3197 <appendix id="support"><title>Support</title>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3198
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3199 <itemizedlist>
1629
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3200 <listitem><para>There is no support. GgrTF development has been
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3201 in maintenance mode for several years. You can still report bugs
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3202 via tells or e-mail, but do not expect that they will be necessarily
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3203 acted upon.
1630
07aadee01164 Oops, slight typo.
Matti Hamalainen <ccr@tnsp.org>
parents: 1629
diff changeset
3204 </para>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3205 <itemizedlist>
549
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3206 <listitem><para>Take your time to <emphasis>think</emphasis>
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3207 while writing, and before submitting your report. Good rule of
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3208 thumb is to include all information that you think might be
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3209 relevant, but no more than that!
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3210 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3211
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3212 <listitem><para>
549
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3213 Remember to include information about your system and environment,
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3214 (*NIX/Linux/Windows), version of &tfurl; ("/ver" command in TF),
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
3215 and version of GgrTF ("/gver" command).
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3216 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3217
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3218 </itemizedlist>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3219 </listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3220
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3221 <listitem><para>We do not provide support for usage, please refer
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3222 to the user's manual and only in case the issue is not documented,
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3223 you might be eligible to ask about it.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3224 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3225
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3226 <listitem><para>Neither we provide technical support for extending
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3227 GgrTF, nor documentation of the internals. You'll have to figure out
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3228 the workings yourself.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3229 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3230
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3231 <listitem><para>Be ready to be contacted by developers, in case
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3232 help and/or more information is required with debugging your issue(s).
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3233 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3234
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3235 <listitem><para>Remember not to bother the developers via tells
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3236 too much, we want to play the game too, instead of just answering
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3237 your questions and resolving problems.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3238 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3239
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3240 <!--
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3241 <listitem><para></para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3242 -->
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3243 </itemizedlist>
1322
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3244
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3245 <section id="patches"><title>Sending patches/corrections</title>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3246 <para>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3247 If you have prepared a fix for some bug or a new feature, you can send us a patch.
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3248 <emphasis>A changeset patch made against current Mercurial repository head/tip is highly preferred</emphasis>,
1323
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3249 short instructions on how to do that can be found below. You will probably need to refer to
1618
2344fa8c992b Update links to Mercurial website.
Matti Hamalainen <ccr@tnsp.org>
parents: 1614
diff changeset
3250 <ulink url="http://www.mercurial-scm.org/guide/">Mercurial guide</ulink> for generic
1323
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3251 Mercurial usage instructions and how to set it up. For making proper commits, you'll need to
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3252 at the very least set up your username, etc.
1322
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3253 </para>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3254 <screen>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3255 # 1) Make changes to files
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3256 $EDITOR ggrtf.tf
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3257
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3258 # 2) Commit related changes to a changeset your local repository
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3259 hg ci [filenames of changed files or nothing, if you wish to commit everything]
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3260
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3261 # 3) Repeat steps 1 to 2 until satisfied
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3262
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3263 # 4) Export your local changes to a bundle
1323
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3264 hg bundle mychanges.bz2 &hgrepourl;
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3265
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3266 # 5) Send mychanges.bz2 to us (Ggr), as e-mail attachment ccr@tnsp.org
1322
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3267 </screen>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3268 </section>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3269
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3270 </appendix>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3271
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3272 <!-- ================================================ -->
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3273
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3274 <appendix id="faq"><title>Frequently Asked Questions (FAQ)</title>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3275 <qandaset>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3276 <qandaentry>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3277 <question>
270
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3278 <para>Is "Grizzt" included in the documentation?</para>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3279 </question>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3280 <answer>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3281 <para>Unfortunately no. Grizzt may be included in some future version, though.</para>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3282 </answer>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3283 </qandaentry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3284
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3285 <qandaentry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3286 <question>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3287 <para>When will next version of GgrTF be released?</para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3288 </question>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3289 <answer>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3290 <para>"When it's done."</para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3291 </answer>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3292 </qandaentry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3293
331
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3294
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3295 <qandaentry>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3296 <question>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3297 <para>How to get rid of the battle round flag/marker?</para>
331
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3298 </question>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3299 <answer>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3300 <para>
978
dc8ee5ec3c66 Add @@ to some command examples, because apparently SOME players have aliased these essential BatMUD commands to something else.
Matti Hamalainen <ccr@tnsp.org>
parents: 972
diff changeset
3301 The BatMUD battle round marker (long line of asterisks "*") is required for
dc8ee5ec3c66 Add @@ to some command examples, because apparently SOME players have aliased these essential BatMUD commands to something else.
Matti Hamalainen <ccr@tnsp.org>
parents: 972
diff changeset
3302 GgrTF's internal functionality, but you can gag it with following piece of
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3303 code (add it to your .tfrc or similar):
331
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3304 </para>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3305 <screen>
345
a53267af3f06 Typofixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 344
diff changeset
3306 /test prlist_insert("event_battle_round", "myroundgag")
a53267af3f06 Typofixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 344
diff changeset
3307 /def -i myroundgag = /substitute -ag
331
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3308 </screen>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3309 <para>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3310 The first line adds macro "myroundgag" to be executed on each round marker,
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3311 the second line defines that macro and sets it to gag the round marker.
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3312 </para>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3313 </answer>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3314 </qandaentry>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3315
381
6af6df52fefd v0.5.11.2: Removed tick predictor, it wasn't working anyway;
Matti Hamalainen <ccr@tnsp.org>
parents: 379
diff changeset
3316
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3317 <qandaentry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3318 <question>
1448
8d07f07bd72b Clarify in the BatMUD configuration / setup section that "sc" should be turned on.
Matti Hamalainen <ccr@tnsp.org>
parents: 1443
diff changeset
3319 <para>My statusline is not updating, why? (HP/SP/EP values not updating)</para>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3320 </question>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3321 <answer>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3322 <para>
1448
8d07f07bd72b Clarify in the BatMUD configuration / setup section that "sc" should be turned on.
Matti Hamalainen <ccr@tnsp.org>
parents: 1443
diff changeset
3323 Maybe you haven't set up your 'short score' or 'prompt' in BatMUD or there is some
8d07f07bd72b Clarify in the BatMUD configuration / setup section that "sc" should be turned on.
Matti Hamalainen <ccr@tnsp.org>
parents: 1443
diff changeset
3324 typo in the setting. See <link linkend="inst-config-batmud">setup-section</link>
1449
1863c4f2c390 Add note about '/gagsc'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1448
diff changeset
3325 for how to do that properly. If you wish that 'sc' line to not be visible, you can turn on '/gagsc' option.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3326 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3327 </answer>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3328 </qandaentry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3329
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3330 <qandaentry>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3331 <question>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3332 <para>How can I get my settings saved automatically? Or can I?</para>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3333 </question>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3334 <answer>
454
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3335 <para>Automatic saving and loading is possible, please refer to
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3336 <link linkend="usage-general-saves">state-saving</link>
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
3337 and <link linkend="inst-config-tf">setup</link> -sections of
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3338 this manual for more information.
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3339 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3340 </answer>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3341 </qandaentry>
454
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3342
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3343 <qandaentry>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3344 <question>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3345 <para>A spell/prot cast by others at me registers in prot-reporting,
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3346 but does not work when I cast it on myself!</para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3347 </question>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3348 <answer>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3349 <para>
1629
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3350 This is most likely a bug, please report the issue via e-mail.
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3351 Remember to include the lines you get when you
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3352 cast the spell on yourself (aka the "prot goes up"-line).
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3353 </para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3354 <para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3355 Also see the next question below.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3356 </para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3357 </answer>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3358 </qandaentry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3359
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3360 <qandaentry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3361 <!--
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3362 <question>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3363 <para>Some prots do not register / are not noticed by GgrTF</para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3364 </question>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3365 -->
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3366 <question>
454
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3367 <para>Sometimes the <link linkend="usage-spellnames">
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3368 spellword translator</link> does not work, what gives?</para>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3369 </question>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3370 <answer>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3371 <para>Your 'cutter'-setting might be too small, the default
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3372 in BatMUD is 80, which adds hard linefeeds too early on a line,
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3373 thus breaking many triggers of GgrTF, including GgrTF::Spellnames
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3374 module. 'cutter 9999' or 'cutter off' should fix this problem.
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3375 </para>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3376
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3377 <para>Please refer to <link linkend="inst-config-batmud">
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3378 BatMUD settings</link> -section of this manual for correct
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3379 in-game settings.
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3380 </para>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3381 </answer>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3382 </qandaentry>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3383
642
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3384 <qandaentry>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3385 <question>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3386 <para>The <link linkend="usage-tf5">TF5 module</link> does not work! I am
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3387 using TF 5.0 beta 6 or older.</para>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3388 </question>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3389 <answer>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3390 <para>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3391 The functionality used by the TF5 module was introduced in TF 5.0 beta 7,
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3392 so you need to have that or a later version.
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3393 </para>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3394 </answer>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3395 </qandaentry>
1529
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3396
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3397 <qandaentry>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3398 <question>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3399 <para>The keypad/numpad functionality (movement, targetting) is not working.</para>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3400 </question>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3401 <answer>
1539
78268db92315 Oops, a missing para-tag. Fixed.
Matti Hamalainen <ccr@tnsp.org>
parents: 1538
diff changeset
3402 <para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
3403 Make sure you have configured your terminal correctly,
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
3404 refer to <link linkend="inst-config-tf-term">terminal configuration</link>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
3405 section for more information.
1539
78268db92315 Oops, a missing para-tag. Fixed.
Matti Hamalainen <ccr@tnsp.org>
parents: 1538
diff changeset
3406 </para>
1529
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3407 </answer>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3408 </qandaentry>
270
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3409 <!--
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3410 <qandaentry>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3411 <question>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3412 <para></para>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3413 </question>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3414 <answer>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3415 <para>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3416 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3417 </answer>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3418 </qandaentry>
270
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3419 -->
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3420 </qandaset>
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3421
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3422 </appendix>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3423
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3424 <!-- ================================================ -->
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3425
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3426 <appendix id="app-verify-sig"><title>How to verify package signatures via
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3427 GnuPG</title>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3428 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3429 If you wish, you may verify the tarball package signatures with GnuPG,
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3430 in case you want to be sure that you are getting unmodified files directly
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3431 from the upstream. To do that, use the following commands:
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3432 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3433
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3434 <itemizedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3435 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3436 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3437 Retrieve Matti Hämäläinen's public key from a keyserver:
1572
b9913c1a9208 Update PGP key ID.
Matti Hamalainen <ccr@tnsp.org>
parents: 1564
diff changeset
3438 <userinput>gpg --keyserver wwwkeys.pgp.net --recv-keys 0x307BAAE3</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3439 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3440 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3441 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3442 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3443 Verify the package signature (assuming you have downloaded both the file and signature):
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3444 <userinput>gpg --verify ggrtf-&ggrtfver;.tar.gz.asc</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3445 If the data is untampered, you should get a result like 'gpg: Good
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3446 signature from "Matti Hamalainen (ccr) &lt;ccr@tnsp.org&gt;"'
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3447 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3448 </listitem>
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3449 </itemizedlist>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3450
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3451 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3452 Please refer to GnuPG or PGP documentation for more information about
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3453 their usage. A great introduction to PKI, cryptography and public key
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3454 signing, the <ulink url="http://www.gnupg.org/gph/en/manual.html">
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3455 GNU Privacy Handbook</ulink> is available from GnuPG project.
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3456 (Versions in other languages and formats, including PDF, are available
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3457 from <ulink url="http://www.gnupg.org/documentation/guides.en.html">
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3458 http://www.gnupg.org/documentation/guides.en.html</ulink>.)
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3459 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3460 </appendix>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3461
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
3462 </book>