[PATCH 3/3] splice.2, tee.2, vmsplice.2: Update return type

[PATCH 3/3] splice.2, tee.2, vmsplice.2: Update return type

[Mark Hills]

Return type is ssize_t since glibc-2.7, see /usr/include/bits/fcntl.h
---
 man2/splice.2   |    6 +++---
 man2/tee.2      |    4 ++--
 man2/vmsplice.2 |    6 +++---
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/man2/splice.2 b/man2/splice.2
index d9c192a..0bb5f17 100644
--- a/man2/splice.2
+++ b/man2/splice.2
@@ -23,7 +23,7 @@
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
-.TH SPLICE 2 2009-02-20 "Linux" "Linux Programmer's Manual"
+.TH SPLICE 2 2009-05-25 "Linux" "Linux Programmer's Manual"
 .SH NAME
 splice \- splice data to/from a pipe
 .SH SYNOPSIS
@@ -31,8 +31,8 @@ splice \- splice data to/from a pipe
 .B #define _GNU_SOURCE
 .B #include <fcntl.h>
 
-.BI "long splice(int " fd_in ", loff_t *" off_in ", int " fd_out ,
-.BI "            loff_t *" off_out ", size_t " len \
+.BI "ssize_t splice(int " fd_in ", loff_t *" off_in ", int " fd_out ,
+.BI "               loff_t *" off_out ", size_t " len \
 ", unsigned int " flags );
 .fi
 .SH DESCRIPTION
diff --git a/man2/tee.2 b/man2/tee.2
index 323bee5..1bea317 100644
--- a/man2/tee.2
+++ b/man2/tee.2
@@ -23,7 +23,7 @@
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
-.TH TEE 2 2006-04-28 "Linux" "Linux Programmer's Manual"
+.TH TEE 2 2009-05-22 "Linux" "Linux Programmer's Manual"
 .SH NAME
 tee \- duplicating pipe content
 .SH SYNOPSIS
@@ -31,7 +31,7 @@ tee \- duplicating pipe content
 .B #define _GNU_SOURCE
 .B #include <fcntl.h>
 
-.BI "long tee(int " fd_in ", int " fd_out ", size_t " len \
+.BI "ssize_t tee(int " fd_in ", int " fd_out ", size_t " len \
 ", unsigned int " flags );
 .fi
 .SH DESCRIPTION
diff --git a/man2/vmsplice.2 b/man2/vmsplice.2
index 2c95893..8a67880 100644
--- a/man2/vmsplice.2
+++ b/man2/vmsplice.2
@@ -23,7 +23,7 @@
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
-.TH VMSPLICE 2 2006-04-28 "Linux" "Linux Programmer's Manual"
+.TH VMSPLICE 2 2009-05-25 "Linux" "Linux Programmer's Manual"
 .SH NAME
 vmsplice \- splice user pages into a pipe
 .SH SYNOPSIS
@@ -32,8 +32,8 @@ vmsplice \- splice user pages into a pipe
 .B #include <fcntl.h>
 .B #include <sys/uio.h>
 
-.BI "long vmsplice(int " fd ", const struct iovec *" iov ,
-.BI "              unsigned long " nr_segs ", unsigned int " flags );
+.BI "ssize_t vmsplice(int " fd ", const struct iovec *" iov ,
+.BI "                 unsigned long " nr_segs ", unsigned int " flags );
 .fi
 .SH DESCRIPTION
 .\" Linus: vmsplice() system call to basically do a "write to
-- 
1.6.2.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 2/3] strcmp.3: Reference strstr(3)

[Mark Hills]

---
 man3/strcmp.3 |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)

diff --git a/man3/strcmp.3 b/man3/strcmp.3
index 4797e71..62d9cc6 100644
--- a/man3/strcmp.3
+++ b/man3/strcmp.3
@@ -27,7 +27,7 @@
 .\" Modified Sat Jul 24 18:08:52 1993 by Rik Faith (faith-+5Oa3zvhR2o3uPMLIKxrzw@public.gmane.org)
 .\" Modified 2001-08-31, aeb
 .\"
