mal di testa - Online nel cloud

PROGRAMMA:

NOME

mal di testa - Un programma per gestire la licenza del file sorgente.

SINOSSI

mal di testa [-H filetto] [-C filetto] [-r] [-aiuto | --aiuto] filetto...

DESCRIZIONE

Questa pagina di manuale documenta brevemente il mal di testa comando.

Questa pagina di manuale è stata scritta per la distribuzione Debian GNU/Linux perché l'originale
il programma non ha una pagina di manuale.

È un uso comune mettere all'inizio dei file di codice sorgente una breve intestazione che dia,
per esempio, alcune informazioni sul copyright. mal di testa è uno strumento semplice e leggero per
gestire facilmente queste intestazioni. Tra le sue funzionalità si possono citare:

· Le intestazioni devono essere generalmente generate come commenti nei file di codice sorgente. mal di testa offerte
con diversi tipi di file e genera per ciascuno di essi intestazioni in modo appropriato
formato.

· Intestazioni rileva automaticamente le intestazioni esistenti e le rimuove. Quindi, puoi usarlo
per aggiornare le intestazioni in un insieme di file.

COMANDO LINE VERSIONI

filetto
Nome di un file da elaborare

-hfile
Crea un'intestazione con testo proveniente da file

-c
Leggi il file di configurazione indicato

-aiuto aiuto
Visualizza l'elenco delle opzioni di mal di testa

USO

Illustriamo l'uso di questo strumento con un piccolo esempio. Supponi di avere un piccolo
progetto che mescola codice C e Caml composto da tre file 'foo.c', 'bar.ml' e 'bar.mli'',
e vuoi equipaggiarli con qualche intestazione. Prima di tutto, scrivi un file di intestazione, ad esempio a
il file di testo normale che include le intestazioni delle informazioni deve menzionare. Un esempio di tale file
è dato nella figura 1. Di seguito, assumiamo che questo file si chiami 'myheader' e sia in
la stessa directory dei file sorgente.

Quindi, per generare le intestazioni, esegui semplicemente il comando: mal di testa -h la mia intestazione foo.c
bar.ml bar.ml

Ogni file è dotato di un'intestazione che include il testo fornito nel file di intestazione
'myheader', circondato da alcuni caratteri extra a seconda del suo formato che lo rendono un
commento (es. '(*' e '*)' nei file '.ml'). Se aggiorni il file di intestazione 'myheader',
è sufficiente eseguire nuovamente il comando precedente per aggiornare le intestazioni nei file del codice sorgente.

Allo stesso modo, eseguendo: mal di testa -r foo.c bar.ml bar.ml rimuove qualsiasi esistente nei file
'foo.c', 'bar.ml' e 'bar.mli'. I file che non hanno un'intestazione vengono mantenuti invariati.

CONFIGURAZIONE RISORSE

I tipi di file e il formato dell'intestazione possono essere specificati da un file di configurazione. Per impostazione predefinita, il
viene utilizzato il file di configurazione predefinito predefinito fornito nella figura 2. Puoi anche usare il tuo
file di configurazione grazie al -c opzione : mal di testa -c la mia configurazione -h la mia intestazione foo.c bar.ml
bar.ml

Per scrivere la propria configurazione è possibile seguire l'esempio riportato in figura 2. A
Il file di configurazione consiste in un elenco di voci separate dal carattere '|'. Ciascuna di
loro è composto da due parti separate da un '->'.

La prima è un'espressione regolare. (Le espressioni regolari sono racchiuse tra double
virgolette e hanno la stessa sintassi di Gnu Emacs.) mal di testa determina i tipi di file
in base ai nomi di base dei file; quindi, ogni file viene trattato usando la prima riga il suo nome
partite.

La seconda descrive il formato delle intestazioni per i file di questo tipo. Si compone di
nome di un modello (es. 'frame'), possibilmente seguito da un elenco di argomenti. Gli argomenti sono
named: 'open:"(*"' significa che il valore dell'argomento 'open' è '(*'. mal di testa
attualmente supporta tre modelli e una parola chiave speciale:

telaio
Con questo modello, le intestazioni vengono generate in un frame. Questo modello ne richiede tre
argomenti: 'open' e 'close' (le sequenze di apertura e chiusura per i commenti) e
'linea' (il carattere utilizzato per creare le linee orizzontali della cornice). Due optional
gli argomenti possono essere usati 'margine' (una stringa stampata tra il lato sinistro e destro di
la cornice e il bordo, di default due spazi) e 'larghezza' (la larghezza dell'interno
del telaio, il valore predefinito è 68).

Linee
Le intestazioni sono composte tra due righe. Devono essere forniti tre argomenti: 'aperto' e
'chiudi' (la sequenza di apertura e chiusura per i commenti), 'linea' (il carattere usato
per fare le linee orizzontali). Sono consentiti tre argomenti opzionali: 'begin' (una stringa
tipo all'inizio di ogni riga, per impostazione predefinita due spazi), 'last' (una stringa
tipo all'inizio dell'ultima riga) e 'width' (la larghezza delle righe,
il valore predefinito è 70).

no
Questo modello non genera intestazioni e non ha argomenti.

Salta
Salta la riga corrispondente a uno dei parametri "match" regexp. Per questo tipo di
linea, viene preso in considerazione ogni modello della prima parte che corrisponde al nome base del file.

Usa il mal di testa online utilizzando i servizi onworks.net