# HG changeset patch
# User David Demelier <markand@malikania.fr>
# Date 1624178301 -7200
# Node ID 4b53eb6fff7348f6db279a2fbfdd7189277a4731
# Parent  d7764d6cdab8c78c46cb4bbba0b9db54544cb4af
man: advertise the shell syntax

diff -r d7764d6cdab8 -r 4b53eb6fff73 man/irccd-templates.7
--- a/man/irccd-templates.7	Sun Jun 20 09:53:12 2021 +0200
+++ b/man/irccd-templates.7	Sun Jun 20 10:38:21 2021 +0200
@@ -46,6 +46,8 @@
 variables).
 .It Ar @{attributes}
 the attributes will be substituted to IRC colors (see Attributes).
+.It Ar !{command}
+execute the shell command (see Shell).
 .El
 .\" TIME
 .Sh TIME
@@ -159,6 +161,12 @@
 .It
 hidden
 .El
+.\" SHELL
+.Sh SHELL
+This format executes the command enclosed in the braces verbatim using the
+.Xr popen 3
+function. It only captures the standard input so you may need to redirect the
+error somewhere else if you need to capture it.
 .\" KEYWORDS
 .Sh KEYWORDS
 Keywords are arbitrary names that are replaced depending on the context. They
@@ -236,6 +244,15 @@
 .Pp
 The keyword #{origin} will be substituted to the nickname and #{channel} to the
 channel name.
+.Pp
+Shell:
+.Bl -tag -width 20n -offset Ds
+.It !{uptime}
+will return the status of the command.
+.El
+.Pp
+Be very cautious with user input as they may access your file system if you use
+direct user input in this.
 .\" SEE ALSO
 .Sh SEE ALSO
 .Xr irccd 1 ,