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 <[email protected]> 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 <[email protected]> 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 <[email protected]> Uploaders: Ben Collins <[email protected]>, GOTO Masanori <[email protected]>, Philip Blundell <[email protected]>, Jeff Bailey <[email protected]>, Daniel Jacobowitz <[email protected]>, Clint Adams <[email protected]>, Aurelien Jarno <[email protected]> -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 <[email protected]> from the following source: - <ftp://sources.redhat.com/pub/glibc/releases/glibc-2.6.1.tar.bz2> + <pserver:[email protected]:/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. -- To UNSUBSCRIBE, email to [email protected] with a subject of "unsubscribe". Trouble? Contact [email protected]
