Re: [PATCH v2 2/3] Documentation: Remove :manpage: from non-existing man pages

[Jonathan Corbet <corbet@lwn.net>]

Petr Vorel <pvorel@suse.cz> writes:

> Removing :manpage: from non-existing man pages (xyzzy(2), xyzzyat(2),
> fxyzzy(3) in adding-syscalls.rst, including translations) prevent
> adding link to nonexisting man pages when using manpages_url in next
> commit.
>
> Signed-off-by: Petr Vorel <pvorel@suse.cz>
> ---
> New in v2.
>
>  Documentation/process/adding-syscalls.rst          | 14 +++++++-------
>  .../translations/it_IT/process/adding-syscalls.rst | 14 +++++++-------
>  .../translations/sp_SP/process/adding-syscalls.rst | 14 +++++++-------
>  3 files changed, 21 insertions(+), 21 deletions(-)
>
> diff --git a/Documentation/process/adding-syscalls.rst b/Documentation/process/adding-syscalls.rst
> index fc0b0bbcd34df..1f61d0b114120 100644
> --- a/Documentation/process/adding-syscalls.rst
> +++ b/Documentation/process/adding-syscalls.rst
> @@ -111,7 +111,7 @@ should use a file descriptor as the handle for that object -- don't invent a
>  new type of userspace object handle when the kernel already has mechanisms and
>  well-defined semantics for using file descriptors.
>  
> -If your new :manpage:`xyzzy(2)` system call does return a new file descriptor,
> +If your new `xyzzy(2)` system call does return a new file descriptor,

Here, once again, you're retaining the backticks.  If we need to mark up
those references at all, they should be ``literal``.

(If you simply remove the backticks, you might run into conflict with
automarkup, though I *think* that the section number will evade its
regexp).

Thanks,

jon