diff --git a/man/journalctl.xml b/man/journalctl.xml
index a3c67f5e82..0ecab521fa 100644
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -887,18 +887,34 @@
- Asks the journal daemon to flush any log data
- stored in /run/log/journal into
- /var/log/journal, if persistent storage
- is enabled. This call does not return until the operation is
- complete. Note that this call is idempotent: the data is only
- flushed from /run/log/journal into
- /var/log/journal once during system
- runtime, and this command exits cleanly without executing any
- operation if this has already happened. This command
- effectively guarantees that all data is flushed to
- /var/log/journal at the time it
- returns.
+ Asks the journal daemon to flush any log data stored in
+ /run/log/journal/ into /var/log/journal/, if persistent
+ storage is enabled. This call does not return until the operation is complete. Note that this call is
+ idempotent: the data is only flushed from /run/log/journal/ into
+ /var/log/journal once during system runtime (but see
+ below), and this command exits cleanly without executing any
+ operation if this has already happened. This command effectively guarantees that all data is flushed
+ to /var/log/journal at the time it returns.
+
+
+
+
+
+ Asks the journal daemon for the reverse operation to : if
+ requested the daemon will write further log data to /run/log/journal/ and stops
+ writing to /var/log/journal/. A subsequent call to
+ causes the log output to switch back to /var/log/journal/, see
+ above.
+
+
+
+
+
+ Similar to but executes no operation if the root file
+ system and /var/lib/journal/ reside on the same mount point. This operation is
+ used during system shutdown in order to make the journal daemon stop writing data to
+ /var/log/journal/ in case that directory is located on a mount point that needs
+ to be unmounted.