Il sorgente di un file ini riceve il seguente trattamento:
- I commenti ini vengono trasformati internamente in commenti 'C'.
- Il testo cosi trasformato viene dato in pasto alla scansione c.
La trasformazione dei commenti avviene in questo modo. Viene esaminato il file ini e le righe comprese tra ";/**"
e ";**/" vengono traformate in commenti 'C'. Un commento ini con questa forma.
;/**
;@Daf scan :: CheckLinks.ini : Ini Controllo Links Html
;@DafType Tag
;@Dir dst.dir.dardat
;@DirEnv %DARDAT%
;@Descr
;<P>Questo file <I>pilota</I> la procedura di controllo dei
;link <SMALL>HTML</SMALL>.</P>
;@/Descr
;**/
;/** @Decl
;group CheckLinks // Parametri di Verifica Link Html
;{
;group Parms
;{
;string ArWebServer; // Nome del Web Server da controllare
;string SkipHttpDocuments; // Flag se saltare i documenti http 'esterni'
;};
;};
;@/Decl **/
[Parms]
ArWebServer=http://ar3.ar-ent.net
SkipHttpDocuments=yes
;/** @/Daf **/
|
Diventa:
/**
@Daf scan :: CheckLinks.ini : Ini Controllo Links Html
@DafType Tag
@Dir dst.dir.dardat
@DirEnv %DARDAT%
@Descr
<P>Questo file <I>pilota</I> la procedura di controllo dei
link <SMALL>HTML</SMALL>.</P>
@/Descr
**/
/** @Decl
group CheckLinks // Parametri di Verifica Link Html
{
group Parms
{
string ArWebServer; // Nome del Web Server da controllare
string SkipHttpDocuments; // Flag se saltare i documenti http 'esterni'
};
};
@/Decl **/
[Parms]
ArWebServer=http://ar3.ar-ent.net
SkipHttpDocuments=yes
/** @/Daf **/
|
In questo esempio la documentazione riceve sia il commento di apertura Daf che un blocco di codice. Questo blocco di codice viene incorporato nel documento creato. Inoltre all'interno del codice è stata creata una zona Decl che a sua volta viene parsata e completa il documento generato. Il risultato della scansione di questo sorgente è visibile esaminando daf.CheckLinks.ini.
Con questa traformazione tutto il sorgente ini è trattabile come codice 'C' e tutti i tags gestiti da Riepilogo dei Tag, sono gestibili in un sorgente ini.
e-mail