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