r3302 - in glibc-doc-reference/trunk: debian manual
Author: aurel32
Date: 2009-02-23 02:09:05 +0000 (Mon, 23 Feb 2009)
New Revision: 3302
Modified:
glibc-doc-reference/trunk/debian/changelog
glibc-doc-reference/trunk/debian/control
glibc-doc-reference/trunk/debian/copyright
glibc-doc-reference/trunk/debian/glibc-doc-reference.doc-base
glibc-doc-reference/trunk/debian/rules
glibc-doc-reference/trunk/manual/arith.texi
glibc-doc-reference/trunk/manual/creature.texi
glibc-doc-reference/trunk/manual/errno.texi
glibc-doc-reference/trunk/manual/filesys.texi
glibc-doc-reference/trunk/manual/libc.texinfo
glibc-doc-reference/trunk/manual/math.texi
glibc-doc-reference/trunk/manual/memory.texi
glibc-doc-reference/trunk/manual/process.texi
glibc-doc-reference/trunk/manual/resource.texi
glibc-doc-reference/trunk/manual/socket.texi
glibc-doc-reference/trunk/manual/startup.texi
glibc-doc-reference/trunk/manual/stdio.texi
glibc-doc-reference/trunk/manual/sysinfo.texi
glibc-doc-reference/trunk/manual/syslog.texi
glibc-doc-reference/trunk/manual/terminal.texi
glibc-doc-reference/trunk/manual/time.texi
Log:
glibc-doc-reference (2.9-1) unstable; urgency=low
* New upstream version.
* Update debian/copyright.
* Fix error reported by lintian in glibc-doc-reference.doc-base.
* Bump Standards-Version to 3.8.0.
-- Aurelien Jarno <aurel32@debian.org> Mon, 23 Feb 2009 02:55:42 +0100
Modified: glibc-doc-reference/trunk/debian/changelog
===================================================================
--- glibc-doc-reference/trunk/debian/changelog 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/debian/changelog 2009-02-23 02:09:05 UTC (rev 3302)
@@ -1,3 +1,12 @@
+glibc-doc-reference (2.9-1) unstable; urgency=low
+
+ * New upstream version.
+ * Update debian/copyright.
+ * Fix error reported by lintian in glibc-doc-reference.doc-base.
+ * Bump Standards-Version to 3.8.0.
+
+ -- Aurelien Jarno <aurel32@debian.org> Mon, 23 Feb 2009 02:55:42 +0100
+
glibc-doc-reference (2.7-1) unstable; urgency=low
* New upstream version.
Modified: glibc-doc-reference/trunk/debian/control
===================================================================
--- glibc-doc-reference/trunk/debian/control 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/debian/control 2009-02-23 02:09:05 UTC (rev 3302)
@@ -5,7 +5,7 @@
Build-Depends-Indep: texinfo, texi2html, gawk, texlive-base-bin
Maintainer: GNU Libc Maintainers <debian-glibc@lists.debian.org>
Uploaders: Ben Collins <bcollins@debian.org>, GOTO Masanori <gotom@debian.org>, Philip Blundell <pb@nexus.co.uk>, Jeff Bailey <jbailey@raspberryginger.com>, Daniel Jacobowitz <dan@debian.org>, Clint Adams <schizo@debian.org>, Aurelien Jarno <aurel32@debian.org>
-Standards-Version: 3.7.2
+Standards-Version: 3.8.0
Package: glibc-doc-reference
Architecture: all
Modified: glibc-doc-reference/trunk/debian/copyright
===================================================================
--- glibc-doc-reference/trunk/debian/copyright 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/debian/copyright 2009-02-23 02:09:05 UTC (rev 3302)
@@ -1,11 +1,11 @@
-This is the Debian prepackaged version of the GNU C Library Reference Manual version 2.5
+This is the Debian prepackaged version of the GNU C Library Reference Manual version 2.9
For licensing reasons, the GNU C Library Reference Manual cannot be distributed
in Debian and has to be shipped in the non-free section. It has been
repackaged by the GNU Libc Maintainers <debian-glibc@lists.debian.org> from the
following source:
- <ftp://sources.redhat.com/pub/glibc/releases/glibc-2.6.1.tar.bz2>
+ <pserver:anoncvs@sources.redhat.com:/cvs/glibc/libc>
The following applies to the GNU C Library Reference Manual (libc.info):
Modified: glibc-doc-reference/trunk/debian/glibc-doc-reference.doc-base
===================================================================
--- glibc-doc-reference/trunk/debian/glibc-doc-reference.doc-base 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/debian/glibc-doc-reference.doc-base 2009-02-23 02:09:05 UTC (rev 3302)
@@ -1,19 +1,19 @@
Document: glibc-manual
Title: The GNU C Library Reference Manual
Author: Sandra Loosemore with Richard M. Stallman, Roland McGrath,
- Andrew Oram, and Ulrich Drepper
+ Andrew Oram, and Ulrich Drepper
Abstract: The GNU C Library Reference Manual
- The GNU C library, described in this document, defines all of the
- library functions that are specified by the ISO C standard, as well as
- additional features specific to POSIX and other derivatives of the Unix
- operating system, and extensions specific to the GNU system.
- .
- The purpose of this manual is to tell you how to use the facilities
- of the GNU library. We have mentioned which features belong to which
- standards to help you identify things that are potentially non-portable
- to other systems. But the emphasis in this manual is not on strict
- portability.
-Section: Apps/Programming
+ The GNU C library, described in this document, defines all of the
+ library functions that are specified by the ISO C standard, as well as
+ additional features specific to POSIX and other derivatives of the Unix
+ operating system, and extensions specific to the GNU system.
+ .
+ The purpose of this manual is to tell you how to use the facilities
+ of the GNU library. We have mentioned which features belong to which
+ standards to help you identify things that are potentially non-portable
+ to other systems. But the emphasis in this manual is not on strict
+ portability.
+Section: Programming/C
Format: info
Index: /usr/share/info/libc.info.gz
Modified: glibc-doc-reference/trunk/debian/rules
===================================================================
--- glibc-doc-reference/trunk/debian/rules 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/debian/rules 2009-02-23 02:09:05 UTC (rev 3302)
@@ -19,8 +19,8 @@
dh_testroot
rm -f build-stamp
- -$(MAKE) -C manual realclean
- -rm -rf manual/libc
+ $(MAKE) -C manual realclean
+ rm -rf manual/libc
dh_clean
Modified: glibc-doc-reference/trunk/manual/arith.texi
===================================================================
--- glibc-doc-reference/trunk/manual/arith.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/arith.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -418,7 +418,7 @@
This function returns a nonzero value if @var{x} is a ``not a number''
value, and zero otherwise.
-@strong{Note:} The @code{isnan} macro defined by @w{ISO C99} overrides
+@strong{NB:} The @code{isnan} macro defined by @w{ISO C99} overrides
the BSD function. This is normally not a problem, because the two
routines behave identically. However, if you really need to get the BSD
function for some reason, you can write
@@ -778,8 +778,7 @@
@comment fenv.h
@comment ISO
-@deftypefun int fesetexceptflag (const fexcept_t *@var{flagp}, int
-@var{excepts})
+@deftypefun int fesetexceptflag (const fexcept_t *@var{flagp}, int @var{excepts})
This function restores the flags for the exceptions indicated by
@var{excepts} to the values stored in the variable pointed to by
@var{flagp}.
@@ -969,7 +968,7 @@
bits in the @dfn{control word}. In C, traps result in the program
receiving the @code{SIGFPE} signal; see @ref{Signal Handling}.
-@strong{Note:} @w{IEEE 754} says that trap handlers are given details of
+@strong{NB:} @w{IEEE 754} says that trap handlers are given details of
the exceptional situation, and can set the result value. C signals do
not provide any mechanism to pass this information back and forth.
Trapping exceptions in C is therefore not very useful.
@@ -1521,7 +1520,7 @@
@comment math.h
@comment BSD
@deftypefunx {long double} dreml (long double @var{numerator}, long double @var{denominator})
-These functions are like @code{fmod} except that they rounds the
+These functions are like @code{fmod} except that they round the
internal quotient @var{n} to the nearest integer instead of towards zero
to an integer. For example, @code{drem (6.5, 2.3)} returns @code{-0.4},
which is @code{6.5} minus @code{6.9}.
@@ -1722,7 +1721,7 @@
machines that don't, the macros can be very slow. Therefore, you should
not use these functions when NaN is not a concern.
-@strong{Note:} There are no macros @code{isequal} or @code{isunequal}.
+@strong{NB:} There are no macros @code{isequal} or @code{isunequal}.
They are unnecessary, because the @code{==} and @code{!=} operators do
@emph{not} throw an exception if one or both of the operands are NaN.
Modified: glibc-doc-reference/trunk/manual/creature.texi
===================================================================
--- glibc-doc-reference/trunk/manual/creature.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/creature.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -217,7 +217,7 @@
Note that if you do this, you must link your program with the BSD
compatibility library by passing the @samp{-lbsd-compat} option to the
-compiler or linker. @strong{Note:} If you forget to do this, you may
+compiler or linker. @strong{NB:} If you forget to do this, you may
get very strange errors at run time.
@end defvr
Modified: glibc-doc-reference/trunk/manual/errno.texi
===================================================================
--- glibc-doc-reference/trunk/manual/errno.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/errno.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -1494,7 +1494,7 @@
@comment error.h
@comment GNU
-@deftypevar {void (*} error_print_progname ) (void)
+@deftypevar {void (*) error_print_progname } (void)
If the @code{error_print_progname} variable is defined to a non-zero
value the function pointed to is called by @code{error} or
@code{error_at_line}. It is expected to print the program name or do
Modified: glibc-doc-reference/trunk/manual/filesys.texi
===================================================================
--- glibc-doc-reference/trunk/manual/filesys.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/filesys.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -3239,7 +3239,7 @@
file name. Usually the template string is something like
@samp{/tmp/@var{prefix}XXXXXX}, and each program uses a unique @var{prefix}.
-@strong{Note:} Because @code{mktemp} and @code{mkstemp} modify the
+@strong{NB:} Because @code{mktemp} and @code{mkstemp} modify the
template string, you @emph{must not} pass string constants to them.
String constants are normally in read-only storage, so your program
would crash when @code{mktemp} or @code{mkstemp} tried to modify the
Modified: glibc-doc-reference/trunk/manual/libc.texinfo
===================================================================
--- glibc-doc-reference/trunk/manual/libc.texinfo 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/libc.texinfo 2009-02-23 02:09:05 UTC (rev 3302)
@@ -18,9 +18,9 @@
@comment %**end of header (This is for running Texinfo on a region.)
@c sold 0.06/1.09, print run out 21may96
-@set EDITION 0.11
-@set VERSION 2.6
-@set UPDATED 2006-12-03
+@set EDITION 0.12
+@set VERSION 2.8
+@set UPDATED 2007-10-27
@set ISBN 1-882114-55-8
@copying
@@ -30,7 +30,7 @@
of @cite{The GNU C Library Reference Manual}, for version @value{VERSION}.
Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2001, 2002,
-2003, 2007 Free Software Foundation, Inc.
+2003, 2007, 2008 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
@@ -41,9 +41,9 @@
copy of the license is included in the section entitled "GNU Free
Documentation License".
-(a) The FSF's Back-Cover Text is: ``You are free to copy and modify
-this GNU Manual. Buying copies from GNU Press supports the FSF in
-developing GNU and promoting software freedom.''
+(a) The FSF's Back-Cover Text is: ``You have the freedom to
+copy and modify this GNU manual. Buying copies from the FSF
+supports it in developing GNU and promoting software freedom.''
@end copying
@iftex
Modified: glibc-doc-reference/trunk/manual/math.texi
===================================================================
--- glibc-doc-reference/trunk/manual/math.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/math.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -1366,7 +1366,7 @@
This function returns the next pseudo-random number in the sequence.
The value returned ranges from @code{0} to @code{RAND_MAX}.
-@strong{Note:} Temporarily this function was defined to return a
+@strong{NB:} Temporarily this function was defined to return a
@code{int32_t} value to indicate that the return value always contains
32 bits even if @code{long int} is wider. The standard demands it
differently. Users must always be aware of the 32-bit limitation,
Modified: glibc-doc-reference/trunk/manual/memory.texi
===================================================================
--- glibc-doc-reference/trunk/manual/memory.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/memory.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -2326,7 +2326,7 @@
variable-sized arrays.
@end itemize
-@strong{Note:} If you mix use of @code{alloca} and variable-sized arrays
+@strong{NB:} If you mix use of @code{alloca} and variable-sized arrays
within one function, exiting a scope in which a variable-sized array was
declared frees all blocks allocated with @code{alloca} during the
execution of that scope.
Modified: glibc-doc-reference/trunk/manual/process.texi
===================================================================
--- glibc-doc-reference/trunk/manual/process.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/process.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -277,7 +277,7 @@
process execute a new program after it has been forked.
To see the effects of @code{exec} from the point of view of the called
-program, @xref{Program Basics}.
+program, see @ref{Program Basics}.
@pindex unistd.h
The functions in this family differ in how you specify the arguments,
Modified: glibc-doc-reference/trunk/manual/resource.texi
===================================================================
--- glibc-doc-reference/trunk/manual/resource.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/resource.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -591,7 +591,7 @@
for something like I/O, its absolute priority is irrelevant.
@cindex runnable process
-@strong{Note:} The term ``runnable'' is a synonym for ``ready to run.''
+@strong{NB:} The term ``runnable'' is a synonym for ``ready to run.''
When two processes are running or ready to run and both have the same
absolute priority, it's more interesting. In that case, who gets the
@@ -663,7 +663,7 @@
its absolute priority when the process isn't getting its entitled share
and lowers it when the process is exceeding it.
-@strong{Note:} The absolute priority is sometimes called the ``static
+@strong{NB:} The absolute priority is sometimes called the ``static
priority.'' We don't use that term in this manual because it misses the
most important feature of the absolute priority: its absoluteness.
Modified: glibc-doc-reference/trunk/manual/socket.texi
===================================================================
--- glibc-doc-reference/trunk/manual/socket.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/socket.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -2070,7 +2070,7 @@
@comment sys/socket.h
@comment BSD
-@deftypefun int listen (int @var{socket}, unsigned int @var{n})
+@deftypefun int listen (int @var{socket}, int @var{n})
The @code{listen} function enables the socket @var{socket} to accept
connections, thus making it a server socket.
Modified: glibc-doc-reference/trunk/manual/startup.texi
===================================================================
--- glibc-doc-reference/trunk/manual/startup.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/startup.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -31,7 +31,7 @@
A program starts another program with the @code{exec} family of system calls.
This chapter looks at program startup from the execee's point of view. To
-see the event from the execor's point of view, @xref{Executing a File}.
+see the event from the execor's point of view, see @ref{Executing a File}.
@menu
* Program Arguments:: Parsing your program's command-line arguments.
@@ -309,9 +309,9 @@
The value of an environment variable can be accessed with the
@code{getenv} function. This is declared in the header file
-@file{stdlib.h}. All of the following functions can be safely used in
-multi-threaded programs. It is made sure that concurrent modifications
-to the environment do not lead to errors.
+@file{stdlib.h}. Modifications of enviroment variables are not
+allowed in Multi-threaded programs. The @code{getenv} function
+can be safely used in multi-threaded programs
@pindex stdlib.h
@comment stdlib.h
Modified: glibc-doc-reference/trunk/manual/stdio.texi
===================================================================
--- glibc-doc-reference/trunk/manual/stdio.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/stdio.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -3907,7 +3907,7 @@
know that a function uses a @code{scanf}-style format string. Then it
can check the number and types of arguments in each call to the
function, and warn you when they do not match the format string.
-For details, @xref{Function Attributes, , Declaring Attributes of Functions,
+For details, see @ref{Function Attributes, , Declaring Attributes of Functions,
gcc.info, Using GNU CC}.
@node EOF and Errors
Modified: glibc-doc-reference/trunk/manual/sysinfo.texi
===================================================================
--- glibc-doc-reference/trunk/manual/sysinfo.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/sysinfo.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -78,7 +78,7 @@
In some contexts, the host name is called a ``node name.''
-For more information on DNS host naming, @xref{Host Names}.
+For more information on DNS host naming, see @ref{Host Names}.
@pindex hostname
@pindex hostid
@@ -1066,8 +1066,7 @@
@comment sysctl.h
@comment BSD
-@deftypefun int sysctl (int *@var{names}, int @var{nlen}, void *@var{oldval},
- size_t *@var{oldlenp}, void *@var{newval}, size_t @var{newlen})
+@deftypefun int sysctl (int *@var{names}, int @var{nlen}, void *@var{oldval}, size_t *@var{oldlenp}, void *@var{newval}, size_t @var{newlen})
@code{sysctl} gets or sets a specified system parameter. There are so
many of these parameters that it is not practical to list them all here,
Modified: glibc-doc-reference/trunk/manual/syslog.texi
===================================================================
--- glibc-doc-reference/trunk/manual/syslog.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/syslog.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -90,7 +90,7 @@
@item priority
This tells how important the content of the message is. Examples of
defined priority values are: debug, informational, warning, critical.
-For the complete list, @xref{syslog; vsyslog}. Except for
+For the complete list, see @ref{syslog; vsyslog}. Except for
the fact that the priorities have a defined order, the meaning of each
of these priorities is entirely determined by the system administrator.
@@ -337,7 +337,7 @@
Results are undefined if the facility code is anything else.
-@strong{note:} @code{syslog} recognizes one other facility code: that of
+@strong{NB:} @code{syslog} recognizes one other facility code: that of
the kernel. But you can't specify that facility code with these
functions. If you try, it looks the same to @code{syslog} as if you are
requesting the default facility. But you wouldn't want to anyway,
Modified: glibc-doc-reference/trunk/manual/terminal.texi
===================================================================
--- glibc-doc-reference/trunk/manual/terminal.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/terminal.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -2075,7 +2075,7 @@
@comment pty.h
@comment BSD
-@deftypefun int openpty (int *@var{amaster}, int *@var{aslave}, char *@var{name}, struct termios *@var{termp}, struct winsize *@var{winp})
+@deftypefun int openpty (int *@var{amaster}, int *@var{aslave}, char *@var{name}, const struct termios *@var{termp}, const struct winsize *@var{winp})
This function allocates and opens a pseudo-terminal pair, returning the
file descriptor for the master in @var{*amaster}, and the file
descriptor for the slave in @var{*aslave}. If the argument @var{name}
@@ -2106,7 +2106,7 @@
@comment pty.h
@comment BSD
-@deftypefun int forkpty (int *@var{amaster}, char *@var{name}, struct termios *@var{termp}, struct winsize *@var{winp})
+@deftypefun int forkpty (int *@var{amaster}, char *@var{name}, const struct termios *@var{termp}, const struct winsize *@var{winp})
This function is similar to the @code{openpty} function, but in
addition, forks a new process (@pxref{Creating a Process}) and makes the
newly opened slave pseudo-terminal device the controlling terminal
Modified: glibc-doc-reference/trunk/manual/time.texi
===================================================================
--- glibc-doc-reference/trunk/manual/time.texi 2009-02-23 00:50:28 UTC (rev 3301)
+++ glibc-doc-reference/trunk/manual/time.texi 2009-02-23 02:09:05 UTC (rev 3302)
@@ -212,7 +212,7 @@
same value approximately every 72 minutes.
For additional functions to examine a process' use of processor time,
-and to control it, @xref{Resource Usage And Limitation}.
+and to control it, see @ref{Resource Usage And Limitation}.
@menu
@@ -1652,7 +1652,7 @@
Leading zeroes are permitted but not required.
-@strong{Note:} The Unix specification says the upper bound on this value
+@strong{NB:} The Unix specification says the upper bound on this value
is @code{61}, a result of a decision to allow double leap seconds. You
will not see the value @code{61} because no minute has more than one
leap second, but the myth persists.
Reply to: