[v2,1/3] manual: Extract the @manpageurl{func,sec} macro
Checks
Context |
Check |
Description |
redhat-pt-bot/TryBot-apply_patch |
success
|
Patch applied to master at the time it was sent
|
linaro-tcwg-bot/tcwg_glibc_build--master-arm |
success
|
Build passed
|
linaro-tcwg-bot/tcwg_glibc_build--master-aarch64 |
success
|
Build passed
|
linaro-tcwg-bot/tcwg_glibc_check--master-arm |
success
|
Test passed
|
linaro-tcwg-bot/tcwg_glibc_check--master-aarch64 |
success
|
Test passed
|
Commit Message
From the existing @manpagefunctionstub{func,sec} macro,
so that URLs can be included in the manual without the
stub text.
Reviewed-by: Carlos O'Donell <carlos@redhat.com>
---
manual/macros.texi | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
Comments
On 9/5/24 4:24 PM, Florian Weimer wrote:
> From the existing @manpagefunctionstub{func,sec} macro,
> so that URLs can be included in the manual without the
> stub text.
LGTM. Same as before, and retains my RB.
> Reviewed-by: Carlos O'Donell <carlos@redhat.com>
> ---
> manual/macros.texi | 7 +++++--
> 1 file changed, 5 insertions(+), 2 deletions(-)
>
> diff --git a/manual/macros.texi b/manual/macros.texi
> index 579da3fb81..f48dd4ec22 100644
> --- a/manual/macros.texi
> +++ b/manual/macros.texi
> @@ -282,10 +282,13 @@ cwd\comments\
> @macro standardsx {element, standard, header}
> @end macro
>
> +@macro manpageurl {func, sec}
> +@url{https://man7.org/linux/man-pages/man\sec\/\func\.\sec\.html}
> +@end macro
> +
> @macro manpagefunctionstub {func,sec}
> This documentation is a stub. For additional information on this
> -function, consult the manual page
> -@url{https://man7.org/linux/man-pages/man\sec\/\func\.\sec\.html}.
> +function, consult the manual page @manpageurl{\func\,\sec\}.
> @xref{Linux Kernel}.
> @end macro
>
@@ -282,10 +282,13 @@ cwd\comments\
@macro standardsx {element, standard, header}
@end macro
+@macro manpageurl {func, sec}
+@url{https://man7.org/linux/man-pages/man\sec\/\func\.\sec\.html}
+@end macro
+
@macro manpagefunctionstub {func,sec}
This documentation is a stub. For additional information on this
-function, consult the manual page
-@url{https://man7.org/linux/man-pages/man\sec\/\func\.\sec\.html}.
+function, consult the manual page @manpageurl{\func\,\sec\}.
@xref{Linux Kernel}.
@end macro