169 lines
4.3 KiB
Groff
169 lines
4.3 KiB
Groff
.\"
|
|
.\" Created by Ferran Pegueroles using help2man and modified by hand.
|
|
.\" Modified and updated by David Essex.
|
|
.\"
|
|
.TH HTCOBOL 1 "24 giugno 2002"
|
|
.UC 6
|
|
.SH NOME
|
|
htcobol \- compilatore COBOL 85
|
|
.SH SINTASSI
|
|
.B htcobol
|
|
[
|
|
.I opzioni
|
|
]
|
|
.I nome_file
|
|
.SH "DESCRIZIONE"
|
|
Un compilatore per il
|
|
\fBCO\fRmmon
|
|
\fBB\fRusiness
|
|
\fBO\fRriented
|
|
\fBL\fRanguage,
|
|
\fBCOBOL\fR.
|
|
.PP
|
|
.I Htcobol
|
|
legge il sorgente COBOL dal file
|
|
.I nome_file
|
|
e, in funzione delle opzioni, preprocessa, compila, assembla e linka
|
|
generando un file binario eseguibile.
|
|
.PP
|
|
Il compilatore genera GNU assembler per la piattaforma IA32 (i386).
|
|
Con l'ausilio degli strumenti \fBGCC\fR,
|
|
questo codice intermedio puo` essere assemblato e linkato producendo un file binario eseguibile.
|
|
.PP
|
|
Il file binario eseguibile puo` essere prodotto direttamente dal compilatore, oppure puo` essere generato un codice assembler intermedio ed usare poi la procedura
|
|
.I Makefile
|
|
per le fasi di assemblaggio e di link.
|
|
.PP
|
|
Il compilatore riconosce divere opzioni nella linea di comando, come descritto di seguito.
|
|
.PP
|
|
E` possibile ottenere un testo d'aiuto eseguendo htcobol con l'opzione
|
|
.B \-h.
|
|
.PP
|
|
.SH "FILES D'INIZIALIZZAZIONE"
|
|
Svariate opzioni per il compilatore possono essere configurate nella linea di comando e/o utilizzando il file delle opzioni.
|
|
.PP
|
|
Il nome di default del file delle opzioni e`
|
|
.I htcobolrc\fR.
|
|
.PP
|
|
La precedenza di ogni opzione di compilazione e` descritta di seguito:
|
|
.TP
|
|
1.
|
|
Opzione su linea di comando, se disponibile.
|
|
.TP
|
|
2.
|
|
Variabile d'ambiente, se disponibile.
|
|
.TP
|
|
3.
|
|
Il file delle opzioni, se disponibile.
|
|
.TP
|
|
4.
|
|
Opzioni di compilazione di default, se definite.
|
|
.SH "OPZIONI"
|
|
.B Opzioni specifice del Compilatore:
|
|
.TP
|
|
\fB\-h\fR
|
|
Visualizza l'aiuto.
|
|
.TP
|
|
\fB\-a\fR
|
|
Crea libreria statica; Preprocessa, compila, assembla e comprime
|
|
.TP
|
|
\fB\-B\fR
|
|
mode Specifica la modalita` di collegamento (statica/dinamica)
|
|
.TP
|
|
\fB\-c\fR
|
|
Compila generando un modulo oggetto linkato staticamente
|
|
.TP
|
|
\fB\-E\fR
|
|
Invoca il preprocessore inviando il risultato nello 'standard output'; non compila, ne` assembla o linka.
|
|
.TP
|
|
\fB\-g\fR
|
|
Genera un file utilizzabile per il debugging
|
|
.TP
|
|
\fB\-l\fR <nome>
|
|
Aggiungi la libreria 'nome' nella fase di link
|
|
.TP
|
|
\fB\-L\fR <dir>
|
|
Aggiungi la cartella 'dir' nel percorso di ricerca delle librerie
|
|
.TP
|
|
\fB\-m\fR
|
|
Crea una libreria d'uso comune (shared); preprocessa, compila, assembla e linka
|
|
.TP
|
|
\fB\-n\fR
|
|
Non esegue alcun comando; visualizza solo cio` che farebbe
|
|
.TP
|
|
\fB\-o\fR <file>
|
|
Specifica il file da genereare
|
|
.TP
|
|
\fB\-S\fR
|
|
Preprocessa, compila (genera codice assembler) solo; non assembla o linka
|
|
.TP
|
|
\fB\-t\fR
|
|
Non rimuove i files intermedi (assembly file, COBOL file da pre-processo) generati
|
|
durante la compilazione.
|
|
.TP
|
|
\fB\-v\fR
|
|
Genera messaggi estesi durante la compilazione
|
|
.TP
|
|
\fB\-V\fR
|
|
Visualizza la versione del compilatore and esce
|
|
.TP
|
|
\fB\-Wl,<options> \fR
|
|
Passa <opzioni> (separate da virgola) al linker
|
|
.TP
|
|
\fB\-x\fR
|
|
Genera un modulo eseguibile
|
|
.TP
|
|
\fB\-z\fR
|
|
Genera messaggi molto estesi durante la compilazione
|
|
.PP
|
|
.B opzioni specifiche COBOL:
|
|
.TP
|
|
\fB\-C\fR
|
|
Rendi tutte le 'calls' COBOL dinamiche
|
|
.TP
|
|
\fB\-D\fR
|
|
Includi le linee di sorgente per il debugging
|
|
.TP
|
|
\fB\-F\fR
|
|
Il sorgente in ingresso e` formattato in modalita` standard (fixed column)
|
|
.TP
|
|
\fB\-I\fR <path>
|
|
Definisce le cartelle 'path' di ricerca delle 'include' (copybooks) (default \-I./)
|
|
Il percorso puo` essere sia una singola cartella, sia un elenco di
|
|
cartelle separate da ":" (";" su piattaforma Win32).
|
|
.TP
|
|
\fB\-P\fR
|
|
Genera un listato di compilazione
|
|
.TP
|
|
\fB\-T\fR <num>
|
|
Converti i 'tabs' in 'num' spazi (default T=8)
|
|
.TP
|
|
\fB\-X\fR
|
|
Il sorgente in ingresso ha la formattazione libera (X/Open free format) (default format)
|
|
.PP
|
|
.SH "FILES"
|
|
.TP
|
|
.I htcobolrc\fR file risorse delle opzioni.
|
|
.TP
|
|
.I htrtconf\fR file risorse delle opzioni run-time.
|
|
.SH VARIABILI D'AMBIENTE
|
|
.TP
|
|
.B TCOB_OPTIONS_PATH
|
|
Percorso della cartella contenente il file delle opzioni.
|
|
.TP
|
|
.B TCOBRT_CONFIG_DIR
|
|
Percorso della cartella contenente il file delle opzioni run-time.
|
|
.TP
|
|
.B TCOB_LD_LIBRARY_PATH e \fB LD_LIBRARY_PATH
|
|
Percorso di ricerca delle librerie caricate dinamicamente.
|
|
.TP
|
|
.B TEMP
|
|
Percorso della cartella dei files temporanei.
|
|
.SH "VEDI ANCHE"
|
|
GCC(1), as(1), ld(1), make(1).
|
|
|
|
|
|
.SH "Traduzione"
|
|
Eseguita da Mario Lodi Rizzini (mlodirizzini@libero.it).
|
|
|