octimer just today finished moving from extlibs to resource/c_common.

so I took a look at the header for this small module, and it illustrates
some of the comments we've had in other threads about figuring out what
the API is.

the header octimer.h has two marked-up functions, but several other
functions where it's not clear whether they're supposed to be part of
the public API or not.  I can't point to the page because it's not part
of the online set at the moment, but this is the list:

time_t  timespec_diff (const time_t after, const time_t before)
void    timespec_add (time_t *to, const time_t seconds)
void    checkTimeout ()
long int getSeconds (struct tm *tp)
time_t  getRelativeIntervalOfWeek (struct tm *tp)
time_t  getSecondsFromAbsTime (struct tm *tp)
int     initThread ()
void *  loop (void *threadid)
time_t  registerTimer (const time_t seconds, int *id, TimerCallback cb)
void    unregisterTimer (int id)

The first two are the ones with markup.

Are all of these part of the API? None? Are the not-marked-up ones to be
considered internal?  Should they be partitioned off into a separate
header if so?


Reply via email to