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/props/P_NAME b/doc/props/P_NAME
index f609cea..1fdc261 100644
--- a/doc/props/P_NAME
+++ b/doc/props/P_NAME
@@ -1,65 +1,84 @@
+
P_NAME
+******
-NAME:
- P_NAME "name"
-DEFINIERT IN:
- <thing/description.h>
+NAME
+====
-BESCHREIBUNG:
- In dieser Property wird der Name eines Objektes vermerkt. Wenn der Name
- regelmaessig dekliniert wird, reicht ein einfacher String. Wird der
- Name unregelmaessig dekliniert, so kann man ein Array von vier Strings
- mit dem Namen im Nominativ, Genitiv, Dativ und Akkusativ (in dieser
- Reihenfolge) angeben.
+ P_NAME "name"
- Die Funktion name() behandelt recht viele Sonderfaelle; man sollte den
- Namen also erst einmal in der Form eines einzelnen Strings pruefen.
- Eine Sonderrolle nehmen Unit-Objekte ein: Hier kann man einen Namen
- fuer den Singular und einen Namen fuer den Plural vergeben.
+DEFINIERT IN
+============
- Setzt man P_NAME eines Unit-Objekts auf einen einfachen String, so wird
- dieser als Name sowohl im Singular als auch im Plural verwendet.
+ <thing/description.h>
- Uebergibt man ein Array von Strings, so wird der erste Eintrag fuer den
- Singular und der zweite Eintrag fuer den Plural benutzt.
- Bei Unit-Objekten ist es nicht moeglich, auch noch zwischen den
- verschiedenen Faellen zu unterscheiden.
+BESCHREIBUNG
+============
-BEMERKUNGEN:
- Diese Property sollte nur den reinen Namen enthalten; will man dem
- Namen noch Adjektive voranstellen, so sollte man dies mit P_NAME_ADJ
- bewerkstelligen, also statt
+ In dieser Property wird der Name eines Objektes vermerkt. Wenn der Name
+ regelmaessig dekliniert wird, reicht ein einfacher String. Wird der
+ Name unregelmaessig dekliniert, so kann man ein Array von vier Strings
+ mit dem Namen im Nominativ, Genitiv, Dativ und Akkusativ (in dieser
+ Reihenfolge) angeben.
- SetProp(P_NAME, ({ "alter Hut", "alten Huts",
- "alten Hut", "alten Hut" }) );
+ Die Funktion name() behandelt recht viele Sonderfaelle; man sollte den
+ Namen also erst einmal in der Form eines einzelnen Strings pruefen.
- besser
+ Eine Sonderrolle nehmen Unit-Objekte ein: Hier kann man einen Namen
+ fuer den Singular und einen Namen fuer den Plural vergeben.
- SetProp(P_NAME, "Hut");
- SetProp(P_NAME_ADJ, "alt");
+ Setzt man P_NAME eines Unit-Objekts auf einen einfachen String, so wird
+ dieser als Name sowohl im Singular als auch im Plural verwendet.
- Bei Lebewesen wird lower_case(P_NAME) (bei Arrays das erste Element
- daraus) automatisch als LivingName gesetzt.
+ Uebergibt man ein Array von Strings, so wird der erste Eintrag fuer den
+ Singular und der zweite Eintrag fuer den Plural benutzt.
-BEISPIELE:
- Ein regelmaessig deklinierbarer Name:
+ Bei Unit-Objekten ist es nicht moeglich, auch noch zwischen den
+ verschiedenen Faellen zu unterscheiden.
- SetProp(P_NAME, "Arkshat");
- Hier ein Beispiel fuer einen unregelmaessig deklinierbaren Namen:
+BEMERKUNGEN
+===========
- SetProp(P_NAME, ({ "Drache", "Drachen", "Drachen", "Drachen" }));
+ Diese Property sollte nur den reinen Namen enthalten; will man dem
+ Namen noch Adjektive voranstellen, so sollte man dies mit P_NAME_ADJ
+ bewerkstelligen, also statt
- Und schliesslich der Name eines allseits bekannten Unit-Objektes:
+ SetProp(P_NAME, ({ "alter Hut", "alten Huts",
+ "alten Hut", "alten Hut" }) );
- SetProp(P_NAME, ({ "Muenze", "Muenzen" }));
+ besser
-SIEHE AUCH:
- /std/thing/description.c, name(), P_NAME_ADJ, set_living_name(),
- find_living(), find_livings()
+ SetProp(P_NAME, "Hut");
+ SetProp(P_NAME_ADJ, "alt");
-----------------------------------------------------------------------------
-Last modified: 19. Okt. 2015, Arathorn.
+ Bei Lebewesen wird lower_case(P_NAME) (bei Arrays das erste Element
+ daraus) automatisch als LivingName gesetzt.
+
+
+BEISPIELE
+=========
+
+ Ein regelmaessig deklinierbarer Name:
+
+ SetProp(P_NAME, "Arkshat");
+
+ Hier ein Beispiel fuer einen unregelmaessig deklinierbaren Namen:
+
+ SetProp(P_NAME, ({ "Drache", "Drachen", "Drachen", "Drachen" }));
+
+ Und schliesslich der Name eines allseits bekannten Unit-Objektes:
+
+ SetProp(P_NAME, ({ "Muenze", "Muenzen" }));
+
+
+SIEHE AUCH
+==========
+
+ /std/thing/description.c, name(), P_NAME_ADJ, set_living_name(),
+ find_living(), find_livings()
+
+Last modified: 19. Okt. 2015, Arathorn.