changeset 5979:5cc92ab8ce76

Use shortcut links to the POSIX specification.
author Bruno Haible <bruno@clisp.org>
date Mon, 11 Jul 2005 11:21:55 +0000
parents ee280efaa0fb
children 5375b994ef54
files ChangeLog MODULES.html.sh lib/getaddrinfo.h lib/getcwd.h lib/getlogin_r.h lib/getsubopt.h lib/inet_ntop.h lib/strtok_r.h lib/time_r.h
diffstat 9 files changed, 43 insertions(+), 15 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-07-11  Bruno Haible  <bruno@clisp.org>
+
+	* MODULES.html.sh: Use shortcut URLs to the www.opengroup.org site.
+	Reported by Jim Meyering.
+
 2005-07-09  Sergey Poznyakoff  <gray@gnu.org.ua>
 
 	* modules/argp (Depends-on): Add unlocked-io
--- a/MODULES.html.sh
+++ b/MODULES.html.sh
@@ -22,10 +22,10 @@
 # Extend the PATH so that gnulib-tool is found.
 PATH=`dirname "$0"`:$PATH; export PATH
 
-POSIX2001_URL='http://www.opengroup.org/onlinepubs/007904975/'
+POSIX2001_URL='http://www.opengroup.org/susv3'
 case $USER in
   bruno )
-    POSIX2001_URL='file:/packages/www/www.opengroup.org/susv3/' ;;
+    POSIX2001_URL='file:/packages/www/www.opengroup.org/susv3' ;;
 esac
 
 sed_lt='s,<,\&lt;,g'
@@ -1063,6 +1063,7 @@
 srand48
 srandom
 sscanf
+stat
 statvfs
 stdin
 strcasecmp
@@ -1336,7 +1337,7 @@
     element='<A HREF="#module='$1'">'$1'</A>'
     func_echo "<TD ALIGN=LEFT VALIGN=TOP WIDTH=\"20%\">$element"
 
-    element=`gnulib-tool --extract-description $1 | sed -e "$sed_lt" -e "$sed_gt" -e "$sed_remove_trailing_empty_line" | sed -e 's,^, ,' | sed -e 's,\([^a-zA-Z]\)'"${posix_functions}"'(),\1<A HREF="'"$POSIX2001_URL"'functions/\2.html">\2</A>(),g' | sed -e 's,^ ,,'`
+    element=`gnulib-tool --extract-description $1 | sed -e "$sed_lt" -e "$sed_gt" -e "$sed_remove_trailing_empty_line" | sed -e 's,^, ,' | sed -e 's,\([^a-zA-Z]\)'"${posix_functions}"'(),\1<A HREF="'"$POSIX2001_URL"'xsh/\2.html">\2</A>(),g' | sed -e 's,^ ,,'`
     func_echo "<TD ALIGN=LEFT VALIGN=TOP WIDTH=\"80%\">$element"
 
     func_end TR
@@ -1348,7 +1349,7 @@
     element='<A NAME="module='$1'"></A><A HREF="modules/'$1'">'$1'</A>'
     func_echo "<TD ALIGN=LEFT VALIGN=TOP>$element"
 
-    element=`gnulib-tool --extract-include-directive $1 | sed -e "$sed_lt" -e "$sed_gt" -e "$sed_remove_trailing_empty_line" | sed -e 's,^#include "\(.*\)"$,#include "<A HREF="lib/\1">\1</A>",' -e 's,^#include &lt;'"${posix_headers}"'\.h&gt;$,#include \&lt;<A HREF="'"$POSIX2001_URL"'basedefs/\1.h.html">\1.h</A>\&gt;,' | sed -e 's/$/<BR>/' | tr -d "$trnl" | sed -e 's/<BR>$//'`
+    element=`gnulib-tool --extract-include-directive $1 | sed -e "$sed_lt" -e "$sed_gt" -e "$sed_remove_trailing_empty_line" | sed -e 's,^#include "\(.*\)"$,#include "<A HREF="lib/\1">\1</A>",' -e 's,^#include &lt;'"${posix_headers}"'\.h&gt;$,#include \&lt;<A HREF="'"$POSIX2001_URL"'xbd/\1.h.html">\1.h</A>\&gt;,' | sed -e 's/$/<BR>/' | tr -d "$trnl" | sed -e 's/<BR>$//'`
     test -n "$element" || element='---'
     func_echo "<TD ALIGN=LEFT VALIGN=TOP>$element"
 
--- a/lib/getaddrinfo.h
+++ b/lib/getaddrinfo.h
@@ -72,16 +72,22 @@
 # endif
 
 /* Translate name of a service location and/or a service name to set of
-   socket addresses.  */
+   socket addresses.
+   For more details, see the POSIX:2001 specification
+   <http://www.opengroup.org/susv3xsh/getaddrinfo.html>.  */
 extern int getaddrinfo (const char *restrict nodename,
 			const char *restrict servname,
 			const struct addrinfo *restrict hints,
 			struct addrinfo **restrict res);
 
-/* Free `addrinfo' structure AI including associated storage.  */
+/* Free `addrinfo' structure AI including associated storage.
+   For more details, see the POSIX:2001 specification
+   <http://www.opengroup.org/susv3xsh/getaddrinfo.html>.  */
 extern void freeaddrinfo (struct addrinfo *ai);
 
