Riga del titolo¶

Si noti che le pagine formattate con l'mdoc di BSD iniziano col comando Dd invece che col comando TH.

Sezioni¶

L'unica intestazione obbligatoria è NOME, che dovrebbe essere la prima sezione e dovrebbe essere seguita, sulla riga successiva, da una descrizione del programma della lunghezza di una riga:

Per un elenco di altre sezioni che potrebbero apparire in una pagina di manuale si veda man-pages(7).

Tipi di carattere¶

.B

Grassetto

.BI

Grassetto alternato a corsivo (molto utile per le specifiche delle funzioni)

.BR

Grassetto alternato a tondo (molto utile per fare riferimento ad altre pagine di manuale)

.I

Corsivo

.IB

Corsivo alternato a grassetto

.IR

Corsivo alternato a tondo

.RB

Tondo alternato a grassetto

.RI

Tondo alternato a corsivo

.SB

Maiuscoletto alternato a grassetto

.SM

Maiuscoletto (utile per gli acronimi)

Tradizionalmente, ogni comando può avere fino a sei argomenti, ma l'implementazione GNU rimuove questa limitazione (ci si può comunque limitare a sei argomenti per compatibilità). Gli argomenti sono delimitati da spazi. Le virgolette doppie possono essere usate per specificare un argomento che contiene spazi. Tutti gli argomenti verranno stampati uno vicino all'altro senza spazi, così il comando .BR può essere usato per specificare una parola in grassetto seguita da un punto in tondo. Se non ci sono argomenti, il comando si applica alla successiva riga di testo.

Altre macro e stringhe¶

Paragrafi normali¶

.LP

Lo stesso di .PP (inzia un nuovo paragrafo).

.P

Lo stesso di .PP (inzia un nuovo paragrafo).

.PP

Incomincia un nuovo paragrafo e reimposta il rientro dominante.

Rientro relativo del margine¶

.RS i

Inizia un rientro relativo del margine; sposta di i il margine sinistro verso destra (se i è omessa, viene usato il valore del rientro principale). Un nuovo rientro principale viene impostato a mezzo pollice; di conseguenza, tutti i paragrafi seguenti vengono rientrati fino al corrispondente .RE.

.RE

Termina il rientro relativo del margine e ripristina il valore precedente del rientro dominante.

Macro per paragrafi rientrati¶

.HP i

Inizia il paragrafo con un rientro a bandiera (la prima riga del paragrafo inizia al margine sinistro dei paragrafi normali mentre il resto delle righe del paragrafo è indentato).

.IP x i

Paragrafo rientrato con un'etichetta opzionale a bandiera. Se l'etichetta x è omessa, l'intero paragrafo seguente è rientrato di i. Se l'etichetta x è presente, viene allineata al margine sinistro prima del paragrafo rientrato seguente (è la stessa cosa di .TP tranne per il fatto che l'etichetta è inclusa nel comando invece di trovarsi sulla riga successiva). Se l'etichetta è troppo lunga, il testo che la segue viene spostato alla riga seguente (e non verrà né perso né impiastricciato). Per gli elenchi puntati, si usi questa macro con \(bu (pallino) o \(em (trattino lungo) come etichetta; per gli elenchi numerati, si usi il numero o la lettera seguiti da un punto come etichetta: ciò semplifica la conversione verso altri formati.

.TP i

Incomincia il paragrafo con un'etichetta a bandiera: l'etichetta è sulla riga seguente, ma il risultato è lo stesso del comando .IP.

Macro per collegamenti ipertestuali¶

.URL url link trailer

Inserisce un collegamento ipertestuale all'URI (URL) url, con link come testo del collegamento. Il trailer verrà stampato immediatamente dopo. Quando si genera l'HTML, questo dovrebbe essere tradotto nel comando HTML <A HREF="url">link</A>trailer.

Questo «macro», e altre ad essa relative, sono nuove e molti strumenti non sapranno cosa farsene, ma considerando che molti strumenti (troff incluso) ignorano tranquillamente le macro indefinite (o, al peggio, inseriscono il loro testo), si possono inserire senza problemi.

Può essere utile definire la propria macro URL nelle pagine di manuale per facilitare coloro che la vedono con un visualizzatore roff piuttosto che con groff. In questo modo URL, testo del collegamento, e testo collegato (se c'è) saranno ancora visibili.

Ecco un esempio:

Nell'esempio qui sopra, se è stato usato groff la definizione della macro URL del pacchetto macro www.tmac sostituirà quella definita localmente.

È disponibile un certo numero di altri collegamenti macro. Si veda groff_www(7) per maggiori dettagli.

Macro varie¶

.DT

Riporta le tabulazioni al valore di tabulazione predefinito (ogni mezzo pollice); non causa un'interruzione.

.PD d

Imposta la distanza verticale tra paragrafi a d (se omesso, d=0.4v); non causa un'interruzione.

.SS t

Sottotitolo t (come .SH, ma usato per una sottosezione in una sezione).

Stringhe predefinite¶

\*R

Simbolo di registrazione: ®

\*S

Torna alla dimensione predefinita del carattere

\*(Tm

Simbolo del marchio registrato: (Tm)

\*(lq

Doppie virgolette verso sinistra: “

\*(rq

Doppie virgolette verso destra: ”

Sottoinsieme sicuro¶

Si possono anche usare molte sequenze di escape di troff (queste sequenze iniziano con \). Quando si ha la necessità di includere il carattere backslash come testo normale usare \e. Altre sequenze che si possono usare, dove x o xx sono caratteri qualsiasi e N è un numero qualunque, includono: \', \`, \-, \., \", \%, \*x, \*(xx, \(xx, \$N, \nx, \n(xx, \fx, e \f(xx. Evitare di usare sequenze di escape per disegni grafici.

Non usare il parametro opzionale per bp (interruzione pagina). Usare solo valori positivi per sp (spazio verticale). Non definire una macro (de) con lo stesso nome di una macro in questo o nel pacchetto macro mdoc con un diverso significato; è facile che queste ridefinizioni vengano ignorate. Ogni rientro positivo (in) deve essere accompagnato da un corrispondente rientro negativo (anche se si dovrebbero usare le macro RS e RE al loro posto). Il test condizionale (if,ie) deve avere solo 't' o 'n' come condizione. Solo le traduzioni (tr) che possono essere ignorate devono essere usate. I cambiamenti del tipo di carattere (ft e la sequenza di escape \f ) devono avere solo i valori 1, 2, 3, 4, R, I, B, P, o CW (il comando ft può anche non avere parametri).

Se si usano potenzialità oltre a queste, si verifichino attentamente i risultati con diversi strumenti. Una volta confermato che la capacità aggiuntiva è sicura mettete a conoscenza il curatore di questo documento del comando o sequenza sicura che deve essere aggiunta a questo elenco.