core: add command /print

1 files changed, 38 insertions, 0 deletions

diff --git a/doc/en/autogen/user/weechat_commands.txt b/doc/en/autogen/user/weechat_commands.txt
index 12a20d9bd..3dc69a684 100644
--- a/doc/en/autogen/user/weechat_commands.txt
+++ b/doc/en/autogen/user/weechat_commands.txt
@@ -561,6 +561,44 @@ arguments: arguments given to plugin on load
 Without argument, this command lists loaded plugins.
 ----
 
+[[command_weechat_print]]
+[command]*`print`* display text on a buffer::
+
+----
+/print  [-buffer <number>|<name>] [-core] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] <text>
+        -stdout|-stderr <text>
+
+-buffer: the buffer where text is displayed (default: current buffer)
+  -core: alias of "-buffer core.weechat"
+-escape: interpret escaped chars (for example \a, \07, \x07)
+  -date: message date, format can be:
+           -n: 'n' seconds before now
+           +n: 'n' seconds in the future
+            n: 'n' seconds since the Epoch (see man time)
+           date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
+           time: hh:mm:ss (example: 04:32:55)
+  -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
+   text: text to display (prefix and message must be separated by \t)
+-stdout: display text on stdout (not in a buffer)
+-stderr: display text on stderr (not in a buffer)
+
+The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
+
+With options -stdout and -stderr, escaped chars are always interpreted.
+
+Examples:
+  display a reminder on core buffer with a highlight:
+    /print -core -tags notify_highlight Reminder: buy milk
+  display an error on core buffer:
+    /print -core -error Some error here
+  display message on core buffer with prefix "abc":
+    /print -core abc	The message
+  display a message on channel #weechat:
+    /print -buffer irc.freenode.#weechat Message on #weechat
+  send alert (BEL):
+    /print -stderr \a
+----
+
 [[command_weechat_proxy]]
 [command]*`proxy`* manage proxies::