Use shortcut links to the POSIX specification.

diff --git a/ChangeLog b/ChangeLog
index d05d42934e5a3f9cd5a779cc6e701a8a64cdeeb6..f2773f252f79aa2f7253605cc3a86b3d47f34871 100644 (file)
--- 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

diff --git a/MODULES.html.sh b/MODULES.html.sh
index 5ec1672b075af90ff35a10570507edc1d23055a8..021915023268d0559307e316db20d3ab75a25e9d 100755 (executable)
--- 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 @@ srand
 srand48
 srandom
 sscanf
+stat
 statvfs
 stdin
 strcasecmp
@@ -1336,7 +1337,7 @@ func_module ()
     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 @@ func_module ()
     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"
 

diff --git a/lib/getaddrinfo.h b/lib/getaddrinfo.h
index dbd7e220641679e64cd9bf731980355bbc54e2f2..955833a6ca7c087965a6ad0eb844db4533f0deab 100644 (file)
--- a/lib/getaddrinfo.h
+++ b/lib/getaddrinfo.h
@@ -72,16 +72,22 @@ struct addrinfo
 # 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

diff --git a/lib/getcwd.h b/lib/getcwd.h
index d69fe206b8b25442b339bed292e543642697b1b3..200a3d32d76ca42f5f4af443a0cd6c5bebde75fd 100644 (file)
--- 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

diff --git a/lib/getlogin_r.h b/lib/getlogin_r.h
index 88935401b87a65632bbdf6e73e106084fbd810d5..3ff3cafa6976c161fadd9a098c5b9919d8fb2798 100644 (file)
--- 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);

diff --git a/lib/getsubopt.h b/lib/getsubopt.h
index e94f8826856696ea03fd5ac57dc0c40502403fa4..5308ef5e71347734b6f10f7e87cdf5de50feb726 100644 (file)
--- 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
 

diff --git a/lib/inet_ntop.h b/lib/inet_ntop.h
index 718a623cb18e2961b980d8767feddd5d1792fc7b..6a9213396929a9950244f1853a626d12f18ec972 100644 (file)
--- 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);

diff --git a/lib/strtok_r.h b/lib/strtok_r.h
index bd32d32c23211f43e0a0e762991b69ac1b6b2341..7d3f21b5f0ec680ae8624a2cd1bba68f81d326e7 100644 (file)
--- 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.

diff --git a/lib/time_r.h b/lib/time_r.h
index f8d5d529312b8c970708010ca610daec7f1a5888..1f2e94a9075cec5269dc8975631312623efb05d8 100644 (file)
--- 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