Re: [PATCH] man-pages.7: Add description of "ATTRIBUTES"

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello Peng,

On Tue, Mar 12, 2013 at 11:41 AM, Peng Haitao <penght@xxxxxxxxxxxxxx> wrote:
> "ATTRIBUTES" section can mention thread safety, cancellation safety and async-cancel-safety.

I have started a local branch in which I am applying these patches.
I've applied this patch, as well as your patches for readdir.3,
ecvt.3, and localeconv.3. I'd like for us to get several more patches
done before I merge the branch into 'master'.

I appreciate that you may have a large number of patches for me. At
least to start with, let us go a bit slowly while we fine tune things.
It would be be best is you sent me 3 to 6 more patches now, and even
better if they handled a few different cases. E.g., if you have
patches that discuss things other than "thread-safety", send me a
couple of those.

Thank you for the patch.

Cheers,

Michael




> Signed-off-by: Peng Haitao <penght@xxxxxxxxxxxxxx>
> ---
>  man7/man-pages.7 | 25 ++++++++++++++++++++++++-
>  1 file changed, 24 insertions(+), 1 deletion(-)
>
> diff --git a/man7/man-pages.7 b/man7/man-pages.7
> index fd1ae37..ae87525 100644
> --- a/man7/man-pages.7
> +++ b/man7/man-pages.7
> @@ -25,7 +25,7 @@
>  .\" 2007-05-30 created by mtk, using text from old man.7 plus
>  .\" rewrites and additional text.
>  .\"
> -.TH MAN-PAGES 7 2013-02-24 "Linux" "Linux Programmer's Manual"
> +.TH MAN-PAGES 7 2013-03-12 "Linux" "Linux Programmer's Manual"
>  .SH NAME
>  man-pages \- conventions for writing Linux man pages
>  .SH SYNOPSIS
> @@ -184,6 +184,7 @@ ERRORS             [Typically only in Sections 2, 3]
>  .\" SECURITY,
>  ENVIRONMENT
>  FILES
> +ATTRIBUTES         [Normally only in Sections 2, 3]
>  VERSIONS           [Normally only in Sections 2, 3]
>  CONFORMING TO
>  NOTES
> @@ -324,6 +325,28 @@ as the base.
>  .\" section).
>  .\" However, please include security information somewhere!
>  .TP
> +.B ATTRIBUTES
> +A summary of various attributes of the function(s) documented on this page,
> +broken into subsections.
> +The following subsections are defined:
> +.sp
> +.RS
> +.TP
> +.B "Multithreading (see pthreads(7))"
> +This subsection notes attributes relating to multithreaded applications:
> +.RS
> +.IP * 3
> +Whether the function is thread-safe.
> +.IP *
> +Whether the function is a cancellation point.
> +.IP *
> +Whether the function is async-cancel-safe.
> +.RE
> +.IP
> +Details of these attributes can be found in
> +.BR pthreads (7).
> +.RE
> +.TP
>  .B VERSIONS
>  A brief summary of the Linux kernel or glibc versions where a
>  system call or library function appeared,
> --
> 1.8.1.4
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux