gmane.linux.man

[PATCH] memchr, strstr: Reference memmem (3) in SEE ALSO section

Alexandre Bique — 2012-05-21T15:41:23

Hi,

This patch references the memmem (3) function in memchr and strstr SEE
ALSO section.

Thanks,

[patch] ld.so.8: typo in LD_USE_LOAD_BIAS description

Jessica McKellar — 2012-05-18T22:23:44

Hi,

There is a small typo in the ld.so man page on master (which I found
on http://www.kernel.org/doc/man-pages/online/pages/man8/ld.so.8.html).

The diff is attached as well as copied below.

(Michael, sorry for the resend; the original e-mail was bounced as
spam for containing HTML. If that's by design, it might help to say
you must send as plaintext only on
http://www.kernel.org/doc/man-pages/patches.html)

Best regards,
-Jessica

--
Jessica McKellar
http://jesstess.com


diff --git a/man8/ld.so.8 b/man8/ld.so.8
index 70b6faf..8e059de 100644
--- a/man8/ld.so.8
+++ b/man8/ld.so.8
< at >< at > -350,7 +350,7 < at >< at > and (nonprelinked) position-independent executables (PIEs)
 and other shared objects will not honor them.
 If
 .B LD_USE_LOAD_BIAS
-is defined wit the value, both executables and PIEs
+is defined with the value 1, both executables and PIEs
 will honor the base addresses.
 If
 .B LD_USE_LOAD_BIAS

[patch], suffixes(7): Warnings from "grotty"

Bjarni Ingi Gislason — 2012-05-18T17:47:22

Package: manpages
Version: 3.40
Severity: minor
Tags: patch

  From "man ..." ("nroff ..."):

grotty:<standard input> (<standard input>):1763: character above first line discarded
grotty:<standard input> (<standard input>):2688: character above first line discarded
grotty:<standard input> (<standard input>):3286: character above first line discarded

  "man" ("nroff") needs a long page to avoid (imaginary) page
breaks for the long tables.

  The culprit is "Dl 0 -xxxx" (vertical line) where "xxxx" is
one line (40 nroff units) too long.  Or there is a bug in
"grotty".  "nroff" or "tbl" makes an empty line where a page
break is.

  Patch:

--- suffixes.72012-04-26 22:58:40.000000000 +0000
+++ suffixes.7.new2012-05-18 01:22:54.000000000 +0000
< at >< at > -35,6 +35,9 < at >< at >
 .\" FIXME, mtk, May 2007: rendering this page yields the error:
 .\" grotty:suffixes.7:1725: character above first line discarded
 .\"
+.\" "nroff" ("man") (or "tbl") needs a long page to avoid warnings
+.\" from "grotty" (at imagined page breaks).  Bu

[Bug 43252] bdflush(2) is obsolete

2012-05-16T06:37:56

https://bugzilla.kernel.org/show_bug.cgi?id=43252


Kazuo Moriwaka <kmoriwak-H+wXaHxf7aLQT0dZR+AlfA< at >public.gmane.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Severity|normal                      |enhancement

[Bug 43252] New: bdflush(2) is obsolete

2012-05-16T06:37:23

https://bugzilla.kernel.org/show_bug.cgi?id=43252

           Summary: bdflush(2) is obsolete
           Product: Documentation
           Version: unspecified
          Platform: All
        OS/Version: Linux
              Tree: Mainline
            Status: NEW
          Severity: normal
          Priority: P1
         Component: man-pages
        AssignedTo: documentation_man-pages-ztI5WcYan/vQLgFONoPN62D2FQJk+8+b< at >public.gmane.org
        ReportedBy: kmoriwak-H+wXaHxf7aLQT0dZR+AlfA< at >public.gmane.org
        Regression: No


In recent kernel, bdflush(2) syscall is deprecated and not effective to
anything.

Adding some statement about this situation to DESCRIPTION or NOTES section will
be helpful for readers.

I think affected pages are: bdflush(2) and syscalls(2)

Best Regards,

[PATCH] aio_cancel.3, aio_suspend.3: ffix

David Prévot — 2012-05-16T03:10:44

---
 man3/aio_cancel.3  |    2 +-
 man3/aio_suspend.3 |    2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/man3/aio_cancel.3 b/man3/aio_cancel.3
index 8b80275..c800075 100644
--- a/man3/aio_cancel.3
+++ b/man3/aio_cancel.3
< at >< at > -104,7 +104,7 < at >< at > The cause of the error can be found by inspecting
 is not a valid file descriptor.
 .TP
 .B ENOSYS
-.BR aio_cancel()
+.BR aio_cancel ()
 is not implemented.
 .SH VERSIONS
 The
diff --git a/man3/aio_suspend.3 b/man3/aio_suspend.3
index 1215ff7..05d045d 100644
--- a/man3/aio_suspend.3
+++ b/man3/aio_suspend.3
< at >< at > -97,7 +97,7 < at >< at > waiting for); see
 .BR signal (7).
 .TP
 .B ENOSYS
-.BR aio_suspend()
+.BR aio_suspend ()
 is not implemented.
 .SH VERSIONS
 The

[PATCH 2/2] open.2: ffix

David Prévot — 2012-05-16T02:07:00

Hi Michael,

Another similar one I only noticed on review.

---
 man2/open.2 |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man2/open.2 b/man2/open.2
index 5ea16f6..ad318b1 100644
--- a/man2/open.2
+++ b/man2/open.2
< at >< at > -776,7 +776,7 < at >< at > I/Os should never be run concurrently with the
 system call,
 if the memory buffer is a private mapping
 (i.e., any mapping created with the
-.BR mmap(2)
+.BR mmap (2)
 .BR MAP_PRIVATE
 flag;
 this includes memory allocated on the heap and statically allocated buffers).

[PATCH] open.2: ffix

David Prévot — 2012-05-16T00:10:27

---
 man2/open.2 |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man2/open.2 b/man2/open.2
index 7fe6602..5ea16f6 100644
--- a/man2/open.2
+++ b/man2/open.2
< at >< at > -799,7 +799,7 < at >< at > flag.
 Nor does this restriction apply when the memory buffer has been advised as
 .B MADV_DONTFORK
 with
-.BR madvise(2),
+.BR madvise (2),
 ensuring that it will not be available
 to the child after
 .BR fork (2).

[patch], mdoc.samples(7): Warnings from [ng]roff, corrections

Bjarni Ingi Gislason — 2012-05-15T19:22:23

Package: man-pages
Version: 3.40
Severity: minor
Tags: patch

  From "man -ww ..." (groff -ww ...):

<standard input>:541: warning: tab character in unquoted macro argument
<standard input>:542: warning: tab character in unquoted macro argument
<standard input>:543: warning: tab character in unquoted macro argument
<standard input>:544: warning: tab character in unquoted macro argument
<standard input>:813: warning: macro `Pu' not defined
Usage: .Rv -std in sections 2 and 3 only (#1669)
mdoc warning: A .Bl directive has no matching .El (#1821)

  String "Pu" defined as a row of punctuations

  ".Bl" and ".El" fixed

  Some arguments, that start with a period or are the name of a
macro, protected with "\&".

  Variable name for macro ".Rv" corrected.

--- mdoc.samples.72012-04-26 22:58:40.000000000 +0000
+++ mdoc.samples.7.new2012-05-15 01:09:17.000000000 +0000
< at >< at > -36,6 +36,8 < at >< at >
 .\" times and is guaranteed to give a worst case performance
 .\" for an already extremely slow package.
 .\"
+.\" String \*(Pu w

[Bug 43249] New: connect(2) changes INADDR_ANY meaning for UDP sockets

2012-05-14T22:28:33

https://bugzilla.kernel.org/show_bug.cgi?id=43249

           Summary: connect(2) changes INADDR_ANY meaning for UDP sockets
           Product: Documentation
           Version: unspecified
    Kernel Version: 3.0.0
          Platform: All
        OS/Version: Linux
              Tree: Mainline
            Status: NEW
          Severity: normal
          Priority: P1
         Component: man-pages
        AssignedTo: documentation_man-pages-ztI5WcYan/vQLgFONoPN62D2FQJk+8+b< at >public.gmane.org
        ReportedBy: sebastian.lauwers-Re5JQEeQqe8AvxtiuMwx3w< at >public.gmane.org
        Regression: No


Created an attachment (id=73297)
 --> (https://bugzilla.kernel.org/attachment.cgi?id=73297)
Testcase which demonstrates the bug scenario

The POSIX man page for connect(2) [1] specifies that:


The Linux man page for connect(2) does not provide this information, and this
may be confusing, regarding the following behaviour:

After creating a socket of type SOCK_DGRAM through socket(2), and calling
bind(2) on it to have it "

[PATCH] Psuedo->Pseudo

Jim Hill — 2012-05-14T20:21:59

---
  man4/pts.4 | 2 +-
  man7/pty.7 | 2 +-
  2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/man4/pts.4 b/man4/pts.4
index 7164e10..ff81c63 100644
--- a/man4/pts.4
+++ b/man4/pts.4
< at >< at > -44,7 +44,7 < at >< at > programs such as
  in which data read from the pseudoterminal master is sent across the 
network
  to a client program that is connected to a terminal or terminal emulator.
  .PP
-Psuedoterminals can also be used to send input to programs that normally
+Pseudoterminals can also be used to send input to programs that normally
  refuse to read input from pipes (such as
  .BR su (1),
  and
diff --git a/man7/pty.7 b/man7/pty.7
index c6d8c35..2860b30 100644
--- a/man7/pty.7
+++ b/man7/pty.7
< at >< at > -48,7 +48,7 < at >< at > that is connected to the slave.
  Conversely, anything that is written to the slave end of the
  pseudoterminal can be read by the process that is connected to
  the master end.
-Psuedoterminals are used by applications such as network login services
+Pseudoterminals are used by applications such

Re: [patch], mdoc(7): Fixing a warning and a table

Bjarni Ingi Gislason — 2012-05-14T19:08:30

  My earlier patch for the ".Bl -column" line is wrong

--- mdoc.72012-04-26 22:58:40.000000000 +0000
+++ mdoc.7.new2012-05-14 01:28:45.000000000 +0000
< at >< at > -201,7 +201,7 < at >< at >
 Options:
 .Bl -tag -width flag -compact
 .It Ar List-types
-.Bl -column xbullet -compact
+.Bl -column ".Fl bullet" -compact
 .It Fl bullet Ta "Bullet Item List"
 .It Fl item Ta "Unlabeled List"
 .It Fl enum Ta "Enumerated List"
< at >< at > -291,7 +291,7 < at >< at >
 .ne 1i
 .Ss Manual Domain Macros
 .Bl -column "Name" "Parsed" Callable" -compact
-.It Em NameParsedCallableDescription
+.It Em "NameParsedCallableDescription"
 .It Li \&Ad Ta Yes Ta Yes Ta "Address. (This macro may be deprecated.)"
 .It Li \&An Ta Yes Ta Yes Ta "Author name."
 .It Li \&Ar Ta Yes Ta Yes Ta "Command-line argument."

haalloo,

abi — 2012-05-12T17:06:25

haalloo,
how are you doing,i hope you are fine,my name is miss abi okom i got your
contact and want us to be a good friend,
please try and write back to me so that i will give you my pictures and tell
you more about me,
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA< at >public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[patch], mdoc(7): Fixing a warning and a table

Bjarni Ingi Gislason — 2012-05-11T19:54:30

Package: man-pages
Version: 3.40
Severity: minor
Tags: patch

  From "groff -ww ..." (or "man --warnings=w ..."):

<groff: mdoc.7>:294: warning: tab character in unquoted macro argument

  In one table the distance between columns is too small in the
"ps" output.  (Bug in the groff "doc.tmac" macro?)

  Patch:

--- mdoc.72012-04-26 22:58:40.000000000 +0000
+++ mdoc.7.new2012-05-11 13:57:40.000000000 +0000
< at >< at > -201,7 +201,10 < at >< at >
 Options:
 .Bl -tag -width flag -compact
 .It Ar List-types
-.Bl -column xbullet -compact
+.\" The width "xbullet" is too small in the "ps" output.
+.\" Spaces to increase the width result in too little space in
+.\" the "ps" output (bug in the groff <= 1.21 "doc.tmac" macro?)
+.Bl -column xbulletM -compact
 .It Fl bullet Ta "Bullet Item List"
 .It Fl item Ta "Unlabeled List"
 .It Fl enum Ta "Enumerated List"
< at >< at > -291,7 +294,7 < at >< at >
 .ne 1i
 .Ss Manual Domain Macros
 .Bl -column "Name" "Parsed" Callable" -compact
-.It Em NameParsedCallableDescription
+.It Em "NameParsedCallableDescr

man pages for fanotify_init(2) and fanotify_mark(2)

James Hunt — 2012-05-10T23:30:29

Please could the man pages for fanotify_init(2) and fanotify_mark(2) be added as they are currently
entirely undocumented aside from a couple of lwn articles.

The man pages are attached to the mails here:

http://permalink.gmane.org/gmane.linux.man/2400

Thanks in advance.

Kind regards,

James.
--
James Hunt
____________________________________
http://upstart.ubuntu.com/cookbook
http://upstart.ubuntu.com/cookbook/upstart_cookbook.pdf
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA< at >public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[patch], iso_8859-*.7: Explanation of SOFT HYPHEN and the code for it

Bjarni Ingi Gislason — 2012-05-10T19:42:31

Package: man-pages
Version: 3.40
Severity: minor
Tags: patch

  From "groff -ww ...":

<groff: iso_8859-2.7>:89: warning: can't find special character `shc'

  This is the only "iso_8859-*.7" file that has this (now)
undefined character.  The code in column four in "iso_8859-1.7" is
"0x2D" ("HYPHEN, MINUS SIGN" or "HYPHEN-MINUS") instead of "0xAD". 
See Debian bug 156154 (or package "manpages").

  There should be an explanation for this graphic character and the
code should be 0xAD in iso_8859-1.7 (as in all others), even though
"[gn]roff" does not display a "HYPHEN" in that position of the table.

  The line with "SOFT HYPHEN" gets a footnote and a short
explanation.  The footnote is from the official ISO standard.

  Suggested patch for one of the files:

--- iso_8859-1.72012-04-26 22:58:39.000000000 +0000
+++ iso_8859-1.7.new2012-05-10 16:01:39.000000000 +0000
< at >< at > -71,7 +71,7 < at >< at >
 The fourth column will only show the proper glyphs
 in an environment configured for ISO 8859-1.
 .TS
-l l l c lp-1.
+l2 l2 l

Re: [PATCH] resolv.conf.5: tfix

Michael Kerrisk (man-pages — 2012-05-10T18:28:10

Applied. Thanks David!

On Fri, May 11, 2012 at 5:29 AM, David Prévot <taffit-8fiUuRrzOP0dnm+yROfE0A< at >public.gmane.org> wrote:

Re: [PATCH] proc.5: ffix

Michael Kerrisk (man-pages — 2012-05-10T18:25:37

Applied. Thanks David!

Cheers,

Michael


On Fri, May 11, 2012 at 3:57 AM, David Prévot <taffit-8fiUuRrzOP0dnm+yROfE0A< at >public.gmane.org> wrote:

[PATCH] resolv.conf.5: tfix

David Prévot — 2012-05-10T17:29:44

---
 man5/resolv.conf.5 |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man5/resolv.conf.5 b/man5/resolv.conf.5
index 589c315..e82ea72 100644
--- a/man5/resolv.conf.5
+++ b/man5/resolv.conf.5
< at >< at > -35,7 +35,7 < at >< at > The file is designed to be human readable and contains a list of
 keywords with values that provide various types of resolver information.
 .LP
 If this file does not exist,
-only the name server be on the local machine will be queried;
+only the name server on the local machine will be queried;
 the domain name is determined from the hostname
 and the domain search path is constructed from the domain name.
 .LP

[PATCH] proc.5: ffix

David Prévot — 2012-05-10T15:57:28

---
 man5/proc.5 |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man5/proc.5 b/man5/proc.5
index ace0941..2ba1daa 100644
--- a/man5/proc.5
+++ b/man5/proc.5
< at >< at > -95,7 +95,7 < at >< at > The format is one \fIunsigned long\fP ID
 plus one \fIunsigned long\fP value for each entry.
 The last entry contains two zeros.
 .TP
-.I /proc/[pid]/cgroup " (since Linux 2.6.24)"
+.IR /proc/[pid]/cgroup " (since Linux 2.6.24)"
 .\"   Info in Documentation/cgroups/cgroups.txt
 This file describes control groups to which the process/task belongs.
 For each cgroup hierarchy there is one entry containing

Re: [PATCH] poll.2: tfix

Michael Kerrisk (man-pages — 2012-05-10T06:08:07

Thanks David. Applied.

On Thu, May 10, 2012 at 5:59 PM, David Prévot <taffit-8fiUuRrzOP0dnm+yROfE0A< at >public.gmane.org> wrote: