Update doc/efun/ aus Driversourcen.
Manpages der efuns aktualisiert, neue Manpages hinzugefuegt.
Change-Id: I7cc91684269ff56d1aef47d5c5e7c87f7fd531dc
diff --git a/doc/efun/save_value b/doc/efun/save_value
index 11de053..c1df37d 100644
--- a/doc/efun/save_value
+++ b/doc/efun/save_value
@@ -1,39 +1,37 @@
SYNOPSIS
- string save_value(mixed wert)
- string save_value(mixed wert, int format)
+ string save_value(mixed value)
+ string save_value(mixed value, int format)
-BESCHREIBUNG
- Schreibt <wert> in einen String, der sich mit restore_value()
- auswerten laesst. Der String wird zurueck gegeben.
+DESCRIPTION
+ Encode the <value> into a string suitable for restoration with
+ restore_value() and return it.
- Das optionale Argument <format> bestimmt das Format des Strings:
+ The optional <format> argument determines the format of the savefile
+ to be written:
- -1: das normale Format des Treibers (Standard)
- 0: das Originalformat nach Amylaar's LPMud und LDMud <=3.2.8
- 1: LDMud >= 3.2.9: Non-Lambda Closures, Symbole und gequotete
- Arrays koennen gespeichert werden
- 2: LDMUd >= 3.5.0: Gleitkommazahlen werden in einem neuen Format
- geschrieben, welches kompakter ist die Gleitkommazahlen aus
- 3.5.x verlustfrei speichern kann.
+ -1: use the driver's native format (default).
+ 0: original format, used by Amylaar LPMud and LDMud <= 3.2.8 .
+ 1: LDMud >= 3.2.9: no-lambda closures, symbols, quoted arrays
+ can be saved.
+ 2: LDMUd >= 3.5.0: floats are stored in a different way, which is
+ more compact and can store the new floats losslessly.
+
+ It is recommended to use version 2 or higher.
+
+ The created string consists of two lines, each terminated with
+ a newline character: the first line describes the format used to
+ save the value in the '#x:y' notation; the second line is the
+ representation of the value itself.
+
+ The format of the encoded value and of the format line matches
+ the format used by save_object() and restore_object().
+
+HISTORY
+ Introduced in LDMud 3.2.8.
+ LDMud 3.2.9 added the saving of non-lambda closures, symbols,
+ and quoted arrays, using the new savefile format version 1.
+ LDMud 3.2.10 added the <format> argument.
+ LDMud 3.5.0 added savefile format version 2.
- Es wird empfohlen, die Angabe des Formats wegzulassen oder in Version
- 2 (oder hoeher) zu speichern.
-
- Der erzeugte String besteht aus zwei Zeilen, die jeweils mit einem
- Zeilenumbruch enden. Die erste Zeile beschreibt das Format, in dem der
- Wert gespeichert wird, in der '#x:y'-Schreibweise. Die zweite Zeile
- stellt den eigentlichen Wert da.
-
- Das Format zum Schreiben des Wertes in den String entspricht dem von
- save_object() und restore_object() verwendeten Format.
-
-GESCHICHTE
- Eingefuehrt in LDMud 3.2.8.
- LDMud 3.2.9. ergaenzte die Funktion um die Moeglichkeit, Non-Lambda
- Closures, Symbole und gequotete Arrays zu speichern. Dazu wurde
- ein neues Format fuer den String eingefuehrt.
- LDMud 3.2.10 fuehrte das Argument <format> ein.
- LDMud 3.5.0 fuehrte Formatversion 2 ein.
-
-SIEHE AUCH
+SEE ALSO
restore_value(E), restore_object(E), save_object(E)