-.TH STRCMP 3  2009-04-21 "" "Linux Programmer's Manual"
+.TH STRCMP 3  2009-05-09 "" "Linux Programmer's Manual"
 .SH NAME
 strcmp, strncmp \- compare two strings
 .SH SYNOPSIS
@@ -68,6 +68,7 @@ SVr4, 4.3BSD, C89, C99.
 .BR strcasecmp (3),
 .BR strcoll (3),
 .BR strncasecmp (3),
+.BR strstr (3),
 .BR strverscmp (3),
 .BR wcscmp (3),
 .BR wcsncmp (3)
-- 
1.6.2.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 1/3] strcpy.3: Reference strdup(3)

[Mark Hills]

---
 man3/strcpy.3 |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)

diff --git a/man3/strcpy.3 b/man3/strcpy.3
index 8fd2c1d..2b4d8ba 100644
--- a/man3/strcpy.3
+++ b/man3/strcpy.3
@@ -30,7 +30,7 @@
 .\" 2007-06-15, Marc Boyer <marc.boyer-oUYRw6/Rnm9Wj0EZb7rXcA@public.gmane.org> + mtk
 .\"     Improve discussion of strncpy().
 .\"
-.TH STRCPY 3  2009-02-04 "GNU" "Linux Programmer's Manual"
+.TH STRCPY 3  2009-05-09 "GNU" "Linux Programmer's Manual"
 .SH NAME
 strcpy, strncpy \- copy a string
 .SH SYNOPSIS
@@ -136,6 +136,7 @@ in ways that may make the impossible possible.
 .BR memccpy (3),
 .BR memcpy (3),
 .BR memmove (3),
+.BR strdup (3),
 .BR strpcpy (3),
 .BR wcscpy (3),
 .BR wcsncpy (3)
-- 
1.6.2.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 1/3] strcpy.3: Reference strdup(3)

[Mark Hills]

Please ignore this thread. The date on the mails is garbage. Git may use 
this so I'll re-send.

> Date:   Tue, 29 Feb 2028 07:35:49 +0000

-- 
Mark
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 2/3] strcmp.3: Reference strstr(3)

[Michael Kerrisk]

Mark,

Why do you think this patch is needed?

Cheers,

Michael

On Tue, Feb 29, 2028 at 9:35 AM, Mark Hills <mark-UrrBsZIrrsb10XsdtD+oqA@public.gmane.org> wrote:
> ---
>  man3/strcmp.3 |    3 ++-
>  1 files changed, 2 insertions(+), 1 deletions(-)
>
> diff --git a/man3/strcmp.3 b/man3/strcmp.3
> index 4797e71..62d9cc6 100644
> --- a/man3/strcmp.3
> +++ b/man3/strcmp.3
> @@ -27,7 +27,7 @@
>  .\" Modified Sat Jul 24 18:08:52 1993 by Rik Faith (faith-+5Oa3zvhR2o@public.gmane.orgdu)
>  .\" Modified 2001-08-31, aeb
>  .\"
> -.TH STRCMP 3  2009-04-21 "" "Linux Programmer's Manual"
> +.TH STRCMP 3  2009-05-09 "" "Linux Programmer's Manual"
>  .SH NAME
>  strcmp, strncmp \- compare two strings
>  .SH SYNOPSIS
> @@ -68,6 +68,7 @@ SVr4, 4.3BSD, C89, C99.
>  .BR strcasecmp (3),
>  .BR strcoll (3),
>  .BR strncasecmp (3),
> +.BR strstr (3),
>  .BR strverscmp (3),
>  .BR wcscmp (3),
>  .BR wcsncmp (3)
> --
> 1.6.2.4
>
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 2/3] strcmp.3: Reference strstr(3)

[Mark Hills]

