log_file legt Verzeichnisse bei Bedarf an
Change-Id: I4dfc1f74f7fe899a7b4dc18987b1e1550cc3075f
diff --git a/doc/sphinx/sefun/log_file.rst b/doc/sphinx/sefun/log_file.rst
index b1586be..cc10d34 100644
--- a/doc/sphinx/sefun/log_file.rst
+++ b/doc/sphinx/sefun/log_file.rst
@@ -3,36 +3,38 @@
FUNKTION
--------
-::
- int log_file(string file, string text)
- int log_file(string file, string text, int size_to_break)
+ varargs int log_file(string file, string text, int size_to_break)
ARGUMENTE
---------
-::
- file - Name der Datei, in die geschrieben werden soll
- text - Der Text, der geschrieben werden soll
- size_to_break - Groesse, ab der ein neues File begonnen wird (optional)
+ file
+ Name der Datei, in die geschrieben werden soll
+
+ text
+ Der Text, der geschrieben werden soll
+
+ size_to_break
+ Groesse, ab der ein neues File begonnen wird (optional)
BESCHREIBUNG
------------
-::
- log_file schreibt den Text text in die Datei /log/file.
- Sollte file schon mit einem /log/ beginnen, wird kein erneutes /log/ davor
- eingefuegt.
+ log_file schreibt den Text text in die Datei /log/file.
+ Sollte file schon mit einem /log/ beginnen, wird kein erneutes /log/ davor
+ eingefuegt.
+ Falls das Zielverzeichnis unterhalb von /log/ noch nicht existiert, wird
+ dies automatisch angelegt, sofern das rufende Objekt das Logfile schreiben
+ darf.
RUECKGABEWERT
-------------
-::
1 bei Erfolg oder 0, falls ein Fehler beim Schreiben auftrat.
BEMERKUNGEN
-----------
-::
Wenn die Groesse von file vor dem Schreiben 50000 Bytes ueberschreitet,
wird sie in file.old umbenannt. Eine schon vorhandene Datei file.old
@@ -42,7 +44,8 @@
BEISPIELE
---------
-::
+
+.. code-block:: pike
log_file( "report/wargon.rep", "TYPO von bla in blubb:\ntest\n");
In /log/report/wargon.rep finde ich nun die neueste Typomeldung... ;)
@@ -51,9 +54,8 @@
SIEHE AUCH
----------
-::
write_file(E)
-29.01.2017, Zesstra
+05.09.2018, Zesstra