Documentation/bup-tick.md

   1 % bup-tick(1) Bup %BUP_VERSION%
   2 % Avery Pennarun <apenwarr@gmail.com>
   3 % %BUP_DATE%
   4
   5 # NAME
   6
   7 bup-tick - wait for up to one second
   8
   9 # SYNOPSIS
  10
  11 bup tick
  12
  13 # DESCRIPTION
  14
  15 `bup tick` waits until `time`(2) returns a different value
  16 than it originally did.  Since time() has a granularity of
  17 one second, this can cause a delay of up to one second.
  18
  19 This program is useful for writing tests that need to
  20 ensure a file date will be seen as modified.  It is
  21 slightly better than `sleep`(1) since it sometimes waits
  22 for less than one second.
  23
  24 # EXAMPLES
  25
  26     $ date; bup tick; date
  27     Sat Feb  6 16:59:58 EST 2010
  28     Sat Feb  6 16:59:59 EST 2010
  29
  30 # BUP
  31
  32 Part of the `bup`(1) suite.