diff options
| author | Slatian <baschdel@disroot.org> | 2023-10-07 18:26:53 +0200 |
|---|---|---|
| committer | Simon Lees <simon@simotek.net> | 2023-10-11 05:32:09 +0000 |
| commit | be7515f9ba9e8467385b051b225b90aa700db340 (patch) | |
| tree | cea1d8940f8d1f5a451d3e2b8ca74ac4c58730a4 | |
| parent | 8664c1fbbd40780bd04d92c51232454f855ee196 (diff) | |
Documented xdg-opens inablity to handle minuses at the start of arguments and possible workarounds.
| -rw-r--r-- | scripts/desc/xdg-open.xml | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/scripts/desc/xdg-open.xml b/scripts/desc/xdg-open.xml index 2bfdf0b..1474dd9 100644 --- a/scripts/desc/xdg-open.xml +++ b/scripts/desc/xdg-open.xml @@ -1,8 +1,8 @@ <?xml version="1.0"?> <?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ ]> <refentry id="xdg-open"> <refentryinfo> @@ -64,6 +64,14 @@ xdg-open is for use inside a desktop session only. It is not recommended to use xdg-open as root. </para> + <para> + As xdg-open can not handle arguments that begin with a <quote>-</quote> it is recommended to pass filepaths in one of the following ways: + </para> + <itemizedlist> + <listitem><para>Pass absolute paths, i.e. by using <command>realpath</command> as a preprocessor.</para></listitem> + <listitem><para>Prefix known relative filepaths with a <quote>./</quote>. For example using <code>sed -E 's|^[^/]|./\0|'</code>.</para></listitem> + <listitem><para>Pass a file URL.</para></listitem> + </itemizedlist> </refsect1> <refsect1 id="options"> <title>Options</title> |