gmane.linux.man

[Bug 43287] New: scanf documentation example

2012-05-23T23:48:43

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

           Summary: scanf documentation example
           Product: Documentation
           Version: unspecified
    Kernel Version: n/a
          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: berkgokden-Re5JQEeQqe8AvxtiuMwx3w< at >public.gmane.org
        Regression: No


In scanf man file ( http://man7.org/linux/man-pages/man3/scanf.3.html ), in
notes section an example given.
Example only works if it is compiled with -std=c89 option. It is not well
defined. Probably because it was written long ago.

[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], 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] 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] 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

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

[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

[PATCH] poll.2: tfix

David Prévot — 2012-05-10T05:59:53

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

diff --git a/man2/poll.2 b/man2/poll.2
index ee53353..87905e8 100644
--- a/man2/poll.2
+++ b/man2/poll.2
< at >< at > -135,7 +135,7 < at >< at > Specifying a
 .I timeout
 of zero causes
 .BR poll ()
-to return immediately, even if no file desciptors are ready.
+to return immediately, even if no file descriptors are ready.
 
 The bits that may be set/returned in
 .I events

[patch], cp1251(7): table too wide

Bjarni Ingi Gislason — 2012-05-09T19:46:51

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

  From "nroff -ww -t ...":

warning: around line 44: table wider than line width

  Columns are made narrower (column gutter decreased).

  Patch:

--- cp1251.72012-04-26 22:58:39.000000000 +0000
+++ cp1251.7.new2012-05-09 02:05:59.000000000 +0000
< at >< at > -37,7 +37,7 < at >< at >
 The fourth column will only show the proper glyphs
 in an environment configured for CP\ 1251.
 .TS
-l l l c lp-1.
+l2 l2 l2 c2 lp-1.
 OctDecHexCharDescription
 _
 20012880CYRILLIC CAPITAL LETTER DJE

[patch], ascii(7): Indent for "troff" makes table to wide

Bjarni Ingi Gislason — 2012-05-09T19:42:14

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

  From "groff -t -ww ...":

warning: around line 53: table wider than line width

  Extra indent for "troff" makes the table look misplaced
(default "ps" output).

  Patch:

--- ascii.72012-04-26 22:58:39.000000000 +0000
+++ ascii.7.new2012-05-09 00:46:03.000000000 +0000
< at >< at > -45,7 +45,6 < at >< at >
 .LP
 C program \f(CW\(aq\eX\(aq\fP escapes are noted.
 .if t \{\
-.in 1i
 .ft CW
 \}
 .TS

[PATCH] ip.7: Improve explanation about calling listen or connect

Flavio Leitner — 2012-05-09T12:30:36

Signed-off-by: Flavio Leitner <fbl-H+wXaHxf7aLQT0dZR+AlfA< at >public.gmane.org>
---
 man7/ip.7 |   15 +++++++++------
 1 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/man7/ip.7 b/man7/ip.7
index 9f560df..84fe32d 100644
--- a/man7/ip.7
+++ b/man7/ip.7
< at >< at > -69,12 +69,11 < at >< at > For
 you may specify a valid IANA IP protocol defined in
 RFC\ 1700 assigned numbers.
 .PP
-.\" FIXME ip current does an autobind in listen, but I'm not sure
-.\" if that should be documented.
 When a process wants to receive new incoming packets or connections, it
 should bind a socket to a local interface address using
 .BR bind (2).
-Only one IP socket may be bound to any given local (address, port) pair.
+In this case, only one IP socket may be bound to any given local
+(address, port) pair.
 When
 .B INADDR_ANY
 is specified in the bind call, the socket will be bound to
< at >< at > -82,10 +81,14 < at >< at > is specified in the bind call, the socket will be bound to
 local interfaces.
 When
 .BR listen (2)
-or
+is called on an unbound socket, th

[PATCH] get_robust_list.2: tfix

David Prévot — 2012-05-09T02:49:13

Only one set_robust_list() error is currently documented.
---
 man2/get_robust_list.2 |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man2/get_robust_list.2 b/man2/get_robust_list.2
index e6e753e..7dc0198 100644
--- a/man2/get_robust_list.2
+++ b/man2/get_robust_list.2
< at >< at > -79,7 +79,7 < at >< at > an error code otherwise.
 .SH ERRORS
 The
 .BR set_robust_list ()
-system call can fail with the following errors:
+system call can fail with the following error:
 .TP
 .B EINVAL 
 .I len

[PATCH] getcpu(2): document return/error values

Mike Frysinger — 2012-05-08T22:36:07

Signed-off-by: Mike Frysinger <vapier-aBrp7R+bbdUdnm+yROfE0A< at >public.gmane.org>
---
 man2/getcpu.2 |    9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/man2/getcpu.2 b/man2/getcpu.2
index 03e724a..a9d0793 100644
--- a/man2/getcpu.2
+++ b/man2/getcpu.2
< at >< at > -48,6 +48,15 < at >< at > The caller must be prepared to handle the situation when
 and
 .I node
 are no longer the current CPU and node.
+.SH "RETURN VALUE"
+On success, 0 is returned.
+On error, \-1 is returned, and
+.I errno
+is set appropriately.
+.SH ERRORS
+.TP
+.B EFAULT
+Arguments point outside the calling process's address space.
 .SH VERSIONS
 .BR getcpu ()
 was added in kernel 2.6.19 for x86_64 and i386.