clock: test and doc non-Y2038 compliance

Add a note in the documentation for clock that some systems
use 32-bit time_t and are thus not year 2038 compliant.

Also add a test to catch this in clock.test

Reported-by: dbohdan <dbohdan@dbohdan.com>
Signed-off-by: Steve Bennett <steveb@workware.net.au>