summaryrefslogtreecommitdiff
path: root/man/systemd.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2018-04-19 17:48:53 +0200
committerLennart Poettering <lennart@poettering.net>2018-04-19 18:04:26 +0200
commit23b27b39d2a3a002ad827a2e8a9872a51495d797 (patch)
tree41a12d6cad4dcd8e647b1a262f0cc70aebf1f359 /man/systemd.xml
parent2c75088094a1c3b0d743145ba224d078025eb5bc (diff)
downloadsystemd-23b27b39d2a3a002ad827a2e8a9872a51495d797.tar.gz
terminal: add internal API to format URLs for display in capable terminals
Newer terminals (in particular gnome-terminal) understand special escape sequence for formatting clickable links. Let's support that to make our tool output more clickable where that's appropriate. For details see this: https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda The one big issue is that 'less' currently doesn't grok this, and doesn't ignore sequence like regular terminal implementations do if they don't support it. Hence for now, let's disable URL output if a pager is used. We should revisit that though as soon as less added support for it and enough time passed for it to enter various distributions.
Diffstat (limited to 'man/systemd.xml')
-rw-r--r--man/systemd.xml9
1 files changed, 9 insertions, 0 deletions
diff --git a/man/systemd.xml b/man/systemd.xml
index 679851fc90..84aa43723c 100644
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -856,6 +856,15 @@
</varlistentry>
<varlistentry>
+ <term><varname>$SYSTEMD_URLIFY</varname></term>
+
+ <listitem><para>The value must be a boolean. Controls whether clickable links should be generated in the output
+ for terminal emulators supporting this. This can be specified to override the decision that
+ <command>systemd</command> makes based on <varname>$TERM</varname> and other conditions.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><varname>$LISTEN_PID</varname></term>
<term><varname>$LISTEN_FDS</varname></term>
<term><varname>$LISTEN_FDNAMES</varname></term>