Automatisch erzeugte Manpages.
Damit nicht jeder sphinx auf dem Rechner haben muss,
behalten wir bis auf weiteres die aus den .rst
erzeugten Manpoages auch im Repo.
Change-Id: Id556c0d11cf5f79659d8350952ce1c014d81ea44
diff --git a/doc/lfun/More b/doc/lfun/More
index 2e73fa2..c504209 100644
--- a/doc/lfun/More
+++ b/doc/lfun/More
@@ -1,56 +1,80 @@
+
More()
+******
-FUNKTION:
- varargs public void More(string txt, int file,
- mixed ctrl, mixed *ctrlargs, int flags);
-DEFINIERT IN:
- /std/util/pager.c
+FUNKTION
+========
-ARGUMENTE:
- txt - entweder ein Text der ausgegeben werden soll, oder ein filename.
- file - das flag file gibt an, ob es sich bei <txt> um einen text oder
- einen Filenamen handelt. Bei einem Filenamen wird der Inhalt
- dieses Files eingelesen und ausgegeben.
- ctrl - Eine closure, die aufgerufen wird, falls kein <txt> angegeben
- wurde.
- ctrlargs - ctrlargs wird als Parameter an ctrl uebergeben.
- flags - flags wird mit den im Spieler definierten P_MORE_FLAGS
- kombiniert.
+ varargs public void More(string txt, int file,
+ mixed ctrl, mixed *ctrlargs, int flags);
-BESCHREIBUNG:
- More() dient der Ausgabe von Texten an Spieler. Mit Hilfe eines
- PL->More(txt) oder PL->More(txt, 1) ist es sehr einfach laengere Texte
- an Spieler auszugeben. Bei der Ausgabe werden die persoenlichen
- Einstellungen des Spielern (wie z.b. Zeilen pro Bildschirmseite)
- automatisch beruecksichtigt und der Text dadurch ggf. zerstueckelt
- und in mehreren Schritten nacheinander angezeigt.
+DEFINIERT IN
+============
-RUeCKGABEWERT:
- keiner
+ /std/util/pager.c
-BEMERKUNGEN:
- Beim einlesen des Files sind die Leserechte des Spieler in dem More()
- aufgerufen wird von Bedeutung und nicht die Rechte des Objektes das
- More() aufruft. Spielerobjekte haben im MorgenGrauen jedoch nur sehr
- eingeschraenkte Leserechte! Ausgegeben werden koennen nur files
- aus /p/*, /gilden/* und /d/* die _keinen_ code enthalten. Als Code
- wird hierbei jedes File betrachtet das als vorletztes Zeichen einen .
- hat (also .c, .h, .o usw.).
- Will man aus irgendwelchen Gruenden ein File (z.b. aus /players/)
- ausgeben, so sollte man stattdessen folgendes verwenden:
- this_player()->More(read_file(filename))
-BEISPIELE:
+ARGUMENTE
+=========
- // Ausgabe eines normalen textes...
- this_player()->More("Einfach nur mal so ein Test...\n");
+ txt - entweder ein Text der ausgegeben werden soll, oder ein filename.
+ file - das flag file gibt an, ob es sich bei <txt> um einen text oder
+ einen Filenamen handelt. Bei einem Filenamen wird der Inhalt
+ dieses Files eingelesen und ausgegeben.
+ ctrl - Eine closure, die aufgerufen wird, falls kein <txt> angegeben
+ wurde.
+ ctrlargs - ctrlargs wird als Parameter an ctrl uebergeben.
+ flags - flags wird mit den im Spieler definierten P_MORE_FLAGS
+ kombiniert.
- // Ausgabe eines kompletten files
- this_player()->More("/etc/WIZRULES", 1);
-SIEHE AUCH:
+BESCHREIBUNG
+============
-----------------------------------------------------------------------------
+ More() dient der Ausgabe von Texten an Spieler. Mit Hilfe eines
+ PL->More(txt) oder PL->More(txt, 1) ist es sehr einfach laengere Texte
+ an Spieler auszugeben. Bei der Ausgabe werden die persoenlichen
+ Einstellungen des Spielern (wie z.b. Zeilen pro Bildschirmseite)
+ automatisch beruecksichtigt und der Text dadurch ggf. zerstueckelt
+ und in mehreren Schritten nacheinander angezeigt.
+
+
+RUeCKGABEWERT
+=============
+
+ keiner
+
+
+BEMERKUNGEN
+===========
+
+ Beim einlesen des Files sind die Leserechte des Spieler in dem More()
+ aufgerufen wird von Bedeutung und nicht die Rechte des Objektes das
+ More() aufruft. Spielerobjekte haben im MorgenGrauen jedoch nur sehr
+ eingeschraenkte Leserechte! Ausgegeben werden koennen nur files
+ aus /p/*, /gilden/* und /d/* die _keinen_ code enthalten. Als Code
+ wird hierbei jedes File betrachtet das als vorletztes Zeichen einen .
+ hat (also .c, .h, .o usw.).
+ Will man aus irgendwelchen Gruenden ein File (z.b. aus /players/)
+ ausgeben, so sollte man stattdessen folgendes verwenden:
+ this_player()->More(read_file(filename))
+
+
+BEISPIELE
+=========
+
+ // Ausgabe eines normalen textes...
+ this_player()->More("Einfach nur mal so ein Test...\n");
+
+ // Ausgabe eines kompletten files
+ this_player()->More("/etc/WIZRULES", 1);
+
+
+SIEHE AUCH
+==========
+
+ ----------------------------------------------------------------------------
+
Last modified: Mon Feb 22 15:09:18 1999 by Padreic