[-- Attachment #1: Type: TEXT/PLAIN, Size: 1536 bytes --]

On Mon, 1 Jun 2009, Michael Kerrisk wrote:

> Mark,
>
> Why do you think this patch is needed?

I deemed that strstr() was relevant as the 'other' string comparison 
function, but didn't go as far as to reference character-based functions 
like strchr(). Apologies that the commit message didn't explain this.

However, after sending the patch I was made aware of string(3). To make it 
easy to discover the string functions (as this patch intended to do) would 
it be more appropriate for all functions listed in string(3) to reference 
it?

> Cheers,
>
> Michael
>
> On Tue, Feb 29, 2028 at 9:35 AM, Mark Hills <mark-UrrBsZIrrsb10XsdtD+oqA@public.gmane.org> wrote:
>> ---
>>  man3/strcmp.3 |    3 ++-
>>  1 files changed, 2 insertions(+), 1 deletions(-)
>>
>> diff --git a/man3/strcmp.3 b/man3/strcmp.3
>> index 4797e71..62d9cc6 100644
>> --- a/man3/strcmp.3
>> +++ b/man3/strcmp.3
>> @@ -27,7 +27,7 @@
>>  .\" Modified Sat Jul 24 18:08:52 1993 by Rik Faith (faith-+5Oa3zvhR2o3uPMLIKxrzw@public.gmane.org)
>>  .\" Modified 2001-08-31, aeb
>>  .\"
>> -.TH STRCMP 3  2009-04-21 "" "Linux Programmer's Manual"
>> +.TH STRCMP 3  2009-05-09 "" "Linux Programmer's Manual"
>>  .SH NAME
>>  strcmp, strncmp \- compare two strings
>>  .SH SYNOPSIS
>> @@ -68,6 +68,7 @@ SVr4, 4.3BSD, C89, C99.
>>  .BR strcasecmp (3),
>>  .BR strcoll (3),
>>  .BR strncasecmp (3),
>> +.BR strstr (3),
>>  .BR strverscmp (3),
>>  .BR wcscmp (3),
>>  .BR wcsncmp (3)
>> --
>> 1.6.2.4
>>
>>
>
>
>
>

-- 
Mark

Re: [PATCH 2/3] strcmp.3: Reference strstr(3)

[Petr Baudis]

On Mon, Jun 01, 2009 at 02:15:31PM +0100, Mark Hills wrote:
> On Mon, 1 Jun 2009, Michael Kerrisk wrote:
>
>> Mark,
>>
>> Why do you think this patch is needed?
>
> I deemed that strstr() was relevant as the 'other' string comparison  
> function, but didn't go as far as to reference character-based functions  
> like strchr(). Apologies that the commit message didn't explain this.
>
> However, after sending the patch I was made aware of string(3). To make 
> it easy to discover the string functions (as this patch intended to do) 
> would it be more appropriate for all functions listed in string(3) to 
> reference it?

I'd agree, I've never known of string(3) either.

-- 
				Petr "Pasky" Baudis
The lyf so short, the craft so long to lerne. -- Chaucer
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 2/3] strcmp.3: Reference strstr(3)

[Michael Kerrisk]

Hi Mark,

On Mon, Jun 1, 2009 at 3:15 PM, Mark Hills <mark-UrrBsZIrrsb10XsdtD+oqA@public.gmane.org> wrote:
> On Mon, 1 Jun 2009, Michael Kerrisk wrote:
>
>> Mark,
>>
>> Why do you think this patch is needed?
>
> I deemed that strstr() was relevant as the 'other' string comparison
> function, but didn't go as far as to reference character-based functions
> like strchr(). Apologies that the commit message didn't explain this.
>
> However, after sending the patch I was made aware of string(3). To make it
> easy to discover the string functions (as this patch intended to do) would
> it be more appropriate for all functions listed in string(3) to reference
> it?

The latter action seems best to e, and that's what I've done for
man-pages-3.27. Thanks for the report!

Thanks,

Michael


