ArDoc • DAF

Analisi

REQ cat • nome

Disegno Logico
DSG cat • nome
MAN cat • nome

Disegno Tecnico
DST cat • nome
SYS cat • nome

DAF nome
DAT nome
KON nome

CLA nome
FUN nome

SRC cat • nome

Disegno Utente
DSU cat • nome

JOB nome
UUI nome
RPT nome

Varie
AMM cat • nome
QCL cat • nome
RIS cat • nome

e-mail

Sys	scan
Src	ScanSource.ini

ScanSource.ini • Ini Scansione Sorgenti

Directory	%DARDAT% • dir.dardat • dardat -- Directory Root dei Dati
Tipo di File	tagged • ... tagged ...

Questo file pilota la procedura di scansione dei sorgenti. Il file viene letto da src.NewScanSource.pl.

group ScanSourceIni

Parametri di Scansione Sorgenti	seq group

Vi sono tre gruppi di parametri. Ognuno dei quali � una sezione del file ini.

SrcCatMethod ?

Metodo per la formazione della categoria

seq group SrcCatMethod

Keys ?

Valori delle chiavi

seq group Keys

Scan +

Sezione di controllo della scansione

seq group Scan

group SrcCatMethod

Metodo per la formazione della categoria	seq group

I tre parametri di questo gruppo controllano come sono formate le tre parti che compongono la categoria. Ciascuna parte pu� assumere uno di questi valori:

system, si usa il sistema indicato sul sorgente. Se non viene usato per formare la categoria dei sorgenti il sistema viene comunque usato come default di eventuali documenti generati dal sorgente.
Keys, si usano le chiavi indicate nel sorgente. Spesso questo argomento viene usato congiuntamente con il parametro DefaultKey.
Group, il gruppo di appartenenza del sorgente. Il gruppo � determinato dal suffisso (v. Tipi di files sorgente).

E' possibile indicare fino a tre chiavi. Se non si indica nulla il sistema assume la sequenza: system, keys, group.

First ?

Prima Chiave

string

Second ?

Seconda Chiave

string

Deve essere stata dichiarata la prima.

Third ?

Terza Chiave

string

Deve essere stata dichiarata la seconda. */

group Keys

Valori delle chiavi	seq group

Se la categorizzazione dei sorgenti utilizza le keys all'interno del sorgente, il sistema crea un insieme di categorie basate sui valori assunti dalla keys. Questa sezione permette di decodificari queste keys.

I campi di questa sezione non sono predefiniti. La chiave indica un codice utilizzato come key nei sorgenti. Il valore della chiave contiene la decodifica da utilizzare.

Nell'elenco abbiamo indicato i codici key predefiniti utilizzati dal sistema.

nome *

Codice di una key

string

Abbiamo usato la stringa nome per indicare come si poteva che si tratta di una qualunque stringa che corrisponde ad un codice assegnato come key nei sorgenti.

std

Applicazione standard (c puro)

string

base

Applicazione AR base (quasi c puro)

string

cui

Applicazione AR con interfaccia a caratteri

string

gui

Applicazione AR con interfaccia grafica

string

batch

Applicazione AR con interfaccia batch

string

main

Il sorgente � una mainline

string

mod

Il sorgente � un modulo (obj linkato)

string

lib

Il sorgente � parte di una libreria

string

group Scan

Sezione di controllo della scansione	seq group

Il nome di questa sezione pu� variare per ovviare al fatto che i files ini non possono contenenre pi� volte la medesima sezione. L'uso � di preparare un nome come "Scan cmd" che richiami il tipo di files da scandire. Viene creata una sezione per ogni gruppo di files che si vogliono scandire.

Dir

Directory in cui sono collocati i files da scandire

string

Base

Nome o pattern dei files da scandire (es. '*')

string

Ext

Estensione dei files da scandire

string

NamePrefix

Prefisso al nome del sorgente

string

Un prefisso che viene aggiunto al nome nel generare il documento src. Evita conflitti di nomi se la scansione viene fatta su pi� directory. Ovviamente non � ammesso il separatore '\' n� il separatore '/'. Usate invece come separatore '.'.

ListFile

Nome del file dove scrivere la testata dei sorgenti

string

Nel caso dei sorgenti 'C' e 'C++' questo file pu� essere utilizzato per aggiornare i sorgenti di provenienza. Il metodo permette di semplificare la messa in scansione dei sorgente, soprattutto quando sono molto numerosi.

ListOkFiles

Attivare lista per files OK

string

Valore (Y)es, (N)o.

ListBadFiles

Attivare lista per files senza testata

string

Valore (Y)es, (N)o.

UseKeys

Usare le keys dei sorgenti

string

Valore (Y)es, (N)o.

AutoKeys

Generare le keys dei sorgenti

string

Si vuole che il sistema deduca le keys esaminando il sorgente. Pu� essere fatto solo per i programmi C. Vengono in questo modo gestite le chiavi standard. Queste chiavi si aggiungono a quelle presenti sul sorgente e ad una eventuale chiave default. I valori, che abbiamo gi� visto nella sezione keys sono: std, base, cui, gui, batch, main, mod, lib.

DefaultKey

Key default

string

Valore (Y)es, (N)o.

Una chiave che viene aggiunta automaticamente ai sorgenti se non sono presenti chiavi. Associato al parametro "UseKeys=No" comporta una forzatura e vengono ignorate le chiavi presenti nel sorgente.

ScanBody

Richiesta scansione del copro del sorgente

string

Valore (Y)es, (N)o.

SrcDocument

Generare documento SRC

string

Valore (Y)es, (N)o.

SrcDocumentOldStyle

Generare documento SRC con testate old-style

string

Valore (Y)es, (N)o.

Il documento SRC viene generato solo per quei sorgenti che hanno la testata new-style.

Codice

[SrcCatMethod]
    First=system
    Second=group
    Third=keys
[Keys]
    main=Mainline
    mod=Moduli
    lib=Libreria
    class=Classi
[Scan cmd]
    Dir=q:\dar\job
    Base=*
    Ext=cmd
    ListFile=n:\ardoc_t\c\job.lst
    ListOkFiles=No
    ListBadFiles=No
    UseKeys=No
    AutoKeys=No
    DefaultKey=jobs
    SrcDocument=Yes
    SrcDocumentOldStyle=No
    ScanBody=No
[Scan mnu]
    Dir=q:\dar\c
    Base=*
    Ext=darm
    UseKeys=No
    AutoKeys=No
    SrcDocument=No
    SrcDocumentOldStyle=No
    ScanBody=Yes

Links verso

Disegno Logico
: src.groups • Tipi di files sorgente
Sorgenti
: NewScanSource.pl • Mainline Scansore sorgenti

Links da

Disegno Logico
: src.ini • Parametri di scansione
Disegno Tecnico
: 41EUJ2N • Files di Inizializzazione
: 42LGNWS • Generazione dei files SGML dai sorgenti
: 42MN4VY • Gestione del Gruppo di Sorgenti
Lavori Batch
: NewScanSource • Scansione Sorgenti e Generazione Documenti SGML
Sorgenti
: NewScanSource.cmd • Scansione Sorgenti e Generazione Documenti SGML