GSoC/GCI Archive
Google Code-in 2012 The NetBSD Project

Document different time structures

completed by: wmzhere

mentors: Radoslaw Kujawa, Aleksej Saushev, Julian Coleman, Julian Fagir

We have several time structures like time_t, struct timespec, struct timeval, struct tm and so on. Document all of them as a time(5) manpage such that a programmer can see all of them at once, in comparison. As we have time zone sensitive and time zone independent representations, figuring out conversions between local time and UTC from manual pages is hard and should also be documented in that manpage.

Our preferred format for the submission is some form of plain text, as that is most portable and can be read anywhere.

It would be interesting to have a graph displaying how one can go from one time representation to another too.