-/* Convert error return from getaddrinfo() to a string.  */
+/* Convert error return from getaddrinfo() to a string.
+   For more details, see the POSIX:2001 specification
+   <http://www.opengroup.org/susv3xsh/gai_strerror.html>.  */
 extern const char *gai_strerror (int ecode);
 
 # endif
--- a/lib/getcwd.h
+++ b/lib/getcwd.h
@@ -1,6 +1,6 @@
 /* Get the working directory, compatibly with the GNU C Library.
 
-   Copyright (C) 2004 Free Software Foundation, Inc.
+   Copyright (C) 2004-2005 Free Software Foundation, Inc.
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
@@ -36,5 +36,7 @@
 # define __GETCWD_XCONCAT(x, y) __GETCWD_CONCAT (x, y)
 # define __GETCWD_ID(y) __GETCWD_XCONCAT (__GETCWD_PREFIX, y)
 # define getcwd __GETCWD_ID (getcwd)
+/* See the POSIX:2001 specification
+   <http://www.opengroup.org/susv3xsh/getcwd.html>.  */
 char *getcwd (char *, size_t);
 #endif
--- a/lib/getlogin_r.h
+++ b/lib/getlogin_r.h
@@ -31,7 +31,7 @@
    the case that the login name cannot be found but no specific error is
    provided (this case is hopefully rare but is left open by the POSIX spec).
 
-   See <http://www.opengroup.org/onlinepubs/009695399/functions/getlogin.html>.
+   See <http://www.opengroup.org/susv3xsh/getlogin.html>.
  */
 #if !HAVE_DECL_GETLOGIN_R
 int getlogin_r (char *name, size_t size);
--- a/lib/getsubopt.h
+++ b/lib/getsubopt.h
@@ -1,5 +1,5 @@
 /* Parse comma separate list into words.
-   Copyright (C) 2004 Free Software Foundation, Inc.
+   Copyright (C) 2004-2005 Free Software Foundation, Inc.
    Contributed by Simon Josefsson <jas@extundo.com>, 2004.
 
    This program is free software; you can redistribute it and/or modify
@@ -26,7 +26,7 @@
      - It returns the index of the "token" in the given array of tokens.
    Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
    For more details see the POSIX:2001 specification.
-   http://www.opengroup.org/onlinepubs/009695399/functions/getsubopt.html */
+   http://www.opengroup.org/susv3xsh/getsubopt.html */
 
 #if HAVE_GETSUBOPT
 
--- a/lib/inet_ntop.h
+++ b/lib/inet_ntop.h
@@ -31,7 +31,10 @@
    DST is returned.  If an error occurs, the return value is NULL and
    errno is set.  If CNT bytes are not sufficient to hold the result,
    the return value is NULL and errno is set to ENOSPC.  A good value
-   for CNT is 46.  */
+   for CNT is 46.
+
+   For more details, see the POSIX:2001 specification
+   <http://www.opengroup.org/susv3xsh/inet_ntop.html>.  */
 
 #if !HAVE_INET_NTOP /* not already defined and declared in <arpa/inet.h> ? */
 extern const char *inet_ntop(int af, const void *src, char *dst, socklen_t cnt);
--- a/lib/strtok_r.h
+++ b/lib/strtok_r.h
@@ -1,5 +1,5 @@
 /* Split string into tokens
-   Copyright (C) 2004 Free Software Foundation, Inc.
+   Copyright (C) 2004-2005 Free Software Foundation, Inc.
    Written by Simon Josefsson.
 
    This program is free software; you can redistribute it and/or modify
@@ -35,7 +35,7 @@
    This is a variant of strtok() that is multithread-safe.
 
    For the POSIX documentation for this function, see:
-   http://www.opengroup.org/onlinepubs/009695399/functions/strtok.html
+   http://www.opengroup.org/susv3xsh/strtok.html
 
    Caveat: It modifies the original string.
    Caveat: These functions cannot be used on constant strings.
--- a/lib/time_r.h
+++ b/lib/time_r.h
@@ -1,6 +1,6 @@
 /* Reentrant time functions like localtime_r.
 
-   Copyright (C) 2003 Free Software Foundation, Inc.
+   Copyright (C) 2003, 2005 Free Software Foundation, Inc.
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
@@ -37,9 +37,20 @@
 # define gmtime_r rpl_gmtime_r
 # define localtime_r rpl_localtime_r
 
+/* See the POSIX:2001 specification
+   <http://www.opengroup.org/susv3xsh/asctime.html>.  */
 char *asctime_r (struct tm const * restrict, char * restrict);
+
+/* See the POSIX:2001 specification
+   <http://www.opengroup.org/susv3xsh/ctime.html>.  */
 char *ctime_r (time_t const *, char *);
+
+/* See the POSIX:2001 specification
+   <http://www.opengroup.org/susv3xsh/gmtime.html>.  */
 struct tm *gmtime_r (time_t const * restrict, struct tm * restrict);
+
+/* See the POSIX:2001 specification
+   <http://www.opengroup.org/susv3xsh/localtime.html>.  */
 struct tm *localtime_r (time_t const * restrict, struct tm * restrict);
 #endif