5.1. Paragrafi

Il comando principale per iniziare un nuovo paragrafo è .P [tipo].

Se tipo è uguale a 0 o è assente, la prima linea del paragrafo viene allineata a sinistra, altrimenti viene indentata del numero di spazi specificato nel registro Pi.

Si può specificare il tipo di paragrafo di default utilizzando il registro Pt (paragraph type). Il valore di default (0) definisce paragrafi non indentati; con il valore 1 il comando .P definisce paragrafi indentati mentre con il valore 2 si ottengono paragrafi indentati fuorché dopo i comandi .H, .DE e .LE.

5.2. Spaziatura verticale

Per creare uno spazio vuoto verticale si utilizza il comando .SP [linee].

Al numero di linee può essere aggiunto anche un indicatore dell'unità di misura, come 3i (3 pollici) o 8v (8 V). Se il parametro linee è assente viene utilizzato il valore 1, ottenendo una linea vuota.

5.3. Salti pagina

Per iniziare una nuova pagina si usa il comando .SK [pagine]

Se il parametro pagine è 0 o viene omesso, verrà iniziata una nuova pagina, a meno che non ci si trovi già a inizio pagina; altrimenti verrà saltato un numero di pagine pari al valore del parametro.

5.4. Corpo dei caratteri

La macro .S [dimensione [spaziatura]] definisce il corpo dei caratteri e la spaziatura verticale delle linee. Il comando:

  .S 12 14

è equivalente ai comandi troff:

  .ps 12
  .vs 14

