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