1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
.\" Man page for format of the manpath.config data file
.\"
.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
.\"
.\" Traduzione di Bortolozzo Giovanni <borto@pluto.linux.it>
.\" Febbraio 1997
.\" 1° Revisione Marzo 1997
.\" 2° Revisione Agosto 1999
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with the
.\" man-db distribution.
.\"
.\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.\"" for hilit19
.TH MANPATH 5 "%date%" "%version%" "%manpath_config_file%"
.SH NOME
manpath \- formato del file %manpath_config_file%
.SH DESCRIZIONE
Il file di configurazione dei percorsi man è usato dalle utility per
le pagine di manuale per stabilire in esecuzione i percorsi man
dell'utente, per indicare quali gerarchie di pagine di manuale
(percorsi man) devono essere trattati come globali e per assegnare a
quest'ultimi delle directory da usare per salvare i cat file.
Se la variabile d'ambiente
.RB $ MANPATH
è già settata, le informazioni contenute all'interno di
%manpath_config_file% non la ridefiniranno.
.SH FORMATO
Attualmente sono riconosciuti i seguenti tipi di campi:
.TP
.BI # \ commento
Righe vuote o che iniziano con un
.B #
saranno trattate come commenti ed ignorate.
.TP
.BI MANDATORY_MANPATH \ elemento_percorso_man
Righe di questo tipo indicano percorsi man che ogni
.RB $ MANPATH
generato automaticamente dovrebbe contenere. Tipicamente include
.IR /usr/man .
.TP
.BI MANPATH_MAP \ elemento_percorso\ elemento_percorso_man
Righe di questo tipo definiscono la mappatura da
.RB $ PATH
a
.RB $ MANPATH .
Per ognuno degli
.I elemento_percorso
trovati nella variabile
.RB $ PATH
dell'utente,
.I elemento_percorso_man
sarà aggiunto a
.RB $ MANPATH .
.TP
\fBMANDB_MAP \fIelemento_percorso_man \fR\|[\|\fIelemento_percorso_cat\fR \|]
Righe di questo tipo indicano quali percorsi man devono essere
trattati come globali e opzionalmente, dove dovrebbero essere salvati
i loro file cat. Questo campo è particolarmente importante se
.B man
è un programma setuid, in quanto indica a quali gerarchie di pagine di
manuale accedere come utente setuid e a quali come l'utente invocante.
Le gerarchie di pagine di manuale sono solitamente quelle
immagazzinate sotto a
.I /usr
come, ad esempio,
.IR /usr/man ,
.I /usr/local/man
e
.IR /usr/X11R6/man .
Se le pagine cat di un particolare
.I elemento_percorso_man
non devono essere salvate o sono salvate nelle posizione tradizionale,
.I elemento_percorso_cat
può essere omesso.
Posizioni cat tradizionali potrebbero essere impossibili per gerarchie
di pagine di manuale montate in sola lettura e a causa di ciò è
impossibile specificare una valida gerarchia di directory per il loro
salvataggio. Per osservare il
.B Linux FSSTND
la parola chiave
.RB ` FSSTND '
può essere usata al posto di una reale directory.
Sfortunatamente, è necessario specificare
.B tutti
i percorsi man globali, inclusi i percorsi di sistema alternativi come
.I /usr/man/sun
o qualsiasi percorso
.B NLS locale
come
.IR /usr/man/it_IT .
Poiché le informazioni sono analizzate riga per riga nell'ordine in cui
sono scritte, è necessario che ognuno dei percorsi man che sia una
sotto gerarchia di un'altra gerarchia sia elencato prima, altrimenti
sarà fatta una corrispondenza non corretta. Ad esempio
.I /usr/man/it_IT
deve venire prima di
.IR /usr/man .
.SH PROBLEMI
Finché le suddette regole non sono seguite e osservate precisamente,
le utility per le pagine di manuale non funzioneranno correttamente. Le
regole sono eccessivamente complicate.
|
