]> Savannah Git Hosting - gnulib.git/commitdiff
maint: time stamp -> timestamp
authorPaul Eggert <eggert@cs.ucla.edu>
Mon, 9 Jan 2017 19:55:22 +0000 (11:55 -0800)
committerPaul Eggert <eggert@cs.ucla.edu>
Mon, 9 Jan 2017 19:58:08 +0000 (11:58 -0800)
Use the spelling "timestamp", as that is what POSIX uses.

21 files changed:
build-aux/bootstrap
build-aux/git-version-gen
doc/install.texi
doc/parse-datetime.texi
doc/posix-functions/ctime.texi
doc/posix-functions/inet_ntoa.texi
lib/fdutimensat.c
lib/futimens.c
lib/mktime.c
lib/parse-datetime.h
lib/parse-datetime.y
lib/stat-time.h
lib/time.in.h
lib/timespec.h
lib/utimecmp.c
lib/utimecmp.h
lib/utimens.c
lib/utimensat.c
lib/xtime.h
modules/utimecmp
tests/test-posixtm.c

index 26066b2ab0d3c175998e829bd9a21d062a0e7edd..932ff85e78e39f2b9c992f3d172973613e72f315 100755 (executable)
@@ -1,6 +1,6 @@
 #! /bin/sh
 # Print a version string.
-scriptversion=2016-11-03.18; # UTC
+scriptversion=2017-01-09.19; # UTC
 
 # Bootstrap this package from checked-out sources.
 
@@ -790,7 +790,7 @@ symlink_to_dir()
       # Leave any existing symlink alone, if it already points to the source,
       # so that broken build tools that care about symlink times
       # aren't confused into doing unnecessary builds.  Conversely, if the
-      # existing symlink's time stamp is older than the source, make it afresh,
+      # existing symlink's timestamp is older than the source, make it afresh,
       # so that broken tools aren't confused into skipping needed builds.  See
       # <http://lists.gnu.org/archive/html/bug-gnulib/2011-05/msg00326.html>.
       test -h "$dst" &&
index c29f9e5928eb8eda5572f33262f76a87ba56f618..079849d5e523cd8354cbfada84dc7e784f3debfc 100755 (executable)
@@ -1,6 +1,6 @@
 #!/bin/sh
 # Print a version string.
-scriptversion=2016-05-08.18; # UTC
+scriptversion=2017-01-09.19; # UTC
 
 # Copyright (C) 2007-2017 Free Software Foundation, Inc.
 #
@@ -200,7 +200,7 @@ v=`echo "$v" |sed "s/^$prefix//"`
 # string we're using came from git.  I.e., skip the test if it's "UNKNOWN"
 # or if it came from .tarball-version.
 if test "x$v_from_git" != x; then
-  # Don't declare a version "dirty" merely because a time stamp has changed.
+  # Don't declare a version "dirty" merely because a timestamp has changed.
   git update-index --refresh > /dev/null 2>&1
 
   dirty=`exec 2>/dev/null;git diff-index --name-only HEAD` || dirty=
index 776eab1e545811b5e8ce72154a1235d4a5278fc3..1b9627d10d7a750cd76408525469a10997e8f2b0 100644 (file)
@@ -262,7 +262,7 @@ use an ANSI C compiler:
 @noindent
 and if that doesn't work, install pre-built binaries of GCC for HP-UX.
 
-HP-UX @command{make} updates targets which have the same time stamps as
+HP-UX @command{make} updates targets which have the same timestamps as
 their prerequisites, which makes it generally unusable when shipped
 generated files such as @command{configure} are involved.  Use GNU
 @command{make} instead.
index 2b168a488b54139a39be8105a1f4db4a08d2740a..9568a4a472b76ff23b4b566ab62f19b7cd203c84 100644 (file)
@@ -311,7 +311,7 @@ unambiguous numeric time zone corrections like @samp{-0500}, as
 described in the previous section.
 
 If neither a time zone item nor a time zone correction is supplied,
-time stamps are interpreted using the rules of the default time zone
+timestamps are interpreted using the rules of the default time zone
 (@pxref{Specifying time zone rules}).
 
 
