P_VISUALBELL durch P_ALERT ersetzt
P_ALERT enthaelt ein Bitfeld, in dem verschiedene Konfigurationen rund
um Benachrichtigungen gespeichert werden koennen.
Dies ist eine Vorbereitung auf eine Aenderung des Klingeltons.
Langfristig soll hier auch gespeichert werden, ob der Spieler
beispielsweise lieber grafische Benachrichtigungen o.Ae. erhalten
moechte.
Bei Anwendung Regionen umstellen.
Change-Id: I0f872777d895ae1cd9fe4c73bdb8a7739c20cb68
diff --git a/doc/sphinx/lfun/ReceiveMsg.rst b/doc/sphinx/lfun/ReceiveMsg.rst
index 1734eb0..153cc73 100644
--- a/doc/sphinx/lfun/ReceiveMsg.rst
+++ b/doc/sphinx/lfun/ReceiveMsg.rst
@@ -232,6 +232,8 @@
MSG_DONT_IGNORE Nachricht kann nicht ignoriert werden
MSG_ALL_TYPES alle relevanten Sinne fuer die angegebenen Nachrichten-
typen muessen benutzbar sein (UND statt ODER).
+ MSG_ALERT Nachricht loest eine vom Spieler konfigurierte
+ Benachrichtigung aus (z.B. Piepston)
MSG_BS_LEAVE_LFS wie BS_LEAVE_MY_LFS fuer break_string()
MSG_BS_SINGLE_SPACE wie BS_SINGLE_SPACE fuer break_string()
@@ -282,4 +284,5 @@
Efuns: tell_object(E), catch_tell(L), catch_msg(L)
query_verb(E), query_once_interactive(E), break_string(SE)
-Letzte Aenderung: 07.01.2022
+Letzte Aenderung: 22.01.2022
+
diff --git a/doc/sphinx/props/P_ALERT.rst b/doc/sphinx/props/P_ALERT.rst
new file mode 100644
index 0000000..6be860a
--- /dev/null
+++ b/doc/sphinx/props/P_ALERT.rst
@@ -0,0 +1,41 @@
+P_ALERT
+=======
+
+NAME
+----
+
+ P_ALERT "visualbell"
+
+DEFINIERT IN
+------------
+
+ /sys/player/comm.h
+
+BESCHREIBUNG
+------------
+
+ Enthaelt ein Bitfeld, in welchem konfiguriert ist, bei welchen Arten von
+ Ereignissen ein Spieler welche Art von Benachrichtigung erhalten moechte.
+
+ Das Verhalten kann vom Spieler durch unterschiedliche Befehle beeinflusst
+ werden, aktuell sind dies ton und klingelton.
+
+ Aktuell gibt es folgende Moeglichkeiten:
+ - AL_NO_SOUND
+ Keine Pieptoene empfangen
+
+BEMERKUNGEN
+-----------
+
+ Bitte verwendet ReceiveMsg() mit MSG_ALERT, anstatt P_ALERT selbst
+ auszuwerten.
+
+ Das historische Standardverhalten ist 0, hierbei werden Toene empfangen und
+ es sind keine sonstigen Konfigurationen vorhanden.
+
+SIEHE AUCH
+----------
+
+ :doc:`../lfun/ReceiveMsg`
+
+Letzte Aenderung: 22.01.2022, Bugfix
diff --git a/doc/sphinx/props/P_MESSAGE_BEEP.rst b/doc/sphinx/props/P_MESSAGE_BEEP.rst
index 90b3f72..2475669 100644
--- a/doc/sphinx/props/P_MESSAGE_BEEP.rst
+++ b/doc/sphinx/props/P_MESSAGE_BEEP.rst
@@ -3,36 +3,29 @@
NAME
----
-::
- P_MESSAGE_BEEP "message_beep"
+ P_MESSAGE_BEEP "message_beep"
DEFINIERT IN
------------
-::
- /sys/player/comm.h
+ /sys/player/comm.h
BESCHREIBUNG
------------
-::
- Wertebereich: int=0..3600 (Sekunden)
- Wenn gesetzt wird in der Kommunikation des Spielers in den angegebenen
- Zeitraeumen ein Signalton ausgegeben. Wird in player/comm.c in comm_beep()
- verarbeitet.
- Ausgabe erfolgt nur, wenn P_VISUALBELL nicht gesetzt ist.
- Wird im Spielerobjekt gespeichert!
+ Wertebereich: int=0..3600 (Sekunden)
+ Wenn gesetzt wird in der Kommunikation des Spielers in den angegebenen
+ Zeitraeumen ein Signalton ausgegeben. Wird in player/comm.c in comm_beep()
+ verarbeitet.
+ Ausgabe erfolgt in Abhaengigkeit der Konfiguration in :doc:`P_ALERT`.
+
+ Wird im Spielerobjekt gespeichert und mittels des Kommandos klingelton
+ modifiziert.
SIEHE AUCH
----------
-::
- klingelton, ton, P_VISUALBELL, P_MESSAGE_LAST_BEEP
+ klingelton, ton, :doc:`P_ALERT`
-LETZTE AENDERUNG
-----------------
-::
-
- 16. Mai 2007 Ennox
-
+Letzte Aenderung: 22.01.2022, Bugfix
diff --git a/doc/sphinx/props/P_VISUALBELL.rst b/doc/sphinx/props/obsolete/P_VISUALBELL.rst
similarity index 84%
rename from doc/sphinx/props/P_VISUALBELL.rst
rename to doc/sphinx/props/obsolete/P_VISUALBELL.rst
index de55bde..c1575b3 100644
--- a/doc/sphinx/props/P_VISUALBELL.rst
+++ b/doc/sphinx/props/obsolete/P_VISUALBELL.rst
@@ -1,6 +1,11 @@
P_VISUALBELL
============
+********************* VERALTETE PROPERTY ***********************
+* Diese Property ist veraltet und wurde durch P_ALERT ersetzt. *
+* Bitte nicht mehr in neuem Code nutzen. *
+****************************************************************
+
NAME
----
::