timespec: Add documentation for struct timespec Helpers

Joel editted the documentation for clarity, grammar and technical
correctness. I also moved it in the manual and added @findex
entries. The core work was just polished.

Author: Krzysztof Mięsowicz <krzysztof.miesowicz@gmail.com>

doc/ada_user/ada_user.texi

@@ -109,6 +109,7 @@
 @include user/cpuuse.texi
 @include user/object.texi
 @include user/chains.texi
+@include user/timespec.texi
 @include user/cbs.texi
 @include user/dirstat.texi
 @include example.texi
@@ -147,6 +148,7 @@
 * CPU Usage Statistics::
 * Object Services::
 * Chains::
+* Timespec Helpers::
 * Constant Bandwidth Server Scheduler API::
 * Directive Status Codes::
 * Example Application::

doc/user/Makefile.am

@@ -14,7 +14,8 @@ GENERATED_FILES = overview.texi concepts.texi datatypes.texi init.texi \
     task.texi intr.texi clock.texi timer.texi sem.texi msg.texi event.texi \
     signal.texi part.texi region.texi dpmem.texi io.texi fatal.texi \
     schedule.texi rtmon.texi barrier.texi bsp.texi userext.texi conf.texi \
-    mp.texi stackchk.texi cpuuse.texi object.texi chains.texi cbs.texi
+    mp.texi stackchk.texi cpuuse.texi object.texi chains.texi timespec.texi \
+    cbs.texi
 
 COMMON_FILES += $(top_srcdir)/common/cpright.texi
 
@@ -179,11 +180,16 @@ object.texi: object.t
 
 chains.texi: chains.t
 	$(BMENU2) -p "Object Services OBJECT_GET_CLASS_INFORMATION - Obtain Class Information" \
+	    -u "Top" \
+	    -n "Timespec Helpers" < $< > $@
+
+timespec.texi: timespec.t
+	$(BMENU2) -p "Chains Prepend a Node" \
 	    -u "Top" \
 	    -n "Constant Bandwidth Server Scheduler API" < $< > $@
 
 cbs.texi: cbs.t
-	$(BMENU2) -p "Chains Prepend a Node" \
+	$(BMENU2) -p "Timespec Helpers TIMESPEC_FROM_TICKS - Convert Ticks to struct timespec Representation" \
 	    -u "Top" \
 	    -n "Directive Status Codes" < $< > $@
 

doc/user/c_user.texi

@@ -108,6 +108,7 @@
 @include cpuuse.texi
 @include object.texi
 @include chains.texi
+@include timespec.texi
 @include cbs.texi
 @include dirstat.texi
 @include example.texi
@@ -146,6 +147,7 @@
 * CPU Usage Statistics::
 * Object Services::
 * Chains::
+* Timespec Helpers::
 * Constant Bandwidth Server Scheduler API::
 * Directive Status Codes::
 * Example Application::