[1/3] manual: Extract the @manpageurl{func,sec} macro

Message ID 01bc271cfd0622152caf38c805798c0d72f61809.1725561027.git.fweimer@redhat.com
State Superseded
Headers
Series Add the sched_setattr, sched_getattr functions |

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

Florian Weimer Sept. 5, 2024, 6:33 p.m. UTC
  From the existing @manpagefunctionstub{func,sec} macro,
so that URLs can be included in the manual without the
stub text.
---
 manual/macros.texi | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)
  

Comments

Carlos O'Donell Sept. 5, 2024, 7:50 p.m. UTC | #1
On 9/5/24 2:33 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.

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
>
  

Patch

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