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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
.\" Man page for whatis
.\"
.\" 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
.\" 3^ Revisione e aggionamento Settembre 1999
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file docs/COPYING.GPLv2 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 %thwhatis% 1 "%date%" "%version%" "Utility per le Pagine di Manuale"
.SH NOME
%whatis% \- mostra le descrizioni delle pagine di manuale
.SH SINTASSI
.B %whatis%
.RB [\| \-dhV \|]
.RB [\| \-r \||\| \-w\c
\|]
.RB [\| \-m
.IR sistema \|[\|,.\|.\|.\|]\|]
.RB [\| \-M
.IR percorso \|]
.I nome
\&.\|.\|.
.SH DESCRIZIONE
Ogni pagina di manuale ha disponibile al suo interno una breve
descrizione.
.B %whatis%
ricerca i nomi e le descrizioni delle pagine di manuale che
corrispondono a
.IR nome .
.I nome
può contenere wildcard (caratteri jolly)
.RB ( \-w )
o essere un'espressione regolare
.RB ( \-r ).
Usando queste opzioni, potrebbe essere necessario racchiudere tra
virgolette (') la
.I parola_chiave
o far precedere da backslash (\\) i caratteri speciali per evitare che
la shell provi a interpretarla(i).
Durante la ricerca sono usate le basi di dati
.BR index .
Per generare dalla base di dati
.B index
la corrispondente base di dati vecchio stile
.B %whatis%
in formato testo, si può usare il comando:
.B %whatis% \-M
.I percorso_man
.B \-w '*' | sort >
.I percorso_man/%whatis%
dove
.I percorso_man
è una gerarchia di pagine di manuale come ad esempio
.IR /usr/man .
.SH OPZIONI
.TP
.B \-d, \-\-debug
Mostra informazioni utili al debug.
.TP
.B \-r, \-\-regex
Interpreta ogni
.I nome
come un'espressione regolare.
Verrà trovata una corrispondenza se
.I nome
corrisponde ad una parte qualsiasi del nome della pagina.
Questa opzione fa sì che
.B %whatis%
sia un po' più lento a causa della natura della ricerca nella base di dati.
.TP
.B \-w, \-\-wildcard
Interpreta ogni
.I nome
come un modello contenente wildcard nello stile della shell.
Affinché ci sia una corrispondenza, un
.I nome
espanso deve corrispondere al nome completo di una pagina di manuale.
Questa opzione fa sì che
.B %whatis%
sia un po' più lento a causa della natura della ricerca nella base di dati.
.\"
.\" Due to the rather silly limit of 6 args per request in some `native'
.\" *roff compilers, we have do the following to get the two-line
.\" hanging tag on one line. .PP to begin a new paragraph, then the
.\" tag, then .RS (start relative indent), the text, finally .RE
.\" (end relative indent).
.\""
.PP
.B \-m
.I sistema\c
.RB \|[\|,.\|.\|.\|]\| ,
.BI \-\-systems= sistema\c
\|[\|,.\|.\|.\|]
.RS
Se questo sistema ha accesso ai nomi delle pagine di manuale di altri
sistemi operativi, può essere fatto un accesso a quest'ultimi usando
questa opzione. Per effettuare una ricerca nei nomi delle pagine di
manuale di NewOS, usare l'opzione
.B \-m
.BR NewOS .
Il
.I sistema
può essere una combinazione qualsiasi di nomi di sistemi
operativi separati da virgole. Per includere la ricerca nei nomi delle
pagine di manuale del sistema operativo nativo, si includa il nome di
sistema
.B man
nella stringa argomento.
Usando questa opzione verrà ignorata la variabile d'ambiente
.RB $ SYSTEM .
.RE
.TP
.BI \-M\ percorso ,\ \-\-manpath= percorso
Specifica un insieme alternativo di gerarchie di pagine di manuale,
separate da `:', nelle quali fare la ricerca.
Di default,
.B %whatis%
usa la variabile d'ambiente
.RB $ MANPATH
finché questa non è vuota o non impostata, nel qual caso determinerà un
percorso man appropriato basandosi sulla variabile d'ambiente
.RB $ PATH
dell'utente. Usando questa opzione verrà ignorato il contenuto della
variabile d'ambiente
.RB $ MANPATH .
.TP
.B \-h, \-\-help
Mostra un messaggio d'aiuto ed esce.
.TP
.B \-V, \-\-version
Mostra informazioni sulla versione e sull'autore.
.SH "STATI D'USCITA"
.TP
.B 0
L'esecuzione del programma ha avuto successo.
.TP
.B 1
Errore d'uso, di sintassi o nel file di configurazione.
.TP
.B 2
Errore operativo.
.TP
.B 16
Non è stata trovata alcuna pagina di manuale che corrisponde al
criterio specificato.
.SH VARIABILI D'AMBIENTE
.TP
.B SYSTEM
Se
.RB $ SYSTEM
è impostata, avrà lo stesso effetto che fosse specificata come argomento
dell'opzione
.BR \-m .
.TP
.B MANPATH
Se
.RB $ MANPATH
è impostata, il suo valore è interpretato come una lista di percorsi,
separati da `:', di gerarchie di pagine di manuale da usare nella ricerca.
.SH FILE
.TP
.I /usr/share/man/index.(bt|db|dir|pag)
Una cache della base di dati globale
.I index
tradizionale.
.TP
.I /var/cache/man/index.(bt|db|dir|pag)
Una cache della base di dati globale
.I index
alternativa e conforme con FHS.
.TP
.I /usr/share/man/\|.\|.\|.\|/whatis
Una tradizionale base di dati
.BR whatis .
.SH "VEDERE ANCHE"
.BR %apropos% (1),
.BR %man% (1).
.SH AUTORE
Wilf. (G.Wilford@ee.surrey.ac.uk).
.br
Fabrizio Polacco (fpolacco@debian.org).
.br
Traduzione di Giovanni Bortolozzo (borto@pluto.linux.it)
|
