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