Per i due argomenti vengono accettati anche i valori P, C e D; in questo caso, se si specifica il valore P per uno dei due argomenti, allora viene ripristinato il valore precedente per quell'argomento. C indica il valore corrente e D il valore di default. Specificando `+' o `-' prima dell'argomento si ottiene l'effetto di incrementare o decrementare il valore dello stesso.

5.5. Giustificazione

Si può selezionare la giustificazione a destra con .SA 1 (che è il valore di default). Con .SA 0 si ottengono invece paragrafi non giustificati.

5.6. Tipo di carattere

Per cambiare il tipo di carattere si possono usare vari comandi: .B (bold = neretto), .R (roman = tondo normale), .I (italic = corsivo), .CW (constant width = non proporzionale)

e .P (previous = precedente).

La sintassi esatta di questi comandi è, per esempio: .B [arg.neretto [arg.font precedente [neretto [...]]]].

Inoltre esistono i comandi:

  .BI
  .BR
  .IB
  .IR
  .RB
  .RI

il cui significato è equivalente ai precedenti ma che alternano tra corsivo, tondo e neretto.

5.7. Intestazioni

Il pacchetto mm consente di formattare automaticamente vari tipi di intestazioni, quali titoli di capitoli, paragrafi e sezioni: le intestazioni possono essere numerate automaticamente. Inoltre è possibile stabilire le convenzioni da utilizzare per i tipi e le dimensioni dei caratteri per le intestazioni.

La macro per definire un'intestazione è .H livello [testo [suffisso]]. Il livello dell'intestazione può variare tra 1 (livello più alto) e 7. Il testo deve essere compreso tra doppi apici se contiene spazi. Il suffisso viene aggiunto al testo nell'intestazione ma non nell'indice; questa caratteristica viene generalmente usata per note a pié di pagina.

La macro .HU serve per creare un'intestazione non numerata. Alcuni esempi:

  .H 1 "Il linguaggio di comandi di troff"
  .H 2 "Comandi fondamentali"
  .H 3 "Paragrafi"
  .HU "Intestazione senza numero"

Si noti che un'eventuale .P dopo un comando .H viene ignorato, perché .H si prende già cura della formattazione e dell'indentazione.

I formati dei vari livelli di intestazione possono essere specificati con grande dettaglio utilizzando alcuni registri, descritti nel seguito.

  .ds HF 2 2 2 2 2 2 2

  .ds HP 14 12 10 10 0 0 0

5.8. Elenchi

Il supporto per gli elenchi fornito dal pacchetto mm è eccellente. Tutte le liste iniziano con la macro .LB e terminano con la macro .LE. Gli elementi della lista vengono definiti con la macro .LI.

Si possono definire vari tipi di liste, utilizzando sette macro predefinite che richiamano LB con vari argomenti (probabilmente solo le prime tre fanno parte delle macro standard; le altre sono proprie di groff_mm).

  .AL   Lista a incremento automatico
  .BL   Lista con pallini
  .DL   Lista con trattini
  .ML
  .VL
  .RL
  .BVL

La macro .AL [tipo [indentazione [1]]], definisce l'inizio di una lista a incremento automatico. Il parametro tipo definisce il tipo di numero da utilizzare: 1 = numeri (default), A = lettere maiuscole, a = lettere minuscole, I = numeri romani in maiuscolo, i = numeri romani in minuscolo.

Anche la macro LI accetta un argomento, che viene utilizzato per sostituire il normale contrassegno.

Le liste possono essere annidate; per esempio:

  1.  Primo elemento

  +   Secondo elemento

       i.  Primo elemento annidato

      ii.  Secondo elemento annidato

  3.  Terzo elemento

La lista precedente è stata ottenuta con i seguenti comandi:

   .AL 1
   .LI
   Primo elemento.
   .LI +
   Secondo elemento
   .AL i
   .LI
   Primo elemento annidato.
   .LI
   Secondo elemento annidato.
   .LE
   .LI
   Terzo elemento.
   .LE

Il registro Li controlla l'indentazione delle liste. Il suo valore di default è 6.

5.9. Note, riferimenti e indice del contenuto

Quando nel corpo del testo compare una nota o un riferimento, mm lo memorizza in un registro, producendo le note alla fine della pagina stessa e i riferimenti alla fine del documento. Per reperire il numero della nota corrente si usa la macro \*F; il testo della nota deve essere inserito di seguito, racchiuso tra le macro .FS [etichetta] e .FE.

Per esempio:

   ... esempio di nota\*F.
   .FS
   Questo è il testo della nota che apparirà a pié
   di pagina.
   .FE
   Altro testo ...

Il parametro etichetta della macro FS indica l'etichetta da usare per la nota in sostituzione della numerazione automatica.

I riferimenti vengono trattati in modo simile, eccetto che vengono conservati fino alla fine del documento e, a quel punto, prodotti in uscita in un unico gruppo nell'ordine corretto.

I riferimenti vanno racchiusi tra le macro .RS [etichetta] e .RE. Il numero del riferimento corrente si trova nel registro \*Rf, che può essere usato nel testo in modo analogo a \*F. Se viene specificato il parametro etichetta nel testo che segue si può fare riferimento al numero del riferimento (sic) mediante la stringa \*[etichetta].

Per il posizionamento dei riferimenti nel testo di input valgono le stesse considerazioni fatte per le note a pié di pagina.

  .ds Ci .25i .5i .75i 1i 1i

5.10. Intestazioni di inizio e fine pagina

Con le macro mm è molto semplice specificare le intestazioni di inizio e fine pagina. L'intestazione di inizio pagina è generata dalla macro .PH [testo], quella di fine pagina dalla macro .PF [testo]. Il testo deve essere specificato con il seguente formato:

  'parte-sinistra'parte-centrale'parte-destra'.

Le tre parti definiscono il contenuto delle tre sezioni dell'intestazione: la parte sinistra viene allineata a sinistra, la parte centrale viene centrata e la parte destra viene allineata a destra.

Sono disponibili anche altre quattro macro, che richiedono un argomento con lo stesso formato:

  .EH [testo]     even-page header
  .OH [testo]     odd-page header
  .EF [testo]     even-page footer
  .OF [testo]     odd-page footer

Nell'esempio seguente vengono sfruttati alcuni registri predefiniti per scrivere il numero del capitolo, la data e il numero di pagina.

  .EH 'Capitolo \n(H1'' YABU'
  .OH '\n(dy/\n(mo/\n(yr''Revisione 2'
  .PF '' - % - ''

6.1. Tipi di memo 0, 1, 2 e 3

I tipi memo da 0 a 3 utilizzano i seguenti dati: ditta (.AF), titolo (.TL), data (eventualmente definita con .ND), autore/i, sommario (.AS, .AE) preceduto dalla stringa "Abstract", che può essere sostituita con una stringa a piacere definita mediante la macro .AST.

L'intestazione dei tre tipi di memo è identica; l'unica cosa che cambia è il titolo (tipo di memo) che viene stampato dopo il sommario, all'inizio del documento.

   nessuno   Copy to
   ""        Copy to
   1         Copy (with att.) to
   2         Copy (without att.) to
   3         Att.
   4         Atts.
   ...
   14        CC

  .AST "Sommario"
  .ND "2 Gennaio 1998"
  .AF "MySoft"
  .TL
  Titolo del memorandum
  .AU "Federico Lupi"
  .AU "Altro Autore"
  .AS
  Contenuto del sommario
  .AE
  .NS
  Destinatario 1
  Destinatario 2
  Destinatario 3
  .NE
  .MT 3

6.2. Tipo di memo 4

Il tipo memo 4 è quello utilizzato per i documenti ufficiali rilasciati al pubblico e assomiglia molto a quello classico ottenuto con le macro ms.

Questo tipo memo usa i seguenti dati: titolo (.TL, obbligatorio), autore/i (.AU), ditta (.AF, è obbligatorio definirla), sommario (.AS, .AE) preceduto dalla stringa "Abstract", che può essere sostituita con una stringa a piacere definita mediante la macro .AST.

6.3. Tipo di memo 5

Il tipo memo 5 viene definito "lettera esterna"; vengono stampati il titolo (.TL) e la data (eventualmente definita con .ND).

6.4. Sommari

Si possono delimitare parti di testo con le macro .AS [arg [indent]] e .AE per produrre un blocco separato con il titolo Abstract.

Il parametro arg può avere i valori:

8.1. Centratura di disegni

I disegni vengono centrati automaticamente, a meno che non siano racchiusi in un display; in questo caso è l'opzione del display a determinare la posizione del disegno.

11.1. Sillabazione

Per ottenere la sillabazione italiana con groff è necessario procurarsi il file di sillabazione. Quello di TeX va bene per groff: basta metterlo nella directory che contiene le macro dandogli il nome hyphen.it. Prima di poterlo utilizzare è però necessario modificare il file, conservando solo la parte che si trova tra le due parentesi graffe di "patterns".

A questo punto per abilitare la sillabazione italiana è sufficiente inserire i seguenti due comandi all'inizio del file di input:

  .do hla it
  .do hpf hyphen.it

11.2. Lettere accentate

Il pacchetto di macro mm definisce alcune macro da usare per semplificare la scrittura di lettere accentate. In particolare sono definite le stringhe \*' per generare un accento acuto e \*` per generare un accento grave. Pertanto per ottenere è si scrive e\*`, mentre per ottenere é si scrive e\*'. La lettera È si ottiene scrivendo E\*`.

