This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Time-HiRes: explicit clockid_t cast for C++11
[perl5.git] / dist / Time-HiRes / Changes
1 Revision history for the Perl extension Time::HiRes.
2
3 1.9740_01 [2016-10-01]
4   - explicit cast to clockid_t needed for C++11 (gcc 6, clang 3.9)
5
6 1.9740 [2016-09-25]
7   - the ext3/ext2 filesystems do not have subsecond resolution,
8     therefore skip the t/utime.t test
9     [rt.cpan.org #116127]
10
11 1.9739 [2016-06-28]
12   - the upcoming macOS 10.12 (Sierra, the operating system formerly
13     known as OS X, or Darwin) has implemented the clock_gettime()
14     and clock_getres() interfaces but not the clock_nanosleep()
15
16 1.9738 [2016-06-26]
17   - fix the dates in the Changes, it's not July yet
18     [rt.cpan.org #115553]
19   - in cygwin, drop the utime.t expected timestamp resolution
20   - documented for utime that the actual timestamp resolution depends
21     on the operating system and the filesystem, just like for stat
22   - looks like in gnukfreebsd 10.1 neither futimens or utimensat work
23     even though they exist, skipping utime tests there for now
24   - demodernize the Test::More use in utime.t (no subtest) to
25     better support older Perl installations
26   - for all the tests, drop the Test::More 0.82 requirement,
27     the only "modern" thing used is the note routine which
28     can be replaced with print("# ...\n") (or printf),
29     with this works back at least with Test::More 0.54 (perl 5.8.7) 
30
31 1.9737 [2016-06-22]
32   - utime in HiRes.xs had dXSARGS which was unnecessary, leading
33     to two markstack pops, panic, and two-minute wait for the watchdog
34     (thanks to Dave Mitchell for the eagle-eye)
35   - even though 5.10.x should have the Perl_ck_warner, many CPAN
36     smokes proved otherwise, so requiring now at least 5.12 for
37     Perl_ck_warner use in IS_SAFE_PATHNAME() 
38
39 1.9736 [2016-06-22]
40   - the IS_SAFE_PATHNAME() emulation was too modern for Perl 5.10
41   - make it so that only one value is set for -DTIME_HIRES_STAT
42     even on systems that support many options
43   - the 1.9734 (only released in blead, and as part of the development
44     release 5.25.2) fix for Darwin's clock_gettime was wrong under
45     threaded builds, leading into mutex panics in clock.t 
46   - the d_hires_utime determination was made more precise
47   - the utime.t was failing in platforms where only one of
48     futimens/utimensat was present (neither or both was okay)
49
50 1.9735 [2016-06-20]
51   - Time::HiRes should override `utime` to allow setting hires
52     (futimens and utimensat support)
53     [rt.perl.org #114809]
54   - the utime patch used IS_SAFE_PATHNAME() which isn't available in
55     too old Perls, so emulate (in case the Devel::PPPort is too old)
56
57 1.9734 [2016-06-17]
58   - fix Darwins with clock_gettime: blead 2d41a263
59     [rt.perl.org #128427]
60
61 1.9733 [2016-04-23]
62   - C90 declaration-after-statement error with darwin threads: blead de1003b4
63     [rt.cpan.org #113856]
64
65 1.9732 [2016-03-13]
66   - MUTEX_LOCK, not PERL_MUTEX_LOCK: blead e5b02b5d
67   - also hrt_ualarm_itimer() is unused: 1cb6cce3
68   - the mutex needs init: 2d639e20
69   - version bump to 1.9732: 730d7fdc
70
71 1.9731 [2016-03-13]
72   - mark unused variable as such: blead a914236c
73   - OS X emulation mutex accidentally unused: da7a6455
74   - remove hrt_ualarm: 6da77c36
75   - pod error fixes: 919ca095
76   - nanosleep and clock_nanosleep cleanups: c8ea02b8..e3ff671b
77   - static funcs in HiRes.xs: 4e922c26
78   - Remove unused variable: 52ffb1b5
79
80 1.9730 [2016-02-17]
81   - TIME_HIRES_DONT_RUN_PROBES=1 to build the probes but not run them
82     [rt.cpan.org #111391]
83
84 1.9729 [2016-02-13]
85   - new constants
86     [rt.cpan.org #111170]
87   - clock_getres(), clock_gettime(), clock_nanosleep() emulation for OS X
88     [rt.cpan.org #78566]
89
90 1.9728 [2015-11-13]
91   - No changes since 1.9727_03
92
93 1.9727_03 [2015-11-06]
94   - use PERL_UNUSED_ARG() in the not-here-croak branches
95   - Makefile.PL/metadata improvements
96
97 1.9727_02 [2015-08-29]
98   - correct documentation to note that Time::NVtime is NV, not double
99     [perl #123879]
100   - avoid a warning about clock_t on OS X / clang 3.6 - 3.6
101     [rt.cpan.org #102718]
102
103 1.9727_01 [2015-08-17]
104   - Remove usage of 5.005 thread APIs in favor of 5.6 and up thread APIs
105     [rt.cpan.org #102799].
106   - Silence a C++ compiler warning [rt.cpan.org #101497].
107   - respect $Config{run} for cross-compiling [rt.cpan.org #92607]
108
109 1.9726 [2013-08-17]
110         - Correct s/us splitting of usleep(1000000) [rt.cpan.org #78266].
111         - Avoid integer overflow in itimer-based alarm() with large
112           argument [rt.cpan.org #87160].
113         - Define PERL_NO_INLINE_FUNCTIONS during probe compilations, to
114           avoid false negatives caused by not linking with the perl core.
115         - Be more careful about context in stat().
116         - Install into "site" directories by default on perl 5.11+
117           [rt.cpan.org #79797].
118         - Fix a couple of doc typos [rt.cpan.org #85365].
119         - Fix function name in a doc example [rt.cpan.org #86318].
120         - Provide lstat() that yields high-res timestamps, alongside
121           the existing high-res stat() [rt.cpan.org #78732].
122
123 1.9725 [2012-02-01]
124         - Correct stack discipline in stat(), which was screwing up list
125           operations in expressions containing calls to it [rt.cpan.org
126           #72926].
127         - Add missing OUTPUT sections to the XS code [rt.cpan.org #70930].
128         - Skip itimer tests on GNU/Hurd, which has the API but lacks
129           the implementation [rt.cpan.org #72754].
130         - Fix a doubled word in the documentation [rt.cpan.org #72763].
131
132 1.9724 [2011-06-09]
133         - Correct XS parameter list, and therefore prototype, for
134           unimplemented-on-this-platform version of clock_nanosleep()
135           [rt.cpan.org #68700].
136         - Declare package variables with "our" rather than "use vars".
137         - Corresponding to "our" usage, check for minimum Perl version
138           5.006.
139         - Declare module dependencies.
140
141 1.9723 [2011-06-07]
142         - Remove $ENV{PERL_CORE} logic from test suite, which is no
143           longer desired in the core.
144         - Convert test suite to use Test::More.
145         - Factor out watchdog code from test suite.
146         - In test suite, be consistent about using fully-qualified form
147           of function names.
148         - Divide test suite into feature-specific scripts.
149         - Make ualarm timing test less vulnerable to delay-induced false
150           failure, from Dave Mitchell.
151
152 1.9722 [2011-05-18]
153         - Update for changes in build process in the core, patches
154           from BinGOs [rt.cpan.org #58858] and Craig Berry [rt.cpan.org
155           #63363].
156         - Fix broken linkage on Windows with gcc 3.4 seen with ActivePerl,
157           report from Christian Walde [rt.cpan.org #61648], fix derived
158           from Vincent Pit.
159         - Jump through hoops to avoid compiler warnings.
160
161 1.9721 [2010-03-17]
162         - Address [rt.cpan.org #54196] alarm and ularm return values are bogus,
163           additional fix from Gisle Aas
164         - Address [rt.cpan.org #55665] "Bad plan" on Windows,
165           report and fix from Jan Dubois
166
167 1.9720 [2010-02-14]
168         - Address [rt.cpan.org #54196] alarm and ularm return values are bogus,
169           report and fix from Nicholas Clark
170
171 1.9719  [2009-01-04]
172         - As with QNX, Haiku has the API of interval timers but not
173           the implementation (bleadperl change #34630), hence skip
174           the tests, via David Mitchell.
175
176 1.9718  [2008-12-31]
177         - .xs code cleanup from Albert Dvornik
178         - in the #39 and #40 do not do us I did, mixing alarm() and
179           sleep().  Now instead spin until enough time has passed.
180
181 1.9717  [2008-12-30]
182         - Skip the tests added in 1.9716 (#39, #40) if there's no subsecond
183           alarm capability, like with the older subsecond alarm tests
184
185 1.9716  [2008-12-26]
186         - Change documentation to agree with reality: there are
187           no interval timers in Win32.
188         - Address [rt.cpan.org #35899] (problem in subsecond sleeps),
189           add two tests to guard against this problem
190         - Address [rt.cpan.org #36600] 'Division by zero' failure in test suite
191         - Address [rt.cpan.org #37340] [PATCH] Address timer process in test
192         - Address [rt.cpan.org#40311 ] bad implementation of hrt_usleep
193           with TIME_HIRES_NANOSLEEP
194
195 1.9715  [2008-04-08]
196         - Silly me: Makefile.PL does need to accept arguments other than mine.
197           Some testing frameworks obviously do this.
198         - Add retrying for tests 34..37, which are the most commonly
199           failing tests.  If this helps, consider extending the retry
200           framework to all the tests.  [Inspired by Slaven Rezic,
201           [rt.cpan.org #34711] Occasional failures of test 35 or 36 (FreeBSD)]
202
203 1.9714  [2008-04-07]
204         - Under Perl 5.6.* NVgf needs to be "g", reported by Zefram,
205           it seems that ppport.h 3.13 gets this wrong.
206         - remove the check in Makefile.PL for 5.7.2, shouldn't be
207           (a) necessary (b) relevant
208         - add logic to Makefile.PL to skip configure/write Makefile
209           step if the "xdefine" file already exists, indicating that
210           the configure step has already been done, one can still
211           force (re)configure by "perl Makefile.PL configure",
212           or of course by "make clean && perl Makefile.PL".
213
214 1.9713  [2008-04-04]
215         - for alarm() and ualarm() [Perl] prefer setitimer() [C]
216           instead of ualarm() [C] since ualarm() [C] cannot portably
217           (and standards-compliantly) be used for more than 999_999
218           microseconds (rt.cpan.org #34655)
219         - it seems that HP-UX has started (at least in 11.31 ia64)
220           #defining the CLOCK_REALTIME et alia (instead of having
221           them just as enums)
222         - document all the diagnostics
223
224 1.9712  [2008-02-09]
225         - move the sub tick in the test file back to where it used to be
226         - in the "consider upgrading" message recommend at least Perl 5.8.8
227           and make the message to appear only for 5.8.0 since 5.8.1 and
228           later have the problem fixed
229         - VOS tweak for Makefile (core perl change #33259)
230         - since the test #17 seems to fail often, relax its limits a bit
231
232 1.9711  [2007-11-29]
233         - lost VMS test skippage from Craig Berry
234         - reformat the test code a little
235
236 1.9710  [2007-11-29]
237         - I got the sense of the QNX test the wrong way in an attempt
238           to generalize it for future
239
240 1.9709  [2007-11-28]
241         - casting fixes from Robin Barker for g++ and 64bitint
242         - in QNX skip the itimer tests because though the API
243           is there, the implementation isn't, from Matt Kraai
244         - raise the dead man timer to 180 seconds for really
245           slow/busy systems
246         - elaborate the UTF-8 locale warning from Makefile.PL
247
248 1.9708  [2007-10-05]
249         - [rt.cpan.org #29747]: Build failure with perl 5.005_05
250           Fixed by regenerating the ppport.h using Devel::PPPort 3.13.
251
252 1.9707  [2007-02-27]
253         - t/HiRes.t failed in Perl 5.6.2,
254           "action is not of type POSIX::SigAction at t/HiRes.t line 318",
255           reported and fixed by Anton Berezin, the reason was faulty
256           use of sigaction() when restoring the old action.
257
258 1.9706  [2007-02-25]
259         - with bleadperl in VMS the HiRes.t overrun the maximum number
260           of deferred signals because the libc SIGALRM was not strong
261           enough to interrupt select(), and select() got restarted every
262           time, solution is to use POSIX::SigAction if available.
263           A fix from Craig Berry (not 100% there, but helps).
264         - allow for more measuring noise for ualarm() tests 35..37
265
266 1.9705  [2007-02-06]
267         - nanosleep() and clock_nanosleep() detection and use were
268           quite broken; in Linux -lrt needed; fixes from Zefram
269         - [internal] slightly cleaner building of $DEFINE in Makefile.PL,
270           should avoid double/conflicting -D flags
271
272 1.9704  [2007-01-01]
273         - allow 10% of slop in test #14 (testing difference between
274           CORE::time() and Time::HiRes::time()), there seem to be often
275           transient failures from Perl smoke builds on this test
276         - small pod tweaks
277
278 1.9703  [2006-12-08]
279         - use int main(int argc, char **argv) consistently in Makefile.PL,
280           should help with
281           [rt.cpan.org #23868] nanosleep not detected under Mac OS 10.3.9 starting with Time::HiRes 1.96
282         - if someone still has the locale-broken Perl 5.8.0,
283           suggest that they upgrade their Perl
284
285 1.9702  [2006-12-06]
286         - restore the -DATLEASTFIVEOHOHFIVE, Win32 needed it still
287
288 1.9701  [2006-12-04]
289         - upgrade to ppport.h 3.10_02
290         - remove the -DATLEASTFIVEOHOHFIVE
291         - use the ppport.h PL_ppaddr, PL_statcache, PL_laststatval
292         - use the ppport.h aTHXR for calling Perl stat()
293         - switch into four-digit version since 2.0 is coming up
294           awfully fast but not feeling like a major rewrite
295
296 1.97    [2006-11-30]
297         - 1.95 broke building in Win32 (since pp_stat is not exported),
298           figured out how to call an op directly in 5.005 (use Perl_ppaddr
299           instead of PL_ppaddr)
300         - backport to Perl 5.004_05  (requires using statcache
301           and laststatval instead of PL_statcache and PL_laststatval)
302           (also checked to work in 5.005_04, 5.6.1, and 5.8.8 with threads)
303
304 1.96    [2006-11-30]
305         - 1.95 broke builds for threaded Perls, rt.cpan.org tickets:
306           [rt.cpan.org #23694] Time::HiRes fails tests on Solaris and Perl 5.6.1
307           [rt.cpan.org #23712] Time-HiRes 1.95 Fails make on AIX 5.2 with Perl 5.8.8
308           [rt.cpan.org #23730] Time::HiRes 1.95 fails make on MacOS X 10.3.9/perl 5.8.8
309         - use main() prototype consistently in Makefile.PL
310
311 1.95    [2006-11-29]
312         - integrate core change #29180: Silence VC++ compiler warnings
313           from Steve Hay
314         - do not use PL_ppaddr in stat() because that is not available
315           in Perl 5.005_04
316         - regenerate fallback/*.inc for older Perls without
317           ExtUtils::Constant because of d_hires_stat, resolves
318           [rt.cpan.org #23694] Time::HiRes fails tests on Solaris and Perl 5.6.1
319         - Make Makefile.PL more defensive against false PERL_CORE
320
321 1.94    [2006-10-16]
322         - file timestamps oddities seen: the atime and mtime
323           can be out of sync (modify first and read second can leave
324           atime < mtime) and mtime can be subsecond while atime is not.
325           So make the test more forgiving.
326
327 1.93    [2006-10-15]
328         - the ualarm() tests (34-37) assumed that ualarm(N)
329           could never alarm in less than N seconds, widened
330           the acceptable relative range to 0.9..1.5.  Addresses
331           [rt.cpan.org #22090] and [rt.cpan.org #22091].
332
333         - skip the stat() tests in cygwin and win32, because
334           if run on FAT the timestamp granularity is only 2 seconds.
335           Any good way to detect (cygwin or win32) whether we are
336           being run on NTFS or anywhere with better timestamps?
337           Addresses [rt.cpan.org #22089] and [rt.cpan.org #22098].
338
339 1.92    [2006-10-13]
340         - scan for subsecond resolution timestamps in struct stat,
341           some known possibilities:
342
343           (1)  struct  timespec st_atimespec;
344                                 st_atimespec.tv_nsec;
345           (2)  time_t  st_atime;
346                long    st_atimensec;
347           (3)  time_t  st_atime;
348                int     st_atime_n;
349           (4)  timestruc_t st_atim;
350                            st_atim.tv_nsec
351           (5)  time_t  st_atime;
352                int     st_uatime;
353
354           If something like this is found, one can do
355
356             use Time::HiRes;
357             my @stat = Time::HiRes::stat();
358
359           or even override the standard stat():
360
361             use Time::HiRes qw(stat);
362
363           to get the stat() timestamps
364
365             my ($atime, $mtime, $ctime) = @stat[8, 9, 10];
366
367           with subsecond resolution (assuming both the operating
368           system and the filesystem support that kind of thing).
369
370           Contributions for more systems (especially non-UNIX,
371           e.g. but not limited to: Win32, VMS, OS/2) gladly accepted.
372           (also more UNIX variants welcome: HP-UX? IRIX?)
373
374           Thanks to H.Merijn Brand, John Peacock, and Craig
375           Berry for brave beta testing.
376
377 1.91    [2006-09-29]
378         - ualarm() in SuSE 10.1 was overflowing after ~4.2 seconds,
379           possibly due to a glibc bug/feature (suspected overflow at
380           2**32 microseconds?), workaround by using the setitimer()
381           implementation of ualarm() if either useconds or
382           interval > 999_999 (this case seems to vary between systems:
383           are useconds more than 999_999 for ualarm() defined or not)
384           Added more ualarm() tests to catch various overflow points,
385           hopefully no problems in various platforms.
386           (The problem report by Mark Seger and Jon Paul Sullivan of HP.)
387
388 1.90    [2006-08-22]
389         - tweak still needed for Const64(), from Jerry Hedden
390         - get a freshly generated ppport.h
391         - update Copyright years
392
393 1.89    [2006-08-22]
394         - Const64() already appends an 'LL' (or i64), so provide LL and i64
395           forms for the IV_1E[679] (effects Win32 and Cygwin), reported by
396           Jerry Hedden.
397         - the Changes entry for 1.88 talked about [IN]V_1[679],
398           missing the 'E'.
399
400 1.88    [2006-08-21]
401         - clean up the g++ warnings in HiRes.xs, all of them
402           about mixing integer and floating point, introduce
403           constants IV_1E[679] and NV_1E[679]
404
405 1.87    [2006-02-13]
406         - [rt.cpan.org #17442] 'make test' frequently fails under
407           Cygwin Perl v5.8.8, reported and patched by J. R. Hedden
408           (two race condition bugs in the END block in the case the
409            main process dies before the timer process, unearthed
410            by a bug in Cygwin ualarm)
411
412 1.86    [2005-12-17]
413         - HiRes.t:s/ok 32/ok 33/, from Dominic Dunlop
414         - tighten up the clock() test marginally by requiring non-negative
415         - clock_nanosleep() and clock() doc tweaks
416
417 1.85    [2005-12-16]
418         - the interface to clock_nanosleep() is more natural
419           when it is like (hires) time() (instead of like nanosleep),
420           and the .xs implementation of clock_nanosleep() in 1.84
421           was broken anyway
422         - the semantics of clock() are not quite so silly as I thought,
423           but still somewhat odd, documented as such
424         - additional enhancements to the clock() documentation
425         - add test for clock_nanosleep() (I cannot test this
426           since none of my systems have the function)
427         - add test for clock()
428
429 1.84    [2005-12-16]
430         - add clock() which returns the processor time in
431           (floating point) seconds since an arbitrary era
432         - add clock_nanosleep() which suspends the current
433           thread until either absolute time or for relative time
434         - [rt.cpan.org #16486] printf missing value in HiRes.t
435         - add constants CLOCKS_PER_SEC, CLOCK_SOFTTIME, TIMER_ABSTIME
436         - tiny typo fixes
437
438 1.83    [2005-11-19]
439         - has_symbol() was wrong since e.g. ITIMER_VIRTUAL is exported
440           via @EXPORT_OK even when it is not available.  This is heinous.
441           @EXPORT_OK should be determined at Makefile.PL time.
442         - be more lenient is testing clock_gettime(): allow more slop,
443           and retry up to three times, sleeping a random nap between
444           the retries
445         - human months are one-based (noticed by Anton Berezin)
446
447 1.82    [2005-10-06]
448         - CLOCK_REALTIME is an enum value (of the clockid_t enum)
449           in HP-UX (and might be so elsewhere, too), debugged by
450           H. Merijn Brand
451         - include const-c.inc as late as possible (from Randy Kobes,
452           [rt.cpan.org #15552] to avoid undefined usleep() on Win32
453
454 1.81    [2005-11-05]
455         - try to be more robust and consistent in the detection of
456           CLOCK_REALTIME and ITIMER_VIRTUAL in HiRes.t: the proper
457           way is
458
459                 sub has_symbol {
460                     my $symbol = shift;
461                     eval 'import Time::HiRes qw($symbol)';
462                     return 0 unless $@ eq '';
463                     return exists ${"Time::HiRes::$symbol"};
464                 }
465
466           and then use
467
468                 &FOO_BAR
469
470           in the test.  All these moves are needed because
471
472           1) one cannot directly do eval 'Time::HiRes::FOO_BAR'
473              because FOO_BAR might have a true value of zero
474              (or in the general case an empty string or even undef)
475
476           2) In case FOO_BAR is not available in this platform,
477              &FOO_BAR avoids the bareword warning
478
479         - wait more (1.5 seconds instead of 0.1) for the CLOCK_REALTIME test
480           but expect the 'customary' slop of 0.20 instead of 0.25
481         - fixed inside a comment HAS_POLL -> TIME_HIRES_NANOSLEEP
482         - at the end of HiRest.t tell how close we were to termination
483
484 1.80    [2005-11-04]
485         - Gisle noticed a mistake (using HAS_NANOSLEEP) in 1.79
486
487 1.79    [2005-11-03]
488         - try nanosleep for emulating usleep -- may help in some weird
489           embedded realtime places which have nanosleep but neither usleep
490           nor select nor poll (doesn't have to be weird embedded realtime
491           place, though -- in many places usleep is nanosleep anyway)
492         - try poll for emulating usleep -- this may help some obscure/old
493           SVR4 places that have neither usleep nor select
494         - a redundant test guard in HiRes.t
495
496 1.78    [2005-11-03]
497         - ITIMER_VIRTUAL detection in HiRes.t had problems (that we cannot
498           in the general case fail already at 'use' phase is suboptimal)
499         - fixes to the documentation of clock_gettime() and clock_getres()
500
501 1.77    [2005-11-03]
502         - add support for the POSIX clock_gettime() and clock_getres(),
503           if available, either as library calls or as syscalls
504         - be more defensive about missing functionality: break out
505           early (during 'use') if no e.g. clock_getres() is available,
506           and protect our back by trapping those cases also in HiRes.xs
507         - the test added in 1.76 could cause an endless loop e.g. in Solaris,
508           due to mixing of sleep() and alarm() (bad programmer, no cookie!)
509
510 1.76    [2005-10-22]
511         - testing for nanosleep had wrong logic which caused nanosleep
512           to become undefined for e.g. Mac OS X
513         - added a test for a core dump that was introduced by Perl 5.8.0
514           safe signals and was fixed for the time of 5.8.1 (one report of
515           the core dump was [perl #20920]), the test skipped pre-5.8.1.
516         - *cough* s/unanosleep/nanosleep/g; *cough*
517
518 1.75    [2005-10-18]
519         - installation patch from Gisle Aas: in Perls 5.8.x and later
520           use MakeMaker INSTALLDIRS value of 'perl' instead of 'site'.
521
522 1.74    [2005-09-19]
523         - [cpan #14608] Solaris 8 perl 5.005_03 File::Spec module does not have method rel2abs
524           (the workaround is not to use rel2abs, should not be necessary)
525         - [cpan #14642] U2time wrongly exported on the C API
526           (patch supplied by the reporter, SALVA@cpan.org)
527         - add release dates to Changes
528
529 1.73    [2005-08-16]
530         - Time::HiRes::nanosleep support for Solaris [PATCH]
531           (POSIX::uname() not available if building with core perl,
532            from Gisle Aas, via perl5-porters, perl change #25295)
533
534 1.72    [2005-07-01]
535         - going back to the 1.68 loader setup (using DynaLoader)
536           since too many weird things starting breaking
537         - fix a typo in José Auguste-Etienne's name
538
539 1.71    [2005-06-28]
540         - a thinko in the nanosleep() detection
541         - move more changes stuff from the README to Changes
542         - add -w to the Makefile.PL
543
544 1.70    [2005-06-26]
545         - oops in 1.69 about @ISA (not affecting anything but silly)
546         - add copyright 2005 to HiRes.pm
547         - add copyright and license to HiRes.xs
548         - add copyrights 2003, 2004, 2005 to README
549
550 1.69    [2005-06-25]
551         - actually run a test for nanosleep
552           (if there is no $Config{d_nanosleep}) since e.g. in AIX 4.2
553           it seems that one can link in nanosleep() but then calling
554           it fails instantly and sets errno to ENOSYS (Not implemented).
555           This may be fixable in the AIX case by figuring out the right
556           (realtime POSIX?) libs and whatnot, but in the general case
557           running a real test case is better.  (Of course, this change
558           will no doubt run into portability problems because of the
559           execution step...)  Note that because of hysterical raisins
560           most Perls do NOT have $Config{d_nanosleep} (scanning for
561           it by Configure would in many platforms require linking in
562           things like -lrt, which would in many platforms be a bad idea
563           for Perl itself).
564           (from José Auguste-Etienne)
565         - support XSLoader also since it's much faster
566           (from Alexey Tourbin)
567         - add SEE ALSO (BSD::Resource and Time::TAI64)
568
569 1.68    [2005-05-14]
570         - somehow 1.67 had a lot of doubled lines (a major cut-and-paste
571           error suspected), but miraculously it still worked since the
572           doubling took place below the __END__ token
573         - undef Pause() before defining it to avoid redefinition warnings
574           during compilation in case perl.h had already defined Pause()
575           (part of perl change #24271)
576         - minor doc tweaks
577
578 1.67    [2005-05-04]
579         - (internal) don't ignore the return value of gettimeofday()
580         - (external) return undef or an empty if the C gettimeofday() fails
581           (affects Time::HiRes gettimeofday() and the hires time())
582
583 1.66    [2004-12-19]
584         - add nanosleep()
585         - fix the 'hierachy' typo in Makefile.PL [rt.cpan.org #8492]
586         - should now build in Solaris [rt.cpan.org #7165] (since 1.64)
587         - should now build in Cygwin [rt.cpan.org #7535] (since 1.64)
588         - close also [rt.cpan.org #5933] "Time::HiRes::time does not
589           pick up time adjustments like ntp" since ever reproducing it
590           (and therefore verifying a possible fix) in the same environment
591           has become rather unlikely
592
593 1.65    [2004-09-18]
594         - one should not mix u?alarm and sleep (the tests modified
595           by 1.65, #12 and #13, hung in Solaris), now we just busy
596           loop executing an empty block
597         - in the documentation underline the unspecificity of mixing
598           sleeps and alarms
599         - small spelling fixes
600
601 1.64    [2004-09-16]
602         - regenerate ppport.h with Devel::PPPort 3.03,
603           now the MY_CXT_CLONE is defined in ppport.h,
604           we no more need to do that.
605
606         - the test #12 would often hang in sigsuspend() (at least that's
607           where Mac OS X' ktrace shows it hanging).  With the sleep()s
608           changed to sleep(1)s, the tests still pass but no hang after
609           a few hundred repeats.
610
611 1.63    [2004-09-01]
612         - Win32 and any ithread build: ppport.h didn't define
613           MY_CXT_CLONE, which seems to be a Time-HiRes-ism.
614
615 1.62    [2004-08-31]
616         - Skip testing if under PERL_CORE and Time::HiRes has not
617           been Configured (from Marcus Holland-Moritz, core change
618           #23246)
619         - Use ppport.h generated by Devel::PPPort 3.01,
620           allowing cutting away our own portability code.
621         - Don't use $ENV{PERL_CORE} for < 5.6.0.
622         - Don't use "for my $i" for <= 5.003.
623         - Don't use Pause() for <= 5.003.
624         - Can't use newSVpvf for <= 5.003.
625         (most of the changes from Marcus)
626
627 1.61    [2004-08-21]
628         - Win32: reset reading from the performance counters every
629           five minutes to better track wall clock time (thanks to
630           PC timers being often quite bad), should help long-running
631           programs.
632
633 1.60    [2004-08-15]
634         - Win32: Patch from Steve Hay
635           [PATCH] Re: [perl #30755] [Win32] Different results from Time::HiRes::gettimeofdayunder the debugger
636           to [perl #30755] reported by Nigel Sandever
637
638         - Cygwin: Use the Win32 recalibration code also in Cygwin if the
639           <w32api/windows.h> APIs are available.  Cygwin testing by
640           Yitzchak Scott-Thoennes.
641
642         - Solaris: use -lposix4 to get nanosleep for Solaris 2.6,
643           after that keep using -lrt, patch from Alan Burlison,
644           bug reported in [cpan #7165]
645
646 1.59    [2004-04-08]
647         - Change the Win32 recalibration limit to 0.5 seconds and tweak
648           the documentation to blather less about the gory details of the
649           Win32 implementation and more about the complications in general
650           of meddling with the system clock.
651
652 1.58    [2004-04-08]
653         - Document the 1.57 change better.
654
655 1.57    [2004-07-04]
656         - Win32/Cygwin/MinGW: if the performance counter drifts by more
657           than two seconds from the system clock (due to ntp adjustments,
658           for example), recalibrate our internal counter: from Jan Dubois,
659           based on [cpan #5933] by Jerry D. Hedden.
660
661 1.56    [2004-29-02]
662         - Give a clearer message if the tests timeout (perl change #22253)
663         - Don't use /tmp or its moral equivalents (perl bug #15036,
664           perl change #22258)
665
666 1.55    [2004-01-14]
667         - Windows: mingw32 patch from Mike Pomraning (use Perl's Const64()
668           instead of VC-specific i64 suffix)
669
670 1.54    [2003-12-31]
671         - Solaris: like Tru64 (dec_osf) also Solaris need -lrt for nanosleep
672
673 1.53    [2003-12-30]
674         - Windows: higher resolution time() by using the Windows
675           performance counter API, from Jan Dubois and Anton Shcherbinin.
676           The exact new higher resolution depends on the hardware,
677           but it should be quite a bit better than using the basic
678           Windows timers.
679
680 1.52    [2003-10-28]
681         - In AIX (v?) with perl 5.6.1 the HiRes.t can hang after
682           the subtest 18.  No known analysis nor fix, but added
683           an alarm (that requires fork() and alarm()) to the test.
684
685 1.51    [2003-09-22]
686         - doc tweaks from mjd (perl change #20456)
687         - NCR MP-RAS hints file added (svr4.pl) (perl change #21249)
688
689 1.50    [2003-08-02]
690         - add a message (for non-core builds) to Makefile.PL about
691           the LC_ALL=C workaround
692         - &Time::HiRes::d_nanosleep was broken (perl change #20131)
693         - the nanosleep() probe was broken (perl change #20061)
694         - use existence instead of definedness for feature probes
695           (perl change #20043)
696         - MPE/iX tweak (perl change #20042)
697         - do not use HAS_NANOSLEEP (perl change #19898)
698
699 1.49    [2003-06-23]
700         - UVuf for non-IVSIZE platforms (from Keiichiro Nagano)
701         - OS/2 can always mix subsecond sleeps with signals
702           (part of perl change #19789)
703
704 1.48    [2003-06-04]
705         - workaround for buggy gcc 2.95.3 in openbsd/sparc64
706           (perl change #19592)
707
708 1.47    [2003-05-03]
709         - do not use -lrt in Linux (from March Lehmann, perl change #19449)
710                 - unnecessary (nanosleep is in libc anyway)
711                 - harmful (-lrt slows down execution)
712                 - incompatible (with many distributions' pthreads)
713
714 1.46    [2003-04-25]
715         - do not create files in blib directories under core
716           (perl change #19160, from rgs)
717         - detypo s/VTLARM/VTARLM/ (perl change #19328, from mjd)
718
719 1.45    [2003-04-01]
720         - guarantee that $xdefine in HiRes.t is always defined
721           (perl change #19109, from IlyaZ)
722         - a cleaner way to detect PERL_CORE (perl change #19111,
723           from IlyaZ)
724
725 1.44    [2003-03-30]
726         - add hints/irix.pl to turn off overly POSIX flags that
727           cause hide struct timespec to be hidden (and compilation
728           to fail) (bleadperl change #19085)
729         - documentation tweaks
730
731 1.43    [2003-03-11]
732         - add c:/temp to the list of temp directories to probe
733           so that cygwin (and win*?) builds are happy.  This was
734           needed at least in my cygwin 1.3.20/w2k setup.
735
736 1.42    [2003-01-07]
737         - modernize the constants code (from Nicholas Clark)
738
739 1.41    [2003-01-03]
740         - At some point the ability to figure our the correct incdir
741           for EXTERN.h (either a core perl build, or an installed perl)
742           had broken (which lead into all test compiles failing with
743           a core perl build, but thanks to the robustness of Makefile.PL
744           nothing of this was visible).  The brokenness seemed to be
745           caused by $ENV{PERL_CORE} not being on for core builds?
746           Now stole a trick from the Encode that sets $ENV{PERL_CORE}
747           right, and both styles of build should work again.
748
749 1.40    [2003-01-03]
750         - Nicholas Clark noticed that the my_catdir() emulation function
751           was broken (which means that we didn't really work for Perls
752           5.002 and 5.003)
753         - inspired by fixing the above made the whole Makefile.PL -w
754           and strict clean
755         - tightened up the Makefile.PL output, less whitespace
756
757 1.39    [2003-10-20]
758         - fix from Craig Berry for better building in VMS with PERL_CORE
759
760 1.38    [2003-10-13]
761         - no functional changes
762         - move lib/Time/HiRes.pm as Hires.pm
763         - libraries scanning was slightly broken (always scanned
764           for a library even when $Config{libs} already had it)
765
766 1.37    [2003-09-23]
767         - Ray Zimmerman ran into a race condition in Mac OS X.
768           A 0.01-second alarm fired before the test expected.
769           The test first slept indefinitely (blocking for signals)
770           and only after that tested for the signal having been sent.
771           Since the signal had already been sent, the test #12 never
772           completed.  The solution: test first, then block.
773         - default to being silent on all probing attempts, set the
774           environment variable VERBOSE to a true value to see the
775           details (the probing command and the possible errors)
776
777 1.36    [2003-09-12]
778         - do not clear MAN3PODS in Makefile.PL (Radoslaw Zielinski)
779         - INSTALLDIRS => 'perl' missing which means that Time::HiRes
780           cannot be upgraded from CPAN to override the 5.8.0 version
781           (Guido A. Ostkamp)
782         - Time::HiRes 1.35 could not be dropped as-is to bleadperl
783           because the include directories did not adjust themselves
784           if $ENV{PERL_CORE} (Hugo van der Sanden)
785         - add documentation about the restart of select() under alarm()
786
787 1.35    [2003-08-24]
788         - small documentation tweaks
789
790
791 1.34    [2003-08-22]
792         - better VMS operation (Craig Berry)
793
794 1.33    [2003-08-20]
795         - our time machine is accelerating: now works with Perl 5.004_01
796           (tried with 5.003_07 and 5.002 but I get segmentation faults
797            from running the Makefile.PL with those in Tru64 4.0D)
798
799 1.32    [2003-08-20]
800         - backward compatibility (pre-5.6.0) tweaks:
801           - no XSLoader in 5.00503, use DynaLoader instead
802           - no SvPV_nolen, either
803           - no PerlProc_pause(), either
804           - now tested with 5.00404 and 5.00503
805           - Makefile.PL requires 5.00404 (no more 5.002)
806         - use nanosleep instead of usleep, if it is available (Wilson Snyder)
807           (this means that one can mix subsecond sleeps with alarms)
808         - because of nanosleep we probe for -lrt and -lposix4
809         - the existence of getitimer/nanosleep/setitimer/ualarm/usleep
810           is available by exportable constants Time::HiRes::d_func
811           (since older Perl do not have them in %Config, and even
812            5.8.0 does not probe for nanosleep)
813
814 1.31    [2003-08-19]
815         - backward compatibility (pre-5.6.1) tweaks:
816           - define NV if no NVTYPE
817           - define IVdf if needed (note: the Devel::PPPort
818             in 5.8.0 does not try hard hard enough since
819             the IVSIZE might not be defined)
820           - define NVgf if needed
821           - grab the typemap from 5.8.0 for the NV stuff
822
823         1.31 and 1.32 add more backward compatibility (now all the way
824         back to Perl 5.00404), and using nanosleep() (if available) for
825         subsecond sleeps.
826
827 1.30    [2003-08-16]
828
829         - release 1.29_02 as 1.30
830
831         1.30 adds all the changes made during the Perl 5.6->5.7->5.8
832         development cycle.  Most notably portability across platforms has been
833         enhanced, and the interval timers (setitimer, getitimer) have been
834         added.  Note that the version of Time::HiRes that is included in Perl
835         5.8.0 calls itself 1.20_00, but it is equivalent to this Time::HiRes
836         version.  Note also that in 1.30 Wegscheid turns over the maintenance
837         to Jarkko Hietaniemi.
838
839 1.29_02 [2003-08-16]
840
841         - fix a silly unclosed comment typo in HiRes.xs
842         - document and export REALTIME_REALPROF (Solaris)
843
844 1.29_01 [2003-08-16]
845
846         - only getitimer(ITIMER_REAL) available in Cygwin and Win32
847           (need to patch this also in Perl 5.[89])
848         - remove CVS revision log from HiRes.xs
849
850 1.29_00 [2003-08-14]
851
852         The following numbered patches refer to the Perl 5.7 changes,
853         you can browse them at http://public.activestate.com/cgi-bin/perlbrowse
854
855         - 17558: Add #!./perl to the .t
856         - 17201: linux + usemorebits fix, from Rafael Garcia-Suarez
857         - 16198: political correctness, from Simon Cozens
858         - 15857: doc tweaks, from Jarkko Hietaniemi
859         - 15593: optimization in .xs, from Paul Green
860         - 14892: pod fixes, from Robin Barker
861         - 14100: VOS fixes, from Paul Green
862         - 13422: XS segfault, from Marc Lehmann
863         - 13378: whether select() gets restarted on signals, depends
864         - 13354: timing constraints, again, from Andy Dougherty
865         - 13278: can't do subsecond alarms with ualarm;
866                  break out early if alarms do not seem to be working
867         - 13266: test relaxation (cygwin gets lower hires
868                  times than lores ones)
869         - 12846: protect against high load, from Jarkko Hietaniemi
870         - 12837: HiRes.t VMS tweak, from Craig A. Berry
871         - 12797: HiRes.t VMS tweak, from Charles Lane
872         - 12769: HiRes.t VMS tweak, from Craig A. Berry
873         - 12744: gcc vs MS 64-bit constant syntax, from Nick Ing-Simmons
874         - 12722: VMS ualarm for VMS without ualarm, from Charles Lane
875         - 12692: alarm() ain't gonna work if ualarm() ain't,
876                  from Gurusamy Sarathy
877         - 12680: minor VMS tweak, from Charles Lane
878         - 12617: don't try to print ints as IVs, from Jarkko Hietaniemi
879         - 12609: croak on negative time, from Jarkko Hietaniemi
880         - 12595: Cygwin rounds up for time(), from Jarkko Hietaniemi
881         - 12594: MacOS Classic timeofday, from Chris Nandor
882         - 12473: allow for more than one second for sleep() and usleep()
883         - 12458: test tuning, relax timing constraints,
884                  from Jarkko Hietaniemi
885         - 12449: make sleep() and usleep() to return the number
886                  of seconds and microseconds actually slept (analogously
887                  with the builtin sleep()), also make usleep() croak if
888                  asked for more than 1_000_000 useconds, from Jarkko Hietaniemi
889         - 12366: Time::HiRes for VMS pre-7.0, from Charles Lane
890         - 12199: do not use ftime on Win32, from Gurusamy Sarathy
891         - 12196: use ftime() on Win32, from Artur Bergman
892         - 12184: fix Time::HiRes gettimeofday() on Win32, from Gurusamy Sarathy
893         - 12105: use GetSystemTime() on Win32, from Artur Bergman
894         - 12060: explain the 1e9 seconds problem, from Jarkko Hietaniemi
895         - 11901: UNICOS sloppy division, from Jarkko Hietaniemi
896         - 11797: problem in HiRes.t, from John P. Linderman
897         - 11414: prototype from Time::HiRes::sleep(), from Abhijit Menon-Sen
898         - 11409: Time::HiRes qw(sleep) failed, from Abhijit Menon-Sen
899         - 11270: dynix/ptx 4.5.2 hints fix, from Peter Prymmer
900         - 11032: VAX VMS s/div/lib\$ediv/ fix, from Peter Prymmer
901         - 11011: VAX VMS s/qdiv/div/ fix, from Peter Prymmer
902         - 10953: SCO OpenServer 5.0.5 requires an explicit -lc for usleep(),
903                  from Jonathan Stowe
904         - 10942: MPE/IX test tweaks, from Mark Bixby
905         - 10784: unnecessary pod2man calls, from Andy Dougherty
906         - 10354: ext/ + -Wall, from Doug MacEachern
907         - 10320: fix the BOOT section to call myU2time correctly
908         - 10317: correct casting for AIX< from H. Merijn Brand
909         - 10119: document that the core time() may be rounding, not truncating
910         - 10118: test fix, from John Peacock
911         -  9988: long =item, from Robin Barker
912         -  9714: correct test output
913         -  9708: test also the scalar aspect of getitimer()
914         -  9705: Add interval timers (setitimer, getitimer)
915         -  9692: do not require at least 5.005 using XS
916                 
917         The following changes were made on top of the changes
918         made for Time::HiRes during the Perl 5.7 development
919         cycle that culminated in the release of Perl 5.8.0.
920
921         - add "require 5.005" to the Makefile.PL
922         - remove the REVISION section (CVS log) from HiRes.pm
923         - add jhi's copyright alongside Douglas'
924         - move HiRes.pm to lib/Time/
925         - move HiRes.t to t/
926         - modify HiRes.t to use $ENV{PERL_CORE}
927         - modify the original Time::HiRes version 1.20 Makefile.PL
928           to work both with Perl 5.8.0 and the new code with pre-5.8.0
929           Perls (tried with 5.6.1)
930         - tiny tweaks and updates in README and TODO
931         - bump the VERSION to 1.29
932
933 1.20  Wed Feb 24 21:30 1999
934         - make our usleep and ualarm substitutes into hrt_usleep
935           and hrt_ualarm. This helps static links of Perl with other
936           packages that also have usleep, etc. From
937           Ilya Zakharevich <ilya@math.ohio-state.edu>
938         - add C API stuff. From Joshua Pritikin
939           <joshua.pritikin@db.com>
940         - VMS Makefile.PL fun.  From pvhp@forte.com (Peter Prymmer)
941         - hopefully correct "-lc" fix for SCO.
942         - add PPD stuff
943
944         1.20 adds a platform neutral set of C accessible routines if you are
945         running 5.005+.  All other changes are packaging changes and build
946         fixes(?) for statically linked Perl, SCO, and VMS.
947
948 1.19  Tue Sep 29 22:30 1998
949         - put VMS gettimeofday() in. Patch is from Sebastian Bazley
950           <seb@stian.demon.co.uk>
951         - change GIMME_V to GIMME to help people with older versions of
952           Perl.
953         - fix Win32 version of gettimeofday(). It didn't affect anything,
954           but it confuses people reading the code when the return value
955           is backwards (0 is success).
956         - fix Makefile.PL (more) so that detection of gettimeofday is
957           more correct.
958
959         1.19 has better VMS support.
960
961 1.18  Mon Jul 6 22:40 1998
962         - add usleep() for Win32.
963         - fix Makefile.PL to fix reported HP/UX feature where unresolved
964           externals still cause an executable to be generated (though no
965           x bit set). Thanks to David Kozinn for report and explanation.
966           Problems with the fix are mine :)
967
968         1.18 has limited Win32 support (no ualarm). Added usleep for Win32.
969         Probably buggy. I'm sure I'll hear.
970
971 1.17  Wed Jul 1 20:10 1998
972         - fix setitimer calls so microseconds is not more than 1000000.
973           Hp/UX 9 doesn't like that. Provided by Roland B Robert, PhD.
974         - make Win32. We only get gettimeofday (the select hack doesn't
975           seem to work on my Win95 system).
976         - fix test 4 on 01test.t. add test to see if time() and
977           Time::HiRes::time() are close.
978
979 1.16  Wed Nov 12 21:05 1997
980         - add missing EXTEND in new gettimeofday scalar code.
981
982         1.16+ should be closer to building out of the box on Linux. Thanks
983         to Gisle Aas for patches, and the ualarm equivalent using setitimer.
984
985         If your underlying operating system doesn't implement ualarm(), then
986         a fake using setitimer() will be made.  If the OS is missing usleep(),
987         a fake one using select() will be made. If a fake can't be made for
988         either ualarm() or usleep(), then the corresponding Perl function will
989         not be available.  If the OS is missing gettimeofday(), you will get
990         unresolved externals, either at link- or run-time.
991
992         This is an improvement; the package used to not even build if
993         you were missing any of these bits. Roderick Schertler
994
995         <roderick@argon.org> did all the conditional compilation stuff,
996         look at HiRes.pm and the test suites; it's good educational reading.
997
998 1.15  Mon Nov 10 21:30 1997
999         - HiRes.pm: update pod. Provided by Gisle Aas.
1000         - HiRes.xs: if gettimeofday() called in scalar context, do
1001           something more useful than before. Provided by Gisle Aas.
1002         - README: tell of xsubpp '-nolinenumber' woes. thanks to
1003           Edward Henigin <ed@texas.net> for pointing out the problem.
1004
1005 1.14  Wed Nov 5 9:40 1997
1006         - Makefile.PL: look for setitimer
1007         - HiRes.xs: if missing ualarm, but we have setitimer, make up
1008           our own setitimer. These were provided by Gisle Aas.
1009
1010 1.13  Tue Nov 4 23:30 1997
1011         - Makefile.PL: fix autodetect mechanism to do try linking in addition
1012           to just compiling; should fix Linux build problem. Fix was provided
1013           by Gisle Aas.
1014
1015 1.12  Sun Oct 12 12:00:00 1997
1016         - Makefile.PL: set XSOPT to '-nolinenumbers' to work around xsubpp bug;
1017           you may need to comment this back out if you have an older xsubpp.
1018         - HiRes.xs: set PROTOTYPES: DISABLE
1019
1020 1.11  Fri Sep 05 16:00:00 1997
1021         - Makefile.PL:
1022           Had some line commented out that shouldn't have been (testing
1023           remnants)
1024         - README:
1025           Previous version was corrupted.
1026
1027 1.10  Thu May 22 20:20:00 1997
1028         - HiRes.xs, HiRes.pm, t/*:
1029               - only compile what we have OS support for (or can
1030                 fake with select())
1031               - only test what we compiled
1032               - gross improvement to the test suite
1033               - fix EXPORT_FAIL.
1034           This work was all done by Roderick Schertler
1035           <roderick@argon.org>. If you run Linux or
1036           one of the other ualarm-less platforms, and you like this
1037           module, let Roderick know; without him, it still wouldn't
1038           be working on those boxes...
1039         - Makefile.PL: figure out what routines the OS has and
1040           only build what we need. These bits were written by Jarkko
1041           Hietaniemi <jhi@iki.fi>. Again, gratitude is due...
1042
1043 1.02  Mon Dec 30 08:00:00 1996
1044         - HiRes.pm: update documentation to say what to do when missing
1045           ualarm() and friends.
1046         - README: update to warn that ualarm() and friends need to exist
1047
1048 1.01  Fri Oct 17 08:00:00 1996
1049         - Makefile.PL: make XSPROTOARGS => '-noprototyopes'
1050         - HiRes.pm: put blank line between __END__ and =head1 so that
1051           pod2man works.
1052
1053 1.00  Tue Sep 03 13:00:00 1996
1054         - original version; created by h2xs 1.16