annotate docs/manual.sgml @ 1678:914961b1e2d2

Update manual a bit, move gm-tf5 module stuff to statusline section and remove the old gm-tf5 section.
author Matti Hamalainen <ccr@tnsp.org>
date Wed, 27 Mar 2024 17:25:13 +0200
parents 54a9a23d8df0
children 63e789382fc6
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
1673
54a9a23d8df0 Bump version.
Matti Hamalainen <ccr@tnsp.org>
parents: 1671
diff changeset
3 <!ENTITY ggrtfver "0.7.5.0">
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>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
985 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
986 castings and certain other events. <emphasis>This depends on
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
987 your <link linkend="inst-config-batmud">BatMUD settings</link>
1601
fcb56c908184 Oops, 100L.
Matti Hamalainen <ccr@tnsp.org>
parents: 1598
diff changeset
988 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
989 not appear, most likely your 'sc' setting is "wrong",
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
990 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
991 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
992
1678
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
993 <para>
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
994 <emphasis>The functionality of the statusline depends on
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
995 your <link linkend="inst-config-batmud">BatMUD settings</link>
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
996 being correctly set up.</emphasis> If HP/SP/EP etc. information does
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
997 not appear, most likely your 'sc' setting is "wrong",
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
998 and thus does not get parsed by GgrTF.
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
999 </para>
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1000 </note>
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1001
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1002 <screenshot>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1003 <mediaobject>
1678
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1004 <imageobject><imagedata fileref="statusbar_tf5.gif" format="GIF" /></imageobject>
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1005 <imageobject><imagedata fileref="statusbar_tf5.eps" format="EPS" /></imageobject>
343
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 <phrase>GgrTF statusline</phrase>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1008 </textobject>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1009 <caption>
1678
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1010 <para>Example of typical basic GgrTF statusline in TF5.</para>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1011 </caption>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1012 </mediaobject>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1013 </screenshot>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1014
1678
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1015 <itemizedlist>
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1016 <listitem><para>
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1017 Enhanced 2-row statusline: First line contains HP/SP/EP- and
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1018 skill/spell/etc- information as usual. Prot status has been
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1019 moved to the second line.
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1020 </para></listitem>
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1021
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1022 </itemizedlist>
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1023
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1024 <!--
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1025 - example configuration
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1026 - document special variables
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1027 -->
914961b1e2d2 Update manual a bit, move gm-tf5 module stuff to statusline section and
Matti Hamalainen <ccr@tnsp.org>
parents: 1673
diff changeset
1028
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1029 <orderedlist>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1030 <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
1031 <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
1032 <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
1033 <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
1034 <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
1035 <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
1036 <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
1037 <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
1038 <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
1039 </orderedlist>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1040
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1041 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1042 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
1043 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
1044 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
1045 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
1046 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1047
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1048 <screenshot>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1049 <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
1050 <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
1051 <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
1052 <textobject>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1053 <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
1054 </textobject>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1055 <caption>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1056 <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
1057 "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
1058 endurance your character has.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1059 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1060 </caption>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1061 </mediaobject>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1062 </screenshot>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1063
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 </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
1065
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
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 <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
1069 <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
1070 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
1071 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
1072 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
1073 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
1074 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
1075 </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
1076 <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
1077 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
1078 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
1079 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
1080
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1081 <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
1082
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
1083 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
1084 "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
1085 (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
1086 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
1087 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
1088 </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
1089
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
1090 <orderedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1091 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1092 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1093 <userinput>/gprompt &gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1094 Set prompt to show only "&gt;" and nothing more.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1095 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1096 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1097 <listitem>
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 <userinput>/gprompt %{status_cast}&gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1100 Show currently in-progress skill or spell in prompt.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1101 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1102 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1103 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1104 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1105 <userinput>/gprompt @{BCred}%{status_cast}@{n}@{BCwhite}&gt;@{n}</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1106 TinyFugue color attributes can be used also.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1107 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1108 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1109 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1110 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1111 <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
1112 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
1113 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
1114 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1115 </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
1116 </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
1117
1075
122c463704e1 Add note about /gprompt attribute formatting not working with earlier betas of TF5.
Matti Hamalainen <ccr@tnsp.org>
parents: 1074
diff changeset
1118 <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
1119 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
1120 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
1121 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
1122 </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
1123
943
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
1124 <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
1125 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
1126 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
1127 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
1128 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
1129 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
1130 ("&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
1131
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1132 <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
1133
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
1134 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
1135
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1136 <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
1137
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1138 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
1139 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
1140 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
1141 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
1142 </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
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 <orderedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1145 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1146 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1147 <userinput>/gprompt %{status_prompt}&gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1148 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
1149 greater than sign in the end.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1150 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1151 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1152 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1153 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1154 <userinput>/gprompt @{BCgreen}%{status_prompt}@{n}&gt;</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1155 Same as above, but coloured bright green.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1156 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1157 </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
1158 </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
1159
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
1160 <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
1161 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
1162 "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
1163 </para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1164
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1165 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1166
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
1167
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1168 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1169
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1170 <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
1171 <para>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1172 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
1173 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
1174 retrieval. Settings get saved and thus restored later,
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1175 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
1176 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
1177 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
1178 How to do this is discussed further below.
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1179 </para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1180
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1181 <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
1182 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1183 <emphasis>Almost</emphasis> all settings (hidden or visible)
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1184 get saved, but there are certain global settings that you
391
Matti Hamalainen <ccr@tnsp.org>
parents: 390
diff changeset
1185 have to set yourself in your TF configuration. These
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1186 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
1187 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1188
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1189 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1190 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
1191 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
1192 different files</emphasis>. In GgrTF, these two types of data
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1193 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
1194 two savefiles are named accordingly. Pre-init settings are
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1195 variables that need to be defined before the main modules
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1196 of GgrTF are loaded in TF's startup configuration (certain
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1197 functionality depends on this). Post-init variables can
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1198 (and sometimes <emphasis>must</emphasis>) be set after loading
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1199 of all modules.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1200 </para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1201 </section>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1202
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1203 <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
1204 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1205 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
1206 set yourself in your TF's startup configuration (.tfrc).
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1207 These variables <emphasis>MUST</emphasis> be set before loading
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1208 of ANY GgrTF modules, otherwise things start breaking and the
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1209 state-saving system does not work correctly.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1210 </para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1211
1052
3f0fec339dcb Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1049
diff changeset
1212 <table><title>Special, non-saved variables</title>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1213 <tgroup cols="3" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1214 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1215 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1216 <entry>Variable</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1217 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1218 <entry>Example</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1219 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1220 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1221 <tbody>
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_plrname</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 Your character's name, written in correct case.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1226 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1227 <entry>/set set_plrname=Ggr</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1228 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1229
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1230 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1231 <entry>set_datapath</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1232 <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
1233 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
1234 from.)</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1235 <entry>/set set_datapath=</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1236 </row>
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 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1239 <entry>set_saveprefix</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1240 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1241 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
1242 savefiles are "<emphasis>&lt;prefix&gt;pre.tf</emphasis>" and
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1243 "<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
1244 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
1245 for either.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1246 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1247 <entry>/set set_saveprefix=bat-</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1248 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1249
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1250 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1251 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1252 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1253
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1254 </section>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1255
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1256
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1257 <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
1258 <para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1259 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
1260 TF configuration, and possibly setting up a savefile directory
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1261 </para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1262
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1263 <para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1264 A simplified example configuration layout is presented below with only
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1265 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
1266 <link linkend="inst-config-tf">setup</link>-section of this
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1267 manual for a more detailed example. Pay close attention to the order
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1268 how things are done, it is very important!
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1269 </para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1270
950
a6e6295d3557 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 944
diff changeset
1271 <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
1272 /eval /set set_datapath=%{HOME}/.ggrtf/
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1273
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1274 ;; 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
1275 /eval /set set_saveprefix=bat-
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1276
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1277 ;; Load the special pre-init module which loads pre-init
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1278 ;; settings from the savefiles. This needs to be done
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1279 ;; before loading any other GgrTF modules.
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1280 /gloadmod ggrtf-pre.tf
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1281
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1282 ;; Load GgrTF core module
629
a80d8bcdef99 Updated some examples, fixed few bugs.
Matti Hamalainen <ccr@tnsp.org>
parents: 625
diff changeset
1283 /gloadmod ggrtf.tf
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1284
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1285 ;; Load other additional modules
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
1286 /gloadmod gm-magical.tf
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1287 ; etc etc.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1288
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1289 ;; Load and restore other previously saved settings.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1290 ;; This should be done after loading any GgrTF modules.
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1291 /gload
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1292 </screen>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1293
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1294 <para>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1295 When you have edited your TF configuration, you need to (re-)start
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1296 it, change settings the way you want them to be and finally issue
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1297 "/gsave" command to get settings saved. <emphasis>After saving,
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1298 you may also want to examine the pre-init -savefile, because it
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1299 contains certain settings that cannot be changed run-time
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1300 </emphasis>. So, here are the steps in short again:
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1301 </para>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1302
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1303 <orderedlist>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1304 <listitem><para>
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1305 <emphasis>Edit TF configuration (see example above)</emphasis>:
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1306 Add <emphasis>set_datapath</emphasis>, <emphasis>set_saveprefix</emphasis>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1307 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
1308 and <emphasis>/gload</emphasis> command.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1309 </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
1310 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1311 <emphasis>Re-start TF</emphasis>:
841
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1312 In order to create the initial savefiles with default settings,
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
1313 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
1314 </para></listitem>
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1315 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1316 <emphasis>Change settings</emphasis>:
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1317 Change GgrTF settings (listed via /opts etc.) to accommodate
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1318 your desires.
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1319 </para></listitem>
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1320 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1321 <emphasis>Save initial settings</emphasis>:
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1322 Issue "/gsave" to get settings saved.
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1323 </para></listitem>
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1324 <listitem><para>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1325 <emphasis>Optionally edit pre-init settings</emphasis>:
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1326 Certain settings are saved into the pre-init savefile (actual
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1327 filename is dependant on what you set "set_saveprefix" to).
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1328 GgrTF does not offer any special interface to change these settings,
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1329 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
1330 </para></listitem>
403
b0bec2ea62f1 Blahblah.
Matti Hamalainen <ccr@tnsp.org>
parents: 401
diff changeset
1331 </orderedlist>
401
6b443f714a3a Improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 397
diff changeset
1332
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1333 </section>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1334
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1335 <section><title>How to make state-saving automatic</title>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1336 <para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1337 In previous example, I only described how settings get restored
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1338 (as TF loads and initializes GgrTF), but how to get settings
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1339 saved automatically too?
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1340 </para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1341
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1342 <para>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1343 The answer lies in &tfurl;'s event hooks. It is possible to
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1344 define a hook, which is executed when TF disconnects from a world.
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1345 By setting this hook to perform "/gsave", we can automatize the
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1346 process of saving settings. Add following line to your TF configuration:
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1347
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1348 <userinput>/def -hDISCONNECT mydisconnect = /gsave</userinput>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1349
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1350 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
1351 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
1352
954
7d4c1c2e981f Instead of <screen> tag, use <userinput> where appropriate.
Matti Hamalainen <ccr@tnsp.org>
parents: 950
diff changeset
1353 <userinput>/def -hDISCONNECT mydisconnect = /greset%;/gsave</userinput>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1354
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1355 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1356
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1357 </section>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1358
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1359
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1360 &sectmacros_2;
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1361 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1362 <entry>/gsave</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1363 <entry>
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
1364 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
1365 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1366 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1367 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1368 <entry>/gload</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1369 <entry>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1370 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
1371 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
1372 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1373 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1374 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1375 <entry>/greset</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1376 <entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1377 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
1378 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
1379 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
1380 restored on next /gload.
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1381 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1382 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1383 &sectmacros_end;
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
1384
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1385 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1386
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1387 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1388
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1389 <section id="usage-general-binds"><title>Command bindings</title>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1390 <para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1391 GgrTF's core provides few macros for defining "bindings", which
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1392 are a way to create commands that look like normal MUD commands
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1393 but are actually intercepted by &tfurl; and executed appropriately.
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1394 These bindings can be used to easily define shorthands for casting
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1395 spells, using skills, executing macros, etc. GgrTF bindings offer
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1396 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
1397 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
1398 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
1399 extra abilities (but also with some limitations.)</emphasis>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1400 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1401
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1402 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1403 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
1404 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
1405 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
1406 with a setting ("opt_bindings"). See below section <link
807
043927590bef Change headlines.
Matti Hamalainen <ccr@tnsp.org>
parents: 806
diff changeset
1407 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
1408 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1409
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1410 <para>
994
c40eabb80393 Add few lines of explanation about bindings.
Matti Hamalainen <ccr@tnsp.org>
parents: 988
diff changeset
1411 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
1412 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
1413 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
1414 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
1415 redefine lots just because you are reincarnating... and you can not execute
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1416 macros with command aliases.
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1417 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1418
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1419 <para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1420 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
1421 drawbacks:
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1422 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1423
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1424 <itemizedlist>
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 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1427 <emphasis>Limitations of TF's parsing</emphasis>:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1428 Because of the nature how bindings are defined and parsed,
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1429 you can only use one binded command per line.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1430 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
1431 and "clair" is a binding to use clairvoyance. Thus, someone
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1432 might want to command:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1433
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1434 <userinput>aoa ggr%;clair</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1435
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1436 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
1437 not evaluate binding as an expression, the "ggr%;clair"-part
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1438 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
1439 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
1440 </para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1441 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1442
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1443 <listitem>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1444 <para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1445 <emphasis>BatMUD commands and GgrTF bindings cannot be mixed</emphasis>:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1446 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
1447 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
1448 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
1449 and "hop" is an emote:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1450
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1451 <userinput>hop jeskko;aoa ggr</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1452
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1453 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
1454 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
1455 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
1456 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
1457 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
1458 </para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1459 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1460
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1461 <listitem>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1462 <para>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1463 <emphasis>Limitations of GgrTF's binding system</emphasis>:
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1464 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
1465 with the current functionality provided by GgrTF. Bindings that
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1466 require complex parameters (more than one optional argument),
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1467 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
1468 aliases for those.
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1469 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
1470 </listitem>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1471 </itemizedlist>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1472
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1473
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1474 <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
1475 <para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1476 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
1477 command bindings!
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1478 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1479
950
a6e6295d3557 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 944
diff changeset
1480 <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
1481 /prdefcbind -s"nf" -c"Neutralize Field" -n
950
a6e6295d3557 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 944
diff changeset
1482 /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
1483
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1484 <para>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1485 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
1486 macros supported by GgrTF. First defines a generic command binding
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1487 to execute "/ceremony" macro when user commands "cere".
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1488 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
1489 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
1490 usage command to use "Fire Building". So basically we have
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1491 three types of bindings:
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1492 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1493
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1494 <itemizedlist>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1495 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1496 <emphasis>/prdefgbind</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1497 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
1498 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
1499 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1500
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1501 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1502 <emphasis>/prdefcbind</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1503 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
1504 to be casted.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1505 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1506
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1507 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1508 <emphasis>/prdefsbind</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1509 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
1510 skill to be executed.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1511 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1512 </itemizedlist>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1513
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1514 <para>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1515 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
1516 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
1517 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
1518 command binding to be defined. The argument options and their
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1519 meanings are listed below:
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1520 </para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1521
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1522 <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
1523 <tgroup cols="2" align="left">
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1524 <thead>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1525 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1526 <entry>Option</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1527 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1528 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1529 </thead>
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 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1532 <entry>-s"name"</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1533 <entry>Specifies the name of the command binding.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1534 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
1535 after which come the optional arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1536 </entry>
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 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1539 <entry>-n</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1540 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1541 Tells GgrTF that the binding does NOT accept arguments.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1542 Anything following the command binding invocation is ignored.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1543 This also affects the possible reporting output of the binding.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1544 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1545 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1546 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1547 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1548 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1549
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1550 <table><title>Arguments specific to generic bindings (/prdefgbind)</title>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1551 <tgroup cols="2" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1552 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1553 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1554 <entry>Option</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1555 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1556 </row>
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 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1559 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1560 <entry>-c"action"</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1561 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1562 Specifies the action, aka what the binding <emphasis>does</emphasis>.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1563 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
1564 TF macro or BatMUD command.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1565 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1566 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1567 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1568 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1569 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1570
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1571 <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
1572 <tgroup cols="2" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1573 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1574 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1575 <entry>Option</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1576 <entry>Description</entry>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1577 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1578 </thead>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1579 <tbody>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1580 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1581 <entry>-c"action"</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1582 <entry>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1583 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
1584 </entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1585 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1586 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1587 <entry>-d"message"</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1588 <entry>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1589 This option overrides the default message string used for reporting
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1590 (see also option "-q" below).
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1591 </entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1592 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1593 <row>
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1594 <entry>-q</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1595 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1596 Makes the binding "quiet", suppresses any reporting. By default,
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1597 spell casting binding reports the action on party report-channel,
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1598 but specifying this option disables it.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1599 </entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1600 </row>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1601 </tbody>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1602 </tgroup>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1603 </table>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
1604
390
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1605 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1606 More examples, now with short explanations:
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1607 </para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1608
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1609 <table><title>Binding defination examples</title>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1610 <tgroup cols="2" align="left">
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1611 <thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1612 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1613 <entry>Definition</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1614 <entry>Description</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1615 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1616 </thead>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1617 <tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1618 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1619 <entry>/prdefgbind -s"repu" -c"/showrep" -n</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1620 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1621 Generic binding, which executes /showrep macro and takes no arguments.
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>/prdefsbind -s"er" -c"Enrage" -n</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 Skill binding for barbarian "Enrage" skill. Also takes no
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1628 arguments.
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"shelter" -c"Shelter" -n -d"Sheltering ..."</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 Spell casting binding, for casting conjurer spell "Shelter".
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1635 Takes no arguments and uses specific reporting string (default
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1636 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
1637 use "Sheltering ..." instead.)
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 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1641 <entry>/prdefcbind -s"dmp" -c"Dispel Magical Protection"</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1642 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1643 Another spell casting binding for a conjurer spell, which takes
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1644 (and requires) a player's name as argument.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1645 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1646 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1647 <row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1648 <entry>/prdefcbind -s"sl" -c"Star Light" -q</entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1649 <entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1650 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
1651 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
1652 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
1653 accepted.
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1654 </entry>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1655 </row>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1656 </tbody>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1657 </tgroup>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1658 </table>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1659
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1660 <para>
0c0aa458c949 And more new content.
Matti Hamalainen <ccr@tnsp.org>
parents: 389
diff changeset
1661 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
1662 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
1663 </para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1664
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1665 </section>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1666
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1667
807
043927590bef Change headlines.
Matti Hamalainen <ccr@tnsp.org>
parents: 806
diff changeset
1668 <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
1669 <para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1670 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
1671 /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
1672 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
1673 </para>
806
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1674 <para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1675 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
1676 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
1677 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
1678 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
1679 .tfrc.
806
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1680 </para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1681 <para>
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1682 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
1683 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
1684 <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
1685 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
1686 for more information.
dc4859b3ff98 Add a section about how bindings are enabled.
Matti Hamalainen <ccr@tnsp.org>
parents: 800
diff changeset
1687 </para>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1688 </section>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1689
995
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1690 <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
1691 <para>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1692 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
1693 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
1694 </para>
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 ,----------------.
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1697 | GgrTF Bindings |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1698 +----------------+----------------------------------------------------.
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1699 | pprots | G | /pprots | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1700 | rpouch | G | /rpouch | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1701 | ad | C | Aura Detection | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1702 | invis | C | Invisibility | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1703 | float | C | Floating | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1704 | ww | C | Water Walking | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1705 | seeinvis | C | See Invisible | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1706 | seemagic | C | See Magic | Yes |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1707 | cere | G | /ceremony | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1708 | curses | G | /curses | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1709 | prots | G | /prots | ? |
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1710 `---------------------------------------------------------------------'
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1711 </screen>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1712 <itemizedlist>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1713 <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
1714 <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
1715 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
1716 <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
1717 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
1718 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
1719 command executed.</para></listitem>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1720 <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
1721 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
1722 question mark ("?") instead.</para></listitem>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1723 </itemizedlist>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1724
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1725 </section>
061ca577a894 Added section about /binds command output, with explanations.
Matti Hamalainen <ccr@tnsp.org>
parents: 994
diff changeset
1726
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1727 </section>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1728
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1729 <!-- ================================================ -->
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
1730
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
1731 <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
1732 <para>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1733 GgrTF provides a mechanism for routing keyboard numpad bindings so that
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1734 different functionality can be swapped in as needed. Core module offers
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1735 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
1736 automatic peering to adjacent directions, useful for <link
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1737 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
1738
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1739 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
1740 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
1741 <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
1742 modules, for example.)
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1743 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1744
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1745 <note>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1746 <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
1747 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
1748 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
1749 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
1750 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
1751 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
1752 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
1753 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
1754 </para>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1755 </note>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1756
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1757 &sectmacros_2;
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1758 <row>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1759 <entry>/move [setting]</entry>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1760 <entry>Set the mode used for numpad bindings. Valid values are
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1761 shown if command is given without arguments. Core GgrTF module
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1762 provides following three modes: <emphasis>move</emphasis>,
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1763 <emphasis>peer</emphasis> and <emphasis>ship</emphasis>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1764 </entry>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1765 </row>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1766
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1767 <row>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1768 <entry>/peer [regexp]</entry>
393
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1769 <entry>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1770 Set the regular expression used for grepping the output of 'peer'
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1771 command used in "/move peer" mode.
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1772 </entry>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1773 </row>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1774
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1775 <row>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1776 <entry>/cruise</entry>
6b253e73b02c And more.
Matti Hamalainen <ccr@tnsp.org>
parents: 392
diff changeset
1777 <entry>Toggle ship cruising speed on/off (off = sail)</entry>
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
1778 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1779 &sectmacros_end;
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1780
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1781 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1782
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1783 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1784
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1785 <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
1786 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1787 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
1788 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
1789 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
1790 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
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 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1794 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
1795 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
1796 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
1797 (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
1798 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
1799 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
1800 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
1801 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
1802 for prot reporting triggers.)
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1803 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1804
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1805 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1806 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
1807 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1808
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1809 <itemizedlist>
584
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1810 <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
1811 <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
1812 <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
1813 <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
1814 <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
1815 <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
1816 <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
1817 <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
1818 <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
1819 <listitem><para>etc...</para></listitem>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1820 </itemizedlist>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1821
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1822 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1823 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
1824 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
1825 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
1826 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
1827 line character (sometimes called the pipe).
787
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
1828 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
1829 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1830
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1831 <table><title>Prot entries</title>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1832 <tgroup cols="2" align="left">
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1833 <thead>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1834 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1835 <entry>Entry</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1836 <entry>Description</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1837 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1838 </thead>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1839 <tbody>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1840 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1841 <entry>Unst[1m9s]</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1842 <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
1843 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1844 <row>
787
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
1845 <entry>+AoA[7m19s]</entry>
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
1846 <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
1847 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1848 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1849 <entry>Infra(2)[0m2s]</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1850 <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
1851 </row>
584
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1852 <row>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1853 <entry>Unst&lt;2&gt;[7m19s]</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1854 <entry>Unstun that has been weakened 2 times.</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1855 </row>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1856 <row>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1857 <entry>-Forget[3m5s]</entry>
4cbf7693af1e Document <> and - in prot reporting.
Matti Hamalainen <ccr@tnsp.org>
parents: 583
diff changeset
1858 <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
1859 </row>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1860 </tbody>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1861 </tgroup>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1862 </table>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1863
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1864 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1865 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
1866 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1867
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1868 <screen>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1869 <userinput>tweak jeskko</userinput>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1870
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1871 You tweak Jeskko's nose mischievously.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1872 Jeskko [report]: Unst[1h1m13s]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1873
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1874 <userinput>unp jeskko</userinput>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1875
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
1876 Ggr [report]: Unpain -&gt; jeskko
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1877 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
1878 GgrTF: 'unpain' -&gt; jeskko
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1879 Unpain: ##### [5]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1880 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
1881 Unpain: ## [2]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1882 Unpain: # [1]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1883 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
1884 You utter the magic words (unpain)
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1885 You cast the spell successfully.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1886 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
1887 Jeskko [report]: Unpain ON!
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1888
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1889 <userinput>tweak jeskko</userinput>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1890
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1891 You tweak Jeskko's nose mischievously.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1892 Jeskko [report]: Unst[1h4m25s] | Unp[2m35s]
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1893 </screen>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1894
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1895
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1896 &sectmacros_2;
343
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 <entry>/prots</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1899 <entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1900 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
1901 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
1902 report-channel.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1903 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1904 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1905 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1906 <entry>/cprots</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1907 <entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1908 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
1909 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
1910 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
1911 discretion.
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1912 </entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1913 </row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1914 <row>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1915 <entry>tweak &lt;target&gt;</entry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1916 <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
1917 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
1918 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
1919 </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
1920 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1921 &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
1922
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 </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
1924
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 <!-- ================================================ -->
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
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 <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
1928 <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
1929 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
1930 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
1931 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
1932 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
1933 </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
1934 <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
1935 <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
1936 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
1937 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
1938 </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
1939 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
1940 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
1941 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
1942 </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
1943
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1944 &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
1945 <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
1946 <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
1947 <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
1948 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
1949 </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
1950 </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
1951 <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
1952 <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
1953 <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
1954 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
1955 </entry>
1203
796e24a218a4 Oops, a </row> tag was missing.
Matti Hamalainen <ccr@tnsp.org>
parents: 1202
diff changeset
1956 </row>
1157
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1957 <row>
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1958 <entry>/cursewarn</entry>
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1959 <entry>
25cee31780bc Add note about /cursewarn setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 1156
diff changeset
1960 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
1961 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
1962 (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
1963 </entry>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1964 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
1965 &sectmacros_end;
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1966
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1967 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1968
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1969 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
1970
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1971 <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
1972
1222
9c89e20131df Comment out a warning.
Matti Hamalainen <ccr@tnsp.org>
parents: 1220
diff changeset
1973 <!--
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1974 <note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1975 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1976 <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
1977 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
1978 you can send complaints to nearest trashbin.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1979 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1980 </note>
1222
9c89e20131df Comment out a warning.
Matti Hamalainen <ccr@tnsp.org>
parents: 1220
diff changeset
1981 -->
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1982
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1983 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1984 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
1985 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
1986 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
1987 (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
1988 so called "zero round").
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1989 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1990
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1991 <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
1992 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
1993 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
1994 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
1995 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
1996 "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
1997 not always match the real ones.
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
1998 <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
1999 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
2000 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2001
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2002 <note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2003 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2004 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
2005 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
2006 </para>
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 <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
2009 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
2010 add that to your eqset swapping commands.
1220
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2011 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2012 </note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2013
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2014
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2015 <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
2016 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2017 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
2018 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
2019 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
2020 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
2021 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2022
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2023 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2024 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
2025 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2026
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2027 <itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2028 <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
2029 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
2030 frequency.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2031 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2032
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2033 <listitem><para>One tick is always 10 heartbeats.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2034 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2035
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2036 <listitem><para>Battle rounds are always around ~3s,
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2037 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
2038 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2039
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2040 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2041 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
2042 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
2043 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2044 </itemizedlist>
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 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2047 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
2048 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2049
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2050 <orderedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2051 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2052 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
2053 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2054
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2055 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2056 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
2057 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
2058 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
2059 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
2060 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2061
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2062 <listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2063
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2064 <para>In gheartbeat_timer() we check for:</para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2065 <itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2066 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2067 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
2068 if it was "too long" ago.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2069 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2070 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2071 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
2072 long ago.
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2073 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2074 <listitem><para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2075 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
2076 </para></listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2077 </itemizedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2078
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2079 </listitem>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2080
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2081 </orderedlist>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2082
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2083 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2084 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
2085 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
2086 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
2087 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2088
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2089 <note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2090 <para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2091 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
2092 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
2093 </para>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2094 </note>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2095
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2096 </section>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2097
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2098 </section>
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2099
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2100 <!-- ================================================ -->
5d19404bec6b Add documentation about heartbeat/tick predictor.
Matti Hamalainen <ccr@tnsp.org>
parents: 1203
diff changeset
2101
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2102 <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
2103 <para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2104 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2105 </section>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2106
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2107 <!-- ================================================ -->
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2108
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2109 <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
2110 <para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2111 Base module for all things magical. This module is <emphasis>required</emphasis>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2112 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
2113 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
2114 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
2115 </para>
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2116
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2117 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2118 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
2119 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
2120 at all times.
275
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2121 </para>
3e167dd18d60 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 272
diff changeset
2122
889
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2123 <itemizedlist>
890
a864a635d545 Add information about resist reporting, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 889
diff changeset
2124 <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
2125 (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
2126 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2127 <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
2128 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
2129 until your spell goes off.
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2130 </para></listitem>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2131 </itemizedlist>
09f63922c16b Remove references to misc module; general reorganizing.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
2132
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2133 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2134
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2135 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2136
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2137 <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
2138 <para>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2139 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
2140 <emphasis>pss</emphasis> (<emphasis>party status short</emphasis>)
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2141 -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
2142 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
2143 status information in compact format.
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2144 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2145
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2146 <para>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2147 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
2148 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
2149 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
2150 unconsciousness, stun, formation, etc.</emphasis>.
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2151 </para>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2152
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2153 <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
2154 </emphasis> when in stunned or unconscious state, but this is normally
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2155 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
2156 </para>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2157
261
2b18754a1f01 Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 260
diff changeset
2158 <para>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2159 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
2160 <link linkend="usage-general-commands">/autopss</link> option). A normally issued
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2161 '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
2162 <emphasis>/pss</emphasis> macro or bind that to 'pss'. (See <link
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2163 linkend="usage-general-binds">Bindings</link>-section for more information.)
261
2b18754a1f01 Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 260
diff changeset
2164 </para>
2b18754a1f01 Twiddle.
Matti Hamalainen <ccr@tnsp.org>
parents: 260
diff changeset
2165
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2166 <screenshot>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2167 <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
2168 <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
2169 <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
2170 <textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2171 <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
2172 </textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2173 <caption>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2174 <para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2175 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
2176 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
2177 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
2178 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2179 </caption>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2180 </mediaobject>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2181 </screenshot>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2182
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2183 <screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2184 <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
2185 <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
2186 <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
2187 <textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2188 <phrase>Stunned</phrase>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2189 </textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2190 <caption>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2191 <para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2192 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
2193 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
2194 (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
2195 (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
2196 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
2197 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2198 </caption>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2199 </mediaobject>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2200 </screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2201
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 <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
2204 <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
2205 <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
2206 <textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2207 <phrase>Unconscious</phrase>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2208 </textobject>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2209 <caption>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2210 <para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2211 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
2212 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
2213 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
2214 hopefully catching your attention.
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2215 </para>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2216 </caption>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2217 </mediaobject>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2218 </screenshot>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2219
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2220
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2221 <section><title>HP/SP/EP colours</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2222 <para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2223 List of possible indicator colours and their meanings. &colourexplanation;
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2224 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2225
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2226
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2227 <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
2228 <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
2229 <thead>
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 <entry>Colour</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2232 <entry>Background</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2233 <entry>Explanation</entry>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2234 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2235 </thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2236 <tbody>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2237 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2238 <entry>Bright White</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2239 <entry>Bright Red</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2240 <entry>Negative value (x &lt; 0)</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2241 </row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2242 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2243 <entry>Bright Red</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2244 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2245 <entry>Less than 16% of max</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2246 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2247 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2248 <entry>Red (dark)</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2249 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2250 <entry>Less than 33% of max</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2251 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2252 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2253 <entry>Yellow (dark)</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2254 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2255 <entry>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
2256 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2257 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2258 <entry>Bright Yellow</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2259 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2260 <entry>Less than 66% of max</entry>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2261 </row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2262 <row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2263 <entry>Green (dark)</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2264 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2265 <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
2266 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2267 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2268 <entry>Bright Green</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2269 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2270 <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
2271 </row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2272 </tbody>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2273 </tgroup>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2274 </table>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2275 </section>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2276
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2277 <section><title>Player name colours</title>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2278 <para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2279 List of possible name colours and their meanings. &colourexplanation;
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2280 </para>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2281
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2282 <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
2283 <tgroup cols="3" align="left">
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2284 <thead>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2285 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2286 <entry>Colour</entry>
272
Matti Hamalainen <ccr@tnsp.org>
parents: 271
diff changeset
2287 <entry>Background</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2288 <entry>State description</entry>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2289 </row>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2290 </thead>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2291 <tbody>
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2292 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2293 <entry>Bright White</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2294 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2295 <entry>Normal</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2296 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2297 <row>
1596
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2298 <entry>Bright Black</entry>
849
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2299 <entry>-</entry>
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2300 <entry>Idle</entry>
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2301 </row>
b9d2598660e0 Add idle status indication to pss-mangler.
Matti Hamalainen <ccr@tnsp.org>
parents: 847
diff changeset
2302 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2303 <entry>Bright White</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2304 <entry>Bright Red</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2305 <entry>Unconscious (unc)</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2306 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2307 <row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2308 <entry>Bright Red</entry>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2309 <entry>-</entry>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2310 <entry>Stunned (stun)</entry>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2311 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2312 <row>
267
e7d531760dd9 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 265
diff changeset
2313 <entry>Magenta</entry>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2314 <entry>-</entry>
1596
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2315 <entry>In form (form), or member (mbr)</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2316 </row>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2317 <row>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2318 <entry>Cyan</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2319 <entry>-</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2320 <entry>Resting/camping/meditating (rest)</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2321 </row>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2322 <row>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2323 <entry>Bright White</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2324 <entry>Blue</entry>
5d563bcc3a78 Update documentation slightly.
Matti Hamalainen <ccr@tnsp.org>
parents: 1587
diff changeset
2325 <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
2326 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2327 &sectmacros_end;
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2328
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
2329 <section>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2330 &sectmacros_1;
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
2331 </para>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2332
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2333 <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
2334 <tgroup cols="2" align="left">
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2335 <thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2336 <row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2337 <entry>Command</entry>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2338 <entry>Description</entry>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2339 </row>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2340 </thead>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2341 <tbody>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2342 <row>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2343 <entry>/prettypss</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2344 <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
2345 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
2346 </row>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2347 <row>
449
725695d31f21 Updated /pstatus -> pss and /pss -> /autopss accordingly.
Matti Hamalainen <ccr@tnsp.org>
parents: 422
diff changeset
2348 <entry>/pss</entry>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2349 <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
2350 </row>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2351 <row>
449
725695d31f21 Updated /pstatus -> pss and /pss -> /autopss accordingly.
Matti Hamalainen <ccr@tnsp.org>
parents: 422
diff changeset
2352 <entry>/autopss</entry>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2353 <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
2354 </row>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2355 <row>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2356 <entry>/fullparty</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2357 <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
2358 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
2359 are shown.</entry>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2360 </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
2361 <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
2362 <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
2363 <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
2364 </row>
258
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2365 </tbody>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2366 </tgroup>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2367 </table>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2368 </section>
ee077893e923 Added new screenshots (from pss-mangler), some manual improvements.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
2369
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2370 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2371
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2372 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2373
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2374 <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
2375 <para>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2376 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
2377 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
2378 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
2379 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
2380 '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
2381 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
2382 </para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2383
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2384 <para>
1385
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2385 <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
2386 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
2387 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
2388 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
2389 </emphasis>
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2390 </para>
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2391
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2392 <para>
6fb66ee3ae03 docs: Clarify functionality of party placer module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1381
diff changeset
2393 NOTICE! This module requires
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2394 <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
2395 </para>
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2396
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2397 &sectmacros_2;
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2398 <row>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2399 <entry>/ppsave</entry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2400 <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
2401 in current formation are stored.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2402 </entry>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2403 </row>
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2404 <row>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2405 <entry>/ppreset</entry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2406 <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
2407 previously. Restoring occurs fully automatically.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
2408 </entry>
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2409 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2410 &sectmacros_end;
414
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2411
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2412 </section>
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2413
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2414 <!-- ================================================ -->
b13a94bd4ee5 Added section skeleton for GgrTF::PartyPlacer
Matti Hamalainen <ccr@tnsp.org>
parents: 410
diff changeset
2415
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2416 <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
2417 <note><para>
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2418 <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
2419 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
2420 </emphasis>
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2421 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
2422 </para></note>
230eb7ac1960 Add note about obsoleteness of GgrTF::Ptracker module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1157
diff changeset
2423
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2424 <para>
1099
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2425 Module for showing prots (and similar effects) affecting your party members.
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2426 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
2427 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
2428 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
2429 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
2430 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
2431 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
2432 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
2433 time is shown.</emphasis>
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2434 </para>
1099
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2435 <note><para>
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2436 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
2437 party members to use <emphasis>working, non-broken</emphasis> triggers
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2438 which use up/down messages that are recognizable to the ptracker module.
1225
9157e2a5441e Clarification.
Matti Hamalainen <ccr@tnsp.org>
parents: 1224
diff changeset
2439 However, this does not affect 'show effects' mode in any way.
1099
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2440 </para></note>
7321b2e8bb0f Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1075
diff changeset
2441
773
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2442 <screen>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2443 .------------+-----+-----+-----+-----+-----+-----+-----+-----+
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2444 | | 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
2445 +------------+-----+-----+-----+-----+-----+-----+-----+-----+
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2446 |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
2447 |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
2448 |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
2449 |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
2450 |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
2451 |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
2452 |Jrj | | | | | | 6:22| | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2453 |Daria | | | | | | | | |
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2454 |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
2455 `------------+-----+-----+-----+-----+-----+-----+-----+-----+
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2456 </screen>
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2457
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2458 <para>
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2459 <emphasis>NOTICE! This module requires
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2460 <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
2461 </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
2462 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
2463 and prot tracker.
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2464 </para>
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2465
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
2466 <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
2467 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
2468 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
2469 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
2470 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
2471 </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
2472
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2473 <!-- @commands -->
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2474 <!-- @binds -->
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2475 <!-- @keybinds -->
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2476
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2477 </section>
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2478
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2479 <!-- ================================================ -->
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
2480
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2481 <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
2482 <para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2483 This module adds in translating of spellwords to actual spell names.
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2484 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
2485 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
2486 under GPL with permission.
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2487 </para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2488
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2489 <para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2490 The translator works by printing the spell name in parentheses
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2491 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
2492 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
2493 </para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2494
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2495 <para>
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2496 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
2497 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
2498 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
2499 otherwise interesting spells are cast.
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2500 </para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2501
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2502 <para>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2503 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
2504 </para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2505
280
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2506 <screen>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2507 You utter the magic words (unstun)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2508
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2509 You utter the magic words 'Paxus' (unstun)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2510
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2511 Acolyte waves his index finger while uttering (flame arrow)
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2512
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2513 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
2514 </screen>
266b73905c1e Information about spellwords translator.
Matti Hamalainen <ccr@tnsp.org>
parents: 279
diff changeset
2515
1060
9f2987d1586f Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 1058
diff changeset
2516 <!-- @commands -->
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2517
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2518 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2519
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2520 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2521
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2522 <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
2523 <para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2524 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2525
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2526 <note>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2527 <para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2528 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
2529 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2530 </note>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2531
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2532 </section>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2533
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2534 <!-- ================================================ -->
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2535
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2536 <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
2537 <para>
262
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2538 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
2539 differences, several exceptions and workarounds are needed to
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2540 improve GgrTF's compatibility with the HCBat environment.
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2541 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
2542 </para>
262
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2543
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2544 <para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2545 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
2546 to contain almost everything related to peculiarities and
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2547 differences of HCBat. We do not have separate
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2548 guild-specific modules for HCBat, the code needed to
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2549 catch the differences is either in this module or in some
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2550 special cases in the guild-specific modules.
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2551 </para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2552
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2553 <para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2554 At the moment this module is rather simple, only replacing
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2555 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
2556 -channel in HCBat. In future more functionality may be added,
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2557 feel free to report bugs/incompatibilities to us.
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2558 </para>
63b3b52544c4 HCBat module description.
Matti Hamalainen <ccr@tnsp.org>
parents: 261
diff changeset
2559
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2560 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2561
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2562 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2563
1598
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2564 <para>
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2565 <emphasis>The functionality of the statusline depends on
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2566 your <link linkend="inst-config-batmud">BatMUD settings</link>
1601
fcb56c908184 Oops, 100L.
Matti Hamalainen <ccr@tnsp.org>
parents: 1598
diff changeset
2567 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
2568 not appear, most likely your 'sc' setting is "wrong",
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2569 and thus does not get parsed by GgrTF.
e3683413d8e2 Add notes about settings correctness.
Matti Hamalainen <ccr@tnsp.org>
parents: 1597
diff changeset
2570 </para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2571 </note>
642
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
2572
638
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2573 <screenshot>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2574 <mediaobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2575 <imageobject><imagedata fileref="statusbar_tf5.gif" format="GIF" /></imageobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2576 <imageobject><imagedata fileref="statusbar_tf5.eps" format="EPS" /></imageobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2577 <textobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2578 <phrase>GgrTF statusline</phrase>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2579 </textobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2580 <caption>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2581 <para>Example of typical basic GgrTF statusline in TF5.</para>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2582 </caption>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2583 </mediaobject>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2584 </screenshot>
Matti Hamalainen <ccr@tnsp.org>
parents: 635
diff changeset
2585
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2586 <itemizedlist>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2587 <listitem><para>
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2588 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
2589 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
2590 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
2591 </para></listitem>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2592
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2593 </itemizedlist>
422
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2594
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2595 <!--
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2596 - example configuration
5c219a591f1d Add TF5-section back in.
Matti Hamalainen <ccr@tnsp.org>
parents: 421
diff changeset
2597 - document special variables
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2598 -->
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2599 </section>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2600
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2601 <!-- ================================================ -->
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
2602
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2603 <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
2604 <para>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2605 This module contains utility functionality for everyone who casts
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2606 different types of dead raising spells, including "raise dead",
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2607 "resurrect", "new body", "reincarnation", etc.
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2608 </para>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2609
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2610 <para>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2611 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
2612 from you, along with information what spell was requested. List can
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2613 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
2614 specifying a player's name, cast his/her request.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2615 </para>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2616
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2617 <para>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2618 You can either directly use the macros or use <link
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2619 linkend="usage-general-binds">command bindings</link>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
2620 to have shorthand commands instead.
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2621 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2622
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2623 <screenshot>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2624 <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
2625 <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
2626 <imageobject><imagedata fileref="rais_list.eps" format="EPS" /></imageobject>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2627 <textobject>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2628 <phrase>List of accepts</phrase>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2629 </textobject>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2630 <caption>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2631 <para>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2632 An example output of "/aclist" macro, listing the players
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2633 who have accepted services from you and respective requested
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2634 spells for each. The time field shows how much
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2635 time has passed from the accept.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2636 </para>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2637 </caption>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2638 </mediaobject>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2639 </screenshot>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2640
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2641 <table><title>Macro commands</title>
1545
fe83084ff7e1 Fix some table column width.
Matti Hamalainen <ccr@tnsp.org>
parents: 1544
diff changeset
2642 <tgroup cols="2" align="left">
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2643 <thead>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2644 <row>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2645 <entry>Command</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2646 <entry>Description</entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2647 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2648 </thead>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2649 <tbody>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2650 <row>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2651 <entry>/aclist</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2652 <entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2653 View list of people who have accepted something from you.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2654 </entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2655 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2656 <row>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2657 <entry>/accast [name]</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2658 <entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2659 Cast Last-type functionality. Without arguments casts the LATEST
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2660 requested spell. Optionally you can specify a name of the player
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2661 and the spell requested by him/her is cast.
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2662 </entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2663 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2664 <row>
583
4bc4bc602eaf Renamed macros acpt_* -> ac*
Matti Hamalainen <ccr@tnsp.org>
parents: 567
diff changeset
2665 <entry>/acclear</entry>
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2666 <entry>
379
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2667 Clears the list. Useful, if the automatic removal
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2668 malfunctions for some reason. (For example, if target
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2669 uses 'pray' to become alive again, there is no message
Matti Hamalainen <ccr@tnsp.org>
parents: 345
diff changeset
2670 provided to the caster.)
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2671 </entry>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2672 </row>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2673 </tbody>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2674 </tgroup>
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2675 </table>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2676
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2677 <!-- @binds -->
317
7797ee045141 Rais-module documented.
Matti Hamalainen <ccr@tnsp.org>
parents: 315
diff changeset
2678
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2679 </section>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2680
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2681 <!-- ================================================ -->
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
2682
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2683 <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
2684 <para>
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2685 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
2686 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
2687 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
2688 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
2689 of hits you mostly deal out.
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2690 </para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2691
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2692 <para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2693 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
2694 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
2695 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
2696 </para>
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2697
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2698 <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
2699 <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
2700
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
2701 <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
2702 <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
2703 <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
2704 <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
2705 <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
2706 <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
2707 <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
2708 <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
2709 <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
2710 <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
2711 </itemizedlist>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2712
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2713 <note><para>
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2714 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
2715 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
2716 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
2717 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
2718 </emphasis>
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2719 </para></note>
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2720
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2721 <para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2722 Example of /hstats output:
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2723 </para>
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2724 <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
2725 ,----------------------.
62b1971f9772 v0.6.11.4-svn; Prompt handling improvements (enable colour lites in prompt, function execution); Handle @{} codes in /opts panel better; Many documentation updates related to prompt, and other things.
Matti Hamalainen <ccr@tnsp.org>
parents: 896
diff changeset
2726 | 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
2727 +-----------------------------------------------.
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 +-| 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
2729 |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
2730 |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
2731 |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
2732 |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
2733 |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
2734 |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
2735 | |
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 +-----------------------------------------------'
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 +-| 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
2738 | 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
2739 | 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
2740 +----------------------------------------------+-------'
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 | 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
2742 | 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
2743 | 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
2744 `----------------------------------------------'
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2745 </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
2746
774
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2747 <para>
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2748 Format of hits described above is:
1007
8c3b1463a0d9 Added some notes to hitstats documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1005
diff changeset
2749 | 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
2750 </para>
89661ef754b4 Incomplete documentation of hit statistics module.
Matti Hamalainen <ccr@tnsp.org>
parents: 773
diff changeset
2751
988
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2752 <note><para>
930c1485903f Added few details about hitstats module.
Matti Hamalainen <ccr@tnsp.org>
parents: 980
diff changeset
2753 <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
2754 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
2755 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
2756 </para></note>
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2757
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
2758 <!-- @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
2759 <!-- @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
2760 <!-- @keybinds -->
773
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 </section>
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2763
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2764 <!-- ================================================ -->
cb2413912904 Update pssmangler, and ptracker sections. Add skeleton hstats section.
Matti Hamalainen <ccr@tnsp.org>
parents: 772
diff changeset
2765
1377
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2766 <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
2767 <para>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2768 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
2769 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
2770 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
2771 </para>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2772
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2773 <para>
1563
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2774 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
2775 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
2776 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
2777 </para>
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2778
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2779 <para>
1377
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2780 Example of output:
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2781 </para>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2782 <screen>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2783 +-| General |----------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2784 | Item....: a pair of stylish blue breeches |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2785 | Name....: blue breeches |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2786 | Handles.: 'breeches', 'stylish blue breeches', 'silk breeches' and |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2787 | 'pants' |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2788 | Names...: Molotov, Belse and Ekkivekki |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2789 | Slots...: leg and leg |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2790 | Material: silk |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2791 +----------------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2792 | 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
2793 | Size....: somewhat small | Maxcond..: AWESOME |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2794 | Worth...: 8851 | Quality..: superb |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2795 | Weight..: almost weightless | Weight/kg: 0.050 |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2796 +-| Stats |------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2797 | insignificantly improve your wis |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2798 +-| Misc |-------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2799 | 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
2800 | 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
2801 | Wielded.: |
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2802 +----------------------------------------------------------------------------+
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2803 </screen>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2804
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2805 <!-- @commands -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2806 <!-- @binds -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2807 <!-- @keybinds -->
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 </section>
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2810
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2811 <!-- ================================================ -->
91d712edde9f Added section for Identify module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1376
diff changeset
2812
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2813 <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
2814 <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
2815 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
2816 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
2817 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
2818 </para>
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2819
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2820 <para>
53b64fd4ffea Added 'screenshot' of reagent pouch mangler, and a general module description for rpouch.
Matti Hamalainen <ccr@tnsp.org>
parents: 995
diff changeset
2821 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
2822 </para>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2823 <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
2824 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
2825 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
2826 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
2827 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
2828 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
2829 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
2830 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
2831 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
2832 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
2833 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
2834 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
2835 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
2836 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
2837 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
2838 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
2839 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
2840 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
2841 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
2842 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
2843 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
2844 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
2845 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
2846 It looks very very heavy.
956
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2847 </screen>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2848
972
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2849 <note><para>
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2850 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
2851 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
2852 this module.
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2853 </para></note>
ea85d502d46f Misc. typo fixes and minor reorganization.
Matti Hamalainen <ccr@tnsp.org>
parents: 969
diff changeset
2854
1563
d8c04a55d1d4 Move reagent pouch command documentation to tfdoc inline docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1562
diff changeset
2855 <!-- @commands -->
956
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 </section>
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2858
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2859 <!-- ================================================ -->
3b2205de6054 More work on the manual and CSS stylesheet.
Matti Hamalainen <ccr@tnsp.org>
parents: 954
diff changeset
2860
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2861 <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
2862 <para>
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2863 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
2864 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
2865 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
2866 <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
2867 </para>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2868
389
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2869 <itemizedlist>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2870 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2871 <emphasis>Channeller aura</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2872 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
2873 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
2874 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
2875 to recharge.
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2876 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2877 <listitem><para>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2878 <emphasis>Blast resistance reporting</emphasis>:
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2879 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
2880 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
2881 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2882 <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
2883 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
2884 </para></listitem>
30f38a49143d Lots of updates and half-finished new content added.
Matti Hamalainen <ccr@tnsp.org>
parents: 387
diff changeset
2885 </itemizedlist>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
2886
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2887 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2888 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2889 <!-- @keybinds -->
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 </section>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2892
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2893 <!-- ================================================ -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2894
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2895 <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
2896 <para>
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2897 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
2898 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
2899 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2900
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
2901 <note><para>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2902 This module requires the generic
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2903 <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
2904 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
2905 </para></note>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2906
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2907 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2908 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2909 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2910
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2911 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2912
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
2913 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2914
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
2915 <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
2916 <para>
263
Matti Hamalainen <ccr@tnsp.org>
parents: 262
diff changeset
2917 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
2918 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
2919 Many of the command macros support "autotargetting", which basically
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2920 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
2921 lumberjacking and "/mine" for mining and GgrTF usually knows what
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2922 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
2923 </para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2924
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2925 <para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2926 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
2927 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
2928 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
2929 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
2930 automagically change to proper tools (saw -&gt; hammer/pick). The
787
23b422d994e1 Various cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 786
diff changeset
2931 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
2932 </para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2933
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2934 <para>
1071
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2935 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
2936 <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
2937 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
2938 </para>
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2939
a728ef32c77e Add hint to merchant module documentation about usefulness of reagent pouch module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1069
diff changeset
2940 <para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2941 Notice that you probably MUST redefine some of these
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2942 macros and default settings in your TF configuration file!
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2943 (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
2944 </para>
15e3dafd668d Little more junk added in.
Matti Hamalainen <ccr@tnsp.org>
parents: 232
diff changeset
2945
1069
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2946 <note><para>
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2947 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
2948 </para></note>
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2949
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2950 <!-- @commands -->
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2951 <!-- @binds -->
1b81712b6261 Improve merchant module documentation, move things to embedded TFDocs.
Matti Hamalainen <ccr@tnsp.org>
parents: 1065
diff changeset
2952 <!-- @keybinds -->
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2953
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2954 <section id="usage-merchant-settings">
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2955 &sectvariables;
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 <entry>mtool_mine</entry>
251
3765cf197a77 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 250
diff changeset
2958 <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
2959 </row>
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 <entry>mtool_lj</entry>
251
3765cf197a77 Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 250
diff changeset
2962 <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
2963 </row>
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 <entry>mtool_bs</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2966 <entry>Tool(s) for blacksmithing.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2967 </row>
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 <entry>mtool_cp</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2970 <entry>Tool(s) for carpentry.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2971 </row>
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 <entry>mtool_gc</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2974 <entry>Tool(s) for gem cutting.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2975 </row>
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 <entry>mtool_gb</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2978 <entry>Tool(s) for glassblowing.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2979 </row>
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 <entry>mtool_ma</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2982 <entry>Tool(s) for masonry.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2983 </row>
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 <entry>mtool_sw</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2986 <entry>Tool(s) for sewing.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2987 </row>
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 <entry>mtool_sc</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2990 <entry>Tool(s) for sculpture skill.</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2991 </row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2992 <row>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2993 <entry>mforge_*</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2994 <entry>Forges/workbenches for skills (similar to mtool_* variables)</entry>
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2995 </row>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
2996 &sectvariablesend;
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
2997
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
2998
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
2999 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3000
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3001 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3002
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3003 <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
3004 <para>
1378
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3005 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
3006 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
3007 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
3008 additional helper for potion research.
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3009 </para>
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3010
1378
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3011 <para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3012 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
3013 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
3014 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
3015 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
3016 </para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3017
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3018 <para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3019 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
3020 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
3021 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
3022 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
3023 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
3024 </para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3025
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3026 <para>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3027 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
3028 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
3029
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3030 <userinput>/eval /set galch_file=%{HOME}/someotherfile.txt</userinput>
fbf2af8e3128 Improve documentation of alchemist module.
Matti Hamalainen <ccr@tnsp.org>
parents: 1377
diff changeset
3031
1380
27c5c0603192 Add note about setting galch_file variable.
Matti Hamalainen <ccr@tnsp.org>
parents: 1379
diff changeset
3032 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
3033 </para>
27c5c0603192 Add note about setting galch_file variable.
Matti Hamalainen <ccr@tnsp.org>
parents: 1379
diff changeset
3034
1376
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3035 <!-- @commands -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3036 <!-- @binds -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3037 <!-- @keybinds -->
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 </section>
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3040
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3041 <!-- ================================================ -->
3d73752368ae docs: Added barebones alchemist section.
Matti Hamalainen <ccr@tnsp.org>
parents: 1364
diff changeset
3042
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3043 <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
3044 <para>
263
Matti Hamalainen <ccr@tnsp.org>
parents: 262
diff changeset
3045 Provides a translator for barbarian reputation bar, reputation
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
3046 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
3047 </para>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3048
276
a1acf2b3de87 Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 275
diff changeset
3049 <section>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3050 &sectmacros_1;
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3051 </para>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3052
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3053 <table><title>Macro commands</title>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3054 <tgroup cols="3" align="left">
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3055 <thead>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3056 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3057 <entry>Binding</entry>
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3058 <entry>Macro</entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3059 <entry>Description</entry>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3060 </row>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3061 </thead>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3062 <tbody>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3063 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3064 <entry>repu</entry>
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3065 <entry>/showrep</entry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3066 <entry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3067 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
3068 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
3069 </entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3070 </row>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3071 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3072 <entry>lb</entry>
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3073 <entry>/lootburn</entry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3074 <entry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3075 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
3076 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
3077 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
3078 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
3079 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
3080 immediately.
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3081 </entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3082 </row>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3083 <row>
800
eeddfde43980 Fix barb module documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 787
diff changeset
3084 <entry></entry>
237
6c495ddc7d4d forgot <action> from burnaction
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 236
diff changeset
3085 <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
3086 <entry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3087 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
3088 <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
3089 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
3090 </entry>
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3091 </row>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3092 &sectmacros_end;
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3093
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3094 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3095 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3096 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3097
236
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3098 </section>
11b8e0016dcb Added some information about ggrtf-barb.tf -module
Jarkko Vaaraniemi <jeskko@pupunen.net>
parents: 235
diff changeset
3099
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3100 <!-- ================================================ -->
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3101
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3102 <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
3103 <para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3104 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
3105 spider servants.
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
3106 </para>
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3107
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3108 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3109 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3110 <!-- @keybinds -->
249
c864584906a2 Improvements in merchant section.
Matti Hamalainen <ccr@tnsp.org>
parents: 248
diff changeset
3111
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3112 </section>
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3113
248
6049eab4692f Updated manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 240
diff changeset
3114 <!-- ================================================ -->
231
2399b7d96036 More twiddling on manual, no actual content.
Matti Hamalainen <ccr@tnsp.org>
parents: 230
diff changeset
3115
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3116 <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
3117 <para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3118 Reporting of succesful and failed 'tiger claw' hits, lites for
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3119 claw and mak reputation gains.
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3120 </para>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3121
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3122 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3123 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3124 <!-- @keybinds -->
841
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 </section>
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3127
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3128 <!-- ================================================ -->
69b5fdbe688b Tinkering on the docs.
Matti Hamalainen <ccr@tnsp.org>
parents: 809
diff changeset
3129
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3130 <section id="usage-tarma"><title>Guild: Tarmalens (gm-tarma.tf)</title>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3131 <para>
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3132 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
3133 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
3134 '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
3135 </para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3136
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3137 <note><para>
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3138 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
3139 <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
3140 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
3141 </para></note>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3142
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3143 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3144 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3145 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3146
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3147 </section>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3148
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3149 <!-- ================================================ -->
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3150
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3151 <section id="usage-druid"><title>Guild: Druids (gm-druid.tf)</title>
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3152 <para>
394
ed989c51b94e v0.5.11.3: Moved functionality from temp to tarmalen module and
Matti Hamalainen <ccr@tnsp.org>
parents: 393
diff changeset
3153 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
3154 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
3155 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
3156 help for casting reincarnations (along with raises, resurrects, etc.)
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3157 </para>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3158
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3159 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3160 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3161 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3162
387
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3163 </section>
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3164
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3165 <!-- ================================================ -->
08045a08d828 Working
Matti Hamalainen <ccr@tnsp.org>
parents: 381
diff changeset
3166
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3167 <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
3168 <para>
1065
98dd57c1fc5e Move some documentation from manual to embedded tfdoc in the scripts.
Matti Hamalainen <ccr@tnsp.org>
parents: 1060
diff changeset
3169 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
3170 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
3171 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
3172 translator, etc.
489
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3173 </para>
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3174
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3175 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3176 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3177 <!-- @keybinds -->
703
20f20c1e8548 Updated copyright notices; Cosmetic cleanups; Updates to documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 695
diff changeset
3178
489
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3179 </section>
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3180
77c5862dd858 Removed some outdated comments concerning TF5 support.
Matti Hamalainen <ccr@tnsp.org>
parents: 454
diff changeset
3181 <!-- ================================================ -->
882
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3182
04abd37e4751 Rename additional modules from ggrtf-*.tf to gm-*.tf.
Matti Hamalainen <ccr@tnsp.org>
parents: 862
diff changeset
3183 <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
3184 <para>
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3185 Very barebones module with support for "blood" ripaction and
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3186 fail/fumble handling.
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3187 </para>
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3188
1049
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3189 <!-- @commands -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3190 <!-- @binds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3191 <!-- @keybinds -->
4d1fae5ae14e Updates to manual, use TFDoc directives.
Matti Hamalainen <ccr@tnsp.org>
parents: 1039
diff changeset
3192
271
e4b0e4d9695c Updates.
Matti Hamalainen <ccr@tnsp.org>
parents: 270
diff changeset
3193 </section>
254
cef90429b16a Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 251
diff changeset
3194
230
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3195 </chapter>
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3196
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3197 <!-- *************************************************************** -->
6a49ec96d5e5 Little work on manual.
Matti Hamalainen <ccr@tnsp.org>
parents: 226
diff changeset
3198
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3199 <appendix id="support"><title>Support</title>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3200
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3201 <itemizedlist>
1629
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3202 <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
3203 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
3204 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
3205 acted upon.
1630
07aadee01164 Oops, slight typo.
Matti Hamalainen <ccr@tnsp.org>
parents: 1629
diff changeset
3206 </para>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3207 <itemizedlist>
549
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3208 <listitem><para>Take your time to <emphasis>think</emphasis>
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3209 while writing, and before submitting your report. Good rule of
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3210 thumb is to include all information that you think might be
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3211 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
3212 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3213
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3214 <listitem><para>
549
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3215 Remember to include information about your system and environment,
6ea798c1ebd0 Twiddling.
Matti Hamalainen <ccr@tnsp.org>
parents: 546
diff changeset
3216 (*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
3217 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
3218 </para></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 </itemizedlist>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3221 </listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3222
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3223 <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
3224 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
3225 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
3226 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3227
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3228 <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
3229 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
3230 the workings yourself.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3231 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3232
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3233 <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
3234 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
3235 </para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3236
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3237 <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
3238 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
3239 your questions and resolving problems.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3240 </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 <!--
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3243 <listitem><para></para></listitem>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3244 -->
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3245 </itemizedlist>
1322
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3246
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3247 <section id="patches"><title>Sending patches/corrections</title>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3248 <para>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3249 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
3250 <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
3251 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
3252 <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
3253 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
3254 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
3255 </para>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3256 <screen>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3257 # 1) Make changes to files
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3258 $EDITOR ggrtf.tf
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 # 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
3261 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
3262
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3263 # 3) Repeat steps 1 to 2 until satisfied
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3264
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3265 # 4) Export your local changes to a bundle
1323
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3266 hg bundle mychanges.bz2 &hgrepourl;
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3267
bcfde549790f Improve patch creation instructions.
Matti Hamalainen <ccr@tnsp.org>
parents: 1322
diff changeset
3268 # 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
3269 </screen>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3270 </section>
903f92f4b918 Add note about sending patches.
Matti Hamalainen <ccr@tnsp.org>
parents: 1313
diff changeset
3271
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3272 </appendix>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3273
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3274 <!-- ================================================ -->
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3275
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3276 <appendix id="faq"><title>Frequently Asked Questions (FAQ)</title>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3277 <qandaset>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3278 <qandaentry>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3279 <question>
270
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3280 <para>Is "Grizzt" included in the documentation?</para>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3281 </question>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3282 <answer>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3283 <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
3284 </answer>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3285 </qandaentry>
314
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3286
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3287 <qandaentry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3288 <question>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3289 <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
3290 </question>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3291 <answer>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3292 <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
3293 </answer>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3294 </qandaentry>
3ab7390f437d Some new sections and new information added to previous sections.
Matti Hamalainen <ccr@tnsp.org>
parents: 313
diff changeset
3295
331
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3296
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3297 <qandaentry>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3298 <question>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3299 <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
3300 </question>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3301 <answer>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3302 <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
3303 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
3304 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
3305 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
3306 </para>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3307 <screen>
345
a53267af3f06 Typofixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 344
diff changeset
3308 /test prlist_insert("event_battle_round", "myroundgag")
a53267af3f06 Typofixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 344
diff changeset
3309 /def -i myroundgag = /substitute -ag
331
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3310 </screen>
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 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
3313 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
3314 </para>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3315 </answer>
806a7cf5e8de Add FAQ entry about gagging of round flag.
Matti Hamalainen <ccr@tnsp.org>
parents: 327
diff changeset
3316 </qandaentry>
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3317
381
6af6df52fefd v0.5.11.2: Removed tick predictor, it wasn't working anyway;
Matti Hamalainen <ccr@tnsp.org>
parents: 379
diff changeset
3318
343
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3319 <qandaentry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3320 <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
3321 <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
3322 </question>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3323 <answer>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3324 <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
3325 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
3326 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
3327 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
3328 </para>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3329 </answer>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3330 </qandaentry>
02fbd1028a27 Updates to the manual. New sections, reordering, typofixing,
Matti Hamalainen <ccr@tnsp.org>
parents: 340
diff changeset
3331
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3332 <qandaentry>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3333 <question>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3334 <para>How can I get my settings saved automatically? Or can I?</para>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3335 </question>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3336 <answer>
454
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3337 <para>Automatic saving and loading is possible, please refer to
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3338 <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
3339 and <link linkend="inst-config-tf">setup</link> -sections of
392
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3340 this manual for more information.
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3341 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3342 </answer>
Matti Hamalainen <ccr@tnsp.org>
parents: 391
diff changeset
3343 </qandaentry>
454
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3344
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3345 <qandaentry>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3346 <question>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3347 <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
3348 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
3349 </question>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3350 <answer>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3351 <para>
1629
be076ff19370 Remove references to bugtracker, as it has decayed due to bitrot.
Matti Hamalainen <ccr@tnsp.org>
parents: 1623
diff changeset
3352 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
3353 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
3354 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
3355 </para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3356 <para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3357 Also see the next question below.
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3358 </para>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3359 </answer>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3360 </qandaentry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3361
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3362 <qandaentry>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3363 <!--
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3364 <question>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3365 <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
3366 </question>
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3367 -->
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3368 <question>
454
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3369 <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
3370 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
3371 </question>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3372 <answer>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3373 <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
3374 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
3375 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
3376 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
3377 </para>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3378
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3379 <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
3380 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
3381 in-game settings.
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3382 </para>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3383 </answer>
9f98896b5e2b Add FAQ entry about problems concerning invalid 'cutter' setting.
Matti Hamalainen <ccr@tnsp.org>
parents: 453
diff changeset
3384 </qandaentry>
546
2991678d1a9a Issue reporting issues added. Information about bugtracker, etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 515
diff changeset
3385
642
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3386 <qandaentry>
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 <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
3389 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
3390 </question>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3391 <answer>
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 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
3394 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
3395 </para>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3396 </answer>
1be950a666af Added note about TF5 module requiring 5.0 beta 7 or later.
Matti Hamalainen <ccr@tnsp.org>
parents: 638
diff changeset
3397 </qandaentry>
1529
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3398
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3399 <qandaentry>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3400 <question>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3401 <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
3402 </question>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3403 <answer>
1539
78268db92315 Oops, a missing para-tag. Fixed.
Matti Hamalainen <ccr@tnsp.org>
parents: 1538
diff changeset
3404 <para>
1538
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
3405 Make sure you have configured your terminal correctly,
15682433fd7a More work on the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 1537
diff changeset
3406 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
3407 section for more information.
1539
78268db92315 Oops, a missing para-tag. Fixed.
Matti Hamalainen <ccr@tnsp.org>
parents: 1538
diff changeset
3408 </para>
1529
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3409 </answer>
74fe408138cc Add an FAQ item about numpad/keypad problems.
Matti Hamalainen <ccr@tnsp.org>
parents: 1526
diff changeset
3410 </qandaentry>
270
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3411 <!--
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3412 <qandaentry>
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3413 <question>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3414 <para></para>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3415 </question>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3416 <answer>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3417 <para>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3418 </para>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3419 </answer>
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3420 </qandaentry>
270
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3421 -->
17bab0d7060a FAQ: Grizzt
Matti Hamalainen <ccr@tnsp.org>
parents: 267
diff changeset
3422 </qandaset>
781
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3423
1c0af78e9a84 Fix appendix chapters.
Matti Hamalainen <ccr@tnsp.org>
parents: 777
diff changeset
3424 </appendix>
259
Matti Hamalainen <ccr@tnsp.org>
parents: 258
diff changeset
3425
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3426 <!-- ================================================ -->
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3427
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3428 <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
3429 GnuPG</title>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3430 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3431 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
3432 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
3433 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
3434 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3435
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3436 <itemizedlist>
1544
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3437 <listitem>
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 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
3440 <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
3441 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3442 </listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3443 <listitem>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3444 <para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3445 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
3446 <userinput>gpg --verify ggrtf-&ggrtfver;.tar.gz.asc</userinput>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3447 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
3448 signature from "Matti Hamalainen (ccr) &lt;ccr@tnsp.org&gt;"'
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3449 </para>
539af86668a9 Some DocBook validation fixes.
Matti Hamalainen <ccr@tnsp.org>
parents: 1543
diff changeset
3450 </listitem>
772
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3451 </itemizedlist>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3452
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3453 <para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3454 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
3455 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
3456 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
3457 GNU Privacy Handbook</ulink> is available from GnuPG project.
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3458 (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
3459 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
3460 http://www.gnupg.org/documentation/guides.en.html</ulink>.)
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3461 </para>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3462 </appendix>
7e87785965bf Tiny updates to the documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 771
diff changeset
3463
223
0bee9da5715a Manual skeleton.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
3464 </book>