annotate docs/manual.sgml @ 1671:b0c58647c169

Bump copyrights.
author Matti Hamalainen <ccr@tnsp.org>
date Fri, 01 Mar 2024 12:52:02 +0200
parents c3a98af55092
children 54a9a23d8df0
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">
1665
dc2ae49143e7 Update http URLs to https.
Matti Hamalainen <ccr@tnsp.org>
parents: 1664
diff changeset
4 <!ENTITY finger "<ulink url='https://www.bat.org/char/$1'>$1</ulink>">
1060
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;)">
1665
dc2ae49143e7 Update http URLs to https.
Matti Hamalainen <ccr@tnsp.org>
parents: 1664
diff changeset
6 <!ENTITY ggr "<ulink url='https://tnsp.org/~ccr/'>Matti Hämäläinen</ulink> (&finger Ggr;)">
dc2ae49143e7 Update http URLs to https.
Matti Hamalainen <ccr@tnsp.org>
parents: 1664
diff changeset
7 <!ENTITY tfurl "<ulink url='https://tinyfugue.sf.net/'>TinyFugue</ulink>">
dc2ae49143e7 Update http URLs to https.
Matti Hamalainen <ccr@tnsp.org>
parents: 1664
diff changeset
8 <!ENTITY homeurl "<ulink url='https://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>">
1665
dc2ae49143e7 Update http URLs to https.
Matti Hamalainen <ccr@tnsp.org>
parents: 1664
diff changeset
11 <!ENTITY hgurl "<ulink url='https://www.mercurial-scm.org/'>Mercurial</ulink>">
dc2ae49143e7 Update http URLs to https.
Matti Hamalainen <ccr@tnsp.org>
parents: 1664
diff changeset
12 <!ENTITY batmudurl "<ulink url='https://www.bat.org/'>BatMUD</ulink>">
dc2ae49143e7 Update http URLs to https.
Matti Hamalainen <ccr@tnsp.org>
parents: 1664
diff changeset
13 <!ENTITY gnupgurl "<ulink url='https://www.gnupg.org/'>GnuPG</ulink>">
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
14
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
15 <!ENTITY exampletfrc SYSTEM "../example-tfrc.txt">
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
16 <!ENTITY validval "Valid values:">
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
17 <!ENTITY validonoff "<emphasis>on</emphasis>, <emphasis>off</emphasis>">
232
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
18
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
19 <!ENTITY colourexplanation "
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
20 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
21 see due to differences in terminal emulation programs and settings.
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
22 ">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
23
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
24 <!ENTITY sectmacros_1 "<title>Macro commands</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
25 <para>&lt;&gt; = required argument, [] = optional argument">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
26
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
27 <!ENTITY sectmacros_2 "<section>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
28 <title>Macro commands</title>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
29 <para>&lt;&gt; = required argument, [] = optional argument</para>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
30 <table><title>Macro commands</title>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
31 <tgroup cols='2' align='left'>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
32 <thead>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
33 <row>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
34 <entry>Command</entry>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
35 <entry>Description</entry>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
36 </row>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
37 </thead>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
38 <tbody>">
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
39
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
40 <!ENTITY sectmacros_end "</tbody>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
41 </tgroup>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
42 </table>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
43 </section>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
44 ">
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
45
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
46 <!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
47 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
48 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
49 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
50 <link linkend='inst-config'>Setup</link>-section of this manual
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
51 or see the example configuration for this module.
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
52 ">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
53
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
54 <!ENTITY sectvariables "
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
55 <title>Settings and user-replaceable macros</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
56 <para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
57 &paravariables;
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
58 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
59
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
60 <table><title></title>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
61 <tgroup cols='2' align='left'>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
62 <thead>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
63 <row>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
64 <entry>Variable / macro name</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
65 <entry>Description</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
66 </row>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
67 </thead>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
68 <tbody>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
69 ">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
70
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
71 <!ENTITY sectvariablesend "
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
72 </tbody>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
73 </tgroup>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
74 </table>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
75 </section>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
76 ">
251
3765cf197a77 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 250
diff changeset
77
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
78 -->
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
79 <book>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
80 <bookinfo>
1052
3f0fec339dcb Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1049
diff changeset
81 <title>The GgrTF v&ggrtfver; User's Guide</title>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
82 <authorgroup>
620
b51e42467f2c Character set conversion ISO-8859-1 -> UTF-8
Matti Hamalainen <ccr@tnsp.org>
parents: 618
diff changeset
83 <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
84 <author><firstname>Jarkko</firstname><surname>Vääräniemi</surname></author>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
85 </authorgroup>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
86 <copyright>
1671
b0c58647c169 Bump copyrights.
Matti Hamalainen <ccr@tnsp.org>
parents: 1667
diff changeset
87 <year>2006-2024</year>
620
b51e42467f2c Character set conversion ISO-8859-1 -> UTF-8
Matti Hamalainen <ccr@tnsp.org>
parents: 618
diff changeset
88 <holder>Matti Hämäläinen (Ggr Pupunen)</holder>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
89 </copyright>
1671
b0c58647c169 Bump copyrights.
Matti Hamalainen <ccr@tnsp.org>
parents: 1667
diff changeset
90 <pubdate>2024</pubdate>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
91
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
92 <legalnotice>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
93 <para>
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
94 This document is distributed under
1667
c3a98af55092 Update manual license to CC BY-SA 4.0 from 3.0.
Matti Hamalainen <ccr@tnsp.org>
parents: 1665
diff changeset
95 <ulink url="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-Share Alike 4.0 International license</ulink>,
c3a98af55092 Update manual license to CC BY-SA 4.0 from 3.0.
Matti Hamalainen <ccr@tnsp.org>
parents: 1665
diff changeset
96 of which full version can be found from <ulink url="https://creativecommons.org/licenses/by-sa/4.0/legalcode">Creative Commons website</ulink>.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
97 </para>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
98
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
99 <para>
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
100 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
101 COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
102 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
103 AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
104 </para>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
105
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
106 <para>
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
107 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
108 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
109 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
110 HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
111 </para>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
112 </legalnotice>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
113 </bookinfo>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
114
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
115 <!-- *************************************************************** -->
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
116
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
117 <chapter id="preface"><title>Preface</title>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
118
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
119 <section id="whatisggrtf"><title>What is GgrTF?</title>
233
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
120
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
121 <para>
567
82a3def121a8 Updated intro, hopefully now in better linguistic form.
Matti Hamalainen <ccr@tnsp.org>
parents: 555
diff changeset
122 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
123 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
124 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
125 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
126 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
127 GgrTF from most other publicly available scripts.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
128 </para>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
129
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
130 <para>
862
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
131 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
132 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
133 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
134 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
135 </para>
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
136
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
137 <para>
669
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
138 The current version (as of v&ggrtfver; release) has modules
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
139 for following character classes:
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
140 </para>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
141 <itemizedlist>
711
46b002db0699 Fix some links.
Matti Hamalainen <ccr@tnsp.org>
parents: 710
diff changeset
142 <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
143 <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
144 <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
145 <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
146 <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
147 <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
148 <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
149 <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
150 <listitem><para><link linkend="usage-spiders">Spiders</link></para></listitem>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
151 <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
152 <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
153 </itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
154
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
155 <para>
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
156 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
157 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
158 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
159 <link linkend="usage-magical">spell</link>-handling, way to
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
160 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
161 (and more), plus following special modules:
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
162 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
163
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
164 <itemizedlist>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
165 <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
166 <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
167 <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
168 <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
169 <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
170 <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
171 <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
172 </itemizedlist>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
173
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
174 <para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
175 And more ...
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
176 </para>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
177 </section>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
178
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
179 <!-- ================================================ -->
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
180
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
181 <section id="isggrtfforme"><title>Is GgrTF for Me?</title>
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
182 <para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
183 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
184 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
185 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
186 not as a complete bells and whistles-type solution.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
187 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
188 </para>
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
189
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
190 <para>
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
191 When I started working on GgrTF,
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
192 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
193 though few others have joined my efforts on scratching.
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
194 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
195 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
196 Thus, if you like the design decisions and features I like,
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
197 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
198 ever touched are supported through efforts of other developers)
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
199 it is likely that you will like GgrTF.
284
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
200 </para>
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
201
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
202 <para>
555
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
203 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
204 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
205 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
206 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
207 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
208 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
209 for you.</emphasis>
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
210 </para>
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
211
b8a4d3e1cce9 More babbling in intro
Matti Hamalainen <ccr@tnsp.org>
parents: 549
diff changeset
212 <para>
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
213 All in all, GgrTF <emphasis>might</emphasis> be something for you,
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
214 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
215 hand GgrTF might not be for you, and there are several alternatives
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
216 out there for those who do not find it satisfactory. Below I have
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
217 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
218 </para>
284
6517558e2516 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 281
diff changeset
219
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
220 <itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
221 <listitem><para>Pros:</para>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
222 <itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
223 <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
224 "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
225 <listitem><para>Modularity, easily extendable for most part.</para></listitem>
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
226 <listitem><para>Updated regularly, most bugs get fixed in upstream.</para></listitem>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
227 <listitem><para>User-level documentation exists.</para></listitem>
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
228 </itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
229 </listitem>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
231 <listitem><para>Cons:</para>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
232 <itemizedlist>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
233 <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
234 <listitem><para>Requires bit more programming knowledge than some other solutions.</para></listitem>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
235 <listitem><para>Due to nature of the developer's reincs, is biased
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
236 towards caster-type functionality than tanks. Thus the support for tank
695
eccaff8ad60f Typofix.
Matti Hamalainen <ccr@tnsp.org>
parents: 670
diff changeset
237 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
238 </itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
239 </listitem>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
240
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
241 </itemizedlist>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
242 </section>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
243
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
244 <!-- ================================================ -->
232
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
245
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
246 <section id="ggrtfhistory"><title>History of GgrTF</title>
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
247 <subtitle>As told by Ggr</subtitle>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
248
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
249 <para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
250 <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
251 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
252
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
253 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
254 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
255 and a little bit of digital electronics and hardware, so
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
256 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
257 Nethack and some CRPGs like Fallout. I guess the RPG statmania
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
258 was one reason that got me hooked in the first place, plus
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
259 the multiplayer interaction and social aspects.
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
260 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
261
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
262 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
263 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
264 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
265 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
266 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
267 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
268 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
269 At least I felt so back then.
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
270 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
271
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
272 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
273 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
274 automating certain things became apparent. I researched some of
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
275 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
276 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
277 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
278 but as usual, they only shared inside small circles of their own.
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
279 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
280
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
281 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
282 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
283 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
284 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
285 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
286 on my &batmudurl; related web-page.
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
287 </para>
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
288
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
289 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
290 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
291 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
292 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
293 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
294 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
295
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
296 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
297 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
298 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
299 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
300 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
301 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
302 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
303 </para>
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
304
dda12c2548c8 Updated history and some other small things.
Matti Hamalainen <ccr@tnsp.org>
parents: 642
diff changeset
305 <para>
1202
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
306 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
307 expected, there were literally dozens of internal version landmarks
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
308 (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
309 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
310
8930a7bf1229 Clean up the history section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1166
diff changeset
311 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
312 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
313 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
314 on few features.
265
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
315 </para>
d676261ebf80 History.
Matti Hamalainen <ccr@tnsp.org>
parents: 263
diff changeset
316
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
317 </section>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
318
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
319 <!-- ================================================ -->
232
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
320
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
321 <section id="license"><title>GgrTF License</title>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
322 <para>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
323 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
324 by Matti Hämäläinen (aka Ggr Pupunen) and
232
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
325 distributed under the GNU General Public License version 2.
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
326 </para>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
327
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
328 <para>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
329 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
330 called COPYING.txt, and is also available
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
331 <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
332 </para>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
333 </section>
a53e2e4cc3b2 And more work.
Matti Hamalainen <ccr@tnsp.org>
parents: 231
diff changeset
334
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
335 </chapter>
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
336
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
337 <!-- *************************************************************** -->
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
338
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
339 <chapter id="installation"><title>Installation</title>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
340 <para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
341 This chapter assumes that you have already succesfully installed &tfurl;
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
342 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
343 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
344 system of choice, be it some flavour of UNIX or Windows, although some
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
345 parts of the instructions are given in step-by-step manner.
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
346 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
347
421
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
348 <note>
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
349 <para>
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
350 Throughout this manual, when GgrTF files are referenced in configuration
783
Matti Hamalainen <ccr@tnsp.org>
parents: 781
diff changeset
351 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
352 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
353 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
354 files in.
421
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
355 </para>
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
356 </note>
17df1b70f898 Added note about tf/-directory being used in examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 418
diff changeset
357
404
cea945e9a2a0 Bim bim
Matti Hamalainen <ccr@tnsp.org>
parents: 403
diff changeset
358 <para>
cea945e9a2a0 Bim bim
Matti Hamalainen <ccr@tnsp.org>
parents: 403
diff changeset
359 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
360 the Mercurial-repository. Releases are considered as stable snapshots,
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
361 which should be relatively bug-free, but releases are done somewhat
281
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
362 infrequently and at least in this phase we don't backport bugfixes to
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
363 release versions.
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
364 </para>
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
365
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
366 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
367 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
368 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
369
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
370
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
371 <section id="inst-releases"><title>Releases</title>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
372 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
373 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
374 <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
375 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
376 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
377 <itemizedlist>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
378 <listitem>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
379 <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
380 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
381 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
382 </listitem>
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 <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
385 have been converted to CRLF line endings.)</para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
386 </listitem>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
387 </itemizedlist>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
388 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
389 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
390 (*.asc), which can be used to cryptographically
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
391 <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
392 </para>
1574
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
393 <para>
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
394 To "install" the package, you simply unpack it to appropriate directory,
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
395 typically under your home directory. Under UNIX-style system:
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
396 </para>
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
397
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
398 <userinput>cd $HOME</userinput>
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
399 <userinput>tar xzvf ggrtf-&ggrtfver;.tar.gz</userinput>
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
400
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
401
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
402 <para>
1574
26812e5f7549 Update installation part.
Matti Hamalainen <ccr@tnsp.org>
parents: 1573
diff changeset
403 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
404 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
405 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
406
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
407 </section>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
408
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
409
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
410 <section id="inst-mercurial"><title>Development version</title>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
411 <para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
412 Another way to get GgrTF is to go to the very source, the
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
413 development source repository. This repository contains the latest
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
414 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
415 are directly committed by developers almost in real time,
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
416 sometimes what you download may be severely broken.
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
417 Also the documentation will not be updated for every little change,
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
418 so you may have to figure out and work around possible backward
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
419 incompatibilities yourself.
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
420 </para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
421
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
422 <para>
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
423 New features and bugfixes may sometimes be worth taking the risk.
670
44a490cc41ec Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 669
diff changeset
424 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
425 manage to handle the possibly arising problems.
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
426 </para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
427
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
428 <para>
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
429 We utilize &hgurl; (Hg) for GgrTF's version management. Mercurial
1557
b922a5f99ad8 Some language improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 1556
diff changeset
430 is a freely available distributed version control system, for which
281
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
431 there are clients available for most common platforms, including
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
432 Windows, Linux and other flavours of UNIX.
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
433 </para>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
434
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
435 <para>
1651
86f3d10eafec Fix reference to old repo location.
Matti Hamalainen <ccr@tnsp.org>
parents: 1650
diff changeset
436 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
437 <ulink url="&hgrepourl;">&hgrepourl;</ulink>.
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
438 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
439 </para>
281
ddba91c39c7d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 280
diff changeset
440
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
441 <section id="intro-checking-out"><title>Checking out</title>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
442 <para>
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
443 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
444 Mercurial client with following command:
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
445
1340
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
446 <userinput>hg clone &hgrepourl; dest_dir</userinput>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
447
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
448 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
449 repository under directory <emphasis>dest_dir</emphasis>.
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
450 </para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
451
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
452 <para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
453 You will most probably want to download the repository to some
1340
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
454 specific place, personally I prefer to use ~/ggrtf/ (aka "ggrtf/"
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
455 under user's home directory) under UNIX.
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
456 Thus typically you would use following command:
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
457
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
458 <userinput>hg clone &hgrepourl; ~/ggrtf</userinput>
57c5fb61e46a Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1337
diff changeset
459
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
460 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
461 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
462 such as <ulink url="http://tortoisehg.bitbucket.org/">TortoiseHg</ulink>.
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
463 </para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
464
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
465 <para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
466 The procedures for cloning and updating your local copy of the repository
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
467 are otherwise similar, except the directory/folder path is different,
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
468 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
469 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
470
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
471 <userinput>hg clone &hgrepourl; "C:\Documents and Settings\Ggr\ggrtf\"</userinput>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
472
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
473 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
474 </para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
475
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
476 </section>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
477
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
478 <section id="intro-updating"><title>Keeping up to date</title>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
479 <para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
480 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
481 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
482 the following commands:
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
483
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
484 <userinput>cd ~/ggrtf</userinput>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
485 <userinput>hg pull</userinput>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
486 <userinput>hg update</userinput>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
487
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
488 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
489 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
490 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
491 your local changesets automatically. Refer to Mercurial documentation.
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
492 </para>
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
493 <para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
494 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
495 yourself with the basics of Mercurial workflow, making commits, fetching, etc. It
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
496 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
497 </para>
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
498
1313
65c5d6d53338 Update documentation for Mercurial.
Matti Hamalainen <ccr@tnsp.org>
parents: 1288
diff changeset
499
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
500 </section>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
501
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
502 </section>
405
7bdc7ef54e6c Add blockdiagram files.
Matti Hamalainen <ccr@tnsp.org>
parents: 404
diff changeset
503
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
504 </chapter>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
505
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
506 <!-- ================================================ -->
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
507
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
508 <chapter id="inst-config"><title>Configuration</title>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
509 <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
510 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
511 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
512 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
513 </para>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
514
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
515 <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
516 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
517 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
518 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
519 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
520 backwards incompatible changes.
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
521 </para>
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
522
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
523
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
524 <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
525 <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
526 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
527 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
528 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
529 system and environment.
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
530 </para>
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
531
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
532 <itemizedlist>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
533 <listitem><para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
534 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
535 <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
536 (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
537 </para></listitem>
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
538
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
539 <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
540 DruWare Win32 port of TF:
1346
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
541 Windows XP/2k/NT - <emphasis>C:\Documents and Settings\username\tfrc</emphasis>,
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
542
de37c79098cc Updated documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1344
diff changeset
543 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
544 </para></listitem>
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
545 </itemizedlist>
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
546
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
547 <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
548 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
549 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
550 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
551 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
552 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
553 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
554 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
555
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
556 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
557 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
558 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
559 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
560 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
561 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
562 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
563
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
564 <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
565
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
566 <!--
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
567 - layout of recommended configuration
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
568 - discussion about modules
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
569 - bindings or not?
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
570 -->
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
571
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
572 <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
573 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
574 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
575 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
576 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
577 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
578 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
579
1230
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
580 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
581 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
582 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
583 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
584 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
585 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
586 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
587 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
588 <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
589 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
590
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
591 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
592 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
593 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
594 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
595 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
596 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
597
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
598 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
599 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
600 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
601 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
602 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
603 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
604 incorrectly.
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
605 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
606
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
607 <para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
608 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
609 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
610 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
611 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
612 </para>
8ef19c746981 Cleanups, add more information about configuration, add information about locales and character encodings.
Matti Hamalainen <ccr@tnsp.org>
parents: 1225
diff changeset
613
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
614 <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
615 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
616 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
617 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
618 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
619 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
620 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
621
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
622 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
623 On Ubuntu, things get a bit more complicated:
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
624 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
625 <orderedlist>
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
626 <listitem>
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
627 <para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
628 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
629 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
630 It should look something like this:
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
631 </para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
632 <screen>en_US.UTF-8 UTF-8
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
633 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
634 </listitem>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
635 <listitem>
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
636 <para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
637 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
638 </para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
639 </listitem>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
640 </orderedlist>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
641 <para>
1602
33eab61839a7 Typofix.
Matti Hamalainen <ccr@tnsp.org>
parents: 1601
diff changeset
642 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
643 for installing locales vary. Your best bet is to
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
644 <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
645 </para>
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 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
648 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
649 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
650 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
651 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
652 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
653 </para>
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 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
656 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
657 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
658 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
659 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
660 <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
661 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
662 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
663 <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
664 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
665 <screen>#!/bin/sh
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
666 SAVE_LANG="$LANG"
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
667 export LANG="en_US.ISO-8859-1"
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
668 printf '\33]701;%s\007' $LANG
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
669
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
670 /usr/bin/tf5 $*
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
671
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
672 export LANG="$SAVE_LANG"
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
673 printf '\33]701;%s\007' $LANG</screen>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
674 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
675 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
676 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
677 (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
678 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
679 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
680 </para>
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 Remember to set the script executable by changing
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
683 its permissions, '<emphasis>chmod 0755 /some/where/scriptfile</emphasis>'
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
684 should do it.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
685 </para>
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 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
688 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
689 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
690 after TF exits.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
691 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
692 </section> <!-- Unix-likes -->
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
693
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 </section>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
696
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
697 <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
698 <para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
699 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
700 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
701 <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
702 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
703 <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
704 </para>
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 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
707 in your terminal.
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
708 </para>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
709 <itemizedlist>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
710 <listitem>
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
711 <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
712 Preferences / Setting / Advanced</emphasis> and turn on
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
713 "Allow VT100 application keypad mode".
1537
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
714 </para>
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
715 </listitem>
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 <para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
718 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
719 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
720 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
721 </para>
6ca679191afd Add some information about configuring locales.
Matti Hamalainen <ccr@tnsp.org>
parents: 1536
diff changeset
722 </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
723 </itemizedlist>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
724 </section> <!-- Terminal -->
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
725
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
726 </section>
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
727
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
728
404
cea945e9a2a0 Bim bim
Matti Hamalainen <ccr@tnsp.org>
parents: 403
diff changeset
729 <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
730 <para>
980
9d3182edd64d Add note about how BatMUD settings should be copypasted exactly as shown.
Matti Hamalainen <ccr@tnsp.org>
parents: 978
diff changeset
731 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
732 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
733 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
734 correctly.</emphasis>
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
735 </para>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
736
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
737 <itemizedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
738 <listitem><para>Line 'cutter' setting:
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
739 <userinput>cutter 9999</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
740 Theoretically, '<emphasis>cutter off</emphasis>'
453
e7d262fb061c Note about 'cutter' setting was missing, added.
Matti Hamalainen <ccr@tnsp.org>
parents: 449
diff changeset
741 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
742 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
743 </listitem>
e7d262fb061c Note about 'cutter' setting was missing, added.
Matti Hamalainen <ccr@tnsp.org>
parents: 449
diff changeset
744
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
745 <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
746 <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
747 </para>
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
748 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
749
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
750 <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
751 <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
752 </para>
306
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
753 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
754
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
755 <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
756 <userinput>@@sc on</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
757 </para>
1449
1863c4f2c390 Add note about '/gagsc'.
Matti Hamalainen <ccr@tnsp.org>
parents: 1448
diff changeset
758 <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
759 </listitem>
8d07f07bd72b Clarify in the BatMUD configuration / setup section that "sc" should be turned on.
Matti Hamalainen <ccr@tnsp.org>
parents: 1443
diff changeset
760
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
761 <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
762 <userinput>@@prompt PROMPT:&gt;</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
763 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
764 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
765 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
766 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
767 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
768
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
769 <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
770 <userinput>@@battle rounds</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
771 This setting is a toggle, make sure that you set it ON
345
a53267af3f06 Typofixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 344
diff changeset
772 ("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
773 </para>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
774 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
775
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
776 <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
777 <userinput>@@battle listen all 2</userinput>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
778 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
779 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
780 </para>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
781 </listitem>
006531a8109f Updates to setup-section and fixes to others.
Matti Hamalainen <ccr@tnsp.org>
parents: 284
diff changeset
782 </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
783
521d0c3233bd v0.5.10.0: Major cleanup of namespace, many functions and variables renamed
Matti Hamalainen <ccr@tnsp.org>
parents: 323
diff changeset
784 <para>
521d0c3233bd v0.5.10.0: Major cleanup of namespace, many functions and variables renamed
Matti Hamalainen <ccr@tnsp.org>
parents: 323
diff changeset
785 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
786 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
787 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
788 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
789 </para>
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
790 </section>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
791
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
792 <!--
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
793 <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
794 <para>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
795 </para>
315
14204307afda More explanation about configuration; prot-management
Matti Hamalainen <ccr@tnsp.org>
parents: 314
diff changeset
796 </section>
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
797 -->
405
7bdc7ef54e6c Add blockdiagram files.
Matti Hamalainen <ccr@tnsp.org>
parents: 404
diff changeset
798
226
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
799 </chapter>
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
800
Matti Hamalainen <ccr@tnsp.org>
parents: 223
diff changeset
801 <!-- *************************************************************** -->
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
802
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
803 <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
804 <para>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
805 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
806 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
807 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
808 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
809 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
810 guild-related modules, containing guild-specialties.
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
811 </para>
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
812
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
813 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
814 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
815 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
816 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
817 with examples.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
818 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
819
1263
d56722e12ed8 Remove (comment out) block diagram from documentation, for now.
Matti Hamalainen <ccr@tnsp.org>
parents: 1255
diff changeset
820 <!--
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
821 <para>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
822 Following block-diagram represents the structure of GgrTF and
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
823 how different components approximately relate to each other:
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
824 </para>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
825
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
826 <screenshot>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
827 <mediaobject>
638
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
828 <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
829 <imageobject><imagedata fileref="blockdiagram.eps" format="EPS" /></imageobject>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
830 <textobject>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
831 <phrase>GgrTF's internal structure</phrase>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
832 </textobject>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
833 <caption>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
834 <para>Internal structure and relations of GgrTF components represented as
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
835 block-diagram.</para>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
836 </caption>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
837 </mediaobject>
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
838 </screenshot>
1263
d56722e12ed8 Remove (comment out) block diagram from documentation, for now.
Matti Hamalainen <ccr@tnsp.org>
parents: 1255
diff changeset
839 -->
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
840
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
841 <!-- ================================================ -->
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
842
340
0bde8b59b02a Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 331
diff changeset
843 <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
844 <para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
845 This is the main module and core of GgrTF. It contains helper
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
846 macro functions used by all the other modules and is thus
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
847 always required to be loaded.
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
848 It also provides much of the basic functionality, such as:
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
849 </para>
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
850
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
851 <itemizedlist>
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
852 <listitem><para>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
853 <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
854 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
855 condition, applied prots and other such information.
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
856 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
857
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
858 <listitem><para>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
859 <link linkend="usage-general-prots">Prot management</link>.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
860 Keeps note of what prots have been cast at you, and provides this
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
861 information in various ways.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
862 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
863
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
864 <listitem><para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
865 <link linkend="usage-general-curses">Curse/degen/etc tracking</link>.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
866 Tracks what handicaps have been cast at enemies (non-partymembers).
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
867 This information is most useful in eq-parties.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
868 </para></listitem>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
869
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
870 <listitem><para>Battle round handling. Enables commands to be
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
871 executed each battle round and autopss functionality.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
872 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
873
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
874 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
875 <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
876 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
877 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
878
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
879 <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
880 or to cast spells and use skills, with or without reporting to
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
881 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
882 section for more information.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
883 </para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
884
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
885 <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
886 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
887 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
888 commands.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
889 </para></listitem>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
890
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
891 <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
892 handling and mangling.</link>
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
893 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
894
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
895 <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
896 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
897 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
898 </para></listitem>
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
899
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
900 <listitem><para>Keyboard movement handling and mapping. Bind your
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
901 numpad keys to move around, either by walking, walking with peering
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
902 in adjacent rooms (useful for merchants) or guiding your ship.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
903 Additional modes may be provided by other optional modules.
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
904 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
905
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
906 <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
907 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
908 more readable and convenient form.
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
909 </para></listitem>
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
910
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
911 <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
912 and whatnots. ("/stats" command)
279
0c28d658f4d9 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 278
diff changeset
913 </para></listitem>
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
914
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
915 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
916 <emphasis>Consider-skill reporting</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
917 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
918 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
919 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
920 estimation of target's toughness.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
921 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
922
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
923 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
924 <emphasis>Combat Damage Analysis reporting</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
925 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
926 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
927
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
928 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
929 <emphasis>Purse contents prettyprinting</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
930 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
931 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
932 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
933
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
934 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
935 <emphasis>Camping status handling and reporting</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
936 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
937 the hp/sp/ep gained from resting.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
938 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
939
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
940 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
941 <emphasis>Ceremony status</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
942 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
943 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
944 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
945
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
946 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
947 <emphasis>Path compression for map.tf</emphasis>:
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
948 TinyFugue distribution comes with map.tf, which
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
949 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
950 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
951 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
952 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
953 "command"-aliases is also provided.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
954 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
955
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
956 <listitem><para>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
957 Plus numerous miscellaneous reporting- and helper-triggers.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
958 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
959
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
960 </itemizedlist>
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
961
278
a06334daf5b0 More updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 277
diff changeset
962
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
963 <section id="usage-general-commands">
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
964 &sectmacros_1;
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
965 </para>
1425
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
966
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
967 <!-- @commands -->
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
968 <!-- @binds -->
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
969
429e4bfbe297 Fetch GgrTF core macro command documentation from the embedded inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1421
diff changeset
970 </section>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
971
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
972 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
973
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 <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
977 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
978 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
979 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
980 &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
981 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
982 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
983
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
984 <para>
862
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
985 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
986 <link linkend="usage-tf5">TF5 support module</link> provides another
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
987 version, enhanced to take advantage of newer TF5 beta features
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
988 (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
989 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
990
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
991 <para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
992 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
993 castings and certain other events. <emphasis>This depends on
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
994 your <link linkend="inst-config-batmud">BatMUD settings</link>
1601
fcb56c908184 Oops, 100L.
Matti Hamalainen <ccr@tnsp.org>
parents: 1598
diff changeset
995 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
996 not appear, most likely your 'sc' setting is "wrong",
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
997 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
998 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
999
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1000 <screenshot>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1001 <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
1002 <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
1003 <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
1004 <textobject>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1005 <phrase>GgrTF statusline</phrase>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1006 </textobject>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1007 <caption>
862
55e9f2a7db27 Remove references to TF4.
Matti Hamalainen <ccr@tnsp.org>
parents: 849
diff changeset
1008 <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
1009 </caption>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1010 </mediaobject>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1011 </screenshot>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1012
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1013 <orderedlist>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1014 <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
1015 <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
1016 <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
1017 <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
1018 <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
1019 <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
1020 <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
1021 <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
1022 <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
1023 </orderedlist>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1024
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1025 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1026 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
1027 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
1028 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
1029 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
1030 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1031
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1032 <screenshot>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1033 <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
1034 <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
1035 <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
1036 <textobject>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1037 <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
1038 </textobject>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1039 <caption>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1040 <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
1041 "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
1042 endurance your character has.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1043 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1044 </caption>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1045 </mediaobject>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1046 </screenshot>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1047
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
1048 </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
1049
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 <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
1053 <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
1054 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
1055 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
1056 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
1057 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
1058 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
1059 </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
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 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
1062 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
1063 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
1064
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1065 <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
1066
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 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
1068 "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
1069 (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
1070 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
1071 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
1072 </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
1073
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 <orderedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1075 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1076 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1077 <userinput>/gprompt &gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1078 Set prompt to show only "&gt;" and nothing more.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1079 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1080 </listitem>
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 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1083 <userinput>/gprompt %{status_cast}&gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1084 Show currently in-progress skill or spell in prompt.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1085 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1086 </listitem>
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 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1089 <userinput>/gprompt @{BCred}%{status_cast}@{n}@{BCwhite}&gt;@{n}</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1090 TinyFugue color attributes can be used also.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1091 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1092 </listitem>
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 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1095 <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
1096 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
1097 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
1098 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1099 </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
1100 </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
1101
1075
122c463704e1 Add note about /gprompt attribute formatting not working with earlier betas of TF5.
Matti Hamalainen <ccr@tnsp.org>
parents: 1074
diff changeset
1102 <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
1103 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
1104 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
1105 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
1106 </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
1107
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
1108 <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
1109 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
1110 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
1111 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
1112 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
1113 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
1114 ("&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
1115
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1116 <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
1117
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 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
1119
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1120 <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
1121
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1122 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
1123 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
1124 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
1125 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
1126 </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
1127
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 <orderedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1129 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1130 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1131 <userinput>/gprompt %{status_prompt}&gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1132 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
1133 greater than sign in the end.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1134 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1135 </listitem>
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 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1138 <userinput>/gprompt @{BCgreen}%{status_prompt}@{n}&gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1139 Same as above, but coloured bright green.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1140 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1141 </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
1142 </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
1143
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 <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
1145 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
1146 "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
1147 </para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1148
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1149 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1150
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
1151
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1152 <!-- ================================================ -->
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 <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
1155 <para>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1156 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
1157 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
1158 retrieval. Settings get saved and thus restored later,
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1159 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
1160 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
1161 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
1162 How to do this is discussed further below.
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1163 </para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1164
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1165 <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
1166 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1167 <emphasis>Almost</emphasis> all settings (hidden or visible)
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1168 get saved, but there are certain global settings that you
391
Matti Hamalainen <ccr@tnsp.org>
parents: 390
diff changeset
1169 have to set yourself in your TF configuration. These
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1170 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
1171 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1172
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1173 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1174 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
1175 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
1176 different files</emphasis>. In GgrTF, these two types of data
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1177 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
1178 two savefiles are named accordingly. Pre-init settings are
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1179 variables that need to be defined before the main modules
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1180 of GgrTF are loaded in TF's startup configuration (certain
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1181 functionality depends on this). Post-init variables can
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1182 (and sometimes <emphasis>must</emphasis>) be set after loading
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1183 of all modules.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1184 </para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1185 </section>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1186
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1187 <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
1188 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1189 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
1190 set yourself in your TF's startup configuration (.tfrc).
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1191 These variables <emphasis>MUST</emphasis> be set before loading
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1192 of ANY GgrTF modules, otherwise things start breaking and the
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1193 state-saving system does not work correctly.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1194 </para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1195
1052
3f0fec339dcb Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1049
diff changeset
1196 <table><title>Special, non-saved variables</title>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1197 <tgroup cols="3" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1198 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1199 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1200 <entry>Variable</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1201 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1202 <entry>Example</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1203 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1204 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1205 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1206 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1207 <entry>set_plrname</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1208 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1209 Your character's name, written in correct case.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1210 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1211 <entry>/set set_plrname=Ggr</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1212 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1213
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1214 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1215 <entry>set_datapath</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1216 <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
1217 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
1218 from.)</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1219 <entry>/set set_datapath=</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1220 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1221
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1222 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1223 <entry>set_saveprefix</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1224 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1225 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
1226 savefiles are "<emphasis>&lt;prefix&gt;pre.tf</emphasis>" and
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1227 "<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
1228 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
1229 for either.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1230 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1231 <entry>/set set_saveprefix=bat-</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1232 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1233
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1234 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1235 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1236 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1237
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1238 </section>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1239
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1240
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1241 <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
1242 <para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1243 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
1244 TF configuration, and possibly setting up a savefile directory
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1245 </para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1246
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1247 <para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1248 A simplified example configuration layout is presented below with only
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1249 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
1250 <link linkend="inst-config-tf">setup</link>-section of this
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1251 manual for a more detailed example. Pay close attention to the order
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1252 how things are done, it is very important!
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1253 </para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1254
950
a6e6295d3557 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 944
diff changeset
1255 <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
1256 /eval /set set_datapath=%{HOME}/.ggrtf/
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1257
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1258 ;; 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
1259 /eval /set set_saveprefix=bat-
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1260
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1261 ;; Load the special pre-init module which loads pre-init
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1262 ;; settings from the savefiles. This needs to be done
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1263 ;; before loading any other GgrTF modules.
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1264 /gloadmod ggrtf-pre.tf
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1265
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1266 ;; Load GgrTF core module
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1267 /gloadmod ggrtf.tf
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1268
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1269 ;; Load other additional modules
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
1270 /gloadmod gm-magical.tf
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1271 ; etc etc.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1272
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1273 ;; Load and restore other previously saved settings.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1274 ;; This should be done after loading any GgrTF modules.
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1275 /gload
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1276 </screen>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1277
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1278 <para>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1279 When you have edited your TF configuration, you need to (re-)start
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1280 it, change settings the way you want them to be and finally issue
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1281 "/gsave" command to get settings saved. <emphasis>After saving,
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1282 you may also want to examine the pre-init -savefile, because it
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1283 contains certain settings that cannot be changed run-time
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1284 </emphasis>. So, here are the steps in short again:
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1285 </para>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1286
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1287 <orderedlist>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1288 <listitem><para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1289 <emphasis>Edit TF configuration (see example above)</emphasis>:
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1290 Add <emphasis>set_datapath</emphasis>, <emphasis>set_saveprefix</emphasis>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1291 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
1292 and <emphasis>/gload</emphasis> command.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1293 </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
1294 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1295 <emphasis>Re-start TF</emphasis>:
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1296 In order to create the initial savefiles with default settings,
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1297 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
1298 </para></listitem>
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1299 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1300 <emphasis>Change settings</emphasis>:
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1301 Change GgrTF settings (listed via /opts etc.) to accommodate
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1302 your desires.
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1303 </para></listitem>
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1304 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1305 <emphasis>Save initial settings</emphasis>:
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1306 Issue "/gsave" to get settings saved.
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1307 </para></listitem>
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1308 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1309 <emphasis>Optionally edit pre-init settings</emphasis>:
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1310 Certain settings are saved into the pre-init savefile (actual
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1311 filename is dependant on what you set "set_saveprefix" to).
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1312 GgrTF does not offer any special interface to change these settings,
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1313 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
1314 </para></listitem>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1315 </orderedlist>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1316
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1317 </section>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1318
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1319 <section><title>How to make state-saving automatic</title>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1320 <para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1321 In previous example, I only described how settings get restored
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1322 (as TF loads and initializes GgrTF), but how to get settings
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1323 saved automatically too?
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1324 </para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1325
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1326 <para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1327 The answer lies in &tfurl;'s event hooks. It is possible to
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1328 define a hook, which is executed when TF disconnects from a world.
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1329 By setting this hook to perform "/gsave", we can automatize the
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1330 process of saving settings. Add following line to your TF configuration:
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1331
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1332 <userinput>/def -hDISCONNECT mydisconnect = /gsave</userinput>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1333
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1334 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
1335 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
1336
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1337 <userinput>/def -hDISCONNECT mydisconnect = /greset%;/gsave</userinput>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1338
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1339 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1340
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1341 </section>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1342
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1343
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1344 &sectmacros_2;
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1345 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1346 <entry>/gsave</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1347 <entry>
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
1348 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
1349 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1350 </row>
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 <entry>/gload</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1353 <entry>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1354 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
1355 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
1356 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1357 </row>
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 <entry>/greset</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1360 <entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1361 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
1362 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
1363 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
1364 restored on next /gload.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1365 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1366 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1367 &sectmacros_end;
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
1368
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1369 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1370
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
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1373 <section id="usage-general-binds"><title>Command bindings</title>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1374 <para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1375 GgrTF's core provides few macros for defining "bindings", which
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1376 are a way to create commands that look like normal MUD commands
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1377 but are actually intercepted by &tfurl; and executed appropriately.
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1378 These bindings can be used to easily define shorthands for casting
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1379 spells, using skills, executing macros, etc. GgrTF bindings offer
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1380 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
1381 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
1382 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
1383 extra abilities (but also with some limitations.)</emphasis>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1384 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1385
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1386 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1387 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
1388 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
1389 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
1390 with a setting ("opt_bindings"). See below section <link
807
043927590bef Change headlines.
Matti Hamalainen <ccr@tnsp.org>
parents: 806
diff changeset
1391 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
1392 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1393
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1394 <para>
994
c40eabb80393 Add few lines of explanation about bindings.
Matti Hamalainen <ccr@tnsp.org>
parents: 988
diff changeset
1395 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
1396 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
1397 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
1398 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
1399 redefine lots just because you are reincarnating... and you can not execute
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1400 macros with command aliases.
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1401 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1402
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1403 <para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1404 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
1405 drawbacks:
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1406 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1407
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1408 <itemizedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1409 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1410 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1411 <emphasis>Limitations of TF's parsing</emphasis>:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1412 Because of the nature how bindings are defined and parsed,
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1413 you can only use one binded command per line.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1414 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
1415 and "clair" is a binding to use clairvoyance. Thus, someone
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1416 might want to command:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1417
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1418 <userinput>aoa ggr%;clair</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1419
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1420 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
1421 not evaluate binding as an expression, the "ggr%;clair"-part
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1422 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
1423 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
1424 </para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1425 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1426
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1427 <listitem>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1428 <para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1429 <emphasis>BatMUD commands and GgrTF bindings cannot be mixed</emphasis>:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1430 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
1431 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
1432 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
1433 and "hop" is an emote:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1434
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1435 <userinput>hop jeskko;aoa ggr</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1436
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1437 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
1438 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
1439 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
1440 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
1441 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
1442 </para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1443 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1444
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1445 <listitem>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1446 <para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1447 <emphasis>Limitations of GgrTF's binding system</emphasis>:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1448 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
1449 with the current functionality provided by GgrTF. Bindings that
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1450 require complex parameters (more than one optional argument),
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1451 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
1452 aliases for those.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1453 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1454 </listitem>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1455 </itemizedlist>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1456
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1457
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1458 <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
1459 <para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1460 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
1461 command bindings!
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1462 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1463
950
a6e6295d3557 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 944
diff changeset
1464 <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
1465 /prdefcbind -s"nf" -c"Neutralize Field" -n
950
a6e6295d3557 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 944
diff changeset
1466 /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
1467
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1468 <para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1469 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
1470 macros supported by GgrTF. First defines a generic command binding
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1471 to execute "/ceremony" macro when user commands "cere".
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1472 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
1473 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
1474 usage command to use "Fire Building". So basically we have
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1475 three types of bindings:
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1476 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1477
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1478 <itemizedlist>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1479 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1480 <emphasis>/prdefgbind</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1481 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
1482 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
1483 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1484
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1485 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1486 <emphasis>/prdefcbind</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1487 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
1488 to be casted.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1489 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1490
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1491 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1492 <emphasis>/prdefsbind</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1493 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
1494 skill to be executed.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1495 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1496 </itemizedlist>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1497
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1498 <para>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1499 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
1500 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
1501 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
1502 command binding to be defined. The argument options and their
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1503 meanings are listed below:
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1504 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1505
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1506 <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
1507 <tgroup cols="2" align="left">
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1508 <thead>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1509 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1510 <entry>Option</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1511 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1512 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1513 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1514 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1515 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1516 <entry>-s"name"</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1517 <entry>Specifies the name of the command binding.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1518 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
1519 after which come the optional arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1520 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1521 </row>
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 <entry>-n</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1524 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1525 Tells GgrTF that the binding does NOT accept arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1526 Anything following the command binding invocation is ignored.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1527 This also affects the possible reporting output of the binding.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1528 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1529 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1530 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1531 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1532 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1533
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1534 <table><title>Arguments specific to generic bindings (/prdefgbind)</title>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1535 <tgroup cols="2" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1536 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1537 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1538 <entry>Option</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1539 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1540 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1541 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1542 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1543 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1544 <entry>-c"action"</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1545 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1546 Specifies the action, aka what the binding <emphasis>does</emphasis>.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1547 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
1548 TF macro or BatMUD command.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1549 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1550 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1551 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1552 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1553 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1554
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1555 <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
1556 <tgroup cols="2" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1557 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1558 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1559 <entry>Option</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1560 <entry>Description</entry>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1561 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1562 </thead>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1563 <tbody>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1564 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1565 <entry>-c"action"</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1566 <entry>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1567 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
1568 </entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1569 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1570 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1571 <entry>-d"message"</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1572 <entry>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1573 This option overrides the default message string used for reporting
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1574 (see also option "-q" below).
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1575 </entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1576 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1577 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1578 <entry>-q</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1579 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1580 Makes the binding "quiet", suppresses any reporting. By default,
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1581 spell casting binding reports the action on party report-channel,
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1582 but specifying this option disables it.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1583 </entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1584 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1585 </tbody>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1586 </tgroup>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1587 </table>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1588
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1589 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1590 More examples, now with short explanations:
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1591 </para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1592
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1593 <table><title>Binding defination examples</title>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1594 <tgroup cols="2" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1595 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1596 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1597 <entry>Definition</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1598 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1599 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1600 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1601 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1602 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1603 <entry>/prdefgbind -s"repu" -c"/showrep" -n</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1604 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1605 Generic binding, which executes /showrep macro and takes no arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1606 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1607 </row>
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 <entry>/prdefsbind -s"er" -c"Enrage" -n</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1610 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1611 Skill binding for barbarian "Enrage" skill. Also takes no
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1612 arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1613 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1614 </row>
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 <entry>/prdefcbind -s"shelter" -c"Shelter" -n -d"Sheltering ..."</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1617 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1618 Spell casting binding, for casting conjurer spell "Shelter".
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1619 Takes no arguments and uses specific reporting string (default
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1620 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
1621 use "Sheltering ..." instead.)
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1622 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1623 </row>
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 <entry>/prdefcbind -s"dmp" -c"Dispel Magical Protection"</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1626 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1627 Another spell casting binding for a conjurer spell, which takes
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1628 (and requires) a player's name as argument.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1629 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1630 </row>
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 <entry>/prdefcbind -s"sl" -c"Star Light" -q</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1633 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1634 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
1635 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
1636 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
1637 accepted.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1638 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1639 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1640 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1641 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1642 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1643
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1644 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1645 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
1646 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
1647 </para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1648
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1649 </section>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1650
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1651
807
043927590bef Change headlines.
Matti Hamalainen <ccr@tnsp.org>
parents: 806
diff changeset
1652 <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
1653 <para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1654 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
1655 /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
1656 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
1657 </para>
806
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1658 <para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1659 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
1660 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
1661 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
1662 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
1663 .tfrc.
806
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1664 </para>
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 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
1667 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
1668 <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
1669 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
1670 for more information.
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1671 </para>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1672 </section>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1673
995
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1674 <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
1675 <para>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1676 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
1677 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
1678 </para>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1679 <screen>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1680 ,----------------.
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1681 | GgrTF Bindings |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1682 +----------------+----------------------------------------------------.
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1683 | pprots | G | /pprots | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1684 | rpouch | G | /rpouch | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1685 | ad | C | Aura Detection | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1686 | invis | C | Invisibility | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1687 | float | C | Floating | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1688 | ww | C | Water Walking | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1689 | seeinvis | C | See Invisible | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1690 | seemagic | C | See Magic | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1691 | cere | G | /ceremony | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1692 | curses | G | /curses | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1693 | prots | G | /prots | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1694 `---------------------------------------------------------------------'
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1695 </screen>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1696 <itemizedlist>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1697 <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
1698 <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
1699 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
1700 <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
1701 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
1702 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
1703 command executed.</para></listitem>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1704 <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
1705 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
1706 question mark ("?") instead.</para></listitem>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1707 </itemizedlist>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1708
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1709 </section>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1710
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1711 </section>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1712
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1713 <!-- ================================================ -->
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1714
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
1715 <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
1716 <para>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1717 GgrTF provides a mechanism for routing keyboard numpad bindings so that
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1718 different functionality can be swapped in as needed. Core module offers
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1719 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
1720 automatic peering to adjacent directions, useful for <link
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1721 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
1722
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1723 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
1724 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
1725 <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
1726 modules, for example.)
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1727 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1728
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1729 <note>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1730 <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
1731 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
1732 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
1733 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
1734 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
1735 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
1736 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
1737 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
1738 </para>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1739 </note>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1740
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1741 &sectmacros_2;
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1742 <row>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1743 <entry>/move [setting]</entry>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1744 <entry>Set the mode used for numpad bindings. Valid values are
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1745 shown if command is given without arguments. Core GgrTF module
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1746 provides following three modes: <emphasis>move</emphasis>,
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1747 <emphasis>peer</emphasis> and <emphasis>ship</emphasis>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1748 </entry>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1749 </row>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1750
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1751 <row>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1752 <entry>/peer [regexp]</entry>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1753 <entry>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1754 Set the regular expression used for grepping the output of 'peer'
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1755 command used in "/move peer" mode.
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1756 </entry>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1757 </row>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1758
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1759 <row>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1760 <entry>/cruise</entry>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1761 <entry>Toggle ship cruising speed on/off (off = sail)</entry>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1762 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1763 &sectmacros_end;
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1764
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1765 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1766
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 <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
1770 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1771 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
1772 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
1773 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
1774 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
1775 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1776
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1777 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1778 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
1779 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
1780 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
1781 (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
1782 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
1783 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
1784 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
1785 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
1786 for prot reporting triggers.)
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1787 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1788
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1789 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1790 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
1791 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1792
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1793 <itemizedlist>
584
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1794 <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
1795 <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
1796 <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
1797 <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
1798 <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
1799 <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
1800 <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
1801 <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
1802 <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
1803 <listitem><para>etc...</para></listitem>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1804 </itemizedlist>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1805
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1806 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1807 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
1808 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
1809 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
1810 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
1811 line character (sometimes called the pipe).
787
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
1812 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
1813 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1814
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1815 <table><title>Prot entries</title>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1816 <tgroup cols="2" align="left">
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1817 <thead>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1818 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1819 <entry>Entry</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1820 <entry>Description</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1821 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1822 </thead>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1823 <tbody>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1824 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1825 <entry>Unst[1m9s]</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1826 <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
1827 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1828 <row>
787
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
1829 <entry>+AoA[7m19s]</entry>
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
1830 <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
1831 </row>
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 <entry>Infra(2)[0m2s]</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1834 <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
1835 </row>
584
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1836 <row>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1837 <entry>Unst&lt;2&gt;[7m19s]</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1838 <entry>Unstun that has been weakened 2 times.</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1839 </row>
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 <entry>-Forget[3m5s]</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1842 <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
1843 </row>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1844 </tbody>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1845 </tgroup>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1846 </table>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1847
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1848 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1849 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
1850 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1851
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1852 <screen>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1853 <userinput>tweak jeskko</userinput>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1854
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1855 You tweak Jeskko's nose mischievously.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1856 Jeskko [report]: Unst[1h1m13s]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1857
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1858 <userinput>unp jeskko</userinput>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1859
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1860 Ggr [report]: Unpain -&gt; jeskko
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1861 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
1862 GgrTF: 'unpain' -&gt; jeskko
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1863 Unpain: ##### [5]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1864 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
1865 Unpain: ## [2]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1866 Unpain: # [1]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1867 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
1868 You utter the magic words (unpain)
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1869 You cast the spell successfully.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1870 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
1871 Jeskko [report]: Unpain ON!
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1872
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1873 <userinput>tweak jeskko</userinput>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1874
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1875 You tweak Jeskko's nose mischievously.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1876 Jeskko [report]: Unst[1h4m25s] | Unp[2m35s]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1877 </screen>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1878
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1879
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1880 &sectmacros_2;
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1881 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1882 <entry>/prots</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1883 <entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1884 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
1885 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
1886 report-channel.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1887 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1888 </row>
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 <entry>/cprots</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1891 <entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1892 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
1893 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
1894 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
1895 discretion.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1896 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1897 </row>
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 <entry>tweak &lt;target&gt;</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1900 <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
1901 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
1902 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
1903 </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
1904 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1905 &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
1906
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 </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
1908
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 <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
1912 <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
1913 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
1914 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
1915 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
1916 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
1917 </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
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 <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
1920 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
1921 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
1922 </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
1923 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
1924 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
1925 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
1926 </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
1927
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1928 &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
1929 <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
1930 <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
1931 <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 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
1933 </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
1934 </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
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 <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
1937 <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 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
1939 </entry>
1203
796e24a218a4 Oops, a </row> tag was missing.
Matti Hamalainen <ccr@tnsp.org>
parents: 1202
diff changeset
1940 </row>
1157
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1941 <row>
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1942 <entry>/cursewarn</entry>
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1943 <entry>
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1944 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
1945 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
1946 (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
1947 </entry>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1948 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1949 &sectmacros_end;
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1950
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1951 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1952
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
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1955 <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
1956
1222
9c89e20131df Comment out a warning.
Matti Hamalainen <ccr@tnsp.org>
parents: 1220
diff changeset
1957 <!--
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1958 <note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1959 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1960 <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
1961 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
1962 you can send complaints to nearest trashbin.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1963 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1964 </note>
1222
9c89e20131df Comment out a warning.
Matti Hamalainen <ccr@tnsp.org>
parents: 1220
diff changeset
1965 -->
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1966
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1967 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1968 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
1969 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
1970 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
1971 (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
1972 so called "zero round").
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1973 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1974
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1975 <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
1976 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
1977 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
1978 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
1979 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
1980 "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
1981 not always match the real ones.
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1982 <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
1983 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
1984 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1985
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1986 <note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1987 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1988 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
1989 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
1990 </para>
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 <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
1993 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
1994 add that to your eqset swapping commands.
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1995 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1996 </note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1997
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 <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
2000 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2001 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
2002 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
2003 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
2004 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
2005 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2006
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2007 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2008 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
2009 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2010
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2011 <itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2012 <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
2013 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
2014 frequency.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2015 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2016
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2017 <listitem><para>One tick is always 10 heartbeats.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2018 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2019
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2020 <listitem><para>Battle rounds are always around ~3s,
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2021 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
2022 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2023
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2024 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2025 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
2026 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
2027 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2028 </itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2029
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2030 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2031 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
2032 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2033
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2034 <orderedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2035 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2036 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
2037 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2038
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2039 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2040 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
2041 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
2042 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
2043 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
2044 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2045
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2046 <listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2047
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2048 <para>In gheartbeat_timer() we check for:</para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2049 <itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2050 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2051 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
2052 if it was "too long" ago.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2053 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2054 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2055 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
2056 long ago.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2057 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2058 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2059 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
2060 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2061 </itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2062
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2063 </listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2064
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2065 </orderedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2066
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2067 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2068 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
2069 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
2070 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
2071 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2072
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2073 <note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2074 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2075 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
2076 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
2077 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2078 </note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2079
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2080 </section>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2081
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2082 </section>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2083
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
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2086 <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
2087 <para>
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 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2090
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
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2093 <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
2094 <para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2095 Base module for all things magical. This module is <emphasis>required</emphasis>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2096 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
2097 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
2098 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
2099 </para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2100
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2101 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2102 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
2103 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
2104 at all times.
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2105 </para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2106
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2107 <itemizedlist>
890
a864a635d545 Add information about resist reporting, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 889
diff changeset
2108 <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
2109 (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
2110 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2111 <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
2112 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
2113 until your spell goes off.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2114 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2115 </itemizedlist>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2116
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2117 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2118
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2119 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2120
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2121 <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
2122 <para>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2123 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
2124 <emphasis>pss</emphasis> (<emphasis>party status short</emphasis>)
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2125 -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
2126 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
2127 status information in compact format.
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2128 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2129
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2130 <para>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2131 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
2132 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
2133 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
2134 unconsciousness, stun, formation, etc.</emphasis>.
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2135 </para>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2136
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2137 <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
2138 </emphasis> when in stunned or unconscious state, but this is normally
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2139 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
2140 </para>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2141
261
2b18754a1f01 Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 260
diff changeset
2142 <para>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2143 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
2144 <link linkend="usage-general-commands">/autopss</link> option). A normally issued
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2145 '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
2146 <emphasis>/pss</emphasis> macro or bind that to 'pss'. (See <link
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2147 linkend="usage-general-binds">Bindings</link>-section for more information.)
261
2b18754a1f01 Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 260
diff changeset
2148 </para>
2b18754a1f01 Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 260
diff changeset
2149
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2150 <screenshot>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2151 <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
2152 <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
2153 <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
2154 <textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2155 <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
2156 </textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2157 <caption>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2158 <para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2159 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
2160 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
2161 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
2162 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2163 </caption>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2164 </mediaobject>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2165 </screenshot>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2166
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2167 <screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2168 <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
2169 <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
2170 <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
2171 <textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2172 <phrase>Stunned</phrase>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2173 </textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2174 <caption>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2175 <para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2176 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
2177 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
2178 (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
2179 (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
2180 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
2181 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2182 </caption>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2183 </mediaobject>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2184 </screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2185
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2186 <screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2187 <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
2188 <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
2189 <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
2190 <textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2191 <phrase>Unconscious</phrase>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2192 </textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2193 <caption>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2194 <para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2195 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
2196 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
2197 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
2198 hopefully catching your attention.
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2199 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2200 </caption>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2201 </mediaobject>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2202 </screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2203
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2204
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2205 <section><title>HP/SP/EP colours</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2206 <para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2207 List of possible indicator colours and their meanings. &colourexplanation;
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2208 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2209
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2210
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2211 <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
2212 <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
2213 <thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2214 <row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2215 <entry>Colour</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2216 <entry>Background</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2217 <entry>Explanation</entry>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2218 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2219 </thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2220 <tbody>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2221 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2222 <entry>Bright White</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2223 <entry>Bright Red</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2224 <entry>Negative value (x &lt; 0)</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2225 </row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2226 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2227 <entry>Bright Red</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2228 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2229 <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
2230 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2231 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2232 <entry>Red (dark)</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2233 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2234 <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
2235 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2236 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2237 <entry>Yellow (dark)</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2238 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2239 <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
2240 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2241 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2242 <entry>Bright Yellow</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2243 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2244 <entry>Less than 66% of max</entry>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2245 </row>
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 <entry>Green (dark)</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2248 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2249 <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
2250 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2251 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2252 <entry>Bright Green</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2253 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2254 <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
2255 </row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2256 </tbody>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2257 </tgroup>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2258 </table>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2259 </section>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2260
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2261 <section><title>Player name colours</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2262 <para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2263 List of possible name colours and their meanings. &colourexplanation;
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2264 </para>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2265
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2266 <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
2267 <tgroup cols="3" align="left">
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2268 <thead>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2269 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2270 <entry>Colour</entry>
272
Matti Hamalainen <ccr@tnsp.org>
parents: 271
diff changeset
2271 <entry>Background</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2272 <entry>State description</entry>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2273 </row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2274 </thead>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2275 <tbody>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2276 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2277 <entry>Bright White</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2278 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2279 <entry>Normal</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2280 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2281 <row>
1596
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2282 <entry>Bright Black</entry>
849
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2283 <entry>-</entry>
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2284 <entry>Idle</entry>
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2285 </row>
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2286 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2287 <entry>Bright White</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2288 <entry>Bright Red</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2289 <entry>Unconscious (unc)</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2290 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2291 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2292 <entry>Bright Red</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2293 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2294 <entry>Stunned (stun)</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2295 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2296 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2297 <entry>Magenta</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2298 <entry>-</entry>
1596
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2299 <entry>In form (form), or member (mbr)</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2300 </row>
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 <entry>Cyan</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2303 <entry>-</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2304 <entry>Resting/camping/meditating (rest)</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2305 </row>
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 <entry>Bright White</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2308 <entry>Blue</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2309 <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
2310 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2311 &sectmacros_end;
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2312
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
2313 <section>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2314 &sectmacros_1;
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
2315 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2316
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2317 <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
2318 <tgroup cols="2" align="left">
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2319 <thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2320 <row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2321 <entry>Command</entry>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2322 <entry>Description</entry>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2323 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2324 </thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2325 <tbody>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2326 <row>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2327 <entry>/prettypss</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2328 <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
2329 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
2330 </row>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2331 <row>
449
725695d31f21 Updated /pstatus -> pss and /pss -> /autopss accordingly.
Matti Hamalainen <ccr@tnsp.org>
parents: 422
diff changeset
2332 <entry>/pss</entry>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2333 <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
2334 </row>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2335 <row>
449
725695d31f21 Updated /pstatus -> pss and /pss -> /autopss accordingly.
Matti Hamalainen <ccr@tnsp.org>
parents: 422
diff changeset
2336 <entry>/autopss</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2337 <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
2338 </row>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2339 <row>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2340 <entry>/fullparty</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2341 <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
2342 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
2343 are shown.</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2344 </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
2345 <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
2346 <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
2347 <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
2348 </row>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2349 </tbody>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2350 </tgroup>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2351 </table>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2352 </section>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2353
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2354 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2355
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2356 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2357
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2358 <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
2359 <para>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2360 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
2361 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
2362 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
2363 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
2364 '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
2365 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
2366 </para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2367
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2368 <para>
1385
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2369 <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
2370 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
2371 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
2372 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
2373 </emphasis>
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2374 </para>
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2375
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2376 <para>
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2377 NOTICE! This module requires
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2378 <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
2379 </para>
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2380
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2381 &sectmacros_2;
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2382 <row>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2383 <entry>/ppsave</entry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2384 <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
2385 in current formation are stored.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2386 </entry>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2387 </row>
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2388 <row>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2389 <entry>/ppreset</entry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2390 <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
2391 previously. Restoring occurs fully automatically.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2392 </entry>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2393 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2394 &sectmacros_end;
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2395
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2396 </section>
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2397
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
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2400 <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
2401 <note><para>
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2402 <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
2403 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
2404 </emphasis>
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2405 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
2406 </para></note>
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2407
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2408 <para>
1099
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2409 Module for showing prots (and similar effects) affecting your party members.
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2410 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
2411 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
2412 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
2413 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
2414 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
2415 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
2416 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
2417 time is shown.</emphasis>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2418 </para>
1099
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2419 <note><para>
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2420 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
2421 party members to use <emphasis>working, non-broken</emphasis> triggers
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2422 which use up/down messages that are recognizable to the ptracker module.
1225
9157e2a5441e Clarification.
Matti Hamalainen <ccr@tnsp.org>
parents: 1224
diff changeset
2423 However, this does not affect 'show effects' mode in any way.
1099
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2424 </para></note>
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2425
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2426 <screen>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2427 .------------+-----+-----+-----+-----+-----+-----+-----+-----+
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2428 | | 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
2429 +------------+-----+-----+-----+-----+-----+-----+-----+-----+
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2430 |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
2431 |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
2432 |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
2433 |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
2434 |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
2435 |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
2436 |Jrj | | | | | | 6:22| | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2437 |Daria | | | | | | | | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2438 |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
2439 `------------+-----+-----+-----+-----+-----+-----+-----+-----+
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2440 </screen>
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2441
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2442 <para>
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2443 <emphasis>NOTICE! This module requires
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2444 <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
2445 </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
2446 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
2447 and prot tracker.
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2448 </para>
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2449
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
2450 <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
2451 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
2452 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
2453 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
2454 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
2455 </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
2456
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2457 <!-- @commands -->
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2458 <!-- @binds -->
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2459 <!-- @keybinds -->
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2460
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2461 </section>
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2462
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
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2465 <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
2466 <para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2467 This module adds in translating of spellwords to actual spell names.
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2468 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
2469 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
2470 under GPL with permission.
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2471 </para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2472
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2473 <para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2474 The translator works by printing the spell name in parentheses
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2475 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
2476 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
2477 </para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2478
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2479 <para>
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2480 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
2481 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
2482 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
2483 otherwise interesting spells are cast.
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2484 </para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2485
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2486 <para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2487 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
2488 </para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2489
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2490 <screen>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2491 You utter the magic words (unstun)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2492
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2493 You utter the magic words 'Paxus' (unstun)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2494
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2495 Acolyte waves his index finger while uttering (flame arrow)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2496
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2497 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
2498 </screen>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2499
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2500 <!-- @commands -->
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2501
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2502 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2503
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2504 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2505
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2506 <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
2507 <para>
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
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2510 <note>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2511 <para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2512 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
2513 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2514 </note>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2515
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2516 </section>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2517
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
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2520 <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
2521 <para>
262
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2522 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
2523 differences, several exceptions and workarounds are needed to
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2524 improve GgrTF's compatibility with the HCBat environment.
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2525 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
2526 </para>
262
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2527
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2528 <para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2529 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
2530 to contain almost everything related to peculiarities and
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2531 differences of HCBat. We do not have separate
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2532 guild-specific modules for HCBat, the code needed to
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2533 catch the differences is either in this module or in some
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2534 special cases in the guild-specific modules.
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2535 </para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2536
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2537 <para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2538 At the moment this module is rather simple, only replacing
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2539 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
2540 -channel in HCBat. In future more functionality may be added,
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2541 feel free to report bugs/incompatibilities to us.
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2542 </para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2543
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2544 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2545
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2546 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2547
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2548 <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
2549 <para>
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2550 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
2551 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
2552 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
2553 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
2554 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2555
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2556 <note>
642
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
2557 <para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2558 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
2559 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
2560 </para>
1598
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2561 <para>
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2562 <emphasis>The functionality of the statusline depends on
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2563 your <link linkend="inst-config-batmud">BatMUD settings</link>
1601
fcb56c908184 Oops, 100L.
Matti Hamalainen <ccr@tnsp.org>
parents: 1598
diff changeset
2564 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
2565 not appear, most likely your 'sc' setting is "wrong",
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2566 and thus does not get parsed by GgrTF.
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2567 </para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2568 </note>
642
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
2569
638
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2570 <screenshot>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2571 <mediaobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2572 <imageobject><imagedata fileref="statusbar_tf5.gif" format="GIF" /></imageobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2573 <imageobject><imagedata fileref="statusbar_tf5.eps" format="EPS" /></imageobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2574 <textobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2575 <phrase>GgrTF statusline</phrase>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2576 </textobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2577 <caption>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2578 <para>Example of typical basic GgrTF statusline in TF5.</para>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2579 </caption>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2580 </mediaobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2581 </screenshot>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2582
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2583 <itemizedlist>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2584 <listitem><para>
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2585 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
2586 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
2587 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
2588 </para></listitem>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2589
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2590 </itemizedlist>
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2591
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 - example configuration
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2594 - document special variables
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2595 -->
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2596 </section>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2597
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
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2600 <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
2601 <para>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2602 This module contains utility functionality for everyone who casts
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2603 different types of dead raising spells, including "raise dead",
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2604 "resurrect", "new body", "reincarnation", etc.
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2605 </para>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2606
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2607 <para>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2608 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
2609 from you, along with information what spell was requested. List can
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2610 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
2611 specifying a player's name, cast his/her request.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2612 </para>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2613
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2614 <para>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2615 You can either directly use the macros or use <link
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2616 linkend="usage-general-binds">command bindings</link>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2617 to have shorthand commands instead.
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2618 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2619
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2620 <screenshot>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2621 <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
2622 <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
2623 <imageobject><imagedata fileref="rais_list.eps" format="EPS" /></imageobject>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2624 <textobject>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2625 <phrase>List of accepts</phrase>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2626 </textobject>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2627 <caption>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2628 <para>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2629 An example output of "/aclist" macro, listing the players
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2630 who have accepted services from you and respective requested
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2631 spells for each. The time field shows how much
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2632 time has passed from the accept.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2633 </para>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2634 </caption>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2635 </mediaobject>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2636 </screenshot>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2637
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2638 <table><title>Macro commands</title>
1545
fe83084ff7e1 Fix some table column width.
Matti Hamalainen <ccr@tnsp.org>
parents: 1544
diff changeset
2639 <tgroup cols="2" align="left">
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2640 <thead>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2641 <row>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2642 <entry>Command</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2643 <entry>Description</entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2644 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2645 </thead>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2646 <tbody>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2647 <row>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2648 <entry>/aclist</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2649 <entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2650 View list of people who have accepted something from you.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2651 </entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2652 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2653 <row>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2654 <entry>/accast [name]</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2655 <entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2656 Cast Last-type functionality. Without arguments casts the LATEST
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2657 requested spell. Optionally you can specify a name of the player
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2658 and the spell requested by him/her is cast.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2659 </entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2660 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2661 <row>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2662 <entry>/acclear</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2663 <entry>
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2664 Clears the list. Useful, if the automatic removal
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2665 malfunctions for some reason. (For example, if target
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2666 uses 'pray' to become alive again, there is no message
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2667 provided to the caster.)
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2668 </entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2669 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2670 </tbody>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2671 </tgroup>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2672 </table>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2673
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2674 <!-- @binds -->
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2675
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2676 </section>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2677
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2678 <!-- ================================================ -->
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2679
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2680 <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
2681 <para>
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2682 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
2683 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
2684 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
2685 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
2686 of hits you mostly deal out.
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2687 </para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2688
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2689 <para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2690 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
2691 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
2692 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
2693 </para>
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2694
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2695 <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
2696 <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
2697
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
2698 <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
2699 <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
2700 <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
2701 <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
2702 <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
2703 <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
2704 <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
2705 <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
2706 <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
2707 <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
2708 </itemizedlist>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2709
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2710 <note><para>
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2711 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
2712 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
2713 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
2714 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
2715 </emphasis>
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2716 </para></note>
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2717
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2718 <para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2719 Example of /hstats output:
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2720 </para>
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2721 <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
2722 ,----------------------.
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 | 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
2724 +-----------------------------------------------.
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 +-| 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
2726 |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
2727 |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
2728 |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
2729 |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
2730 |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
2731 |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
2732 | |
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 +-| 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
2735 | 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
2736 | 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
2737 +----------------------------------------------+-------'
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 | 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
2739 | 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
2740 | 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
2741 `----------------------------------------------'
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2742 </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
2743
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2744 <para>
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2745 Format of hits described above is:
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2746 | 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
2747 </para>
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2748
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2749 <note><para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2750 <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
2751 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
2752 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
2753 </para></note>
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2754
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
2755 <!-- @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
2756 <!-- @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
2757 <!-- @keybinds -->
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2758
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2759 </section>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2760
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
1377
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2763 <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
2764 <para>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2765 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
2766 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
2767 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
2768 </para>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2769
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2770 <para>
1563
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2771 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
2772 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
2773 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
2774 </para>
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2775
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2776 <para>
1377
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2777 Example of output:
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2778 </para>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2779 <screen>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2780 +-| General |----------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2781 | Item....: a pair of stylish blue breeches |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2782 | Name....: blue breeches |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2783 | Handles.: 'breeches', 'stylish blue breeches', 'silk breeches' and |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2784 | 'pants' |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2785 | Names...: Molotov, Belse and Ekkivekki |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2786 | Slots...: leg and leg |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2787 | Material: silk |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2788 +----------------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2789 | 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
2790 | Size....: somewhat small | Maxcond..: AWESOME |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2791 | Worth...: 8851 | Quality..: superb |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2792 | Weight..: almost weightless | Weight/kg: 0.050 |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2793 +-| Stats |------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2794 | insignificantly improve your wis |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2795 +-| Misc |-------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2796 | 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
2797 | 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
2798 | Wielded.: |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2799 +----------------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2800 </screen>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2801
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2802 <!-- @commands -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2803 <!-- @binds -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2804 <!-- @keybinds -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2805
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2806 </section>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2807
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
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2810 <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
2811 <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
2812 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
2813 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
2814 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
2815 </para>
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2816
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2817 <para>
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2818 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
2819 </para>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2820 <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
2821 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
2822 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
2823 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
2824 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
2825 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
2826 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
2827 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
2828 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
2829 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
2830 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
2831 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
2832 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
2833 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
2834 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
2835 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
2836 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
2837 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
2838 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
2839 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
2840 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
2841 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
2842 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
2843 It looks very very heavy.
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2844 </screen>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2845
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2846 <note><para>
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2847 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
2848 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
2849 this module.
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2850 </para></note>
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2851
1563
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2852 <!-- @commands -->
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2853
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2854 </section>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2855
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
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2858 <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
2859 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2860 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
2861 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
2862 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
2863 <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
2864 </para>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2865
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2866 <itemizedlist>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2867 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2868 <emphasis>Channeller aura</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2869 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
2870 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
2871 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
2872 to recharge.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2873 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2874 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2875 <emphasis>Blast resistance reporting</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2876 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
2877 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
2878 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2879 <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
2880 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
2881 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2882 </itemizedlist>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2883
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2884 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2885 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2886 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2887
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2888 </section>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2889
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 <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
2893 <para>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2894 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
2895 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
2896 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2897
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2898 <note><para>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2899 This module requires the generic
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2900 <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
2901 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
2902 </para></note>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2903
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2904 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2905 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2906 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2907
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2908 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2909
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2910 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2911
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2912 <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
2913 <para>
263
Matti Hamalainen <ccr@tnsp.org>
parents: 262
diff changeset
2914 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
2915 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
2916 Many of the command macros support "autotargetting", which basically
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2917 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
2918 lumberjacking and "/mine" for mining and GgrTF usually knows what
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2919 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
2920 </para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2921
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2922 <para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2923 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
2924 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
2925 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
2926 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
2927 automagically change to proper tools (saw -&gt; hammer/pick). The
787
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
2928 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
2929 </para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2930
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2931 <para>
1071
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2932 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
2933 <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
2934 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
2935 </para>
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2936
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2937 <para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2938 Notice that you probably MUST redefine some of these
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2939 macros and default settings in your TF configuration file!
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2940 (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
2941 </para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2942
1069
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2943 <note><para>
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2944 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
2945 </para></note>
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2946
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2947 <!-- @commands -->
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2948 <!-- @binds -->
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2949 <!-- @keybinds -->
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2950
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2951 <section id="usage-merchant-settings">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2952 &sectvariables;
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2953 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2954 <entry>mtool_mine</entry>
251
3765cf197a77 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 250
diff changeset
2955 <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
2956 </row>
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 <entry>mtool_lj</entry>
251
3765cf197a77 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 250
diff changeset
2959 <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
2960 </row>
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 <entry>mtool_bs</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2963 <entry>Tool(s) for blacksmithing.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2964 </row>
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 <entry>mtool_cp</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2967 <entry>Tool(s) for carpentry.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2968 </row>
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 <entry>mtool_gc</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2971 <entry>Tool(s) for gem cutting.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2972 </row>
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 <entry>mtool_gb</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2975 <entry>Tool(s) for glassblowing.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2976 </row>
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 <entry>mtool_ma</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2979 <entry>Tool(s) for masonry.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2980 </row>
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 <entry>mtool_sw</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2983 <entry>Tool(s) for sewing.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2984 </row>
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 <entry>mtool_sc</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2987 <entry>Tool(s) for sculpture skill.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2988 </row>
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 <entry>mforge_*</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2991 <entry>Forges/workbenches for skills (similar to mtool_* variables)</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2992 </row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2993 &sectvariablesend;
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2994
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2995
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2996 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2997
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2998 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2999
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3000 <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
3001 <para>
1378
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3002 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
3003 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
3004 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
3005 additional helper for potion research.
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3006 </para>
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3007
1378
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3008 <para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3009 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
3010 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
3011 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
3012 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
3013 </para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3014
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3015 <para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3016 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
3017 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
3018 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
3019 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
3020 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
3021 </para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3022
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3023 <para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3024 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
3025 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
3026
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3027 <userinput>/eval /set galch_file=%{HOME}/someotherfile.txt</userinput>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3028
1380
27c5c0603192 Add note about setting galch_file variable.
Matti Hamalainen <ccr@tnsp.org>
parents: 1379
diff changeset
3029 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
3030 </para>
27c5c0603192 Add note about setting galch_file variable.
Matti Hamalainen <ccr@tnsp.org>
parents: 1379
diff changeset
3031
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3032 <!-- @commands -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3033 <!-- @binds -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3034 <!-- @keybinds -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3035
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3036 </section>
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3037
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
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3040 <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
3041 <para>
263
Matti Hamalainen <ccr@tnsp.org>
parents: 262
diff changeset
3042 Provides a translator for barbarian reputation bar, reputation
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
3043 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
3044 </para>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3045
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
3046 <section>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3047 &sectmacros_1;
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3048 </para>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3049
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3050 <table><title>Macro commands</title>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3051 <tgroup cols="3" align="left">
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3052 <thead>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3053 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3054 <entry>Binding</entry>
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3055 <entry>Macro</entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3056 <entry>Description</entry>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3057 </row>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3058 </thead>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3059 <tbody>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3060 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3061 <entry>repu</entry>
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3062 <entry>/showrep</entry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3063 <entry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3064 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
3065 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
3066 </entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3067 </row>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3068 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3069 <entry>lb</entry>
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3070 <entry>/lootburn</entry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3071 <entry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3072 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
3073 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
3074 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
3075 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
3076 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
3077 immediately.
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3078 </entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3079 </row>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3080 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3081 <entry></entry>
237
6c495ddc7d4d forgot <action> from burnaction
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 236
diff changeset
3082 <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
3083 <entry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3084 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
3085 <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
3086 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
3087 </entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3088 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3089 &sectmacros_end;
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3090
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3091 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3092 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3093 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3094
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3095 </section>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3096
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3097 <!-- ================================================ -->
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3098
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3099 <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
3100 <para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3101 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
3102 spider servants.
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
3103 </para>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3104
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3105 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3106 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3107 <!-- @keybinds -->
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
3108
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3109 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3110
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3111 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3112
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3113 <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
3114 <para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3115 Reporting of succesful and failed 'tiger claw' hits, lites for
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3116 claw and mak reputation gains.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3117 </para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3118
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3119 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3120 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3121 <!-- @keybinds -->
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3122
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3123 </section>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3124
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
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3127 <section id="usage-tarma"><title>Guild: Tarmalens (gm-tarma.tf)</title>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3128 <para>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3129 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
3130 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
3131 '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
3132 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3133
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3134 <note><para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3135 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
3136 <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
3137 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
3138 </para></note>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3139
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3140 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3141 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3142 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3143
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3144 </section>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3145
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3146 <!-- ================================================ -->
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3147
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3148 <section id="usage-druid"><title>Guild: Druids (gm-druid.tf)</title>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3149 <para>
394
ed989c51b94e v0.5.11.3: Moved functionality from temp to tarmalen module and
Matti Hamalainen <ccr@tnsp.org>
parents: 393
diff changeset
3150 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
3151 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
3152 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
3153 help for casting reincarnations (along with raises, resurrects, etc.)
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3154 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3155
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3156 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3157 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3158 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3159
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3160 </section>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3161
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3162 <!-- ================================================ -->
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3163
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3164 <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
3165 <para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3166 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
3167 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
3168 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
3169 translator, etc.
489
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3170 </para>
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3171
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3172 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3173 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3174 <!-- @keybinds -->
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
3175
489
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3176 </section>
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3177
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3178 <!-- ================================================ -->
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3179
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3180 <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
3181 <para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3182 Very barebones module with support for "blood" ripaction and
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3183 fail/fumble handling.
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3184 </para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3185
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3186 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3187 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3188 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3189
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3190 </section>
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
3191
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3192 </chapter>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3193
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
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3196 <appendix id="support"><title>Support</title>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3197
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3198 <itemizedlist>
1629
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3199 <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
3200 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
3201 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
3202 acted upon.
1630
07aadee01164 Oops, slight typo.
Matti Hamalainen <ccr@tnsp.org>
parents: 1629
diff changeset
3203 </para>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3204 <itemizedlist>
549
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3205 <listitem><para>Take your time to <emphasis>think</emphasis>
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3206 while writing, and before submitting your report. Good rule of
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3207 thumb is to include all information that you think might be
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3208 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
3209 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3210
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3211 <listitem><para>
549
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3212 Remember to include information about your system and environment,
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3213 (*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
3214 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
3215 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3216
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3217 </itemizedlist>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3218 </listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3219
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3220 <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
3221 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
3222 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
3223 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3224
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3225 <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
3226 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
3227 the workings yourself.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3228 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3229
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3230 <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
3231 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
3232 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3233
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3234 <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
3235 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
3236 your questions and resolving problems.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3237 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3238
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 <listitem><para></para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3241 -->
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3242 </itemizedlist>
1322
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3243
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3244 <section id="patches"><title>Sending patches/corrections</title>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3245 <para>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3246 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
3247 <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
3248 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
3249 <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
3250 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
3251 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
3252 </para>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3253 <screen>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3254 # 1) Make changes to files
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3255 $EDITOR ggrtf.tf
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3256
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3257 # 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
3258 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
3259
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3260 # 3) Repeat steps 1 to 2 until satisfied
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3261
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3262 # 4) Export your local changes to a bundle
1323
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3263 hg bundle mychanges.bz2 &hgrepourl;
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3264
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3265 # 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
3266 </screen>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3267 </section>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3268
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3269 </appendix>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3270
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3271 <!-- ================================================ -->
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3272
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3273 <appendix id="faq"><title>Frequently Asked Questions (FAQ)</title>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3274 <qandaset>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3275 <qandaentry>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3276 <question>
270
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3277 <para>Is "Grizzt" included in the documentation?</para>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3278 </question>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3279 <answer>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3280 <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
3281 </answer>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3282 </qandaentry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3283
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3284 <qandaentry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3285 <question>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3286 <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
3287 </question>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3288 <answer>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3289 <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
3290 </answer>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3291 </qandaentry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3292
331
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3293
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3294 <qandaentry>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3295 <question>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3296 <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
3297 </question>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3298 <answer>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3299 <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
3300 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
3301 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
3302 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
3303 </para>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3304 <screen>
345
a53267af3f06 Typofixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 344
diff changeset
3305 /test prlist_insert("event_battle_round", "myroundgag")
a53267af3f06 Typofixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 344
diff changeset
3306 /def -i myroundgag = /substitute -ag
331
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3307 </screen>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3308 <para>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3309 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
3310 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
3311 </para>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3312 </answer>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3313 </qandaentry>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3314
381
6af6df52fefd v0.5.11.2: Removed tick predictor, it wasn't working anyway;
Matti Hamalainen <ccr@tnsp.org>
parents: 379
diff changeset
3315
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3316 <qandaentry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3317 <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
3318 <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
3319 </question>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3320 <answer>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3321 <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
3322 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
3323 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
3324 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
3325 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3326 </answer>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3327 </qandaentry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3328
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3329 <qandaentry>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3330 <question>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3331 <para>How can I get my settings saved automatically? Or can I?</para>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3332 </question>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3333 <answer>
454
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3334 <para>Automatic saving and loading is possible, please refer to
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3335 <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
3336 and <link linkend="inst-config-tf">setup</link> -sections of
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3337 this manual for more information.
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3338 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3339 </answer>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3340 </qandaentry>
454
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3341
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3342 <qandaentry>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3343 <question>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3344 <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
3345 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
3346 </question>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3347 <answer>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3348 <para>
1629
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3349 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
3350 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
3351 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
3352 </para>
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 Also see the next question below.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3355 </para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3356 </answer>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3357 </qandaentry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3358
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3359 <qandaentry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3360 <!--
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3361 <question>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3362 <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
3363 </question>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3364 -->
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3365 <question>
454
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3366 <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
3367 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
3368 </question>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3369 <answer>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3370 <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
3371 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
3372 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
3373 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
3374 </para>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3375
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3376 <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
3377 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
3378 in-game settings.
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3379 </para>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3380 </answer>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3381 </qandaentry>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3382
642
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3383 <qandaentry>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3384 <question>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3385 <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
3386 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
3387 </question>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3388 <answer>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3389 <para>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3390 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
3391 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
3392 </para>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3393 </answer>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3394 </qandaentry>
1529
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3395
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3396 <qandaentry>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3397 <question>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3398 <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
3399 </question>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3400 <answer>
1539
78268db92315 Oops, a missing para-tag. Fixed.
Matti Hamalainen <ccr@tnsp.org>
parents: 1538
diff changeset
3401 <para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
3402 Make sure you have configured your terminal correctly,
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
3403 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
3404 section for more information.
1539
78268db92315 Oops, a missing para-tag. Fixed.
Matti Hamalainen <ccr@tnsp.org>
parents: 1538
diff changeset
3405 </para>
1529
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3406 </answer>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3407 </qandaentry>
270
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3408 <!--
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3409 <qandaentry>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3410 <question>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3411 <para></para>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3412 </question>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3413 <answer>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3414 <para>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3415 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3416 </answer>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3417 </qandaentry>
270
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3418 -->
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3419 </qandaset>
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3420
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3421 </appendix>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3422
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3423 <!-- ================================================ -->
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 <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
3426 GnuPG</title>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3427 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3428 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
3429 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
3430 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
3431 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3432
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3433 <itemizedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3434 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3435 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3436 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
3437 <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
3438 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3439 </listitem>
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 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3442 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
3443 <userinput>gpg --verify ggrtf-&ggrtfver;.tar.gz.asc</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3444 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
3445 signature from "Matti Hamalainen (ccr) &lt;ccr@tnsp.org&gt;"'
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3446 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3447 </listitem>
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3448 </itemizedlist>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3449
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3450 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3451 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
3452 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
3453 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
3454 GNU Privacy Handbook</ulink> is available from GnuPG project.
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3455 (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
3456 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
3457 http://www.gnupg.org/documentation/guides.en.html</ulink>.)
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3458 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3459 </appendix>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3460
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
3461 </book>