summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSlatian <baschdel@disroot.org>2023-11-27 21:57:45 +0100
committerSlatian <baschdel@disroot.org>2023-11-27 22:02:37 +0100
commit56ee8b38cafa8fda177492a66d1321de773756f9 (patch)
tree1a49f229c515c3309a78a77f84b000f4d557ded7
parent1e2ec2446b55854b36f2fd2c52778d3e7dda08f8 (diff)
Added a reporting issues section to xdg-open in the hopes that more issues will be attributed correctly
-rw-r--r--scripts/desc/xdg-open.xml18
1 files changed, 18 insertions, 0 deletions
diff --git a/scripts/desc/xdg-open.xml b/scripts/desc/xdg-open.xml
index f3c8135..3e259c3 100644
--- a/scripts/desc/xdg-open.xml
+++ b/scripts/desc/xdg-open.xml
@@ -148,6 +148,24 @@
In case of success the process launched from the .desktop file will not be forked off and therefore may result in xdg-open running for a very long time. This behaviour intentionally differs from most desktop specific openers to allow terminal based applications to run using the same terminal xdg-open was called from.
</para>
</refsect1>
+ <refsect1 id="reporting-issues">
+ <title>Reporting Issues</title>
+ <para>
+ Please keep in mind <command>xdg-open</command> inherits most of the flaws of its configuration and the underlying opener.
+ </para>
+ <para>
+ In case the command <code>xdg-mime query default "$(xdg-mime query filetype troublesome file)"</code> names the program responsible for any unexpected behaviour you can fix that by setting a different handler. (If the program is broken let the developers know)
+ </para>
+ <para>
+ Also see the security note on <citerefentry><refentrytitle>xdg-mime</refentrytitle><manvolnum>1</manvolnum></citerefentry> for the <code>default</code> subcommand.
+ </para>
+ <para>
+ If a flaw is reproducible using the desktop specific opener (and isn't a configuration issue): Please report to whoever is responsible for that first (reporting to xdg-utils is better than not reporting at all, but since the xdg-utils are maintained in very little spare time a fix will take much longer)
+ </para>
+ <para>
+ In case an issue specific to xdg-open please report it to <uri>https://gitlab.freedesktop.org/xdg/xdg-utils/-/issues</uri> .
+ </para>
+ </refsect1>
<refsect1 id="seealso">
<title>See Also</title>
<para><citerefentry><refentrytitle>xdg-mime</refentrytitle>