Formatierung, Querverweise, Klarstellungen.
Hinweis ergaenzt, die Kurzbeschreibung auch kurz zu halten.
Change-Id: I3e634e80bb491a7bfa4c30736f709fdc6bd3938d
diff --git a/doc/sphinx/lfun/short.rst b/doc/sphinx/lfun/short.rst
index 1d1eda3..e31d7ff 100644
--- a/doc/sphinx/lfun/short.rst
+++ b/doc/sphinx/lfun/short.rst
@@ -3,52 +3,52 @@
FUNKTION
--------
-::
public varargs string short();
DEFINIERT IN
------------
-::
/std/thing/description.c
ARGUMENTE
---------
-::
keine
BESCHREIBUNG
------------
-::
Der Inhalt der Property P_SHORT wird ausgewertet, mit ".\n"
abgeschlossen und zurueckgegeben.
-RUeCKGABEWERT
--------------
-::
-
- Die Kurzbeschreibung als String oder 0, falls das Objekt unsichtbar
- ist.
-
-BEMERKUNGEN
------------
-::
-
- Durch Ueberladen von short() lassen sich noch weitere Eigenschaften des
+ Durch Ueberladen von short() lassen sich ggf. weitere Eigenschaften des
Objektes zeigen. Fackeln zeigen zum Beispiel an, ob sie brennen,
Ruestungen, ob sie angezogen sind und Waffen, ob sie gezueckt sind.
+ In jedem Fall muss die Kurzbeschreibung aber *kurz* sein, empfohlen
+ werden max. 60 Zeichen.
+
+RUeCKGABEWERT
+-------------
+
+ Die Kurzbeschreibung als String oder 0, falls das Objekt nicht
+ wahrnehmbar ist (d.h. nicht in Inventaren angezeigt wird).
+
+BEMERKUNGEN
+-----------
+
+ Zu der mit dem Rueckgabewert von 0 vermittelten Unsichtbarkeit s.
+ :doc:`../props/P_SHORT`.
+
SIEHE AUCH
----------
-::
- Aehnliches: long()
- Properties: P_SHORT, P_INVIS
- Sonstiges: make_invlist()
+ Aehnliches
+ :doc:`long`
+ Properties
+ :doc:`../props/P_SHORT`, :doc:`../props/P_INVIS`,
+ :doc:`../props/P_INT_SHORT`
-
-20.01.2015, Zesstra
+:Letzte Aenderung: 18.06.2020, Zesstra