Comandi-# nei sorgenti


Oltre al markup sgml il testo può comprendere tutti i comandi di link. Questi comandi, utilizzabili anche in notes1, sono stati creati specificamente per essere gestiti nei sorgenti e possono essere usati liberamente.

/**
*************************************************************************************
@Fun     Sets the abort handler
@Param   p_abort_ar  IN  A pointer to the abort routine of type #dat(pABORT_AR)
@Descr   
Sets the new abort handler. If the parameter is NULL it calls
#symfun(abort_ar_UnSetRoutine). This '#sym(trade)' is a trade mark.
@/Descr                     ...
*************************************************************************************
**/
...

Sono molto più semplici da usare del corrispondente comando sgml2. Il medesimo esempio scritto usando sgml appare come segue, Si noti che per le entità --- simboli e caratteri speciali --- il formato sgml risulta più conciso.

/**
*************************************************************************************
@Fun     Sets the abort handler
@Param   p_abort_ar  IN  A pointer to the abort routine of type 
                         <LNK dcl="dat" name="pABORT_AR">pABORT_AR</LNK>
@Descr   
<P>
Sets the new abort handler. If the parameter is NULL it calls
<LNK dcl="dat" name="pABORT_AR">pABORT_AR</LMK>. This '&trade;'is a trade mark.
</P>
@/Descr                     ...
*************************************************************************************
**/
...


1 In notes i comandi di link vengono generati automaticamente usando un link notes piuttosto che un hotspot. In notes è necessario usare i comandi # solo quando il documento citato non è gestito in notes.

2 La funzione è esattamente la medesima. La differenza è solo una differenza di notazione.

dsg.tag.ref • LastModified: 14-9-2007 • John Peter Arnold