Set+Query: default argument statt varargs
Die Funktionen sind varargs aufgrund der letzten Argumente,
die anderen sind nicht optional. Daher bietet sich ein default
fuer diese Argumente an statt varargs fuer die ganze Funktion,
zumal diese gar nicht pruefen, ob die anderen Argumente
uebergeben werden.
Ausserdem das Argument 'extern' in 'drop_priv' umbenannt, weil das
besser beschreibt, um was es geht: den Aufruf trotz internem Call
*nicht* als privilegiert zu behandeln.
Aber Achtung:
Es ist verfuehrerisch, das 'drop_priv||extern_call()' durch 'drop_priv'
zu ersetzen, weil extern_call() das default-argument fuer <drop_priv>
ist. Das ist keine gute Idee, weil <drop_priv> unter der Kontrolle des
Aufrufers ist und dieser 0 uebergeben kann. Sprich: wenn es 0 ist,
muessen wir dennoch selber pruefen. Wir glauben aber immer, wenn es 1
ist und der Aufrufer Privilegien abgeben will.
Change-Id: I90cecbfc1ed36a3ed5e3614bca7cc51e78b85b72
diff --git a/doc/sphinx/lfun/Query.rst b/doc/sphinx/lfun/Query.rst
index 0a27959..31f2ce0 100644
--- a/doc/sphinx/lfun/Query.rst
+++ b/doc/sphinx/lfun/Query.rst
@@ -5,7 +5,7 @@
--------
::
- public varargs mixed Query(string name, int Type);
+ public mixed Query(string name, int Type = F_VALUE);
DEFINIERT IN
------------
diff --git a/doc/sphinx/lfun/Set.rst b/doc/sphinx/lfun/Set.rst
index ffca76a..bf2dbad 100644
--- a/doc/sphinx/lfun/Set.rst
+++ b/doc/sphinx/lfun/Set.rst
@@ -5,7 +5,8 @@
--------
::
- public varargs mixed Set(string name, mixed Value, int Type, int extern);
+ public mixed Set(string name, mixed Value,
+ int Type = F_VALUE, int drop_priv = extern_call())
DEFINIERT IN
------------
@@ -21,8 +22,8 @@
name - Property, die manipuliert werden soll
Value - der zu setzende/aendernde Wert
Type - die Eigenschaft der Property, die manipuliert werden soll
- extern - Interne Verwendung:
- Wurde Set ueber SetProp von aussen gerufen.
+ drop_priv - Interne Verwendung, wenn Aufrufer Privilegien abgibt,
+ z.B. objekt-interner Aufruf extern zaehlen soll.
BESCHREIBUNG
------------
@@ -170,5 +171,5 @@
Konzept: properties, /std/thing/properties.c
Sonstiges: P_AUTOLOADOBJ
-06. Jan 2008 Arathorn
+8.9.2021, Zesstra