Merge lp:~stefanor/ibid/pandoc-man-511899 into lp:~ibid-core/ibid/old-trunk-1.6
- pandoc-man-511899
- Merge into old-trunk-1.6
Proposed by
Stefano Rivera
Status: | Merged | ||||
---|---|---|---|---|---|
Approved by: | Stefano Rivera | ||||
Approved revision: | 914 | ||||
Merged at revision: | 915 | ||||
Proposed branch: | lp:~stefanor/ibid/pandoc-man-511899 | ||||
Merge into: | lp:~ibid-core/ibid/old-trunk-1.6 | ||||
Diff against target: |
1173 lines (+554/-501) 12 files modified
man/Makefile (+13/-0) man/README (+4/-0) man/ibid-db.1.md (+62/-57) man/ibid-factpack.1.md (+61/-56) man/ibid-knab-import.1.md (+47/-41) man/ibid-memgraph.1.md (+41/-36) man/ibid-objgraph.1.md (+48/-47) man/ibid-pb-client.1.md (+43/-47) man/ibid-plugin.1.md (+64/-64) man/ibid-setup.1.md (+35/-32) man/ibid.1.md (+35/-26) man/ibid.ini.5.md (+101/-95) |
||||
To merge this branch: | bzr merge lp:~stefanor/ibid/pandoc-man-511899 | ||||
Related bugs: |
|
Reviewer | Review Type | Date Requested | Status |
---|---|---|---|
Michael Gorven | Approve | ||
Jonathan Hitchcock | Approve | ||
Max Rabkin | Approve | ||
Review via email: mp+21400@code.launchpad.net |
Commit message
Convert manpages to Markdown and generate with pandoc
Description of the change
To post a comment you must log in.
- 913. By Stefano Rivera
-
Correct spelling
- 914. By Stefano Rivera
-
Escape -- to prevent rendering as dash
Revision history for this message
Jonathan Hitchcock (vhata) : | # |
review:
Approve
Revision history for this message
Keegan Carruthers-Smith (keegan-csmith) wrote : | # |
I thought pandoc supported restructured text? Is it not more consistent to stick with rst?
Revision history for this message
Stefano Rivera (stefanor) wrote : | # |
> I thought pandoc supported restructured text? Is it not more consistent to
> stick with rst?
Yes, that was my original intention. However it doesn't seem to support building the man-page header fields when converting from rst to nroff.
I switched and also noted that markdown would be conciser than the equivalent rst, which was enough to convince me to stick with it.
Preview Diff
[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1 | === added file 'man/Makefile' |
2 | --- man/Makefile 1970-01-01 00:00:00 +0000 |
3 | +++ man/Makefile 2010-03-20 10:39:26 +0000 |
4 | @@ -0,0 +1,13 @@ |
5 | +MANPAGES=$(patsubst %.md,%,$(wildcard *.md)) |
6 | + |
7 | +all: $(MANPAGES) |
8 | + |
9 | +clean: |
10 | + rm -f $(MANPAGES) |
11 | + |
12 | +%: %.md |
13 | +# Incorrect escaping in code blocks: |
14 | +# http://code.google.com/p/pandoc/issues/detail?id=223 |
15 | + pandoc -s -t man $< | sed -e '/^[^.]/ s/\\"/"/g' > $@ |
16 | + |
17 | +.PHONY: all clean |
18 | |
19 | === added file 'man/README' |
20 | --- man/README 1970-01-01 00:00:00 +0000 |
21 | +++ man/README 2010-03-20 10:39:26 +0000 |
22 | @@ -0,0 +1,4 @@ |
23 | +All files in this directory are: |
24 | + |
25 | +Copyright (c) 2010, Stefano Rivera |
26 | +Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
27 | |
28 | === renamed file 'man/ibid-db.1' => 'man/ibid-db.1.md' |
29 | --- man/ibid-db.1 2010-03-08 20:27:21 +0000 |
30 | +++ man/ibid-db.1.md 2010-03-20 10:39:26 +0000 |
31 | @@ -1,59 +1,64 @@ |
32 | -.\" Copyright (c) 2010, Stefano Rivera |
33 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
34 | -.TH IBID-DB "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
35 | -.SH NAME |
36 | -ibid-db \- Database management utility for Ibid |
37 | -.SH SYNOPSIS |
38 | -.B ibid-db command |
39 | -.RI [ options ...] |
40 | -.SH DESCRIPTION |
41 | -This utility is for offline management of your Ibid bot's database. |
42 | -Used for import, export, and upgrades. |
43 | -.P |
44 | +% IBID-DB(1) Ibid Multi-protocol Bot | Ibid 0.1 |
45 | +% Stefano Rivera |
46 | +% March 2010 |
47 | + |
48 | +# NAME |
49 | + |
50 | +ibid-db - Database management utility for Ibid |
51 | + |
52 | +# SYNOPSIS |
53 | + |
54 | +**ibid-db** *command* [*options*...] |
55 | + |
56 | +# DESCRIPTION |
57 | + |
58 | +This utility is for offline management of your Ibid bot's database. Used for |
59 | +import, export, and upgrades. |
60 | + |
61 | The export format is DBMS-agnostic and can be used to migrate between different |
62 | databases. |
63 | -.SH COMMANDS |
64 | -.TP |
65 | -\fB\-e\fR \fIFILE\fR, \fB\-\-export\fR=\fIFILE\fR |
66 | -Export DB contents to \fIFILE\fR. |
67 | -Export format is JSON. |
68 | -.IP |
69 | -FILE can be \fB\-\fR for stdin/stdout or can end in \fB.gz\fR for automatic |
70 | -gzip compression. |
71 | -.TP |
72 | -\fB\-i\fR \fIFILE\fR, \fB\-\-import\fR=\fIFILE\fR |
73 | -Import DB contents from \fIFILE\fR as exported by this utility. |
74 | -.IP |
75 | -FILE can be \fB\-\fR for stdin/stdout or can end in \fB.gz\fR for automatic |
76 | -gzip compression. |
77 | -.IP |
78 | -.B Note: |
79 | -The DB must be empty first. |
80 | -.TP |
81 | -\fB\-u\fR, \fB\-\-upgrade\fR |
82 | -Upgrade DB schema to the latest version. |
83 | -You need to run this after upgrading your bot. |
84 | -.IP |
85 | -.B Note: |
86 | -You should backup first. |
87 | -.SH OPTIONS |
88 | -.TP |
89 | -\fB\-\-version\fR |
90 | -Show the program's version and exit. |
91 | -.TP |
92 | -\fB\-h\fR, \fB\-\-help\fR |
93 | -Show a help message and exit. |
94 | -.TP |
95 | -\fB\-v\fR, \fB\-\-verbose\fR |
96 | -Turn on debugging output to stderr. |
97 | -.SH FILES |
98 | -.TP |
99 | -.I ibid.ini |
100 | -Locates the database to act upon by looking for the \fB[databases].ibid\fR value |
101 | -in the bot configuration file in the current directory. |
102 | -.SH SEE ALSO |
103 | -.BR ibid (1), |
104 | -.BR ibid.ini (5), |
105 | -.BR ibid-setup (1), |
106 | -.UR http://ibid.omnia.za.net/ |
107 | -.BR http://ibid.omnia.za.net/ |
108 | + |
109 | +# COMMANDS |
110 | + |
111 | +**-e** *FILE*, **-\-export**=*FILE* |
112 | +: Export DB contents to *FILE*. |
113 | + Export format is JSON. |
114 | + *FILE* can be **-** for *stdout* or can end in **.gz** for automatic gzip |
115 | + compression. |
116 | + |
117 | +**-i** *FILE*, **-\-import**=*FILE* |
118 | +: Import DB contents from *FILE* as exported by this utility. |
119 | + *FILE* can be **-** for *stdin* or can end in **.gz** for automatic gzip |
120 | + compression. |
121 | + |
122 | +: **Note:** The DB must be empty first. |
123 | + |
124 | +**-u**, **-\-upgrade** |
125 | +: Upgrade DB schema to the latest version. |
126 | + You need to run this after upgrading your bot. |
127 | + |
128 | +: **Note:** You should backup first. |
129 | + |
130 | +# OPTIONS |
131 | + |
132 | +**-\-version** |
133 | +: Show the program's version and exit. |
134 | + |
135 | +**-h**, **-\-help** |
136 | +: Show a help message and exit. |
137 | + |
138 | +**-v**, **-\-verbose** |
139 | +: Turn on debugging output to stderr. |
140 | + |
141 | +# FILES |
142 | + |
143 | +*ibid.ini* |
144 | +: Locates the database to act upon by looking for the |
145 | + [**databases**].**ibid** value in the bot configuration file in the current |
146 | + directory. |
147 | + |
148 | +# SEE ALSO |
149 | +`ibid` (1), |
150 | +`ibid.ini` (5), |
151 | +`ibid-setup` (1), |
152 | +http://ibid.omnia.za.net/ |
153 | |
154 | === renamed file 'man/ibid-factpack.1' => 'man/ibid-factpack.1.md' |
155 | --- man/ibid-factpack.1 2010-03-08 20:27:21 +0000 |
156 | +++ man/ibid-factpack.1.md 2010-03-20 10:39:26 +0000 |
157 | @@ -1,65 +1,70 @@ |
158 | -.\" Copyright (c) 2010, Stefano Rivera |
159 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
160 | -.TH IBID-FACTPACK "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
161 | -.SH NAME |
162 | -ibid-factpack \- Factoid-package management utility for Ibid |
163 | -.SH SYNOPSIS |
164 | -.B ibid-factpack |
165 | -.RB [ -s ] |
166 | -.I factpack-file |
167 | -.br |
168 | -.B ibid-factpack -r |
169 | -.RB [ -f ] |
170 | -.I factpack-name |
171 | -.br |
172 | -.B ibid-factpack -h |
173 | -.SH DESCRIPTION |
174 | +% IBID-FACTPACK(1) Ibid Multi-protocol Bot | Ibid 0.1 |
175 | +% Stefano Rivera |
176 | +% March 2010 |
177 | + |
178 | +# NAME |
179 | + |
180 | +ibid-factpack - Factoid-package management utility for Ibid |
181 | + |
182 | +# SYNOPSIS |
183 | + |
184 | +**ibid-factpack** [**-s**] *factpack-file* |
185 | +**ibid-factpack** **-r** [**-f**] *factpack-name* |
186 | +**ibid-factpack** **-h** |
187 | + |
188 | +# DESCRIPTION |
189 | + |
190 | This utility is for adding and removing sets of packaged factoids, known as |
191 | factpacks, from your Ibid's factoid database. |
192 | -.P |
193 | + |
194 | The default mode is factpack loading. |
195 | -The \fIfactpack-file\fR specified is loaded into the bot's database. |
196 | +The *factpack-file* specified is loaded into the bot's database. |
197 | Should the pack contain any facts with the same name as an existing fact in the |
198 | -bot's database, loading will be aborted, unless the \fB-s\fR option is |
199 | -supplied. |
200 | -.P |
201 | -Factpacks can be gzipped if the filename ends with \fB\.gz\fR. |
202 | -.P |
203 | -When invoked with the \fB-r\fR option, the named factpack (original import |
204 | +bot's database, loading will be aborted, unless the *-s* option is supplied. |
205 | + |
206 | +Factpacks can be gzipped if the filename ends with **.gz**. |
207 | + |
208 | +When invoked with the **-r** option, the named factpack (original import |
209 | filename minus the extension) will be removed from the bot. |
210 | If any of the facts contained in that pack were modified while loaded in the |
211 | -bot, unloading will be aborted, unless the \fB-f\fR option is supplied. |
212 | -.SH OPTIONS |
213 | -.TP |
214 | -\fB\-r\fR, \fB\-\-remove\fR |
215 | -Remove the named factpack, rather than importing. |
216 | -.TP |
217 | -\fB\-f\fR, \fB\-\-force\fR |
218 | -Force removal, if facts in the factpack were modified by users. |
219 | -.TP |
220 | -\fB\-s\fR, \fB\-\-skip\fR |
221 | -Skip facts that clash with existing factoids, during import. |
222 | -.TP |
223 | -\fB\-h\fR, \fB\-\-help\fR |
224 | -Show a help message and exit. |
225 | -.SH FACTPACKS |
226 | +bot, unloading will be aborted, unless the **-f** option is supplied. |
227 | + |
228 | +# OPTIONS |
229 | + |
230 | +**-r**, **-\-remove** |
231 | +: Remove the named factpack, rather than importing. |
232 | + |
233 | +**-f**, **-\-force** |
234 | +: Force removal, if facts in the factpack were modified by users. |
235 | + |
236 | +**-s**, **-\-skip** |
237 | +: Skip facts that clash with existing factoids, during import. |
238 | + |
239 | +**-h**, **-\-help** |
240 | +: Show a help message and exit. |
241 | + |
242 | +# FACTPACKS |
243 | + |
244 | Factpacks are JSON-encoded text files containing a list of facts. |
245 | Each fact is a tuple of two lists: fact-names, fact-values. |
246 | The same substitutions are available as in normal online Factoids. |
247 | -.SS Example: |
248 | -.nf |
249 | -[ |
250 | - [["Hello", "Hi"], ["<reply> Hi There", "<action> waves"]], |
251 | - [["Bye"], ["<reply> kbye $who", "<reply> Cheers"]] |
252 | -] |
253 | -.fi |
254 | -.SH FILES |
255 | -.TP |
256 | -.I ibid.ini |
257 | -Locates the database to act upon by looking for the \fB[databases].ibid\fR value |
258 | -in the bot configuration file in the current directory. |
259 | -.SH SEE ALSO |
260 | -.BR ibid (1), |
261 | -.BR ibid.ini (5), |
262 | -.UR http://ibid.omnia.za.net/ |
263 | -.BR http://ibid.omnia.za.net/ |
264 | + |
265 | +## Example: |
266 | + |
267 | + [ |
268 | + [["Hello", "Hi"], ["<reply> Hi There", "<action> waves"]], |
269 | + [["Bye"], ["<reply> kbye $who", "<reply> Cheers"]] |
270 | + ] |
271 | + |
272 | +# FILES |
273 | + |
274 | +*ibid.ini* |
275 | +: Locates the database to act upon by looking for the |
276 | + [**databases**].**ibid** value in the bot configuration file in the current |
277 | + directory. |
278 | + |
279 | +# SEE ALSO |
280 | + |
281 | +`ibid` (1), |
282 | +`ibid.ini` (5), |
283 | +http://ibid.omnia.za.net/ |
284 | |
285 | === renamed file 'man/ibid-knab-import.1' => 'man/ibid-knab-import.1.md' |
286 | --- man/ibid-knab-import.1 2010-03-08 20:27:21 +0000 |
287 | +++ man/ibid-knab-import.1.md 2010-03-20 10:39:26 +0000 |
288 | @@ -1,44 +1,50 @@ |
289 | -.\" Copyright (c) 2010, Stefano Rivera |
290 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
291 | -.TH IBID-DB "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
292 | -.SH NAME |
293 | -ibid-knab-import \- Knab->Ibid Import utility |
294 | -.SH SYNOPSIS |
295 | -.B ibid-knab-import |
296 | -.I knab-sa-url |
297 | -.I source |
298 | -.RI [ config-file ] |
299 | -.SH DESCRIPTION |
300 | -This utility imports users, last seen information, factoids, and URLs |
301 | -from a Knab bot's database into an Ibid. |
302 | -.P |
303 | +% IBID-KNAB-IMPORT(1) Ibid Multi-protocol Bot | Ibid 0.1 |
304 | +% Stefano Rivera |
305 | +% March 2010 |
306 | + |
307 | +# NAME |
308 | + |
309 | +ibid-knab-import - Knab->Ibid Import utility |
310 | + |
311 | +# SYNOPSIS |
312 | + |
313 | +**ibid-knab-import** *knab-sa-url* *source* [*config-file*] |
314 | + |
315 | +# DESCRIPTION |
316 | + |
317 | +This utility imports users, last seen information, factoids, and URLs from a |
318 | +Knab bot's database into an Ibid. |
319 | + |
320 | For best results, import directly into a brand new, clean Ibid install. |
321 | -.P |
322 | + |
323 | On import, strings are converted to Unicode, guessing UTF-8 and falling back to |
324 | detection. |
325 | -.SH OPTIONS |
326 | -.TP |
327 | -.I knab-sa-url |
328 | -The SQLAlchemy URI for the Knab's database. |
329 | -The format is |
330 | -.BI mysql:// user : pass @ hostname / dbname |
331 | -.TP |
332 | -.I source |
333 | -The name in the Ibid bot for the source that the Knab was previously connected to. |
334 | -.TP |
335 | -.I config-file |
336 | -If supplied, this is configuration file is used for locating the Ibid's |
337 | -database rather than \fBibid.ini\fR. |
338 | -.SH FILES |
339 | -.TP |
340 | -.I ibid.ini |
341 | -Locates the database to act upon by looking for the \fB[databases].ibid\fR value |
342 | -in the bot configuration file in the current directory. |
343 | -.SH SEE ALSO |
344 | -.BR ibid (1), |
345 | -.BR ibid.ini (5), |
346 | -.BR ibid-setup (1), |
347 | -.UR http://ibid.omnia.za.net/ |
348 | -.BR http://ibid.omnia.za.net/ , |
349 | -.UR http://knab.omnia.za.net/ |
350 | -.BR http://knab.omnia.za.net/ |
351 | + |
352 | +# OPTIONS |
353 | + |
354 | +*knab-sa-url* |
355 | +: The SQLAlchemy URI for the Knab's database. |
356 | + The format is **mysql://**_user_**:**_pass_**@**_hostname_**/**_dbname_ |
357 | + |
358 | +*source* |
359 | +: The name in the Ibid bot for the source that the Knab was previously |
360 | + connected to. |
361 | + |
362 | +*config-file* |
363 | +: If supplied, this is configuration file is used for locating the Ibid's |
364 | + database rather than **ibid.ini**. |
365 | + |
366 | +# FILES |
367 | + |
368 | +*ibid.ini* |
369 | +: Locates the database to act upon by looking for the |
370 | + [**databases**].**ibid** value in the bot configuration file in the current |
371 | + directory. |
372 | + |
373 | +# SEE ALSO |
374 | + |
375 | +`ibid` (1), |
376 | +`ibid.ini` (5), |
377 | +`ibid-setup` (1), |
378 | +http://ibid.omnia.za.net/, |
379 | +http://knab.omnia.za.net/ |
380 | |
381 | === renamed file 'man/ibid-memgraph.1' => 'man/ibid-memgraph.1.md' |
382 | --- man/ibid-memgraph.1 2010-03-08 20:27:21 +0000 |
383 | +++ man/ibid-memgraph.1.md 2010-03-20 10:39:26 +0000 |
384 | @@ -1,39 +1,44 @@ |
385 | -.\" Copyright (c) 2010, Stefano Rivera |
386 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
387 | -.TH IBID-MEMGRAPH "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
388 | -.SH NAME |
389 | -ibid-memgraph \- Memory usage graph generation utility for Ibid |
390 | -.SH SYNOPSIS |
391 | -.B ibid-memgraph |
392 | -.RB [ options ...] |
393 | -.I logfile |
394 | -.br |
395 | -.B ibid-memgraph -h |
396 | -.SH DESCRIPTION |
397 | +% IBID-MEMGRAPH(1) Ibid Multi-protocol Bot | Ibid 0.1 |
398 | +% Stefano Rivera |
399 | +% March 2010 |
400 | + |
401 | +# NAME |
402 | + |
403 | +ibid-memgraph - Memory usage graph generation utility for Ibid |
404 | + |
405 | +# SYNOPSIS |
406 | + |
407 | +**ibid-memgraph** [*options*...] *logfile* |
408 | +**ibid-memgraph** **-h** |
409 | + |
410 | +# DESCRIPTION |
411 | + |
412 | This utility is for graphing memory usage from an Ibid bot configured to |
413 | log such usage. |
414 | -.P |
415 | + |
416 | Matplotlib is required for graphing. |
417 | -.SH OPTIONS |
418 | -.TP |
419 | -\fB\-o\fR \fIFILE\fR, \fB\-\-output\fR=\fIFILE\fR |
420 | -Output to \fIFILE\fR instead of displaying interactive graph GUI. |
421 | -\fIFILE\fR can be any format supported by Matplotlib, detected by the file |
422 | -extension. |
423 | -.TP |
424 | -\fB\-d\fR \fIDPI\fR, \fB\-\-dpi\fR=\fIDPI\fR |
425 | -When outputting in raster formats, use \fIDPI\fR output DPI. |
426 | -.TP |
427 | -\fB\-h\fR, \fB\-\-help\fR |
428 | -Show a help message and exit. |
429 | -.SH FILES |
430 | -.TP |
431 | -.I logfile |
432 | -A log file generated by loading the \fBmemory\fR plugin into Ibid, which will |
433 | -periodically log memory usage. |
434 | -It can be gzip compressed, if the filename ends in \fB.gz\fR. |
435 | -.SH SEE ALSO |
436 | -.BR ibid (1), |
437 | -.BR ibid-objgraph (1), |
438 | -.UR http://ibid.omnia.za.net/ |
439 | -.BR http://ibid.omnia.za.net/ |
440 | + |
441 | +# OPTIONS |
442 | + |
443 | +**-o** *FILE*, **-\-output**=*FILE* |
444 | +: Output to *FILE* instead of displaying interactive graph GUI. |
445 | + *FILE* can be any format supported by Matplotlib, detected by the file |
446 | + extension. |
447 | + |
448 | +**-d** *DPI*, **-\-dpi**=*DPI* |
449 | + When outputting in raster formats, use *DPI* output DPI. |
450 | + |
451 | +**-h**, **-\-help** |
452 | + Show a help message and exit. |
453 | + |
454 | +# FILES |
455 | + |
456 | +*logfile* |
457 | +: A log file generated by loading the **memory** plugin into Ibid, which will |
458 | + periodically log memory usage. |
459 | + It can be gzip compressed, if the filename ends in **.gz**. |
460 | + |
461 | +# SEE ALSO |
462 | +`ibid` (1), |
463 | +`ibid-objgraph` (1), |
464 | +http://ibid.omnia.za.net/ |
465 | |
466 | === renamed file 'man/ibid-objgraph.1' => 'man/ibid-objgraph.1.md' |
467 | --- man/ibid-objgraph.1 2010-03-08 20:27:21 +0000 |
468 | +++ man/ibid-objgraph.1.md 2010-03-20 10:39:26 +0000 |
469 | @@ -1,50 +1,51 @@ |
470 | -.\" Copyright (c) 2010, Stefano Rivera |
471 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
472 | -.TH IBID-OBJGRAPH "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
473 | -.SH NAME |
474 | -ibid-objgraph \- Memory usage graph generation utility for Ibid |
475 | -.SH SYNOPSIS |
476 | -.B ibid-objgraph |
477 | -.RB [ options ...] |
478 | -.IR "logfile type" ... |
479 | -.br |
480 | -.B ibid-objgraph |
481 | -.BI "-e " TIME |
482 | -.RB [ options ...] |
483 | -.I logfile |
484 | -.br |
485 | -.B ibid-objgraph -h |
486 | -.SH DESCRIPTION |
487 | +% IBID-OBJGRAPH(1) Ibid Multi-protocol Bot | Ibid 0.1 |
488 | +% Stefano Rivera |
489 | +% March 2010 |
490 | + |
491 | +# NAME |
492 | + |
493 | +ibid-objgraph - Memory usage graph generation utility for Ibid |
494 | + |
495 | +# SYNOPSIS |
496 | + |
497 | +**ibid-objgraph** [*options*...] *logfile* *type*... |
498 | +**ibid-objgraph** [*options*...] **-e** *TIME* *logfile* |
499 | +**ibid-objgraph** **-h** |
500 | + |
501 | +# DESCRIPTION |
502 | + |
503 | This utility is for graphing object-type usage from an Ibid bot |
504 | configured to log such usage. |
505 | -.P |
506 | + |
507 | Matplotlib is required for graphing. |
508 | -.SH OPTIONS |
509 | -.TP |
510 | -\fB\-e\fR \fITIME\fR, \fB\-\-examine\fR=\fITIME\fR |
511 | -Examine the object usage at time \fITIME\fR, and print a sorted list of type |
512 | -statistics at that time. |
513 | -This function can be useful in determining which types to graph, when chasing |
514 | -down a detected leak. |
515 | -.TP |
516 | -\fB\-o\fR \fIFILE\fR, \fB\-\-output\fR=\fIFILE\fR |
517 | -Output to \fIFILE\fR instead of displaying interactive graph GUI. |
518 | -\fIFILE\fR can be any format supported by Matplotlib, detected by the file |
519 | -extension. |
520 | -.TP |
521 | -\fB\-d\fR \fIDPI\fR, \fB\-\-dpi\fR=\fIDPI\fR |
522 | -When outputting in raster formats, use \fIDPI\fR output DPI. |
523 | -.TP |
524 | -\fB\-h\fR, \fB\-\-help\fR |
525 | -Show a help message and exit. |
526 | -.SH FILES |
527 | -.TP |
528 | -.I logfile |
529 | -A log file generated by loading the \fBmemory\fR plugin into Ibid, which will |
530 | -periodically log object usage. |
531 | -It can be gzip compressed, if the filename ends in \fB.gz\fR. |
532 | -.SH SEE ALSO |
533 | -.BR ibid (1), |
534 | -.BR ibid-memgraph (1), |
535 | -.UR http://ibid.omnia.za.net/ |
536 | -.BR http://ibid.omnia.za.net/ |
537 | + |
538 | +# OPTIONS |
539 | + |
540 | +**-e** *TIME*, **-\-examine**=*TIME* |
541 | +: Examine the object usage at time *TIME*, and print a sorted list of type |
542 | + statistics at that time. |
543 | + This function can be useful in determining which types to graph, when |
544 | + chasing down a detected leak. |
545 | + |
546 | +**-o** *FILE*, **-\-output**=*FILE* |
547 | +: Output to *FILE* instead of displaying interactive graph GUI. |
548 | + *FILE* can be any format supported by Matplotlib, detected by the file |
549 | + extension. |
550 | + |
551 | +**-d** *DPI*, **-\-dpi**=*DPI* |
552 | +: When outputting in raster formats, use *DPI* output DPI. |
553 | + |
554 | +**-h**, **-\-help** |
555 | + Show a help message and exit. |
556 | + |
557 | +# FILES |
558 | + |
559 | +*logfile* |
560 | +: A log file generated by loading the **memory** plugin into Ibid, which will |
561 | + periodically log object usage. |
562 | + It can be gzip compressed, if the filename ends in **.gz**. |
563 | + |
564 | +# SEE ALSO |
565 | +`ibid` (1), |
566 | +`ibid-memgraph` (1), |
567 | +http://ibid.omnia.za.net/ |
568 | |
569 | === renamed file 'man/ibid-pb-client.1' => 'man/ibid-pb-client.1.md' |
570 | --- man/ibid-pb-client.1 2010-03-08 20:27:21 +0000 |
571 | +++ man/ibid-pb-client.1.md 2010-03-20 10:39:26 +0000 |
572 | @@ -1,54 +1,50 @@ |
573 | -.\" Copyright (c) 2010, Stefano Rivera |
574 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
575 | -.TH IBID-PB-CLIENT "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
576 | -.SH NAME |
577 | -ibid-pb-client \- RPC Client for Ibid |
578 | -.SH SYNOPSIS |
579 | -.B ibid-pb-client |
580 | -.RI [ options ...] |
581 | -.BI message " message" |
582 | -.br |
583 | -.B ibid-pb-client |
584 | -.RI [ options ...] |
585 | -.BI plugin " feature method" |
586 | -.RI [ parameter ...] |
587 | -.br |
588 | -.B ibid-pb-client -h |
589 | -.SH DESCRIPTION |
590 | +% IBID-PB-CLIENT(1) Ibid Multi-protocol Bot | Ibid 0.1 |
591 | +% Stefano Rivera |
592 | +% March 2010 |
593 | + |
594 | +# NAME |
595 | + |
596 | +ibid-pb-client - RPC Client for Ibid |
597 | + |
598 | +# SYNOPSIS |
599 | + |
600 | +**ibid-pb-client** [*options*...] **message** *message* |
601 | +**ibid-pb-client** [*options*...] **plugin** *feature* *method* [*parameter*...] |
602 | +**ibid-pb-client** **-h** |
603 | + |
604 | +# DESCRIPTION |
605 | + |
606 | This utility is for passing events to a running Ibid bot, or executing |
607 | RPC-exposed functions remotely. |
608 | -.P |
609 | -It communicates with the \fBpb\fR source on the Ibid. |
610 | -.P |
611 | -.I message |
612 | -is a text message as could be sent to the bot by an IM source. |
613 | + |
614 | +It communicates with the **pb** source on the Ibid. |
615 | + |
616 | +*message* is a text message as could be sent to the bot by an IM source. |
617 | The message is processed normally by the bot. |
618 | -.P |
619 | -.I feature |
620 | -is the name of the feature to invoke exposed method \fImethod\fR on, |
621 | + |
622 | +*feature* is the name of the feature to invoke exposed method **method** on, |
623 | directly. |
624 | -.IR parameter s |
625 | -are passed directly to the method. |
626 | -They can be specified positionally or by key, using the same syntax as |
627 | -Python: |
628 | -.IR key = value . |
629 | +*parameter*s are passed directly to the method. |
630 | +They can be specified positionally or by key, using the same syntax as Python: |
631 | +_key_**=**_value_. |
632 | They may be encoded in JSON, if not valid JSON they will be treated as |
633 | strings. |
634 | -.P |
635 | + |
636 | The output is a JSON-encoded response. |
637 | -.SH OPTIONS |
638 | -.TP |
639 | -\fB\-s\fR \fIHOSTNAME\fR, \fB\-\-server\fR=\fISERVER\fR |
640 | -Connect to the Ibid running on \fISERVER\fR, by default it connects to |
641 | -\fIlocalhost\fR. |
642 | -.TP |
643 | -\fB\-p\fR \fIFILE\fR, \fB\-\-port\fR=\fIPORT\fR |
644 | -Connect to the \fBpb\fR source running on port \fIPORT\fR, by default |
645 | -8789. |
646 | -.TP |
647 | -\fB\-h\fR, \fB\-\-help\fR |
648 | -Show a help message and exit. |
649 | -.SH SEE ALSO |
650 | -.BR ibid (1), |
651 | -.UR http://ibid.omnia.za.net/ |
652 | -.BR http://ibid.omnia.za.net/ |
653 | + |
654 | +# OPTIONS |
655 | + |
656 | +**-s** *SERVER*, **-\-server**=*SERVER* |
657 | +: Connect to the Ibid running on *SERVER*, by default it connects to |
658 | + *localhost*. |
659 | + |
660 | +**-p** *PORT*, **-\-port**=*PORT* |
661 | +: Connect to the **pb** source running on port *PORT*, by default 8789. |
662 | + |
663 | +**-h**, **-\-help** |
664 | +: Show a help message and exit. |
665 | + |
666 | +# SEE ALSO |
667 | + |
668 | +`ibid` (1), |
669 | +http://ibid.omnia.za.net/ |
670 | |
671 | === renamed file 'man/ibid-plugin.1' => 'man/ibid-plugin.1.md' |
672 | --- man/ibid-plugin.1 2010-03-08 20:27:21 +0000 |
673 | +++ man/ibid-plugin.1.md 2010-03-20 10:39:26 +0000 |
674 | @@ -1,71 +1,71 @@ |
675 | -.\" Copyright (c) 2010, Stefano Rivera |
676 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
677 | -.TH IBID-PLUGIN "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
678 | -.SH NAME |
679 | +% IBID-PLUGIN(1) Ibid Multi-protocol Bot | Ibid 0.1 |
680 | +% Stefano Rivera |
681 | +% March 2010 |
682 | + |
683 | +# NAME |
684 | + |
685 | ibid-plugin \- Plugin testing developer environment for Ibid |
686 | -.SH SYNOPSIS |
687 | -.B ibid-plugin |
688 | -.RI [ options ...] |
689 | -.RI [ plugin\fR[\fB- ]| plugin\fB.\fIProcessor [\fB-\fR]...] |
690 | -.SH DESCRIPTION |
691 | -This utility is for testing Ibid plugins without the full bot |
692 | -environment. |
693 | + |
694 | +# SYNOPSIS |
695 | + |
696 | +**ibid-plugin** [*options*...] [*plugin*[**-**]|_plugin_**.**_Processor_[**-**]...] |
697 | + |
698 | +# DESCRIPTION |
699 | + |
700 | +This utility is for testing Ibid plugins without the full bot environment. |
701 | This means testing can be performed offline and without loading all the |
702 | available plugins. |
703 | -.P |
704 | + |
705 | This should be run in a configured Ibid bot directory. |
706 | -.P |
707 | + |
708 | All the listed plugins and Processors will be loaded on start-up. |
709 | Naming a plugin loads the complete plugin. |
710 | -Suffixing a \fB-\fR to the name, ignores that plugin or Processor |
711 | -instead of loading it. |
712 | -.SH OPTIONS |
713 | -.TP |
714 | -\fB\-c\fR, \fB\-\-configured\fR |
715 | -Load all configured plugins, instead of only the core and requested |
716 | -plugins. |
717 | -.TP |
718 | -\fB\-o\fR, \fB\-\-only\fR |
719 | -Don't load the Ibid core plugins, only the plugins requested. |
720 | -Note that without the \fBcore\fR plugin to pre- and post-process events, |
721 | -most other plugins won't function correctly. |
722 | -.TP |
723 | -\fB\-p\fR, \fB\-\-public\fR |
724 | -By default, \fBibid-plugin\fR emulates a private conversation with the |
725 | -bot. |
726 | -With this option, the conversation is considered to be public and the |
727 | -bot will have to be addressed to provoke a response. |
728 | -.TP |
729 | -\fB\-v\fR, \fB\-\-verbose\fR |
730 | -Increase verbosity. |
731 | -The final form of each \fIEvent\fR object will be displayed before any responses. |
732 | -.TP |
733 | -\fB\-h\fR, \fB\-\-help\fR |
734 | +Suffixing a **-** to the name, ignores that plugin or Processor instead of |
735 | +loading it. |
736 | + |
737 | +# OPTIONS |
738 | + |
739 | +**-c**, **-\-configured** |
740 | +: Load all configured plugins, instead of only the core and requested |
741 | + plugins. |
742 | + |
743 | +**-o**, **-\-only** |
744 | +: Don't load the Ibid core plugins, only the plugins requested. |
745 | + Note that without the **core** plugin to pre- and post-process events, most |
746 | + other plugins won't function correctly. |
747 | + |
748 | +**-p**, **-\-public** |
749 | +: By default, **ibid-plugin** emulates a private conversation with the bot. |
750 | + With this option, the conversation is considered to be public and the |
751 | + bot will have to be addressed to provoke a response. |
752 | + |
753 | +**-v**, **-\-verbose** |
754 | +: Increase verbosity. |
755 | + The final form of each *Event* object will be displayed before any |
756 | + responses. |
757 | + |
758 | +**-h**, **-\-help** |
759 | Show a help message and exit. |
760 | -.SH FILES |
761 | -.TP |
762 | -.I ibid.ini |
763 | -Locates the database to act upon by looking for the \fB[databases].ibid\fR value |
764 | -in the bot configuration file in the current directory. |
765 | -.SH BUGS |
766 | -\fBibid-plugin\fR doesn't emulate a complete Ibid environment, and will |
767 | -ignore all of the following: |
768 | -.TP |
769 | -* |
770 | -Delayed and periodically executed functions. |
771 | -.TP |
772 | -* |
773 | -Messages to alternate sources. |
774 | -.TP |
775 | -* |
776 | -Messages directly dispatched, rather than added to responses. |
777 | -.TP |
778 | -* |
779 | -Permissions. |
780 | -All permissions are granted to the user. |
781 | -.SH SEE ALSO |
782 | -.BR ibid (1), |
783 | -.BR ibid.ini (5), |
784 | -.BR ibid-setup (1), |
785 | -.UR http://ibid.omnia.za.net/ |
786 | -.BR http://ibid.omnia.za.net/ |
787 | + |
788 | +# FILES |
789 | + |
790 | +*ibid.ini* |
791 | +: Locates the database to act upon by looking for the |
792 | + [**databases**].**ibid** value in the bot configuration file in the current |
793 | + directory. |
794 | + |
795 | +# BUGS |
796 | + |
797 | +**ibid-plugin** doesn't emulate a complete Ibid environment, and will ignore |
798 | +all of the following: |
799 | + |
800 | +* Delayed and periodically executed functions. |
801 | +* Messages to alternate sources. |
802 | +* Messages directly dispatched, rather than added to responses. |
803 | +* Permissions. All permissions are granted to the user. |
804 | + |
805 | +# SEE ALSO |
806 | +`ibid` (1), |
807 | +`ibid.ini` (5), |
808 | +`ibid-setup` (1), |
809 | +http://ibid.omnia.za.net/ |
810 | |
811 | === renamed file 'man/ibid-setup.1' => 'man/ibid-setup.1.md' |
812 | --- man/ibid-setup.1 2010-03-08 20:27:21 +0000 |
813 | +++ man/ibid-setup.1.md 2010-03-20 10:39:26 +0000 |
814 | @@ -1,33 +1,36 @@ |
815 | -.\" Copyright (c) 2010, Stefano Rivera |
816 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
817 | -.TH IBID-SETUP "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
818 | -.SH NAME |
819 | -ibid-setup \- Create a basic configuration file and database for an Ibid |
820 | -bot |
821 | -.SH SYNOPSIS |
822 | -.B ibid-setup |
823 | -.SH DESCRIPTION |
824 | -This program sets up everything that a new Ibid bot needs before it can |
825 | -run. |
826 | +% IBID-SETUP(1) Ibid Multi-protocol Bot | Ibid 0.1 |
827 | +% Stefano Rivera |
828 | +% March 2010 |
829 | + |
830 | +# NAME |
831 | + |
832 | +ibid-setup - Create a basic configuration file and database for an Ibid bot |
833 | + |
834 | +# SYNOPSIS |
835 | + |
836 | +**ibid-setup** |
837 | + |
838 | +# DESCRIPTION |
839 | + |
840 | +This program sets up everything that a new Ibid bot needs before it can run. |
841 | It asks a series of questions about the new bot, and writes out a basic |
842 | -configuration file - |
843 | -.BR ibid.ini (5) |
844 | -- to the current directory. |
845 | -It also creates a database for the bot, by default a SQLite database in |
846 | -the current directory. |
847 | -.P |
848 | -This should be run in the directory which will become the new Ibid bot's |
849 | -base. |
850 | -.P |
851 | -Should there be an existing \fBibid.ini\fR in the current directory, it |
852 | -will be used, and the only questions asked will be for adding an |
853 | -administrative user. These can safely be skipped with a \fB^C\fR. |
854 | -.SH FILES |
855 | -.TP |
856 | -.I ibid.ini |
857 | -The Ibid bot's configuration file, will be created if it doesn't exist. |
858 | -.SH SEE ALSO |
859 | -.BR ibid (1), |
860 | -.BR ibid.ini (5), |
861 | -.UR http://ibid.omnia.za.net/ |
862 | -.BR http://ibid.omnia.za.net/ |
863 | +configuration file - `ibid.ini` (5) - to the current directory. |
864 | +It also creates a database for the bot, by default a SQLite database in the |
865 | +current directory. |
866 | + |
867 | +This should be run in the directory which will become the new Ibid bot's base. |
868 | + |
869 | +Should there be an existing **ibid.ini** in the current directory, it will be |
870 | +used, and the only questions asked will be for adding an administrative user. |
871 | +These can safely be skipped with a **^C**. |
872 | + |
873 | +# FILES |
874 | + |
875 | +*ibid.ini* |
876 | +: The Ibid bot's configuration file, will be created if it doesn't exist. |
877 | + |
878 | +# SEE ALSO |
879 | + |
880 | +`ibid` (1), |
881 | +`ibid.ini` (5), |
882 | +http://ibid.omnia.za.net/ |
883 | |
884 | === renamed file 'man/ibid.1' => 'man/ibid.1.md' |
885 | --- man/ibid.1 2010-03-08 20:27:21 +0000 |
886 | +++ man/ibid.1.md 2010-03-20 10:39:26 +0000 |
887 | @@ -1,32 +1,41 @@ |
888 | -.\" Copyright (c) 2010, Stefano Rivera |
889 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
890 | -.TH IBID "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
891 | -.SH NAME |
892 | -ibid \- Run an Ibid bot |
893 | -.SH SYNOPSIS |
894 | -.B ibid |
895 | -.RI [ config-file ] |
896 | -.SH DESCRIPTION |
897 | +% IBID(1) Ibid Multi-protocol Bot | Ibid 0.1 |
898 | +% Stefano Rivera |
899 | +% March 2010 |
900 | + |
901 | +# NAME |
902 | + |
903 | +ibid - Run an Ibid bot |
904 | + |
905 | +# SYNOPSIS |
906 | + |
907 | +**ibid** [*config-file*] |
908 | + |
909 | +# DESCRIPTION |
910 | + |
911 | This runs an Ibid bot in the foreground. |
912 | -.P |
913 | -There should there be an existing \fBibid.ini\fR (created by |
914 | -.BR ibid-setup (1)) |
915 | + |
916 | +There should there be an existing **ibid.ini** (created by |
917 | +`ibid-setup` (1)) |
918 | in the current directory or one should be provided on the command line. |
919 | -.P |
920 | -Where possible, you should run \fBtwistd \-n ibid\fR instead of this |
921 | + |
922 | +Where possible, you should run **twistd -n ibid** instead of this |
923 | program, as otherwise some classes of errors go unreported. |
924 | -.RB "See " BUGS . |
925 | -.SH BUGS |
926 | +See **BUGS**. |
927 | + |
928 | +# BUGS |
929 | + |
930 | Exceptions in twisted callbacks can go unnoticed in this program. |
931 | That has no harmful effects, but the developers may miss out on some |
932 | good bug reports. |
933 | -.SH FILES |
934 | -.TP |
935 | -.I ibid.ini |
936 | -The Ibid bot's configuration file, will be created if it doesn't exist. |
937 | -.SH SEE ALSO |
938 | -.BR ibid.ini (5), |
939 | -.BR ibid-setup (1), |
940 | -.BR twistd (1), |
941 | -.UR http://ibid.omnia.za.net/ |
942 | -.BR http://ibid.omnia.za.net/ |
943 | + |
944 | +# FILES |
945 | + |
946 | +*ibid.ini* |
947 | +: The Ibid bot's configuration file, will be created if it doesn't exist. |
948 | + |
949 | +# SEE ALSO |
950 | + |
951 | +`ibid.ini` (5), |
952 | +`ibid-setup` (1), |
953 | +`twistd` (1), |
954 | +http://ibid.omnia.za.net/ |
955 | |
956 | === renamed file 'man/ibid.ini.5' => 'man/ibid.ini.5.md' |
957 | --- man/ibid.ini.5 2010-03-08 20:27:21 +0000 |
958 | +++ man/ibid.ini.5.md 2010-03-20 10:39:26 +0000 |
959 | @@ -1,113 +1,119 @@ |
960 | -.\" Copyright (c) 2010, Stefano Rivera |
961 | -.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details. |
962 | -.TH IBID.INI "5" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot" |
963 | -.SH NAME |
964 | -ibid.ini \- Configuration file for Ibid |
965 | -.SH DESCRIPTION |
966 | +% IBID.INI(5) Ibid Multi-protocol Bot | Ibid 0.1 |
967 | +% Stefano Rivera |
968 | +% March 2010 |
969 | + |
970 | +# NAME |
971 | + |
972 | +ibid.ini - Configuration file for Ibid |
973 | + |
974 | +# DESCRIPTION |
975 | + |
976 | ibid.ini contains all the configuration for an Ibid bot. |
977 | -.P |
978 | + |
979 | A complete description of the contents of this file is out of the scope of this |
980 | manpage. |
981 | -For more details see the Ibid documentation: |
982 | -.UR http://ibid.omnia.za.net/docs/ |
983 | -.BR http://ibid.omnia.za.net/docs/ |
984 | -.P |
985 | -Lines beginning with \fB#\fR are considered to be comments and ignored. |
986 | -To use a \fB#\fR symbol in an option (e.g. an IRC channel name), quote the |
987 | -option with double-quotes, e.g. |
988 | -.BR channels = """#ibid""," |
989 | -.P |
990 | +For more details see the Ibid documentation: http://ibid.omnia.za.net/docs/ |
991 | + |
992 | +Lines beginning with **#** are considered to be comments and ignored. |
993 | +To use a **#** symbol in an option (e.g. an IRC channel name), quote the |
994 | +option with double-quotes, e.g. **channels**=**"#ibid",** |
995 | + |
996 | This file will be written to by the bot when configuration settings are |
997 | altered online. |
998 | It can also be edited manually and a running bot told to |
999 | -\fB"reload config"\fR. |
1000 | +**"reload config"**. |
1001 | Manual edits and comments will be preserved when the bot modifies its |
1002 | own configuration, provided that they have not been edited since bot |
1003 | start-up or the last config reload. |
1004 | -.SH SECTIONS |
1005 | -.SS auth |
1006 | + |
1007 | +# SECTIONS |
1008 | + |
1009 | +## auth |
1010 | + |
1011 | Settings related to permissions and authentication. |
1012 | -Permissions listed in \fBauth.permissions\fR are granted to all users unless |
1013 | +Permissions listed in **auth**.**permissions** are granted to all users unless |
1014 | revoked by source or account. |
1015 | -.SS sources |
1016 | + |
1017 | +## sources |
1018 | + |
1019 | Sources are Ibid connections to an IM service. |
1020 | They range from IRC networks to the bot's built-in HTTP server. |
1021 | -.P |
1022 | + |
1023 | Each source is configured in a section named after the source. |
1024 | The source name will define the driver that the source should use, unless a |
1025 | -\fBtype\fR option is provided. |
1026 | -.P |
1027 | +**type** option is provided. |
1028 | + |
1029 | Sources can be disabled by setting |
1030 | -.BR disabled = True . |
1031 | -.SS plugins |
1032 | +**disabled**=**True**. |
1033 | + |
1034 | +## plugins |
1035 | + |
1036 | Plugin configuration. |
1037 | Each plugin is configured within a section named after the plugin. |
1038 | -.P |
1039 | -.TP |
1040 | -.B cachedir |
1041 | -The directory that temporary files (such as downloaded data), useful to be the |
1042 | -bot but expendable, is stored in. |
1043 | -.TP |
1044 | -.B core.autoload |
1045 | -If \fBTrue\fR, all plugins not explicitly ignored will be loaded. |
1046 | -(Note that some plugins mark themselves as non-auto-loadable). |
1047 | -Defaults to \fBTrue\fR. |
1048 | -.TP |
1049 | -.B core.load |
1050 | -The list of plugins (or \fBplugin\fR.\fBProcessor\fRs) to load. |
1051 | -.TP |
1052 | -.B core.noload |
1053 | -The list of plugins (or \fBplugin\fR.\fBProcessor\fRs) to ignore and not load. |
1054 | -.TP |
1055 | -.B core.names |
1056 | -The names that the bot should respond to. |
1057 | -.TP |
1058 | -.B core.ignore |
1059 | -Nicks that the bot should completely ignore (e.g. other bots). |
1060 | -.SH EXAMPLE |
1061 | -.nf |
1062 | -botname = joebot |
1063 | -logging = logging.ini |
1064 | - |
1065 | -[auth] |
1066 | - methods = password, |
1067 | - timeout = 300 |
1068 | - permissions = +factoid, +karma, +sendmemo, +recvmemo, +feeds, +publicresponse |
1069 | - |
1070 | -[sources] |
1071 | - [[telnet]] |
1072 | - [[timer]] |
1073 | - [[http]] |
1074 | - url = http://joebot.example.com |
1075 | - [[smtp]] |
1076 | - [[pb]] |
1077 | - [[atrum]] |
1078 | - channels = "#ibid", |
1079 | - nick = $botname |
1080 | - type = irc |
1081 | - auth = hostmask, nickserv |
1082 | - server = irc.atrum.org |
1083 | - |
1084 | -[plugins] |
1085 | - cachedir = /tmp/ibid |
1086 | - [[core]] |
1087 | - names = $botname, bot, ant |
1088 | - ignore = , |
1089 | - |
1090 | -[databases] |
1091 | - ibid = sqlite:///ibid.db |
1092 | -.fi |
1093 | -.SH FILES |
1094 | -.TP |
1095 | -.I logging.ini |
1096 | -A standard Python \fBlogging.config\fR configuration file describing |
1097 | -loggers, handlers, and formatters for log messages. |
1098 | -See |
1099 | -.UR http://docs.python.org/library/logging.html |
1100 | -.BR http://docs.python.org/library/logging.html |
1101 | -.SH SEE ALSO |
1102 | -.BR ibid (1), |
1103 | -.BR ibid.ini (5), |
1104 | -.BR twistd (1), |
1105 | -.UR http://ibid.omnia.za.net/ |
1106 | -.BR http://ibid.omnia.za.net/ |
1107 | + |
1108 | +**cachedir** |
1109 | +: The directory that temporary files (such as downloaded data), useful to be |
1110 | + the bot but expendable, is stored in. |
1111 | + |
1112 | +**core**.**autoload** |
1113 | +: If **True**, all plugins not explicitly ignored will be loaded. |
1114 | + (Note that some plugins mark themselves as non-auto-loadable). |
1115 | + Defaults to **True**. |
1116 | + |
1117 | +**core**.**load** |
1118 | +: The list of plugins (or **plugin**.**Processor**s) to load. |
1119 | + |
1120 | +**core**.**noload** |
1121 | +: The list of plugins (or **plugin**.**Processor**s) to ignore and not load. |
1122 | + |
1123 | +**core**.**names** |
1124 | +: The names that the bot should respond to. |
1125 | + |
1126 | +**core**.**ignore** |
1127 | +: Nicks that the bot should completely ignore (e.g. other bots). |
1128 | + |
1129 | +# EXAMPLE |
1130 | + |
1131 | + botname = joebot |
1132 | + logging = logging.ini |
1133 | + |
1134 | + [auth] |
1135 | + methods = password, |
1136 | + timeout = 300 |
1137 | + permissions = +factoid, +karma, +sendmemo, +recvmemo, +feeds, +publicresponse |
1138 | + |
1139 | + [sources] |
1140 | + [[telnet]] |
1141 | + [[timer]] |
1142 | + [[http]] |
1143 | + url = http://joebot.example.com |
1144 | + [[smtp]] |
1145 | + [[pb]] |
1146 | + [[atrum]] |
1147 | + channels = "#ibid", |
1148 | + nick = $botname |
1149 | + type = irc |
1150 | + auth = hostmask, nickserv |
1151 | + server = irc.atrum.org |
1152 | + |
1153 | + [plugins] |
1154 | + cachedir = /tmp/ibid |
1155 | + [[core]] |
1156 | + names = $botname, bot, ant |
1157 | + ignore = , |
1158 | + |
1159 | + [databases] |
1160 | + ibid = sqlite:///ibid.db |
1161 | + |
1162 | +# FILES |
1163 | + |
1164 | +*logging*.*ini* |
1165 | +: A standard Python **logging**.**config** configuration file describing |
1166 | + loggers, handlers, and formatters for log messages. |
1167 | + See http://docs.python.org/library/logging.html |
1168 | + |
1169 | +# SEE ALSO |
1170 | +`ibid` (1), |
1171 | +`ibid.ini` (5), |
1172 | +`twistd` (1), |
1173 | +http://ibid.omnia.za.net/ |
Approved once the double-hyphen issue is fixed.