Files
Questi sorgenti rappresentano un programma scritto in Perl.
I suffissi previsti sono: ".pl", ".pm".
Testata
Il codice che segue mostra la testata standard.
=arhead
**************************************************************
Title: Scansione testata Sorgenti Sgml
**************************************************************
Author: jparn@ar-ent.net
Date-Composed: 6-9-2000
Date-Changed:
System: auto
Keys: mod
**************************************************************
Description:
<P>Il sorgente scandisce la testata di un sorgente SGML, XML, HTML.
In pratica isola il primo blocco di commenti tra "<!--" e
"-->". Prende questo blocco e lo passa a #src(NewScanSourceHeadAr.pl).
</P>
**************************************************************
Revisions:
$Header$
$Log$
**************************************************************
=cut
|
Le regole di parsing di questa testata sono le seguenti:
- La testata è all'inizio del programma. Può essere preceduta unicamente da "white-space".
- La prima riga contiene un inizio di blocco "=arhead". Questa stringa deve essere in colonna 1.
- L'ultima riga contiene un fine blocco "=cut". Questa stringa deve essere in colonna 1.
- Le parole chiave iniziano in colonna 1. Una parola chiave chiude il contenuto della parola chiave precedente.
- Un "*" in colonna 1 chiude il contenuto della parola precedente.
Dalla testata vengono estratti e gestiti i seguenti campi:
Tag di Testata programmi Perl
Tag |
Regola |
Title: |
Titolo o descrizione breve del programma. |
Author: |
Autore del programma. Deve essere un e-mail. Il sistema cerca di ricostruire l'e-mail grazie ai files di supporto. |
Written: |
Qutore del sorgente. |
Date-Composed: |
Data di creazione del sorgente. |
Date-Changed: |
Data di ultima modifica. Se assente il sistema cerca di ricavarla dalle revisioni. |
System: |
Il sistema o sotto-sistema cui appartiene il sorgente. |
Keys: |
Parole chiave relative alle caratteristiche Tecniche del programma. Sono parole separate da virgola. |
Description: |
Un testo in formato %body.full che descrive il contenuto del sorgente. |
Revisions: |
Blocco descrittivo delle modifiche apportate. Il blocco è composto da un insieme di singoli blocchi Revision. Il tutto è chiuso da un "*" in colonna 1. |
Revision |
Inizio singola revisione. La riga ha il seguenti formati: - "Revision nnn.nnn aaaa-mm-gg hh:mm:ss sigla-autore".
- "Revision gg-mm-aaaa sigla-autore"
Il primo formato è compatibile con i programmi automatici di gestione delle revisioni. Il secondo formato può essere utilizzato manualmente. Una o più riche sucessive in formato %body.mini. Quete riche vengono chiuse da: - Una nuova riga di inizio revisione.
- Un '*' in colonna 1.
|
e-mail