Familien verlinkt, Erlaeutert in P_SECOND
Hinweis ergaenzt, bei Aenderung von P_SECOND auf die Familie zu achten.
Ausserdem Text jetzt als rST.
Change-Id: I4b47819913ceaf7fe107ed6b33eaf7f7764d7560
diff --git a/doc/sphinx/props/P_SECOND.rst b/doc/sphinx/props/P_SECOND.rst
index 74e1fb3..14989d9 100644
--- a/doc/sphinx/props/P_SECOND.rst
+++ b/doc/sphinx/props/P_SECOND.rst
@@ -3,26 +3,34 @@
NAME
----
-::
- P_SECOND "second"
+ P_SECOND "second"
DEFINIERT IN
------------
-::
/sys/player/base.h
BESCHREIBUNG
------------
-::
Wenn diese Prop gesetzt ist, ist der Spieler ein Zweitie. Inhalt der
Prop ist ein String mit dem (lowercase) Namen des Ersties.
+ Ob anderen Spielern angezeigt wird, dass jemand Zweitie ist, kann mittels
+ der Property P_SECOND_MARK gesteuert werden.
+
+ Bitte auch das Konzept der Familie beachten (s. :doc:`../wiz/familien`)
+ und speziell bei Aenderung von P_SECOND ggf. die Familie eintragen
+ lassen.
+
+ Soll ein Spieler kein Zweitie mehr sein, bitte zusaetzlich zum Loeschen
+ dieser Property den Zweitieeintrage auch in /secure/zweities loeschen
+ (lassen).
BEISPIEL
--------
-::
+
+.. code-block:: pike
if (this_player()->QueryProp(P_SECOND)=="notstrom") {
tell_object(this_player(), "Nicht alles aufessen!\n");
@@ -30,11 +38,15 @@
SIEHE AUCH
----------
-::
- Properties: P_SECOND_MARK
- Sonstiges: /secure/zweities.c
+ Familien:
+ :doc:`../wiz/familien`
+ Kommandos:
+ :doc:`../pcmd/zweitiemarkierung`
+ Properties:
+ :doc:`P_SECOND_MARK`
+ Sonstiges:
+ /secure/zweities.c
-
-Last modified: 18-Jun-2015, Arathorn.
+Last modified: 08.01.2019, Zesstra
diff --git a/doc/sphinx/wiz/familien.rst b/doc/sphinx/wiz/familien.rst
new file mode 100644
index 0000000..b40b464
--- /dev/null
+++ b/doc/sphinx/wiz/familien.rst
@@ -0,0 +1,60 @@
+FAMILIEN
+========
+
+BESCHREIBUNG
+------------
+
+ Eine Familie umfasst den Erstie und alle Zweities, sprich alle diese haben
+ den gleichen "Familiennamen". Dieser Name ist in der Regel die UUID des
+ Ersties dieser Familie. Falls aber der Erstie sich aendern sollte (z.B.
+ Magierwerdung eines Zweities) und sich der Familienname nicht aendern soll,
+ dann koennen wir den Namen dieser Familie beibehalten (d.h. alter Erstie).
+
+ Will man wissen, welcher Familie ein Char angehoert (egal, ob Erstie oder
+ Zweitie), dann geht das mit::
+
+ # xcall /secure/zweities->QueryFamilie(player_object)
+
+ Des Weiteren liefert dieses Objekt auch noch zu jedem Zweitie den Erstie
+ und zu jedem Erstie die Liste aller bekannten Zweities::
+
+ # xcall /secure/zweities->QueryErstieName(player_object)
+ # xcall /secure/zweities->QueryErstieUUID(player_object)
+ # xcall /secure/zweities->QueryZweities(player_object)
+
+ Der Datenbestand ist (noch) nicht vollstaendig, daher fehlen da noch viele
+ Chars. Die werden aber in absehbarer Zeit dort nachgetragen.
+
+ Die Familie wird in Zukunft genutzt, um Dinge zu personalisieren, welche
+ fuer den Spieler, aber nicht fuer den Char individuell sein sollen. Sprich:
+ personalisiert man irgendwas ueber die Familie, koennen alle Chars dieser
+ Familie das irgendwas nutzen.
+
+VERWALTUNG
+----------
+
+ Wenn sich der Erstie aendert, aber die Familie aller Zweities erhalten
+ bleiben soll (z.B. weil sich der Erstie innerhalb der Familie wegen
+ Magierwerdung aendert), muss dies in der Familienverwaltung hinterlegt
+ werden, indem fuer den *neuen* Erstie die alte Familien-ID eingetragen wird.
+ Dies koennen zur Zeit EM+.
+
+ Beispiel: Der alte Erstie einer Familie ist bert_123456, der neue Erstie ist
+ alice_654321. Die Familie soll aber weiterhin bert_123456 sein::
+
+ # xcall /secure/zweities->SetFamilie("alice_654321, "bert_123456")
+
+ Ein solcher expliziter Familieneintrag kann wieder geloescht werden::
+
+ # xcall /secure/zweities->DeleteFamilie("alice_654321")
+
+ EM+ koennen Zweities wieder aus der Datenbank loeschen (UUID angeben!)::
+
+ # xcall /secure/zweities->DeleteZweitie("bert_12345")
+
+SIEHE AUCH:
+ :doc:`../props/P_SECOND`, :doc:`../props/P_SECOND_MARK`
+
+LETZTE AeNDERUNG:
+ 8.1.2019, Zesstra
+