Per ottenere la lettera ì è necessaria un'ulteriore avvertenza: bisogna utilizzare la `i' senza puntino. Questa caratteristica non è documentata, e forse è propria solo di groff. La sequenza da inserire per ottenere la `i' senza puntino è: \(.i, per cui per ottenere la `i' accentata bisogna scrivere così:

   \(.i\*`

Inoltre sono definite le seguenti stringhe:

    con a\*^ si ottiene â
    con a\*~ si ottiene ã
    con a\*: si ottiene ä
    con c\*, si ottiene ç

In alternativa, per poter scrivere con più comodità le lettere accentate, si possono definire alcune stringhe:

  .ds a \o"a\`"
  .ds e \o"e\`"
  .ds i \o"i\`"
  .ds o \o"o\`"
  .ds u \o"u\`"
  .ds ea \o"e\'"

La frase precedente è stata scritta così:

  Per poter scrivere con pi\*u comodit\*a le ...

11.3. Lettere accentate con groff_char

Come si può vedere, il supporto di troff alle lingue straniere è decisamente spartano e, pertanto, consiglio di dimenticare il supporto offerto dalle macro e di utilizzare al suo posto i caratteri supportati da groff_char (man groff_char).

Per esempio:

  per ottenere à si scrive \(`a
  per ottenere è si scrive \(`e
  per ottenere é si scrive \('e
  per ottenere ì si scrive \(`i
  per ottenere ò si scrive \(`o
  per ottenere ù si scrive \(`u

Groff_char definisce una quantità di altri simboli e non è difficile definire delle macro per vi che generino automaticamente le sequenze opportune quando si premono le lettere accentate sulla tastiera italiana.