Manpages als reStructuredText erstellt
Unsere Manpages wurden mit einem LPC-Tool in
reStructuredText konvertiert und liegen jetzt
in diesem Verzeichnis als Quelldaten.
Aus diesen reStructuredText sollen dann per
Script die ASCII-Manpages und per Sphinx HTML u.a.
erzeugt werden.
Change-Id: I75d659a7b3f9863aecb11dbeb0037e6cae227c36
diff --git a/doc/sphinx/lfun/DiscoverDoor.rst b/doc/sphinx/lfun/DiscoverDoor.rst
new file mode 100644
index 0000000..2deb1a1
--- /dev/null
+++ b/doc/sphinx/lfun/DiscoverDoor.rst
@@ -0,0 +1,54 @@
+DiscoverDoor()
+==============
+
+FUNKTION
+--------
+::
+
+ varargs int DiscoverDoor(string dname)
+
+ARGUMENTE
+---------
+::
+
+ dname: Name des Raumes, in dem der Seher das Sehertor kennenlernen soll.
+ Default: Die Umgebung des Sehers.
+
+BESCHREIBUNG
+------------
+::
+
+ Nachdem diese Funktion aufgerufen wurde, kann der Seher (this_player())
+ das Tor in dem angegebenen Raum immer verwenden.
+
+RUECKGABEWERT
+-------------
+::
+
+ 1, falls der Seher ein NEUES Tor kennengelernt hat
+ 0, falls er das Tor schon kannte oder kein Seher war
+
+BEMERKUNGEN
+-----------
+::
+
+ Von einem Sehertor wird diese Funktion automatisch beim Betreten des
+ umgebenden Raumes aufgerufen, falls P_SEERDOOR_DISCOVER gesetzt ist. Wenn
+ ein Tor auf diese Art nicht entdeckt werden soll, so darf
+ P_SEERDOOR_DISCOVER nicht gesetzt sein und muss DiscoverDoor() separat,
+ z.B. von einem Questobjekt, aufgerufen werden.
+ Diese Funktion wird von /d/seher/portale/sehertormaster definiert.
+
+BEISPIELE
+---------
+::
+
+ write("Der Zauberer sagt: Im Nichts wirst Du ein weiteres Tor finden!\n");
+ "/d/seher/portale/sehertormaster"->DiscoverDoor("/room/void");
+
+SIEHE AUCH
+----------
+::
+
+ DoorIsKnown, ShowDoors, Teleport, GetDoorsMapping
+