From 8583c5f48bb1aea53dcebf76613a1d694d578e69 Mon Sep 17 00:00:00 2001 From: Naïm Favier Date: Tue, 28 Dec 2021 13:26:35 +0100 Subject: doc: remove reference to unix-man-urls.lua --- doc/build-aux/pandoc-filters/link-unix-man-references.lua | 3 +-- doc/contributing/contributing-to-documentation.chapter.md | 2 +- 2 files changed, 2 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/build-aux/pandoc-filters/link-unix-man-references.lua b/doc/build-aux/pandoc-filters/link-unix-man-references.lua index 12431f140fe..e437ac73a1c 100644 --- a/doc/build-aux/pandoc-filters/link-unix-man-references.lua +++ b/doc/build-aux/pandoc-filters/link-unix-man-references.lua @@ -1,6 +1,5 @@ --[[ -Turns a manpage reference into a link, when a mapping is defined -in the unix-man-urls.lua file. +Turns a manpage reference into a link, when a mapping is defined below. ]] local man_urls = { diff --git a/doc/contributing/contributing-to-documentation.chapter.md b/doc/contributing/contributing-to-documentation.chapter.md index 178fdb36262..1384772ebb2 100644 --- a/doc/contributing/contributing-to-documentation.chapter.md +++ b/doc/contributing/contributing-to-documentation.chapter.md @@ -55,7 +55,7 @@ Additionally, the following syntax extensions are currently used: - []{#ssec-contributing-markup-inline-roles} If you want to link to a man page, you can use `` {manpage}`nix.conf(5)` ``, which will turn into {manpage}`nix.conf(5)`. - The references will turn into links when a mapping exists in {file}`doc/build-aux/pandoc-filters/unix-man-urls.lua`. + The references will turn into links when a mapping exists in {file}`doc/build-aux/pandoc-filters/link-unix-man-references.lua`. This syntax is taken from [MyST](https://myst-parser.readthedocs.io/en/latest/syntax/syntax.html#roles-an-in-line-extension-point). Though, the feature originates from [reStructuredText](https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-manpage) with slightly different syntax. -- cgit 1.4.1