SF.net SVN: docutils:[10119] trunk/docutils/docs/user/config.rst

Revision: 10119
          http://sourceforge.net/p/docutils/code/10119
Author:   grubert
Date:     2025-05-01 10:01:14 +0000 (Thu, 01 May 2025)
Log Message:
-----------
some text to manpage references

Modified Paths:
--------------
    trunk/docutils/docs/user/config.rst

Modified: trunk/docutils/docs/user/config.rst
===================================================================
--- trunk/docutils/docs/user/config.rst	2025-05-01 09:35:34 UTC (rev 10118)
+++ trunk/docutils/docs/user/config.rst	2025-05-01 10:01:14 UTC (rev 10119)
@@ -2106,7 +2106,21 @@
 .. _mandoc: http://mandoc.bsd.lv/
 .. _groff: https://gnu.org/software/groff/
 
+macro-references
+~~~~~~~~~~~~~~~~
+Output man-macros ``.UR``/``.UE`` for uri references 
+and ``.MT``/``.ME`` for email-addresses.
 
+If False rendering of references is done by the manpage writer.
+
+The option exists because 2024 or so, the man macros began to support
+OSC8 terminals, that became more available. But not everyone, every
+system supports OSC8, e.g. mandoc_ macros do not output OSC8.
+
+:Default: False. ... will be True ... soon.
+:Options: ``--macro-references`` to set True, ``--text-references`` to set
+          False.
+
 .. _ODF/ODT Writer:
 
 [odf_odt writer]

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.