>> On Tue, Feb 29, 2028 at 9:35 AM, Mark Hills <mark-UrrBsZIrrsb10XsdtD+oqA@public.gmane.org> wrote:
>>>
>>> ---
>>>  man3/strcmp.3 |    3 ++-
>>>  1 files changed, 2 insertions(+), 1 deletions(-)
>>>
>>> diff --git a/man3/strcmp.3 b/man3/strcmp.3
>>> index 4797e71..62d9cc6 100644
>>> --- a/man3/strcmp.3
>>> +++ b/man3/strcmp.3
>>> @@ -27,7 +27,7 @@
>>>  .\" Modified Sat Jul 24 18:08:52 1993 by Rik Faith (faith-wslx+O7Dwtg@public.gmane.org.edu)
>>>  .\" Modified 2001-08-31, aeb
>>>  .\"
>>> -.TH STRCMP 3  2009-04-21 "" "Linux Programmer's Manual"
>>> +.TH STRCMP 3  2009-05-09 "" "Linux Programmer's Manual"
>>>  .SH NAME
>>>  strcmp, strncmp \- compare two strings
>>>  .SH SYNOPSIS
>>> @@ -68,6 +68,7 @@ SVr4, 4.3BSD, C89, C99.
>>>  .BR strcasecmp (3),
>>>  .BR strcoll (3),
>>>  .BR strncasecmp (3),
>>> +.BR strstr (3),
>>>  .BR strverscmp (3),
>>>  .BR wcscmp (3),
>>>  .BR wcsncmp (3)
>>> --
>>> 1.6.2.4
>>>
>>>
>>
>>
>>
>>
>
> --
> Mark



-- 
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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 1/3] strcpy.3: Reference strdup(3)

[Michael Kerrisk]

Hi Mark,

The fact that a patch is simple doesn't mean it should have no explanation.

I've applied this one, but for the future, please do include an
explanation of why the patch is needed.

Cheers,

Michael

On Mon, May 25, 2009 at 11:43 PM, Mark Hills <mark-UrrBsZIrrsb10XsdtD+oqA@public.gmane.org> wrote:
> ---
>  man3/strcpy.3 |    3 ++-
>  1 files changed, 2 insertions(+), 1 deletions(-)
>
> diff --git a/man3/strcpy.3 b/man3/strcpy.3
> index 8fd2c1d..2b4d8ba 100644
> --- a/man3/strcpy.3
> +++ b/man3/strcpy.3
> @@ -30,7 +30,7 @@
>  .\" 2007-06-15, Marc Boyer <marc.boyer-oUYRw6/Rnm9Wj0EZb7rXcA@public.gmane.org> + mtk
>  .\"     Improve discussion of strncpy().
>  .\"
> -.TH STRCPY 3  2009-02-04 "GNU" "Linux Programmer's Manual"
> +.TH STRCPY 3  2009-05-09 "GNU" "Linux Programmer's Manual"
>  .SH NAME
>  strcpy, strncpy \- copy a string
>  .SH SYNOPSIS
> @@ -136,6 +136,7 @@ in ways that may make the impossible possible.
>  .BR memccpy (3),
>  .BR memcpy (3),
>  .BR memmove (3),
> +.BR strdup (3),
>  .BR strpcpy (3),
>  .BR wcscpy (3),
>  .BR wcsncpy (3)
> --
> 1.6.2.4
>
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 1/3] strcpy.3: Reference strdup(3)

[Mark Hills]

---
 man3/strcpy.3 |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)

diff --git a/man3/strcpy.3 b/man3/strcpy.3
index 8fd2c1d..2b4d8ba 100644
--- a/man3/strcpy.3
+++ b/man3/strcpy.3
@@ -30,7 +30,7 @@
 .\" 2007-06-15, Marc Boyer <marc.boyer-oUYRw6/Rnm9Wj0EZb7rXcA@public.gmane.org> + mtk
 .\"     Improve discussion of strncpy().
 .\"
-.TH STRCPY 3  2009-02-04 "GNU" "Linux Programmer's Manual"
+.TH STRCPY 3  2009-05-09 "GNU" "Linux Programmer's Manual"
 .SH NAME
 strcpy, strncpy \- copy a string
 .SH SYNOPSIS
@@ -136,6 +136,7 @@ in ways that may make the impossible possible.
 .BR memccpy (3),
 .BR memcpy (3),
 .BR memmove (3),
+.BR strdup (3),
 .BR strpcpy (3),
 .BR wcscpy (3),
 .BR wcsncpy (3)
-- 
1.6.2.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html