summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2012-08-24 02:19:57 -0700
committerPaul Eggert <eggert@cs.ucla.edu>2012-08-24 02:20:34 -0700
commit0815bd3d34b072659e4e2c8c97241fe2ccae1cd6 (patch)
tree48da33d98d36ea83df11460571f962ca92a0cdab
parent8f25604017b00aec5a7b2a37fc96a55f2c948ec9 (diff)
downloadgnulib-0815bd3d34b072659e4e2c8c97241fe2ccae1cd6.tar.gz
doc: do not use @acronym
* doc/inet_ntoa.texi (inet_ntoa): * doc/parse-datetime.texi (Seconds since the Epoch) (Specifying time zone rules): * doc/posix-functions/inet_ntoa.texi (inet_ntoa): Don't use @acronym. Problem reported by John Darlington in <http://lists.gnu.org/archive/html/bug-gnulib/2012-08/msg00124.html>.
-rw-r--r--ChangeLog10
-rw-r--r--doc/inet_ntoa.texi2
-rw-r--r--doc/parse-datetime.texi24
-rw-r--r--doc/posix-functions/inet_ntoa.texi2
4 files changed, 24 insertions, 14 deletions
diff --git a/ChangeLog b/ChangeLog
index b46a8bd89a..570cb9a1ad 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2012-08-24 Paul Eggert <eggert@cs.ucla.edu>
+
+ doc: do not use @acronym
+ * doc/inet_ntoa.texi (inet_ntoa):
+ * doc/parse-datetime.texi (Seconds since the Epoch)
+ (Specifying time zone rules):
+ * doc/posix-functions/inet_ntoa.texi (inet_ntoa):
+ Don't use @acronym. Problem reported by John Darlington in
+ <http://lists.gnu.org/archive/html/bug-gnulib/2012-08/msg00124.html>.
+
2012-08-23 Paul Eggert <eggert@cs.ucla.edu>
stdnoreturn: port to newer GCCs
diff --git a/doc/inet_ntoa.texi b/doc/inet_ntoa.texi
index c02c011650..c052f0c9d1 100644
--- a/doc/inet_ntoa.texi
+++ b/doc/inet_ntoa.texi
@@ -17,6 +17,6 @@ is not required to be thread safe. Implementations of
If two threads call @code{inet_ntoa} at roughly the same time, you
might end up with the wrong date in one of the threads, or some
undefined string. Further, @code{inet_ntoa} is specific for
-@acronym{IPv4} addresses.
+IPv4 addresses.
A protocol independent function is @code{inet_ntop}.
diff --git a/doc/parse-datetime.texi b/doc/parse-datetime.texi
index 9f1e5b43ed..f17b6b444f 100644
--- a/doc/parse-datetime.texi
+++ b/doc/parse-datetime.texi
@@ -482,15 +482,15 @@ supported by the internal representation is truncated toward minus
infinity. Such a number cannot be combined with any other date
item, as it specifies a complete time stamp.
-@cindex beginning of time, for @acronym{POSIX}
-@cindex epoch, for @acronym{POSIX}
+@cindex beginning of time, for POSIX
+@cindex epoch, for POSIX
Internally, computer times are represented as a count of seconds since
-an epoch---a well-defined point of time. On @acronym{GNU} and
-@acronym{POSIX} systems, the epoch is 1970-01-01 00:00:00 @sc{utc}, so
+an epoch---a well-defined point of time. On GNU and
+POSIX systems, the epoch is 1970-01-01 00:00:00 @sc{utc}, so
@samp{@@0} represents this time, @samp{@@1} represents 1970-01-01
-00:00:01 @sc{utc}, and so forth. @acronym{GNU} and most other
-@acronym{POSIX}-compliant systems support such times as an extension
-to @acronym{POSIX}, using negative counts, so that @samp{@@-1}
+00:00:01 @sc{utc}, and so forth. GNU and most other
+POSIX-compliant systems support such times as an extension
+to POSIX, using negative counts, so that @samp{@@-1}
represents 1969-12-31 23:59:59 @sc{utc}.
Traditional Unix systems count seconds with 32-bit two's-complement
@@ -519,7 +519,7 @@ two quote characters (@samp{"}) must be present in the date, and any
quotes or backslashes within @var{rule} must be escaped by a
backslash.
-For example, with the @acronym{GNU} @command{date} command you can
+For example, with the GNU @command{date} command you can
answer the question ``What time is it in New York when a Paris clock
shows 6:30am on October 31, 2004?'' by using a date beginning with
@samp{TZ="Europe/Paris"} as shown in the following shell transcript:
@@ -543,16 +543,16 @@ A @env{TZ} value is a rule that typically names a location in the
@uref{http://www.twinsun.com/tz/tz-link.htm, @samp{tz} database}.
A recent catalog of location names appears in the
@uref{http://twiki.org/cgi-bin/xtra/tzdate, TWiki Date and Time
-Gateway}. A few non-@acronym{GNU} hosts require a colon before a
+Gateway}. A few non-GNU hosts require a colon before a
location name in a @env{TZ} setting, e.g.,
@samp{TZ=":America/New_York"}.
The @samp{tz} database includes a wide variety of locations ranging
from @samp{Arctic/Longyearbyen} to @samp{Antarctica/South_Pole}, but
if you are at sea and have your own private time zone, or if you are
-using a non-@acronym{GNU} host that does not support the @samp{tz}
-database, you may need to use a @acronym{POSIX} rule instead. Simple
-@acronym{POSIX} rules like @samp{UTC0} specify a time zone without
+using a non-GNU host that does not support the @samp{tz}
+database, you may need to use a POSIX rule instead. Simple
+POSIX rules like @samp{UTC0} specify a time zone without
daylight saving time; other rules can specify simple daylight saving
regimes. @xref{TZ Variable,, Specifying the Time Zone with @code{TZ},
libc, The GNU C Library}.
diff --git a/doc/posix-functions/inet_ntoa.texi b/doc/posix-functions/inet_ntoa.texi
index e5026e85d0..a21f3197b6 100644
--- a/doc/posix-functions/inet_ntoa.texi
+++ b/doc/posix-functions/inet_ntoa.texi
@@ -24,5 +24,5 @@ might end up with the wrong date in one of the threads, or some
undefined string.
@end itemize
-Note: @code{inet_ntoa} is specific for @acronym{IPv4} addresses.
+Note: @code{inet_ntoa} is specific for IPv4 addresses.
A protocol independent function is @code{inet_ntop}.