@@ -478,12 +478,12 @@ year.
 @node Seconds since the Epoch
 @section Seconds since the Epoch
 
-If you precede a number with @samp{@@}, it represents an internal time
-stamp as a count of seconds.  The number can contain an internal
+If you precede a number with @samp{@@}, it represents an internal
+timestamp as a count of seconds.  The number can contain an internal
 decimal point (either @samp{.} or @samp{,}); any excess precision not
 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.
+item, as it specifies a complete timestamp.
 
 @cindex beginning of time, for POSIX
 @cindex epoch, for POSIX
index 6bff20c3d2748fc78e58ade87db89a31b6fda4ef..f5a7c276264ce7d3404f4fd26b01b8748e4a34a3 100644 (file)
@@ -17,7 +17,7 @@ This function may overflow its internal buffer if an invalid year is passed.
 @item
 The @code{ctime} function need not be reentrant, and consequently is
 not required to be thread safe.  Implementations of @code{ctime}
-typically write the time stamp into static buffer.  If two threads
+typically write the timestamp into static buffer.  If two threads
 call @code{ctime} at roughly the same time, you might end up with the
 wrong date in one of the threads, or some undefined string.  There is
 a re-entrant interface @code{ctime_r}.
index a21f3197b6ffd18b35845aba0d59454cfd7864a0..56b497dd8f761c708907eb4791927405512b8937 100644 (file)
@@ -18,7 +18,7 @@ mingw, MSVC 9.
 @item
 The @code{inet_ntoa} function need not be reentrant, and consequently
 is not required to be thread safe.  Implementations of
-@code{inet_ntoa} typically write the time stamp into static buffer.
+@code{inet_ntoa} typically write the timestamp into static buffer.
 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.
index 1475bb049dc5dd153ce759c1112af095acd78464..ff68490a2f1743b448bceccf2176c1f91054d6ed 100644 (file)
 #include <fcntl.h>
 #include <sys/stat.h>
 
-/* Set the access and modification time stamps of FD (a.k.a. FILE) to be
+/* Set the access and modification timestamps of FD (a.k.a. FILE) to be
    TIMESPEC[0] and TIMESPEC[1], respectively; relative to directory DIR.
    FD must be either negative -- in which case it is ignored --
    or a file descriptor that is open on FILE.
    If FD is nonnegative, then FILE can be NULL, which means
    use just futimes (or equivalent) instead of utimes (or equivalent),
    and fail if on an old system without futimes (or equivalent).
-   If TIMESPEC is null, set the time stamps to the current time.
+   If TIMESPEC is null, set the timestamps to the current time.
    ATFLAG is passed to utimensat if FD is negative or futimens was
    unsupported, which can allow operation on FILE as a symlink.
    Return 0 on success, -1 (setting errno) on failure.  */
index d370568a051cf015b72a4707229174ac46dc2f41..213e9b7511a43c5c44e6ad10f2081cbb85b034ce 100644 (file)
 
 #include "utimens.h"
 
-/* Set the access and modification time stamps of FD to be
+/* Set the access and modification timestamps of FD to be
    TIMESPEC[0] and TIMESPEC[1], respectively.
    Fail with ENOSYS on systems without futimes (or equivalent).
-   If TIMESPEC is null, set the time stamps to the current time.
+   If TIMESPEC is null, set the timestamps to the current time.
    Return 0 on success, -1 (setting errno) on failure.  */
 int
 futimens (int fd, struct timespec const times[2])
