Made the gen_section more accurate.

1999-05-26 18:20:40 +00:00
parent e968366e21
commit 110bdfe694
13 changed files with 257 additions and 253 deletions
--- a/doc/itron3.0/config.t
+++ b/doc/itron3.0/config.t
@@ -16,11 +16,11 @@ system manager is ...
 The services provided by the system manager are:

@itemize @bullet
-@item @code{get_ver} - Get Version Information
- Get Version Information of another Node
-@item @code{ref_sys} - Reference Semaphore Status
-@item @code{ref_cfg} - Reference Configuration Information
-@item @code{def_svc} - Define Extended SVC Handler
+@item @code{get_ver} - Get Version Information
+@item @code{ref_sys} - Reference Semaphore Status
+@item @code{ref_cfg} - Reference Configuration Information
+@item @code{def_svc} - Define Extended SVC Handler
+@item @code{def_exc} - Define Exception Handler
@end itemize

@section Background
@@ -40,14 +40,14 @@ and status codes.
@c

@page
-@page
+@subsection get_ver -  Get Version Information Get Version Information of another Node

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER get_ver (
-@example
+ T_VER *pk_ver ER nget_ver 
 );
@end example
@end ifset
@@ -69,14 +69,14 @@ ER get_ver (
@c

@page
-@c
+@subsection ref_sys -  Reference Semaphore Status

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_sys (
-@ifset is-C
+ T_RSYS *pk_rsys
 );
@end example
@end ifset
@@ -98,14 +98,14 @@ ER ref_sys (
@c

@page
-@c
+@subsection ref_cfg -  Reference Configuration Information

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_cfg (
-@ifset is-C
+ T_RCFG *pk_rcfg
 );
@end example
@end ifset
@@ -127,14 +127,14 @@ ER ref_cfg (
@c

@page
-@c
+@subsection def_svc -  Define Extended SVC Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER def_svc (
-@ifset is-C
+ FN s_fncd, T_DSVC *pk_dsvc
 );
@end example
@end ifset
@@ -156,14 +156,14 @@ ER def_svc (
@c

@page
-@c
+@subsection def_exc -  Define Exception Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER def_exc (
-@ifset is-C
+ UINT exckind, T_DEXC *pk_dexc
 );
@end example
@end ifset
--- a/doc/itron3.0/eventflags.t
+++ b/doc/itron3.0/eventflags.t
@@ -16,14 +16,14 @@ eventflags manager is ...
 The services provided by the eventflags manager are:

@itemize @bullet
-@item @code{cre_flg} - Create Eventflag
-@item @code{del_flg} - Delete Eventflag
-@item @code{set_flg} - Set Eventflag
-@item @code{clr_flg} - Clear Eventflag
-@item @code{wai_flg} - Wait on Eventflag with Timeout
- Wait on Eventflag
-@item @code{pol_flg} - Wait for Eventflag (Polling)
-@item @code{twai_flg} - Wait on Eventflag with Timeout
+@item @code{cre_flg} - Create Eventflag
+@item @code{del_flg} - Delete Eventflag
+@item @code{set_flg} - Set Eventflag
+@item @code{clr_flg} - Clear Eventflag
+@item @code{wai_flg} - Wait on Eventflag
+@item @code{pol_flg} - Wait for Eventflag (Polling)
+@item @code{twai_flg} - Wait on Eventflag with Timeout
+@item @code{ref_flg} - Reference Eventflag Status
@end itemize

@section Background
@@ -43,14 +43,14 @@ and status codes.
@c

@page
-@page
+@subsection cre_flg -  Create Eventflag

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER cre_flg (
-ER cre_flg (
+ ID flgid, T_CFLG *pk_cflg
 );
@end example
@end ifset
@@ -72,14 +72,14 @@ ER cre_flg (
@c

@page
-@page
+@subsection del_flg -  Delete Eventflag

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER del_flg (
-ER del_flg (
+ ID flgid
 );
@end example
@end ifset
@@ -101,14 +101,14 @@ ER del_flg (
@c

@page
-@page
+@subsection set_flg -  Set Eventflag

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER set_flg (
-ER set_flg (
+ ID flgid, UINT setptn
 );
@end example
@end ifset
@@ -130,14 +130,14 @@ ER set_flg (
@c

@page
-@page
+@subsection clr_flg -  Clear Eventflag

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER clr_flg (
-ER clr_flg (
+ ID flgid, UINT clrptn
 );
@end example
@end ifset
@@ -159,14 +159,14 @@ ER clr_flg (
@c

@page
-@page
+@subsection wai_flg -  Wait on Eventflag with Timeout Wait on Eventflag

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER wai_flg (
-@example
+ UINT *p_flgptn, ID flgid, UINT waiptn, UINT wfmode ER ercd =twai_flg 
 );
@end example
@end ifset
@@ -188,14 +188,14 @@ ER wai_flg (
@c

@page
-@c
+@subsection pol_flg -  Wait for Eventflag (Polling)

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER pol_flg (
-@ifset is-C
+ UINT *p_flgptn, ID flgid, UINT waiptn, UINT wfmode
 );
@end example
@end ifset
@@ -217,14 +217,14 @@ ER pol_flg (
@c

@page
-@c
+@subsection twai_flg -  Wait on Eventflag with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =twai_flg (
-@ifset is-C
+ UINT *p_flgptn, ID flgid, UINT waiptn, UINT wfmode,
 );
@end example
@end ifset
@@ -246,14 +246,14 @@ ER ercd =twai_flg (
@c

@page
-@c
+@subsection ref_flg -  Reference Eventflag Status

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_flg (
-@ifset is-C
+ T_RFLG *pk_rflg, ID flgid
 );
@end example
@end ifset
--- a/doc/itron3.0/fixedblock.t
+++ b/doc/itron3.0/fixedblock.t
@@ -16,13 +16,13 @@ fixed block manager is ...
 The services provided by the fixed block manager are:

@itemize @bullet
-@item @code{cre_mpf} - Create Fixed-Size Memorypool
-@item @code{del_mpf} - Delete Fixed-Size Memorypool
-@item @code{get_blf} - Get Fixed-Size Memory Block
- Poll and Get Fixed-Size Memory Block
- Get Fixed-Size Memory Block with Timeout
-@item @code{pget_blf} - Poll and Get Fixed-Size Memory Block
-@item @code{tget_blf} - Get Fixed-Size Memory Block with Timeout
+@item @code{cre_mpf} - Create Fixed-Size Memorypool
+@item @code{del_mpf} - Delete Fixed-Size Memorypool
+@item @code{get_blf} - Get Fixed-Size Memory Block
+@item @code{pget_blf} - Poll and Get Fixed-Size Memory Block
+@item @code{tget_blf} - Get Fixed-Size Memory Block with Timeout
+@item @code{rel_blf} - Release Fixed-Size Memory Block
+@item @code{ref_mpf} - Reference Fixed-Size Memorypool Status
@end itemize

@section Background
@@ -42,14 +42,14 @@ and status codes.
@c

@page
-
+@subsection cre_mpf -  Create Fixed-Size Memorypool

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER cre_mpf (
-@example
+ ID mpfid, T_CMPF *pk_cmpf
 );
@end example
@end ifset
@@ -71,14 +71,14 @@ ER cre_mpf (
@c

@page
-
+@subsection del_mpf -  Delete Fixed-Size Memorypool

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER del_mpf (
-@example
+ ID mpfid
 );
@end example
@end ifset
@@ -100,14 +100,14 @@ ER del_mpf (
@c

@page
-
+@subsection get_blf -  Get Fixed-Size Memory Block Poll and Get Fixed-Size Memory Block Get Fixed-Size Memory Block with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER get_blf (
-
+ VP *p_blf, ID mpfid ER ercd =pget_blf 
 );
@end example
@end ifset
@@ -129,14 +129,14 @@ ER get_blf (
@c

@page
-@c
+@subsection pget_blf -  Poll and Get Fixed-Size Memory Block

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =pget_blf (
-@subheading CALLING SEQUENCE:
+ VP *p_blf, ID mpfid
 );
@end example
@end ifset
@@ -158,14 +158,14 @@ ER ercd =pget_blf (
@c

@page
-@c
+@subsection tget_blf -  Get Fixed-Size Memory Block with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =tget_blf (
-@subheading CALLING SEQUENCE:
+ VP *p_blf, ID mpfid, TMO tmout
 );
@end example
@end ifset
@@ -187,14 +187,14 @@ ER ercd =tget_blf (
@c

@page
-@c
+@subsection rel_blf -  Release Fixed-Size Memory Block

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER rel_blf (
-@subheading CALLING SEQUENCE:
+ ID mpfid, VP blf
 );
@end example
@end ifset
@@ -216,14 +216,14 @@ ER rel_blf (
@c

@page
-@c
+@subsection ref_mpf -  Reference Fixed-Size Memorypool Status

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_mpf (
-@subheading CALLING SEQUENCE:
+ T_RMPF *pk_rmpf, ID mpfid
 );
@end example
@end ifset
--- a/doc/itron3.0/gen_section
+++ b/doc/itron3.0/gen_section
@@ -126,7 +126,7 @@ echo "@itemize @bullet"

 for routine in ${ROUTINES}
 do
-  description=`grep ${routine} ../../itron_spec/itron3-1.txt | grep "]" | cut -d']' -f2`
+  description=`grep " ${routine} " ../../itron_spec/itron3-1.txt | grep "]" | cut -d']' -f2 `
  description=`echo ${description}`
  echo "@item @code{${routine}} - ${description}"
 done
@@ -148,14 +148,14 @@ echo ""
 for routine in ${ROUTINES}
 do
  description=`grep ${routine} ../../itron_spec/itron3-1.txt | grep "]" | cut -d']' -f2`
-  description=`echo ${description}`
+  description=`echo -n ${description}`
  echo ""
  echo "@c"
  echo "@c  ${routine}"
  echo "@c"
  echo ""
  echo "@page"
-  echo "@subsection ${routine} - ${description}"
+  echo "@subsection ${routine} - " ${description}
  echo ""
  echo "@subheading CALLING SEQUENCE:"
  echo ""
@@ -163,7 +163,7 @@ do
  echo "@example"
  proto=`grep "${routine} (" ../../itron_spec/itron3-6.txt | sed -e 's/ercd = //'`   # | sed -e 's/ \\(/(/'`
  
-  echo `echo ${proto} | cut -d'(' -f1`"("
+  echo `echo -n ${proto} | cut -d'(' -f1`"("
  echo ${proto} | cut -d'(' -f2 | sed -e 's/ .;//'
  echo ");"
  # echo "int ${routine}("
--- a/doc/itron3.0/interrupt.t
+++ b/doc/itron3.0/interrupt.t
@@ -16,15 +16,15 @@ interrupt manager is ...
 The services provided by the interrupt manager are:

@itemize @bullet
-@item @code{def_int} - Define Interrupt Handler
-@item @code{ret_int} - Return from Interrupt Handler
-@item @code{ret_wup} - Return and Wakeup Task
-@item @code{loc_cpu} - Lock CPU
-@item @code{unl_cpu} - Unlock CPU
-@item @code{dis_int} - Disable Interrupt
-@item @code{ena_int} - Enable Interrupt
-@item @code{chg_iXX} - Change Interrupt Mask (Level or Priority)
-@item @code{ref_iXX} - Reference Interrupt Mask (Level or Priority)
+@item @code{def_int} - Define Interrupt Handler
+@item @code{ret_int} - Return from Interrupt Handler
+@item @code{ret_wup} - Return and Wakeup Task
+@item @code{loc_cpu} - Lock CPU
+@item @code{unl_cpu} - Unlock CPU
+@item @code{dis_int} - Disable Interrupt
+@item @code{ena_int} - Enable Interrupt
+@item @code{chg_iXX} - Change Interrupt Mask (Level or Priority)
+@item @code{ref_iXX} - Reference Interrupt Mask (Level or Priority)
@end itemize

@section Background
@@ -44,14 +44,14 @@ and status codes.
@c

@page
-@subsection def_int - Define Interrupt Handler
+@subsection def_int -  Define Interrupt Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER def_int (
- UINT dintno, T_DINT *pk_dint
+ UINT dintno, T_DINT *pk_dint
 );
@end example
@end ifset
@@ -73,14 +73,14 @@ ER def_int (
@c

@page
-@subsection ret_int - Return from Interrupt Handler
+@subsection ret_int -  Return from Interrupt Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 void ret_int (
-
+
 );
@end example
@end ifset
@@ -102,14 +102,14 @@ void ret_int (
@c

@page
-@subsection ret_wup - Return and Wakeup Task
+@subsection ret_wup -  Return and Wakeup Task

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 void ret_wup (
- ID tskid
+ ID tskid
 );
@end example
@end ifset
@@ -131,14 +131,14 @@ void ret_wup (
@c

@page
-@subsection loc_cpu - Lock CPU
+@subsection loc_cpu -  Lock CPU

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER loc_cpu (
-
+
 );
@end example
@end ifset
@@ -160,14 +160,14 @@ ER loc_cpu (
@c

@page
-@subsection unl_cpu - Unlock CPU
+@subsection unl_cpu -  Unlock CPU

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER unl_cpu (
-
+
 );
@end example
@end ifset
@@ -189,14 +189,14 @@ ER unl_cpu (
@c

@page
-@subsection dis_int - Disable Interrupt
+@subsection dis_int -  Disable Interrupt

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER dis_int (
- UINT eintno
+ UINT eintno
 );
@end example
@end ifset
@@ -218,14 +218,14 @@ ER dis_int (
@c

@page
-@subsection ena_int - Enable Interrupt
+@subsection ena_int -  Enable Interrupt

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ena_int (
- UINT eintno
+ UINT eintno
 );
@end example
@end ifset
@@ -247,14 +247,14 @@ ER ena_int (
@c

@page
-@subsection chg_iXX - Change Interrupt Mask (Level or Priority)
+@subsection chg_iXX -  Change Interrupt Mask (Level or Priority)

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER chg_iXX (
- UINT iXXXX
+ UINT iXXXX
 );
@end example
@end ifset
@@ -276,14 +276,14 @@ ER chg_iXX (
@c

@page
-@subsection ref_iXX - Reference Interrupt Mask (Level or Priority)
+@subsection ref_iXX -  Reference Interrupt Mask (Level or Priority)

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_iXX (
- UINT *p_iXXXX
+ UINT *p_iXXXX
 );
@end example
@end ifset
--- a/doc/itron3.0/mailbox.t
+++ b/doc/itron3.0/mailbox.t
@@ -16,13 +16,13 @@ mailbox manager is ...
 The services provided by the mailbox manager are:

@itemize @bullet
-@item @code{cre_mbx} - Create Mailbox
-@item @code{del_mbx} - Delete Mailbox
-@item @code{snd_msg} - Send Message to Mailbox
-@item @code{rcv_msg} - Poll and Receive Message from Mailbox
- Receive Message from Mailbox
- Receive Message from Mailbox with Timeout
-@item @code{prcv_msg} - Poll and Receive Message from Mailbox
+@item @code{cre_mbx} - Create Mailbox
+@item @code{del_mbx} - Delete Mailbox
+@item @code{snd_msg} - Send Message to Mailbox
+@item @code{rcv_msg} - Receive Message from Mailbox
+@item @code{prcv_msg} - Poll and Receive Message from Mailbox
+@item @code{trcv_msg} - Receive Message from Mailbox with Timeout
+@item @code{ref_mbx} - Reference Mailbox Status
@end itemize

@section Background
@@ -42,14 +42,14 @@ and status codes.
@c

@page
-
+@subsection cre_mbx -  Create Mailbox

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER cre_mbx (
-@example
+ ID mbxid, T_CMBX* pk_cmbx
 );
@end example
@end ifset
@@ -71,14 +71,14 @@ ER cre_mbx (
@c

@page
-
+@subsection del_mbx -  Delete Mailbox

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER del_mbx (
-@example
+ ID mbxid
 );
@end example
@end ifset
@@ -100,14 +100,14 @@ ER del_mbx (
@c

@page
-
+@subsection snd_msg -  Send Message to Mailbox

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER snd_msg (
-@example
+ ID mbxid, T_MSG *pk_msg
 );
@end example
@end ifset
@@ -129,14 +129,14 @@ ER snd_msg (
@c

@page
-
+@subsection rcv_msg -  Poll and Receive Message from Mailbox Receive Message from Mailbox Receive Message from Mailbox with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER rcv_msg (
-
+ T_MSG **ppk_msg, ID mbxid ER ercd =prcv_msg 
 );
@end example
@end ifset
@@ -158,14 +158,14 @@ ER rcv_msg (
@c

@page
-@c
+@subsection prcv_msg -  Poll and Receive Message from Mailbox

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =prcv_msg (
-@subheading CALLING SEQUENCE:
+ T_MSG **ppk_msg, ID mbxid
 );
@end example
@end ifset
@@ -187,14 +187,14 @@ ER ercd =prcv_msg (
@c

@page
-@c
+@subsection trcv_msg -  Receive Message from Mailbox with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =trcv_msg (
-@subheading CALLING SEQUENCE:
+ T_MSG **ppk_msg, ID mbxid, TMO tmout
 );
@end example
@end ifset
@@ -216,14 +216,14 @@ ER ercd =trcv_msg (
@c

@page
-@c
+@subsection ref_mbx -  Reference Mailbox Status

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_mbx (
-@subheading CALLING SEQUENCE:
+ T_RMBX *pk_rmbx, ID mbxid
 );
@end example
@end ifset
--- a/doc/itron3.0/memorypool.t
+++ b/doc/itron3.0/memorypool.t
@@ -16,13 +16,13 @@ memory pool manager is ...
 The services provided by the memory pool manager are:

@itemize @bullet
-@item @code{cre_mpl} - Create Variable-Size Memorypool
-@item @code{del_mpl} - Delete Variable-Size Memorypool
-@item @code{get_blk} - Get Variable-Size Memory Block
- Poll and Get Variable-Size Memory Block
- Get Variable-Size Memory Block with Timeout
-@item @code{pget_blk} - Poll and Get Variable-Size Memory Block
-@item @code{tget_blk} - Get Variable-Size Memory Block with Timeout
+@item @code{cre_mpl} - Create Variable-Size Memorypool
+@item @code{del_mpl} - Delete Variable-Size Memorypool
+@item @code{get_blk} - Get Variable-Size Memory Block
+@item @code{pget_blk} - Poll and Get Variable-Size Memory Block
+@item @code{tget_blk} - Get Variable-Size Memory Block with Timeout
+@item @code{rel_blk} - Release Variable-Size Memory Block
+@item @code{ref_mpl} - Reference Variable-Size Memorypool Status
@end itemize

@section Background
@@ -42,14 +42,14 @@ and status codes.
@c

@page
-
+@subsection cre_mpl -  Create Variable-Size Memorypool

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER cre_mpl (
-@example
+ ID mplid, T_CMPL *pk_cmpl
 );
@end example
@end ifset
@@ -71,14 +71,14 @@ ER cre_mpl (
@c

@page
-
+@subsection del_mpl -  Delete Variable-Size Memorypool

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER del_mpl (
-@example
+ ID mplid
 );
@end example
@end ifset
@@ -100,14 +100,14 @@ ER del_mpl (
@c

@page
-
+@subsection get_blk -  Get Variable-Size Memory Block Poll and Get Variable-Size Memory Block Get Variable-Size Memory Block with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER get_blk (
-
+ VP *p_blk, ID mplid, INT blksz ER ercd =pget_blk 
 );
@end example
@end ifset
@@ -129,14 +129,14 @@ ER get_blk (
@c

@page
-@c
+@subsection pget_blk -  Poll and Get Variable-Size Memory Block

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =pget_blk (
-@subheading CALLING SEQUENCE:
+ VP *p_blk, ID mplid, INT blksz
 );
@end example
@end ifset
@@ -158,14 +158,14 @@ ER ercd =pget_blk (
@c

@page
-@c
+@subsection tget_blk -  Get Variable-Size Memory Block with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =tget_blk (
-@subheading CALLING SEQUENCE:
+ VP *p_blk, ID mplid, INT blksz, TMO tmout
 );
@end example
@end ifset
@@ -187,14 +187,14 @@ ER ercd =tget_blk (
@c

@page
-@c
+@subsection rel_blk -  Release Variable-Size Memory Block

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER rel_blk (
-@subheading CALLING SEQUENCE:
+ ID mplid, VP blk
 );
@end example
@end ifset
@@ -216,14 +216,14 @@ ER rel_blk (
@c

@page
-@c
+@subsection ref_mpl -  Reference Variable-Size Memorypool Status

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_mpl (
-@subheading CALLING SEQUENCE:
+ T_RMPL *pk_rmpl, ID mplid
 );
@end example
@end ifset
--- a/doc/itron3.0/msgbuffer.t
+++ b/doc/itron3.0/msgbuffer.t
@@ -16,15 +16,15 @@ message buffer manager is ...
 The services provided by the message buffer manager are:

@itemize @bullet
-@item @code{cre_mbf} - Create MessageBuffer
-@item @code{del_mbf} - Delete MessageBuffer
-@item @code{snd_mbf} - Poll and Send Message to MessageBuffer
- Send Message to MessageBuffer
- Send Message to MessageBuffer with Timeout
-@item @code{psnd_mbf} - Poll and Send Message to MessageBuffer
-@item @code{tsnd_mbf} - Send Message to MessageBuffer with Timeout
-@item @code{rcv_mbf} - Poll and Receive Message from MessageBuffer
- Receive Message from MessageBuffer
+@item @code{cre_mbf} - Create MessageBuffer
+@item @code{del_mbf} - Delete MessageBuffer
+@item @code{snd_mbf} - Send Message to MessageBuffer
+@item @code{psnd_mbf} - Poll and Send Message to MessageBuffer
+@item @code{tsnd_mbf} - Send Message to MessageBuffer with Timeout
+@item @code{rcv_mbf} - Receive Message from MessageBuffer
+@item @code{prcv_mbf} - Poll and Receive Message from MessageBuffer
+@item @code{trcv_mbf} - Receive Message from MessageBuffer with Timeout
+@item @code{ref_mbf} - Reference MessageBuffer Status
@end itemize

@section Background
@@ -44,14 +44,14 @@ and status codes.
@c

@page
-@c  cre_mbf
+@subsection cre_mbf -  Create MessageBuffer

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER cre_mbf (
-
+ ID mbfid, T_CMBF *pk_cmbf
 );
@end example
@end ifset
@@ -73,14 +73,14 @@ ER cre_mbf (
@c

@page
-@c  del_mbf
+@subsection del_mbf -  Delete MessageBuffer

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER del_mbf (
-
+ ID mbfid
 );
@end example
@end ifset
@@ -102,14 +102,14 @@ ER del_mbf (
@c

@page
-@c  snd_mbf
+@subsection snd_mbf -  Poll and Send Message to MessageBuffer Send Message to MessageBuffer Send Message to MessageBuffer with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER snd_mbf (
-
+ ID mbfid, VP msg, INT msgsz ER ercd =psnd_mbf 
 );
@end example
@end ifset
@@ -131,14 +131,14 @@ ER snd_mbf (
@c

@page
-
+@subsection psnd_mbf -  Poll and Send Message to MessageBuffer

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =psnd_mbf (
-@subsection psnd_mbf - Poll and Send Message to MessageBuffer
+ ID mbfid, VP msg, INT msgsz
 );
@end example
@end ifset
@@ -160,14 +160,14 @@ ER ercd =psnd_mbf (
@c

@page
-
+@subsection tsnd_mbf -  Send Message to MessageBuffer with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =tsnd_mbf (
-@subsection tsnd_mbf - Send Message to MessageBuffer with Timeout
+ ID mbfid, VP msg, INT msgsz, TMO tmout
 );
@end example
@end ifset
@@ -189,14 +189,14 @@ ER ercd =tsnd_mbf (
@c

@page
-
+@subsection rcv_mbf -  Poll and Receive Message from MessageBuffer Receive Message from MessageBuffer Receive Message from MessageBuffer with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER rcv_mbf (
-@subsection rcv_mbf - Poll and Receive Message from MessageBuffer
+ VP msg, INT *p_msgsz, ID mbfid ER ercd =prcv_mbf 
 );
@end example
@end ifset
@@ -218,14 +218,14 @@ ER rcv_mbf (
@c

@page
-@subheading DESCRIPTION:
+@subsection prcv_mbf -  Poll and Receive Message from MessageBuffer

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =prcv_mbf (
-@c
+ VP msg, INT *p_msgsz, ID mbfid
 );
@end example
@end ifset
@@ -247,14 +247,14 @@ ER ercd =prcv_mbf (
@c

@page
-@subheading DESCRIPTION:
+@subsection trcv_mbf -  Receive Message from MessageBuffer with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =trcv_mbf (
-@c
+ VP msg, INT *p_msgsz, ID mbfid, TMO tmout
 );
@end example
@end ifset
@@ -276,14 +276,14 @@ ER ercd =trcv_mbf (
@c

@page
-@subheading DESCRIPTION:
+@subsection ref_mbf -  Reference MessageBuffer Status

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_mbf (
-@c
+ T_RMBF *pk_rmbf, ID mbfid
 );
@end example
@end ifset
--- a/doc/itron3.0/network.t
+++ b/doc/itron3.0/network.t
@@ -16,10 +16,10 @@ network support manager is ...
 The services provided by the network support manager are:

@itemize @bullet
-@item @code{nrea_dat} - Read Data from another Node
-@item @code{nwri_dat} - Write Data to another Node
-@item @code{nget_nod} - Get Local Node Number
-@item @code{nget_ver} - Get Version Information of another Node
+@item @code{nrea_dat} - Read Data from another Node
+@item @code{nwri_dat} - Write Data to another Node
+@item @code{nget_nod} - Get Local Node Number
+@item @code{nget_ver} - Get Version Information of another Node
@end itemize

@section Background
@@ -39,14 +39,14 @@ and status codes.
@c

@page
-@subsection nrea_dat - Read Data from another Node
+@subsection nrea_dat -  Read Data from another Node

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER nrea_dat (
- INT *p_reasz, VP dstadr, NODE srcnode, VP srcadr,
+ INT *p_reasz, VP dstadr, NODE srcnode, VP srcadr,
 );
@end example
@end ifset
@@ -68,14 +68,14 @@ ER nrea_dat (
@c

@page
-@subsection nwri_dat - Write Data to another Node
+@subsection nwri_dat -  Write Data to another Node

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER nwri_dat (
- INT *p_wrisz, NODE dstnode, VP dstadr, VP srcadr,
+ INT *p_wrisz, NODE dstnode, VP dstadr, VP srcadr,
 );
@end example
@end ifset
@@ -97,14 +97,14 @@ ER nwri_dat (
@c

@page
-@subsection nget_nod - Get Local Node Number
+@subsection nget_nod -  Get Local Node Number

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER nget_nod (
- NODE *p_node
+ NODE *p_node
 );
@end example
@end ifset
@@ -126,14 +126,14 @@ ER nget_nod (
@c

@page
-@subsection nget_ver - Get Version Information of another Node
+@subsection nget_ver -  Get Version Information of another Node

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER nget_ver (
- T_VER *pk_ver, NODE node
+ T_VER *pk_ver, NODE node
 );
@end example
@end ifset
--- a/doc/itron3.0/rendezvous.t
+++ b/doc/itron3.0/rendezvous.t
@@ -16,17 +16,17 @@ rendezvous manager is ...
 The services provided by the rendezvous manager are:

@itemize @bullet
-@item @code{cre_por} - Create Port for Rendezvous
-@item @code{del_por} - Delete Port for Rendezvous
-@item @code{cal_por} - Call Port for Rendezvous
- Poll and Call Port for Rendezvous
- Call Port for Rendezvous with Timeout
-@item @code{pcal_por} - Poll and Call Port for Rendezvous
-@item @code{tcal_por} - Call Port for Rendezvous with Timeout
-@item @code{acp_por} - Accept Port for Rendezvous
- Poll and Accept Port for Rendezvous
- Accept Port for Rendezvous with Timeout
-@item @code{pacp_por} - Poll and Accept Port for Rendezvous
+@item @code{cre_por} - Create Port for Rendezvous
+@item @code{del_por} - Delete Port for Rendezvous
+@item @code{cal_por} - Call Port for Rendezvous
+@item @code{pcal_por} - Poll and Call Port for Rendezvous
+@item @code{tcal_por} - Call Port for Rendezvous with Timeout
+@item @code{acp_por} - Accept Port for Rendezvous
+@item @code{pacp_por} - Poll and Accept Port for Rendezvous
+@item @code{tacp_por} - Accept Port for Rendezvous with Timeout
+@item @code{fwd_por} - Forward Rendezvous to Other Port
+@item @code{rpl_rdv} - Reply Rendezvous
+@item @code{ref_por} - Reference Port Status
@end itemize

@section Background
@@ -46,14 +46,14 @@ and status codes.
@c

@page
-@c  cre_por
+@subsection cre_por -  Create Port for Rendezvous

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER cre_por (
-
+ ID porid, T_CPOR *pk_cpor
 );
@end example
@end ifset
@@ -75,14 +75,14 @@ ER cre_por (
@c

@page
-@c  del_por
+@subsection del_por -  Delete Port for Rendezvous

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER del_por (
-
+ ID porid
 );
@end example
@end ifset
@@ -104,14 +104,14 @@ ER del_por (
@c

@page
-@c  cal_por
+@subsection cal_por -  Call Port for Rendezvous Poll and Call Port for Rendezvous Call Port for Rendezvous with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER cal_por (
-
+ VP msg, INT *p_rmsgsz, ID porid, UINT calptn, INT ER ercd =pcal_por 
 );
@end example
@end ifset
@@ -133,14 +133,14 @@ ER cal_por (
@c

@page
-
+@subsection pcal_por -  Poll and Call Port for Rendezvous

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =pcal_por (
-@subsection pcal_por - Poll and Call Port for Rendezvous
+ VP msg, INT *p_rmsgsz, ID porid, UINT calptn, INT
 );
@end example
@end ifset
@@ -162,14 +162,14 @@ ER ercd =pcal_por (
@c

@page
-
+@subsection tcal_por -  Call Port for Rendezvous with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =tcal_por (
-@subsection tcal_por - Call Port for Rendezvous with Timeout
+ VP msg, INT *p_rmsgsz, ID porid, UINT calptn, INT
 );
@end example
@end ifset
@@ -191,14 +191,14 @@ ER ercd =tcal_por (
@c

@page
-
+@subsection acp_por -  Accept Port for Rendezvous Poll and Accept Port for Rendezvous Accept Port for Rendezvous with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER acp_por (
-@subsection acp_por - Accept Port for Rendezvous
+ RNO *p_rdvno, VP msg, INT *p_cmsgsz, ID porid, UINT ER ercd =pacp_por 
 );
@end example
@end ifset
@@ -220,14 +220,14 @@ ER acp_por (
@c

@page
-@subheading DESCRIPTION:
+@subsection pacp_por -  Poll and Accept Port for Rendezvous

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =pacp_por (
-@c
+ RNO *p_rdvno, VP msg, INT *p_cmsgsz, ID porid, UINT
 );
@end example
@end ifset
@@ -249,14 +249,14 @@ ER ercd =pacp_por (
@c

@page
-@subheading DESCRIPTION:
+@subsection tacp_por -  Accept Port for Rendezvous with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =tacp_por (
-@c
+ RNO *p_rdvno, VP msg, INT *p_cmsgsz, ID porid, UINT
 );
@end example
@end ifset
@@ -278,14 +278,14 @@ ER ercd =tacp_por (
@c

@page
-@subheading DESCRIPTION:
+@subsection fwd_por -  Forward Rendezvous to Other Port

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER fwd_por (
-@c
+ ID porid, UINT calptn, RNO rdvno, VP msg, INT cmsgsz
 );
@end example
@end ifset
@@ -307,14 +307,14 @@ ER fwd_por (
@c

@page
-@subheading DESCRIPTION:
+@subsection rpl_rdv -  Reply Rendezvous

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER rpl_rdv (
-@c
+ RNO rdvno, VP msg, INT rmsgsz
 );
@end example
@end ifset
@@ -336,14 +336,14 @@ ER rpl_rdv (
@c

@page
-@subheading DESCRIPTION:
+@subsection ref_por -  Reference Port Status

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_por (
-@c
+ T_RPOR *pk_rpor, ID porid
 );
@end example
@end ifset
--- a/doc/itron3.0/semaphore.t
+++ b/doc/itron3.0/semaphore.t
@@ -48,6 +48,7 @@ and passed an as argument to the @code{cre_sem} service.  The structure
 is defined as follows:

@example
+@group
 typedef struct t_csem @{
        VP    exinf;    /* extended information */
        ATR   sematr;   /* semaphore attributes */
@@ -64,6 +65,7 @@ sematr:
    TA_TFIFO   H'0...00   /* waiting tasks are handled by FIFO */
    TA_TPRI    H'0...01   /* waiting tasks are handled by priority */

+@end group
@end example

 where the meaning of each field is:
@@ -93,6 +95,7 @@ status and state information on a semaphore.  The structure
 is defined as follows:

@example
+@group
 typedef struct t_rsem @{
        VP      exinf;    /* extended information */
        BOOL_ID wtsk;     /* indicates whether or not there is a
@@ -103,6 +106,7 @@ typedef struct t_rsem @{
       implementation */
                ...
@} T_RSEM;
+@end group
@end example

@table @b
--- a/doc/itron3.0/tasksync.t
+++ b/doc/itron3.0/tasksync.t
@@ -16,13 +16,13 @@ task-dependent synchronization manager is ...
 The services provided by the task-dependent synchronization manager are:

@itemize @bullet
-@item @code{sus_tsk} - Suspend Other Task
-@item @code{rsm_tsk} - Forcibly Resume Suspended Task
- Resume Suspended Task
-@item @code{frsm_tsk} - Forcibly Resume Suspended Task
-@item @code{slp_tsk} - Sleep Task
- Sleep Task with Timeout
-@item @code{tslp_tsk} - Sleep Task with Timeout
+@item @code{sus_tsk} - Suspend Other Task
+@item @code{rsm_tsk} - Resume Suspended Task
+@item @code{frsm_tsk} - Forcibly Resume Suspended Task
+@item @code{slp_tsk} - Sleep Task
+@item @code{tslp_tsk} - Sleep Task with Timeout
+@item @code{wup_tsk} - Wakeup Other Task
+@item @code{can_wup} - Cancel Wakeup Request
@end itemize

@section Background
@@ -42,14 +42,14 @@ and status codes.
@c

@page
-
+@subsection sus_tsk -  Suspend Other Task

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER sus_tsk (
-@example
+ ID tskid
 );
@end example
@end ifset
@@ -71,14 +71,14 @@ ER sus_tsk (
@c

@page
-
+@subsection rsm_tsk -  Forcibly Resume Suspended Task Resume Suspended Task

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER rsm_tsk (
-@ifset is-C
+ ID tskid ER ercd =frsm_tsk 
 );
@end example
@end ifset
@@ -100,14 +100,14 @@ ER rsm_tsk (
@c

@page
-@c  frsm_tsk
+@subsection frsm_tsk -  Forcibly Resume Suspended Task

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ercd =frsm_tsk (
-
+ ID tskid
 );
@end example
@end ifset
@@ -129,14 +129,14 @@ ER ercd =frsm_tsk (
@c

@page
-@c  slp_tsk
+@subsection slp_tsk -  Sleep Task Sleep Task with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER slp_tsk (
-@subheading CALLING SEQUENCE:
+ ER ercd =tslp_tsk 
 );
@end example
@end ifset
@@ -158,14 +158,14 @@ No polling function for slp_tsk is provided.  A similar function can be implemen
@c  tslp_tsk
@c

-No polling function for slp_tsk is provided.  A similar function can be implemented if necessary using can_wup.
+@subsection tslp_tsk -  Sleep Task with Timeout
@subsection tslp_tsk - Sleep Task with Timeout

@subheading CALLING SEQUENCE:

@ifset is-C
 ER ercd =tslp_tsk (
-@subsection tslp_tsk - Sleep Task with Timeout
+ TMO tmout
  TMO tmout
 );
@end example
@@ -187,14 +187,14 @@ If you simply wish to delay a task (make it wait for a while), use dly_tsk rathe
@c  wup_tsk
@c

-If you simply wish to delay a task (make it wait for a while), use dly_tsk rather than tslp_tsk.
+@subsection wup_tsk -  Wakeup Other Task
@subsection wup_tsk - Wakeup Other Task

@subheading CALLING SEQUENCE:

@ifset is-C
 ER wup_tsk (
-@subsection wup_tsk - Wakeup Other Task
+ ID tskid
  ID tskid
 );
@end example
@@ -216,14 +216,14 @@ An E_QOVR error will result if wup_tsk is issued more than the maximum value all
@c  can_wup
@c

-
+@subsection can_wup -  Cancel Wakeup Request
@subsection can_wup - Cancel Wakeup Request

@subheading CALLING SEQUENCE:

@ifset is-C
 ER can_wup (
-@subsection can_wup - Cancel Wakeup Request
+ INT *p_wupcnt, ID tskid
  ID tskid
 );
@end example
--- a/doc/itron3.0/time.t
+++ b/doc/itron3.0/time.t
@@ -16,15 +16,15 @@ time manager is ...
 The services provided by the time manager are:

@itemize @bullet
-@item @code{get_tim} - Get System Clock
-@item @code{set_tim} - Set System Clock
-@item @code{dly_tsk} - Delay Task
-@item @code{def_cyc} - Define Cyclic Handler
-@item @code{act_cyc} - Activate Cyclic Handler
-@item @code{ref_cyc} - Reference Cyclic Handler Status
-@item @code{def_alm} - Define Alarm Handler
-@item @code{ref_alm} - Reference Alarm Handler Status
-@item @code{ret_tmr} - Return from Timer Handler
+@item @code{get_tim} - Get System Clock
+@item @code{set_tim} - Set System Clock
+@item @code{dly_tsk} - Delay Task
+@item @code{def_cyc} - Define Cyclic Handler
+@item @code{act_cyc} - Activate Cyclic Handler
+@item @code{ref_cyc} - Reference Cyclic Handler Status
+@item @code{def_alm} - Define Alarm Handler
+@item @code{ref_alm} - Reference Alarm Handler Status
+@item @code{ret_tmr} - Return from Timer Handler
@end itemize

@section Background
@@ -44,14 +44,14 @@ and status codes.
@c

@page
-@subsection get_tim - Get System Clock
+@subsection get_tim -  Get System Clock

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER get_tim (
- SYSTIME *pk_tim
+ SYSTIME *pk_tim
 );
@end example
@end ifset
@@ -73,14 +73,14 @@ ER get_tim (
@c

@page
-@subsection set_tim - Set System Clock
+@subsection set_tim -  Set System Clock

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER set_tim (
- SYSTIME *pk_tim
+ SYSTIME *pk_tim
 );
@end example
@end ifset
@@ -102,14 +102,14 @@ ER set_tim (
@c

@page
-@subsection dly_tsk - Delay Task
+@subsection dly_tsk -  Delay Task

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER dly_tsk (
- DLYTIME dlytim
+ DLYTIME dlytim
 );
@end example
@end ifset
@@ -131,14 +131,14 @@ ER dly_tsk (
@c

@page
-@subsection def_cyc - Define Cyclic Handler
+@subsection def_cyc -  Define Cyclic Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER def_cyc (
- HNO cycno, T_DCYC *pk_dcyc
+ HNO cycno, T_DCYC *pk_dcyc
 );
@end example
@end ifset
@@ -160,14 +160,14 @@ ER def_cyc (
@c

@page
-@subsection act_cyc - Activate Cyclic Handler
+@subsection act_cyc -  Activate Cyclic Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER act_cyc (
- HNO cycno, UINT cycact
+ HNO cycno, UINT cycact
 );
@end example
@end ifset
@@ -189,14 +189,14 @@ ER act_cyc (
@c

@page
-@subsection ref_cyc - Reference Cyclic Handler Status
+@subsection ref_cyc -  Reference Cyclic Handler Status

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_cyc (
- T_RCYC *pk_rcyc, HNO cycno
+ T_RCYC *pk_rcyc, HNO cycno
 );
@end example
@end ifset
@@ -218,14 +218,14 @@ ER ref_cyc (
@c

@page
-@subsection def_alm - Define Alarm Handler
+@subsection def_alm -  Define Alarm Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER def_alm (
- HNO almno, T_DALM *pk_dalm
+ HNO almno, T_DALM *pk_dalm
 );
@end example
@end ifset
@@ -247,14 +247,14 @@ ER def_alm (
@c

@page
-@subsection ref_alm - Reference Alarm Handler Status
+@subsection ref_alm -  Reference Alarm Handler Status

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 ER ref_alm (
- T_RALM *pk_ralm, HNO almno
+ T_RALM *pk_ralm, HNO almno
 );
@end example
@end ifset
@@ -276,14 +276,14 @@ ER ref_alm (
@c

@page
-@subsection ret_tmr - Return from Timer Handler
+@subsection ret_tmr -  Return from Timer Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
 void ret_tmr (
-
+
 );
@end example
@end ifset