src.c: Programmi C e C++

dcl	SRC: File sorgente
dtd	SRC -- Sorgenti
Nome	Il nome del sorgente
Titolo	Il titolo del sorgente
Sistema	Il sistema di appartenenza
Sorgente	Si agisce sui files con suffisso c e cpp. Si veda Testata C e C++ per il formato di compilazione.

Sono utili le seguenti chiavi standard, che possono essere generate automaticamente dallo scansore:

• Tipo applicazione:
• STD, applicazione standard
• BASE, applicazione Base
• CUI, Applicazione Cui
• GUI, Applicazione Gui
• BATCH, Applicazione Batch
• Tipo programma:
• MAIN, Mainline
• MOD, Modulo Chiamato
• LIB, Modulo di Libreria

E' utile produrre una breve descrizione per i soli sorgenti di tipo batch-main. In questo caso è utile indicare l'input e output del programma.

I link verso comprendono i seguenti dcl:

• dst, Quando viene creato un documento che descrive in modo esteso il funzionamento del programma.

I link da per i src main comprendono i seguenti dcl:

• uui: Voce di menu.
• src: Sorgente di un job.

Questi sorgenti possono comportare la generazione di documenti automatici. Tipicamente:

• fun.c: Funzione C
• fun.cpp: Metodo di una Classe C++
• fun.c: Macro C
• job.main: Job Principale

E utile riportare tutte le principali modifiche effettuate. Si evitano descrizioni troppo lunghe creando piuttosto un link ad un documento di modifica dst.mdf: Modifica.

Quando si migra da una procedure esistente è utile procedere a livelli:

• 1° Livello:
• Si verifica il titolo del sorgente.
• Si assegna un sistema default.
• Si assegna o si verificano le chiavi.
• Si sandiscono le testate, v. Scansione Testata dei Programmi.
• 2° Livello:
• Si riportando l'eventuale collegamento al documento dst.
• 3° Livello:
• Si modificano i commenti nei sorgenti per attivare la generazione dei documenti automatici.