1
0
mirror of https://github.com/cc65/cc65.git synced 2024-12-27 15:29:46 +00:00
cc65/doc
Oliver Schmidt 842c151edd Replaced _systime with clock_gettime.
We want to add the capability to not only get the time but also set the time, but there's no "setter" for the "getter" time().

The first ones that come into mind are gettimeofday() and settimeofday(). However, they take a struct timezone argument that doesn't make sense - even the man pages says "The use of the timezone structure is obsolete; the tz argument should normally be specified as NULL." And POSIX says "Applications should use the clock_gettime() function instead of the obsolescent gettimeofday() function."

The ...timeofday() functions work with microseconds while the clock_...time() functions work with nanoseconds. Given that we expect our targets to support only 1/10 of seconds the microseconds look preferable at first sight. However, already microseconds require the cc65 data type 'long' so it's not such a relevant difference to nanoseconds. Additionally clock_getres() seems useful.

In order to avoid code duplication clock_gettime() takes over the role of the actual time getter from _systime(). So time() now calls clock_gettime() instead of _systime().

For some reason beyond my understanding _systime() was mentioned in time.h. _systime() worked exactly like e.g. _sysremove() and those _sys...() functions are all considered internal. The only reason I could see would be a performance gain of bypassing the time() wrapper. However, all known _systime() implementations internally called mktime(). And mktime() is implemented in C using an iterative algorithm so I really can't see what would be left to gain here. From that perspective I decided to just remove _systime().
2018-08-15 16:06:44 +02:00
..
apple2.sgml Switched Apple II output format to AppleSingle. 2018-03-07 23:05:21 +01:00
apple2enh.sgml Switched Apple II output format to AppleSingle. 2018-03-07 23:05:21 +01:00
ar65.sgml Deprecated commands mentioned 2017-05-30 02:05:35 +02:00
atari2600.sgml Add Atari 2600 documentation 2017-01-15 20:53:34 +01:00
atari5200.sgml fix warning when generating info file 2014-05-29 00:41:39 +02:00
atari.sgml Small typo 2018-02-25 22:38:58 +00:00
atmos.sgml Update atmos.sgml 2017-11-03 20:49:49 +01:00
c16.sgml Add CBM kernal call SECOND to CBM library (see issue #525) 2018-05-23 17:32:02 +02:00
c64.sgml Add CBM kernal call SECOND to CBM library (see issue #525) 2018-05-23 17:32:02 +02:00
c128.sgml Add CBM kernal call SECOND to CBM library (see issue #525) 2018-05-23 17:32:02 +02:00
ca65.sgml Reserve space in examples with .res 2017-09-02 19:30:14 -07:00
cbm510.sgml Add CBM kernal call SECOND to CBM library (see issue #525) 2018-05-23 17:32:02 +02:00
cbm610.sgml Add CBM kernal call SECOND to CBM library (see issue #525) 2018-05-23 17:32:02 +02:00
cc65-intern.sgml cc65-intern update minor change notes from greg-king5 2016-03-02 21:01:46 -05:00
cc65.sgml Fix cc65 doc for telestrat target 2017-11-12 10:42:09 +01:00
chrcvt65.sgml Renamed chrcvt to chrcvt65 and added it to the build. 2016-03-27 19:09:00 +02:00
cl65.sgml Added commit ca4ed290d5964dbe833224d967d3707e20972278's command-line option to the cl65 document. 2017-10-16 09:39:33 -04:00
co65.sgml Streamlined the document author credits. 2014-04-08 15:36:39 -04:00
coding.sgml Streamlined the document author credits. 2014-04-08 15:36:39 -04:00
creativision.sgml Creativision documentation enhancements. 2017-11-15 00:13:06 +01:00
customizing.sgml Renamed INITBSS to INIT and INIT to ONCE. 2016-03-06 21:27:19 +01:00
da65.sgml Followed the discussions in the Pull request #682. 2018-06-14 02:02:16 +09:00
debugging.sgml Fixed the SGML <htmlurl> and <url> tags. 2014-04-14 05:54:13 -04:00
dio.sgml Update dio.sgml 2018-02-22 13:30:50 +01:00
doc.css Made html doc look a little less boring. 2014-02-09 22:43:55 +01:00
doc.png Made html doc look a little less boring. 2014-02-09 22:43:55 +01:00
funcref.sgml Replaced _systime with clock_gettime. 2018-08-15 16:06:44 +02:00
gamate.sgml Fix docs for #453 2017-11-21 09:51:35 +01:00
geos.sgml Fixed the SGML <htmlurl> and <url> tags. 2014-04-14 05:54:13 -04:00
grc65.sgml Avoided some makeinfo warnings when Cygwin runs LinuxDoc Tools. 2014-04-25 03:33:53 -04:00
header.html Some minor fine tuning. 2014-02-09 22:57:38 +01:00
index.sgml Splitting of funcref 2017-11-25 19:31:36 +01:00
intro.sgml Switched Apple II output format to AppleSingle. 2018-03-07 23:05:21 +01:00
ld65.sgml Oricutron mentioned 2017-05-26 01:44:33 +02:00
library.sgml Update 2018-02-28 00:24:28 +00:00
lynx.sgml Fixed the SGML <htmlurl> and <url> tags. 2014-04-14 05:54:13 -04:00
Makefile make: change uppercase prefix var 2017-07-22 16:38:50 +02:00
nes.sgml oops 2017-07-18 00:01:15 +02:00
od65.sgml Fixed the SGML <htmlurl> and <url> tags. 2014-04-14 05:54:13 -04:00
osi.sgml Macro-based implementation of screen layout configuration modules. 2015-03-23 19:02:45 +01:00
pce.sgml Changed the PC-Engine's configuration file, so that the command line can build 8K, 16K, and 32K carts. 2018-02-23 16:06:49 -05:00
pet.sgml cbm_k_tksa() from the PET docs 2018-05-22 18:48:43 +02:00
plus4.sgml Add CBM kernal call SECOND to CBM library (see issue #525) 2018-05-23 17:32:02 +02:00
sim65.sgml sim65: add command line parameter to print number of CPU cycles at exit 2016-07-05 17:07:39 +02:00
smc.sgml Fixed typos. 2016-01-05 15:38:05 +01:00
sp65.sgml A forgotten option. Empty arguments are not silent anymore. 2016-04-10 02:21:36 +02:00
supervision.sgml Date 2017-11-21 09:59:31 +01:00
telestrat.sgml Doc modified 2017-11-10 10:58:01 +01:00
tgi.sgml Update tgi.sgml 2018-05-23 13:34:37 +00:00
using-make.sgml CC65_HOME is gone for quite some time by now. 2018-03-06 20:43:08 +01:00
vic20.sgml Add CBM kernal call SECOND to CBM library (see issue #525) 2018-05-23 17:32:02 +02:00