index cd52835ca0219f95dbb003c1b2964bbb4c8f5604..2efd44a226803003fdeaad620ff2bdb039f909d5 100644 (file)
@@ -153,7 +153,7 @@ isdst_differ (int a, int b)
 
 /* Return an integer value measuring (YEAR1-YDAY1 HOUR1:MIN1:SEC1) -
    (YEAR0-YDAY0 HOUR0:MIN0:SEC0) in seconds, assuming that the clocks
-   were not adjusted between the time stamps.
+   were not adjusted between the timestamps.
 
    The YEAR values uses the same numbering as TP->tm_year.  Values
    need not be in the usual range.  However, YEAR1 must not overflow
index a777aac4d52b03f2734203478efb38e89c67e30f..fa6a9a3769536c9d5777da3051b14ef82119b2ba 100644 (file)
@@ -1,4 +1,4 @@
-/* Parse a string into an internal time stamp.
+/* Parse a string into an internal timestamp.
 
    Copyright (C) 1995, 1997-1998, 2003-2004, 2007, 2009-2017 Free Software
    Foundation, Inc.
index 30488d68a0a178101261d808c8e5027f66297f35..c604be6f775c15b271868c7dbc741f89fdd06d00 100644 (file)
@@ -1,5 +1,5 @@
 %{
-/* Parse a string into an internal time stamp.
+/* Parse a string into an internal timestamp.
 
    Copyright (C) 1999-2000, 2002-2017 Free Software Foundation, Inc.
 
@@ -24,7 +24,7 @@
    Modified by Paul Eggert <eggert@twinsun.com> in August 1999 to do
    the right thing about local DST.  Also modified by Paul Eggert
    <eggert@cs.ucla.edu> in February 2004 to support
-   nanosecond-resolution time stamps, and in October 2004 to support
+   nanosecond-resolution timestamps, and in October 2004 to support
    TZ strings in dates.  */
 
 /* FIXME: Check for arithmetic overflow in all cases, not just
@@ -1066,8 +1066,8 @@ static table const relative_time_table[] =
 };
 
 /* The universal time zone table.  These labels can be used even for
-   time stamps that would not otherwise be valid, e.g., GMT time
-   stamps in London during summer.  */
+   timestamps that would not otherwise be valid, e.g., GMT timestamps
+   oin London during summer.  */
 static table const universal_time_zone_table[] =
 {
   { "GMT",      tZONE,     HOUR ( 0) }, /* Greenwich Mean */
@@ -1540,9 +1540,9 @@ mktime_ok (struct tm const *tm0, struct tm const *tm1, time_t t)
 {
   if (t == (time_t) -1)
     {
-      /* Guard against falsely reporting an error when parsing a time
-         stamp that happens to equal (time_t) -1, on a host that
-         supports such a time stamp.  */
+      /* Guard against falsely reporting an error when parsing a
+         timestamp that happens to equal (time_t) -1, on a host that
+         supports such a timestamp.  */
       tm1 = localtime (&t);
       if (!tm1)
         return false;
@@ -2034,7 +2034,7 @@ parse_datetime2 (struct timespec *result, char const *p,
             dbg_printf ("warning: using midnight as starting time: 00:00:00\n");
         }
 
-      /* Let mktime deduce tm_isdst if we have an absolute time stamp.  */
+      /* Let mktime deduce tm_isdst if we have an absolute timestamp.  */
       if (pc.dates_seen | pc.days_seen | pc.times_seen)
         tm.tm_isdst = -1;
 
index b060cc7a7b5fc62f6c4e0bf8deeefbbe558fb81b..9402b3fc1c05325bf2eab999daf4ba5f54ae5cb3 100644 (file)
@@ -181,7 +181,7 @@ get_stat_birthtime (struct stat const *st)
      || defined HAVE_STRUCT_STAT_ST_BIRTHTIMENSEC)
   /* FreeBSD and NetBSD sometimes signal the absence of knowledge by
      using zero.  Attempt to work around this problem.  Alas, this can
-     report failure even for valid time stamps.  Also, NetBSD
+     report failure even for valid timestamps.  Also, NetBSD
      sometimes returns junk in the birth time fields; work around this
      bug if it is detected.  */
   if (! (t.tv_sec && 0 <= t.tv_nsec && t.tv_nsec < 1000000000))
index 97fa9d25f0a45fcd6b7bd7575e07ac7882a6f319..86436c2276e598ec80f97bbfa83b118523a44635 100644 (file)
@@ -217,7 +217,7 @@ _GL_CXXALIAS_SYS (gmtime, struct tm *, (time_t const *__timer));
 _GL_CXXALIASWARN (gmtime);
 # endif
 
-/* Parse BUF as a time stamp, assuming FORMAT specifies its layout, and store
+/* Parse BUF as a timestamp, assuming FORMAT specifies its layout, and store
    the resulting broken-down time into TM.  See
    <http://www.opengroup.org/susv3xsh/strptime.html>.  */
 # if @GNULIB_STRPTIME@
index fc7b3d115b77f18c5da9de750c5575d4eccdbde1..a5eca797ce3b5eda275594605022c7485fee4c48 100644 (file)
@@ -29,7 +29,7 @@ _GL_INLINE_HEADER_BEGIN
 # define _GL_TIMESPEC_INLINE _GL_INLINE
 #endif
 
-/* Resolution of timespec time stamps (in units per second), and log
+/* Resolution of timespec timestamps (in units per second), and log
    base 10 of the resolution.  */
 
 enum { TIMESPEC_RESOLUTION = 1000000000 };
@@ -48,7 +48,7 @@ make_timespec (time_t s, long int ns)
 
 /* Return negative, zero, positive if A < B, A == B, A > B, respectively.
 
-   For each time stamp T, this code assumes that either:
+   For each timestamp T, this code assumes that either:
 
      * T.tv_nsec is in the range 0..999999999; or
      * T.tv_sec corresponds to a valid leap second on a host that supports
@@ -56,7 +56,7 @@ make_timespec (time_t s, long int ns)
      * T.tv_sec is the minimum time_t value and T.tv_nsec is -1; or
        T.tv_sec is the maximum time_t value and T.tv_nsec is 2000000000.
        This allows for special struct timespec values that are less or
-       greater than all possible valid time stamps.
+       greater than all possible valid timestamps.
 
    In all these cases, it is safe to subtract two tv_nsec values and
    convert the result to integer without worrying about overflow on
index 1d7745f398a5c761e887f09052750ded5b16e6f1..cd773aefc86ddd3baea121362d52d6f69bd08479 100644 (file)
@@ -1,4 +1,4 @@
-/* utimecmp.c -- compare file time stamps
+/* utimecmp.c -- compare file timestamps
 
    Copyright (C) 2004-2007, 2009-2017 Free Software Foundation, Inc.
 
@@ -56,13 +56,13 @@ enum { SYSCALL_RESOLUTION = 1000 };
 enum { SYSCALL_RESOLUTION = BILLION };
 #endif
 
-/* Describe a file system and its time stamp resolution in nanoseconds.  */
+/* Describe a file system and its timestamp resolution in nanoseconds.  */
 struct fs_res
 {
   /* Device number of file system.  */
   dev_t dev;
 
-  /* An upper bound on the time stamp resolution of this file system,
+  /* An upper bound on the timestamp resolution of this file system,
      ignoring any resolution that cannot be set via utimens.  It is
      represented by an integer count of nanoseconds.  It must be
      either 2 billion, or a power of 10 that is no greater than a
@@ -108,9 +108,9 @@ dev_info_compare (void const *x, void const *y)
    If OPTIONS & UTIMECMP_TRUNCATE_SOURCE, do the comparison after SRC is
    converted to the destination's timestamp resolution as filtered through
    utimens.  In this case, return -2 if the exact answer cannot be
-   determined; this can happen only if the time stamps are very close and
+   determined; this can happen only if the timestamps are very close and
    there is some trouble accessing the file system (e.g., the user does not
-   have permission to futz with the destination's time stamps).  */
+   have permission to futz with the destination's timestamps).  */
 
 int
 utimecmp (char const *dst_name,
@@ -133,7 +133,7 @@ utimecmp (char const *dst_name,
 
   verify (TYPE_IS_INTEGER (time_t));
 
-  /* Destination and source time stamps.  */
+  /* Destination and source timestamps.  */
   time_t dst_s = dst_stat->st_mtime;
   time_t src_s = src_stat->st_mtime;
   int dst_ns = get_stat_mtime_ns (dst_stat);
@@ -141,7 +141,7 @@ utimecmp (char const *dst_name,
 
   if (options & UTIMECMP_TRUNCATE_SOURCE)
     {
-      /* Look up the time stamp resolution for the destination device.  */
+      /* Look up the timestamp resolution for the destination device.  */
 
       /* Hash table for caching information learned about devices.  */
       static Hash_table *ht;
@@ -151,7 +151,7 @@ utimecmp (char const *dst_name,
       struct fs_res *dst_res = NULL;
       struct fs_res tmp_dst_res;
 
-      /* Time stamp resolution in nanoseconds.  */
+      /* timestamp resolution in nanoseconds.  */
       int res;
 
       /* Quick exit, if possible.  Since the worst resolution is 2
@@ -280,13 +280,13 @@ utimecmp (char const *dst_name,
               struct timespec timespec[2];
               struct stat dst_status;
 
-              /* Ignore source time stamp information that must necessarily
+              /* Ignore source timestamp information that must necessarily
                  be lost when filtered through utimens.  */
               src_ns -= src_ns % SYSCALL_RESOLUTION;
 
-              /* If the time stamps disagree widely enough, there's no need
-                 to interrogate the file system to deduce the exact time
-                 stamp resolution; return the answer directly.  */
+              /* If the timestamps disagree widely enough, there's no need
+                 to interrogate the file system to deduce the exact
+                 timestamp resolution; return the answer directly.  */
               {
                 time_t s = src_s & ~ (res == 2 * BILLION ? 1 : 0);
                 if (src_s < dst_s || (src_s == dst_s && src_ns <= dst_ns))
@@ -296,9 +296,9 @@ utimecmp (char const *dst_name,
                   return -1;
               }
 
-              /* Determine the actual time stamp resolution for the
+              /* Determine the actual timestamp resolution for the
                  destination file system (after truncation due to
-                 SYSCALL_RESOLUTION) by setting the access time stamp of the
+                 SYSCALL_RESOLUTION) by setting the access timestamp of the
                  destination to the existing access time, except with
                  trailing nonzero digits.  */
 
@@ -366,12 +366,12 @@ utimecmp (char const *dst_name,
           dst_res->exact = true;
         }
 
-      /* Truncate the source's time stamp according to the resolution.  */
+      /* Truncate the source's timestamp according to the resolution.  */
       src_s &= ~ (res == 2 * BILLION ? 1 : 0);
       src_ns -= src_ns % res;
     }
 
-  /* Compare the time stamps and return -1, 0, 1 accordingly.  */
+  /* Compare the timestamps and return -1, 0, 1 accordingly.  */
   return (dst_s < src_s ? -1
           : dst_s > src_s ? 1
           : dst_ns < src_ns ? -1
index 4d1d044eae905bb6fd813078380733e359e40ff5..11e9d7cf52a83e038a7d4a101ca3fa628914065e 100644 (file)
@@ -1,4 +1,4 @@
-/* utimecmp.h -- compare file time stamps
+/* utimecmp.h -- compare file timestamps
 
    Copyright (C) 2004, 2009-2017 Free Software Foundation, Inc.
 
@@ -26,7 +26,7 @@
 /* Options for utimecmp.  */
 enum
 {
-  /* Before comparing, truncate the source time stamp to the
+  /* Before comparing, truncate the source timestamp to the
      resolution of the destination file system and to the resolution
      of utimens.  */
   UTIMECMP_TRUNCATE_SOURCE = 1
index e2bb702e7dc4244955480c47fab9798602036bff..3643668c3a549327a9cfe41ccbe6836939fdeb66 100644 (file)
@@ -154,14 +154,14 @@ update_timespec (struct stat const *statbuf, struct timespec *ts[2])
   return false;
 }
 
-/* Set the access and modification time stamps of FD (a.k.a. FILE) to be
+/* Set the access and modification timestamps of FD (a.k.a. FILE) to be
    TIMESPEC[0] and TIMESPEC[1], respectively.
    FD must be either negative -- in which case it is ignored --
    or a file descriptor that is open on FILE.
    If FD is nonnegative, then FILE can be NULL, which means
    use just futimes (or equivalent) instead of utimes (or equivalent),
    and fail if on an old system without futimes (or equivalent).
-   If TIMESPEC is null, set the time stamps to the current time.
+   If TIMESPEC is null, set the timestamps to the current time.
    Return 0 on success, -1 (setting errno) on failure.  */
 
 int
@@ -190,7 +190,7 @@ fdutimens (int fd, char const *file, struct timespec const timespec[2])
       return -1;
     }
 
-  /* Some Linux-based NFS clients are buggy, and mishandle time stamps
+  /* Some Linux-based NFS clients are buggy, and mishandle timestamps
      of files in NFS file systems in some cases.  We have no
      configure-time test for this, but please see
      <http://bugs.gentoo.org/show_bug.cgi?id=132673> for references to
@@ -411,7 +411,7 @@ fdutimens (int fd, char const *file, struct timespec const timespec[2])
   }
 }
 
-/* Set the access and modification time stamps of FILE to be
+/* Set the access and modification timestamps of FILE to be
    TIMESPEC[0] and TIMESPEC[1], respectively.  */
 int
 utimens (char const *file, struct timespec const timespec[2])
@@ -419,7 +419,7 @@ utimens (char const *file, struct timespec const timespec[2])
   return fdutimens (-1, file, timespec);
 }
 
-/* Set the access and modification time stamps of FILE to be
+/* Set the access and modification timestamps of FILE to be
    TIMESPEC[0] and TIMESPEC[1], respectively, without dereferencing
    symlinks.  Fail with ENOSYS if the platform does not support
    changing symlink timestamps, but FILE was a symlink.  */
index 7c5ee89fc363b8d04e80a6c81769df6a86836c71..7605747c6bea6084844fbd2f89a33c42684cebb0 100644 (file)
@@ -133,11 +133,11 @@ rpl_utimensat (int fd, char const *file, struct timespec const times[2],
 
 #endif /* !HAVE_UTIMENSAT */
 
-/* Set the access and modification time stamps of FILE to be
+/* Set the access and modification timestamps of FILE to be
    TIMESPEC[0] and TIMESPEC[1], respectively; relative to directory
    FD.  If flag is AT_SYMLINK_NOFOLLOW, change the times of a symlink,
    or fail with ENOSYS if not possible.  If TIMESPEC is null, set the
-   time stamps to the current time.  If possible, do it without
+   timestamps to the current time.  If possible, do it without
    changing the working directory.  Otherwise, resort to using
    save_cwd/fchdir, then utimens/restore_cwd.  If either the save_cwd
    or the restore_cwd fails, then give a diagnostic and exit nonzero.
index 810a3c7796a1abe143f44b302968cebe2f3d31fd..6cea17c493a4d170574f269160c2d7765b46779c 100644 (file)
@@ -1,4 +1,4 @@
-/* xtime -- extended-resolution integer time stamps
+/* xtime -- extended-resolution integer timestamps
 
    Copyright (C) 2005-2006, 2009-2017 Free Software Foundation, Inc.
 
@@ -28,7 +28,7 @@ _GL_INLINE_HEADER_BEGIN
 # define XTIME_INLINE _GL_INLINE
 #endif
 
-/* xtime_t is a signed type used for time stamps.  It is an integer
+/* xtime_t is a signed type used for timestamps.  It is an integer
    type that is a count of nanoseconds -- except for obsolescent hosts
    without sufficiently-wide integers, where it is a count of
    seconds.  */
index 398411e53ba27fea5105b227baf4c0cee1fd8483..c7eee89ce053ebdf4b122a5ff5543fdbaa548a1c 100644 (file)
@@ -1,5 +1,5 @@
 Description:
-compare file time stamps
+compare file timestamps
 
 Files:
 lib/utimecmp.h
index 499e5cc9e869b8efa5171efd92a64f0ac49961a8..069b721d1be633440c3f318449988d4c94bc750b 100644 (file)
@@ -47,7 +47,7 @@ static struct posixtm_test const T[] =
     { "12131415",        13, 1,            0}, /* ??? Dec 13 14:15:00 ???? */
 
     /* These two tests fail on 64-bit Solaris up through at least
-       Solaris 10, which is off by one day for time stamps before
+       Solaris 10, which is off by one day for timestamps before
        0001-01-01 00:00:00 UTC.  */
     { "000001010000.00", 13, 1,
                       - INT64_C (62167219200)},/* Sat Jan  1 00:00:00 0    */