Manpages als reStructuredText erstellt
Unsere Manpages wurden mit einem LPC-Tool in
reStructuredText konvertiert und liegen jetzt
in diesem Verzeichnis als Quelldaten.
Aus diesen reStructuredText sollen dann per
Script die ASCII-Manpages und per Sphinx HTML u.a.
erzeugt werden.
Change-Id: I75d659a7b3f9863aecb11dbeb0037e6cae227c36
diff --git a/doc/sphinx/lfun/UseHands.rst b/doc/sphinx/lfun/UseHands.rst
new file mode 100644
index 0000000..9485e83
--- /dev/null
+++ b/doc/sphinx/lfun/UseHands.rst
@@ -0,0 +1,61 @@
+UseHands()
+==========
+
+FUNKTION
+--------
+::
+
+ public varargs int UseHands(object ob, int num)
+
+DEFINIERT IN
+------------
+::
+
+ /std/living/combat.c
+
+ARGUMENTE
+---------
+::
+
+ ob - das Objekt, das die Haende belegen soll
+ num - die Anzahl der zu belegenden Haende
+
+RUECKGABEWERT
+-------------
+::
+
+ 1, fuer Erfolg
+ 0, sonst
+
+BESCHREIBUNG
+------------
+::
+
+ Belegt, wenn moeglich Haende eines Livings durch ein bestimmtes
+ Objekt. Wenn die Anzahl der freien Haende (P_MAX_HANDS-P_USED_HANDS)
+ kleiner ist als "num", dann schlaegt diese Belegung fehl.
+
+BEISPIELE
+---------
+::
+
+ > halte seil fest
+ ...
+ this_player()->UseHands(this_object(),2);
+ ...
+
+ > lasse seil los
+ ...
+ this_player()->FreeHands(this_object());
+ ...
+
+SIEHE AUCH
+----------
+::
+
+ P_HANDS, P_HANDS_USED_BY
+ P_MAX_HANDS, P_USED_HANDS, P_FREE_HANDS
+ FreeHands
+
+1.Feb.2004 Gloinson
+