Update doc/efun/ aus Driversourcen.
Manpages der efuns aktualisiert, neue Manpages hinzugefuegt.
Change-Id: I7cc91684269ff56d1aef47d5c5e7c87f7fd531dc
diff --git a/doc/efun/m_add b/doc/efun/m_add
index e7e34d1..60a4362 100644
--- a/doc/efun/m_add
+++ b/doc/efun/m_add
@@ -1,22 +1,21 @@
SYNOPSIS
- mapping m_add(mapping map, mixed key, [mixed data, ...])
+ mapping m_add(mapping map, mixed key, [mixed data...])
-BESCHREIBUNG
- Fuegt einen neuen Eintrag mit Index <key> zum Mapping <map> hinzu
- oder ersetzt diesen. Das veraenderte Mapping wird auch als Ergebnis
- zurueckgeliefert.
+DESCRIPTION
+ Add (or replace) an entry with index <key> in mapping <map>.
+ The modified mapping is also returned as result.
- Die zugehoerigen Werte fuer diesen Eintrag werden aus den weiteren
- Parametern entnommen. Fehlende Parameter werden als 0 interpretiert,
- ueberzaehlige Parameter werden ignoriert.
+ The values for the entry are taken from the <data> arguments.
+ Unassigned entry values default to 0, extraneous <data> arguments
+ are ignored.
- Der Unterschied zwischen m_add() und dem '+='-Operator besteht darin,
- dass fuer letzterem gegebenenfalls erst ein temporaeres Mapping,
- welches die hinzuzufuegenden Eintraege enthaelt, erstellt werden
- muesste, wogegen m_add() ohne ein solches auskommt.
+ The difference between m_add() and the operator += is that for
+ the latter you might need to create a temporary mapping that
+ contains the entries to add, which m_add() doesn't.
-BEISPIELE
+EXAMPLES
mapping m;
+
m = ([ "foo" ]);
m_add(m, "bar", 1) --> ([ "foo", "bar" ])
@@ -25,13 +24,12 @@
m = ([ "foo":1;2 ]);
m_add(m, "bar", 1) --> ([ "foo":1;2, "bar":1;0 ])
+ m_add(m, "baz", ({ 4, 5 })... )
+ --> ([ "foo":1;2, "bar":1;0, "baz":4;5 ])
- apply(#'m_add, m, "baz", ({ 4, 5 }))
- --> ([ "foo":1;2, "bar":1;0, "baz":4;5 ])
+HISTORY
+ Introduced in LDMud 3.2.9.
-GESCHICHTE
- Eingefuehrt in LDMud 3.2.9.
-
-SIEHE AUCH
+SEE ALSO
mappingp(E), mkmapping(E), m_delete(E), m_entry(E), m_indices(E),
m_values(E), sizeof(E), widthof(E)