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).  Bug in grotty?
+.if n .pl 1000v
 .TH SUFFIXES 7  2000-11-16 "Linux" "Linux Programmer's Manual"
 .SH NAME
 suffixes \- list of file suffixes

[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 was not defined, probably means punctuation
+.ds Pu "[ .,:;()[]?! ]
 .Dd December 30, 1993
 .Os
 .Dt MDOC.SAMPLES 7
< at >< at > -535,10 +537,10 < at >< at >
 .\" PS1UNIX Programmer's Supplementary Documents
 .Pp
 .Bl -column SMM -offset indent -compact
-.It Li AMDUNIX Ancestral Manual Documents
-.It Li SMMUNIX System Manager's Manual
-.It Li URMUNIX Reference Manual
-.It Li PRMUNIX Programmer's Manual
+.It Li "AMDUNIX Ancestral Manual Documents"
+.It Li "SMMUNIX System Manager's Manual"
+.It Li "URMUNIX Reference Manual"
+.It Li "PRMUNIX Programmer's Manual"
 .El
 .Pp
 The default volume labeling is
< at >< at > -808,7 +810,7 < at >< at >
 of the form addr1[,addr2[,addr3]].
 .Pp
 .Dl Usage: .Ad address ... \*(Pu
-.Bl -tag -width ".Ad f1 , f2 , f3 :" -compact -offset 14n
+.Bl -tag -width "\&.Ad f1 , f2 , f3 :" -compact -offset 14n
 .It Li \&.Ad addr1
 .Ad addr1
 .It Li \&.Ad addr1\ .
< at >< at > -835,7 +837,7 < at >< at >
 to be punctuation.
 .Pp
 .Dl Usage: .An author_name \*(Pu
-.Bl -tag -width ".An Joe Author ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.An Joe Author ) ) ," -compact -offset 14n
 .It Li \&.An Joe\ Author
 .An Joe Author
 .It Li \&.An Joe\ Author\ ,
< at >< at > -860,7 +862,7 < at >< at >
 a command-line argument is referenced.
 .Pp
 .Dl Usage: .Ar argument ... \*(Pu
-.Bl -tag -width ".Ar file1 file2" -compact -offset 15n
+.Bl -tag -width "\&.Ar file1 file2" -compact -offset 15n
 .It Li \&.Ar
 .Ar
 .It Li \&.Ar file1
< at >< at > -878,7 +880,7 < at >< at >
 If
 .Ql \&.Ar
 is called without arguments
-.Ql Ar
+.Ql \&Ar
 is assumed.
 The
 .Ql \&.Ar
< at >< at > -916,7 +918,7 < at >< at >
 .Ql \&.Dv .
 .Pp
 .Dl Usage: .Dv defined_variable ... \*(Pu
-.Bl -tag -width ".Dv MAXHOSTNAMELEN" -compact -offset 14n
+.Bl -tag -width "\&.Dv MAXHOSTNAMELEN" -compact -offset 14n
 .It Li ".Dv MAXHOSTNAMELEN"
 .Dv MAXHOSTNAMELEN
 .It Li ".Dv TIOCGPGRP )"
< at >< at > -942,7 +944,7 < at >< at >
 a section two manual page.
 .Pp
 .Dl Usage: .Er ERRNOTYPE ... \*(Pu
-.Bl -tag -width ".Bq Er ENOTDIR" -compact -offset 14n
+.Bl -tag -width "\&.Bq Er ENOTDIR" -compact -offset 14n
 .It Li \&.Er ENOENT
 .Er ENOENT
 .It Li \&.Er ENOENT\ )\ ;
< at >< at > -963,7 +965,7 < at >< at >
 macro specifies an environment variable.
 .Pp
 .Dl Usage: .Ev argument ... \*(Pu
-.Bl -tag -width ".Ev PRINTER ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.Ev PRINTER ) ) ," -compact -offset 14n
 .It Li \&.Ev DISPLAY
 .Ev  DISPLAY
 .It Li \&.Ev PATH\ .
< at >< at > -999,7 +1001,7 < at >< at >
 may also be used to refer to structure members.
 .Pp
 .Dl Usage: .Fa function_argument ... \*(Pu
-.Bl -tag -width ".Fa d_namlen\ )\ )\ ," -compact -offset 14n
+.Bl -tag -width "\&.Fa d_namlen\ )\ )\ ," -compact -offset 14n
 .It Li \&.Fa d_namlen\ )\ )\ ,
 .Fa d_namlen ) ) ,
 .It Li \&.Fa iov_len
< at >< at > -1049,7 +1051,7 < at >< at >
 macro is identical, but without the dash.
 .Pp
 .Dl Usage: .Fl argument ... \*(Pu
-.Bl -tag -width ".Fl \-s \-t \-v" -compact -offset 14n
+.Bl -tag -width "\&.Fl \-s \-t \-v" -compact -offset 14n
 .It Li \&.Fl
 .Fl
 .It Li \&.Fl cfv
< at >< at > -1079,7 +1081,7 < at >< at >
 .Bd -literal
 Usage: .Fn [type] function [[type] parameters ... \*(Pu]
 .Ed
-.Bl -tag -width ".Fn _int align_ _const * char *sptrsxx" -compact
+.Bl -tag -width "\&.Fn _int align_ _const * char *sptrsxx" -compact
 .It Li "\&.Fn getchar"
 .Fn getchar
 .It Li "\&.Fn strlen ) ,"
< at >< at > -1190,7 +1192,7 < at >< at >
 macro designates an interactive or internal command.
 .Pp
 .Dl Usage: .Ic argument ... \*(Pu
-.Bl -tag -width ".Ic setenv , unsetenvxx" -compact -offset 14n
+.Bl -tag -width "\&.Ic setenv , unsetenvxx" -compact -offset 14n
 .It Li \&.Ic :wq
 .Ic :wq
 .It Li \&.Ic do while {...}
< at >< at > -1243,7 +1245,7 < at >< at >
 it can not recall the first argument it was invoked with.
 .Pp
 .Dl Usage: .Nm argument ... \*(Pu
-.Bl -tag -width ".Nm mdoc.sample" -compact -offset 14n
+.Bl -tag -width "\&.Nm mdoc.sample" -compact -offset 14n
 .It Li \&.Nm mdoc.sample
 .Nm mdoc.sample
 .It Li \&.Nm \e-mdoc
< at >< at > -1271,7 +1273,7 < at >< at >
 may be used across one or more lines.
 .Pp
 .Dl Usage: .Op options ... \*(Pu
-.Bl -tag -width ".Op Fl c Ar objfil Op Ar corfil ," -compact -offset indent
+.Bl -tag -width "\&.Op Fl c Ar objfil Op Ar corfil ," -compact -offset indent
 .It Li \&.Op
 .Op
 .It Li ".Op Fl k"
< at >< at > -1322,7 +1324,7 < at >< at >
 macro formats pathnames or filenames.
 .Pp
 .Dl Usage: .Pa pathname \*(Pu
-.Bl -tag -width ".Pa /tmp/fooXXXXX ) ." -compact -offset 14n
+.Bl -tag -width "\&.Pa /tmp/fooXXXXX ) ." -compact -offset 14n
 .It Li \&.Pa /usr/share
 .Pa /usr/share
 .It Li \&.Pa /tmp/fooXXXXX\ )\ .
< at >< at > -1336,7 +1338,7 < at >< at >
 Generic variable reference:
 .Pp
 .Dl Usage: .Va variable ... \*(Pu
-.Bl -tag -width ".Va char s ] ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.Va char s ] ) ) ," -compact -offset 14n
 .It Li \&.Va count
 .Va count
 .It Li \&.Va settimer ,
< at >< at > -1363,7 +1365,7 < at >< at >
 remaining arguments are assumed to be punctuation.
 .Pp
 .Dl Usage: .Xr man_page [1,...,8] \*(Pu
-.Bl -tag -width ".Xr mdoc 7 ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.Xr mdoc 7 ) ) ," -compact -offset 14n
 .It Li \&.Xr mdoc
 .Xr mdoc
 .It Li \&.Xr mdoc\ ,
< at >< at > -1386,7 +1388,7 < at >< at >
 .Bd -literal -offset indent -compact
 Usage: .At [v6 | v7 | 32v | V.1 | V.4] ... \*(Pu
 .Ed
-.Bl -tag -width ".At v6 ) ," -compact -offset 14n
+.Bl -tag -width "\&.At v6 ) ," -compact -offset 14n
 .It Li ".At"
 .At
 .It Li ".At v6 ."
< at >< at > -1403,7 +1405,7 < at >< at >
 It accepts at most two arguments.
 .Ss BSD Macro
 .Dl Usage: .Bx [Version/release] ... \*(Pu
-.Bl -tag -width ".Bx 4.3 ) ," -compact -offset 14n
+.Bl -tag -width "\&.Bx 4.3 ) ," -compact -offset 14n
 .It Li ".Bx"
 .Bx
 .It Li ".Bx 4.3 ."
< at >< at > -1417,7 +1419,7 < at >< at >
 .Bd -literal -offset indent -compact
 Usage: .Fx Version.release ... \*(Pu
 .Ed
-.Bl -tag -width ".Fx 2.2 ) ," -compact -offset 14n
+.Bl -tag -width "\&.Fx 2.2 ) ," -compact -offset 14n
 .It Li ".Fx 2.2 ."
 .Fx 2.2 .
 .El
< at >< at > -1432,7 +1434,7 < at >< at >
 It accepts at most two arguments.
 .Ss UNIX Macro
 .Dl Usage: .Ux ... \*(Pu
-.Bl -tag -width ".Ux 4.3 ) ," -compact -offset 14n
+.Bl -tag -width "\&.Ux 4.3 ) ," -compact -offset 14n
 .It Li ".Ux"
 .Ux
 .El
< at >< at > -1518,7 +1520,7 < at >< at >
 .Pp
 .ne 4
 Examples of quoting:
-.Bl -tag -width ".Aq Pa ctype.h ) ,xxxxxxxx" -compact -offset indent
+.Bl -tag -width "\&.Aq Pa ctype.h ) ,xxxxxxxx" -compact -offset indent
 .It Li \&.Aq
 .Aq
 .It Li \&.Aq \&Ar ctype.h\ )\ ,
< at >< at > -1576,7 +1578,7 < at >< at >
 macro eliminates unwanted spaces in between macro requests.
 It is useful for old style argument lists where there is no space
 between the flag and argument:
-.Bl -tag -width ".Op Fl I Ns Ar directoryxx" -offset indent
+.Bl -tag -width "\&.Op Fl I Ns Ar directoryxx" -offset indent
 .It Li ".Op Fl I Ns Ar directory"
 produces
 .Op Fl I Ns Ar directory
< at >< at > -1661,11 +1663,13 < at >< at >
 .Ql \&.Rv -std atexit
 will generate the following text:
 .Pp
-.\" fake chapter 3 to avoid error message from Rv
-.ds cH 3
+.\" fake section 3 to avoid error message from Rv
+.\".ds cH 3
+.ds section 3
 .Rv -std atexit
 .\" and back to 7 again
-.ds cH 7
+.\".ds cH 7
+.ds section 7
 .Pp
 The
 .Fl std
< at >< at > -1675,7 +1679,7 < at >< at >
 all upper case words longer than two characters.
 .Pp
 .Dl Usage: .Tn symbol ... \*(Pu
-.Bl -tag -width ".Tn ASCII" -compact -offset 14n
+.Bl -tag -width "\&.Tn ASCII" -compact -offset 14n
 .It Li \&.Tn DEC
 .Tn DEC
 .It Li \&.Tn ASCII
< at >< at > -1815,7 +1819,7 < at >< at >
 .Ql \&.Sh
 macro can take up to nine arguments.
 It is parsed and but is not callable.
-.Bl -tag -width ".Sh SYNOPSIS"
+.Bl -tag -width "\&.Sh SYNOPSIS"
 .It \&.Sh NAME
 The
 .Ql \&.Sh NAME
< at >< at > -1868,6 +1872,7 < at >< at >
 configuration device usage macro.
 Several other macros may be necessary to produce
 the synopsis line as shown below:
+.El
 .Pp
 .Bd -filled -offset indent
 .Nm cat
< at >< at > -1902,6 +1907,7 < at >< at >
 .Sx PREDEFINED STRINGS
 for a usable \*(Ba
 character in other situations.
+.Bl -tag
 .It \&.Sh DESCRIPTION
 In most cases the first text in the
 .Sx DESCRIPTION
< at >< at > -2233,6 +2239,7 < at >< at >
 The display-type must be one of the following four types and
 may have an offset specifier for indentation:
 .Ql \&.Bd .
+.El
 .Pp
 .Bl -tag -width "file file_name  " -compact
 .It Fl ragged
< at >< at > -2291,7 +2298,6 < at >< at >
 work and perhaps may never do the right thing by
 .Xr troff .
 .El
-.El
 .It ".Ed"
 End-display.
 .El
< at >< at > -2305,7 +2311,7 < at >< at >
 The usual font for emphasis is italic.
 .Pp
 .Dl Usage: .Em argument ... \*(Pu
-.Bl -tag -width ".Em vide infra ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.Em vide infra ) ) ," -compact -offset 14n
 .It Li ".Em does not"
 .Em does not
 .It Li ".Em exceed 1024 ."
< at >< at > -2328,7 +2334,7 < at >< at >
 would be typed.
 .Pp
 .Dl Usage: .Li argument ... \*(Pu
-.Bl -tag -width ".Li cntrl-D ) ,"  -compact -offset 14n
+.Bl -tag -width "\&.Li cntrl-D ) ,"  -compact -offset 14n
 .It Li \&.Li \een
 .Li \en
 .It Li \&.Li M1 M2 M3\ ;
< at >< at > -2347,10 +2353,9 < at >< at >
 either the symbolic sense or the traditional English usage.
 .Pp
 .Dl Usage: .Sy symbol ... \*(Pu
-.Bl -tag -width ".Sy Important Noticex" -compact -offset 14n
+.Bl -tag -width "\&.Sy Important Noticex" -compact -offset 14n
 .It Li \&.Sy Important Notice
 .Sy Important Notice
-.El
 .Pp
 The
 .Ql \&.Sy
< at >< at > -2358,6 +2363,7 < at >< at >
 Arguments to
 .Ql \&.Sy
 may be quoted.
+.El
 .It Li \&.Bf
 Begin font mode.
 The
< at >< at > -2444,6 +2450,7 < at >< at >
 \&Lastly item three goes here.
 \&.El
 .Ed
+.El
 .Pp
 The results:
 .Pp
< at >< at > -2474,6 +2481,7 < at >< at >
 Bullet two here.
 .El
 .Pp
+.Bl -ohang -compact
 .It Fl tag
 .It Fl diag
 .It Fl hang
< at >< at > -2491,13 +2499,14 < at >< at >
 .Em tagged .
 This
 list was constructed with the
-.Ql Fl ohang
+.Ql \&Fl ohang
 list-type.
 The
 .Ql \&.It
 macro is parsed only for the inset, hang
 and tag list-types and is not callable.
 Here is an example of inset labels:
+.El
 .Bl -inset -offset indent
 .It Em Tag
 The tagged list (also called a tagged paragraph) is the
< at >< at > -2621,7 +2630,6 < at >< at >
 again, the width is set to the constant width of the string
 given.
 .El
-.El
 .Pp
 If a width is not specified for the tag list type, the first
 time

[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 "listen" on all interfaces (through the use of
INADDR_ANY as value of sockaddr_in.sin_addr.s_addr), it is possible to call
connect(2) on said socket. This behaviour is correctly explained by the
connect(2) Linux man page [2]:


However, upon doing so, the socket is no longer "bound" to any interface (as
could be assumed through the usage of INADDR_ANY), but one in particular (and
it is apparently not possible to know which one, before calling connect(2)).
This seems to contradict the information provided by the ip(7) man page [3]:


I have attached a test-case which demonstrates this apparently conflicting
behaviour.

I would suggest adding a paragraph or comment that would explain this subtlety,
as it can cause difficult to diagnose issues when using connected UDP sockets.

[1]: http://www.unix.com/man-page/posix/3posix/connect/
[2]: http://linux.die.net/man/2/connect
[3]: http://linux.die.net/man/7/ip

[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 as network login services
  .RB ( ssh "(1), " rlogin "(1), " telnet (1)),
  terminal emulators,
  .BR script (1),

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 "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."

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 l2 c2 lp-1.
 OctDecHexCharDescription
 _
 240160A0 NO-BREAK SPACE
< at >< at > -87,7 +87,7 < at >< at >
 252170AAªFEMININE ORDINAL INDICATOR
 253171AB«LEFT-POINTING DOUBLE ANGLE QUOTATION MARK
 254172AC¬NOT SIGN
-255173AD-SOFT HYPHEN
+255173ADSOFT HYPHEN (shown as a hyphen at line breaks)¹
 256174AE®REGISTERED SIGN
 257175AF¯MACRON
 260176B0°DEGREE SIGN
< at >< at > -171,6 +171,11 < at >< at >
 376254FEþLATIN SMALL LETTER THORN
 377255FFÿLATIN SMALL LETTER Y WITH DIAERESIS
 .TE
+  ¹ A graphic character that is imaged by a graphic symbol
+identical with, or similar to, that representing HYPHEN, for use
+when a line break has been established wihin a word.
+.BR "ISO 8859-1:1987" ,
+paragraph 6.3.3.
 .SH "SEE ALSO"
 .BR ascii (7),
 .BR iso_8859-15 (7)

[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, the socket is automatically bound
+to a random free port with the local address set to
+.BR INADDR_ANY .
+When
 .BR connect (2)
-are called on an unbound socket, it is automatically bound to a
-random free port with the local address set to
+is called on an unbound socket, the socket is automatically bound
+to a random free port or an usable shared port with the local address
+set to
 .BR INADDR_ANY .
 
 A TCP local socket address that has been bound is unavailable for

[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.