diff options
Diffstat (limited to 'man/it/man1/man.man1')
| -rw-r--r-- | man/it/man1/man.man1 | 1105 |
1 files changed, 1105 insertions, 0 deletions
diff --git a/man/it/man1/man.man1 b/man/it/man1/man.man1 new file mode 100644 index 0000000..5c203f9 --- /dev/null +++ b/man/it/man1/man.man1 @@ -0,0 +1,1105 @@ +'\" t +.\" ** The above line should force tbl to be a preprocessor ** +.\" Man page for man +.\" +.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.) +.\" +.\" Traduzione di Bortolozzo Giovanni <borto@pluto.linux.it> +.\" dal 2006: Giuseppe Sacco <eppesuig@debian.org> +.\" Febbraio 1997 +.\" 1^ Revisione Marzo 1997 +.\" 2^ Revisione Agosto 1999 +.\" 3^ Revisione e aggionamento Settembre 1999 +.\" 4^ revisione e aggirnamento Febbraio 2007 +.\" +.\" 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 +.pc +.TH %thman% 1 "%date%" "%version%" "Utility per le Pagine di Manuale" +.SH NOME +%man% \- un'interfaccia ai manuali di riferimento in linea +.SH SINTASSI +.\" Linea di comando generale +.B %man% +.RB [\| \-c \||\| \-w \||\| \-tZ \|] +.RB [\| \-H \|\c +.RI [\| browser \|]\|] +.RB [\| \-T \|\c +.IR dispositivo \|] +.RB [\| \-X \|\c +.RI [\| dpi \|]\|] +.RB [\| \-adhu7V \|] +.RB [\| \-i \||\| \-I \|] +.RB [\| \-m +.IR sistema \|[\|,.\|.\|.\|]\|] +.RB [\| \-L +.IR locale \|] +.RB [\| \-p +.IR stringa \|] +.RB [\| \-C +.IR file \|] +.RB [\| \-M +.IR percorso \|] +.RB [\| \-P +.IR paginatore \|] +.RB [\| \-r +.IR prompt \|] +.RB [\| \-S +.IR lista \|] +.RB [\| \-e +.IR estensione \|] +.RI [\|[\| sezione \|] +.IR pagina \ .\|.\|.\|]\ .\|.\|. +.\" The --local command line +.br +.B %man% +.B \-l +.RB [\| \-7 \|] +.RB [\| \-tZT \|] +.RB [\| \-H \|\c +.RI [\| browser \|]\|] +.RB [\| \-T \|\c +.IR dispositivo \|] +.RB [\| \-X \|\c +.RI [\| dpi \|]\|] +.RB [\| \-p +.IR stringa \|] +.RB [\| \-P +.IR paginatore \|] +.RB [\| \-r +.IR prompt \|] +.I file +\&.\|.\|. +.\" The apropos command line +.br +.B %man% +.B \-k +.RI [\| apropos +.IR opzioni \|] +.I espr_reg +\&.\|.\|. +.\" The whatis command line +.br +.B %man% +.B \-f +.RI [\| whatis +.IR opzioni \|] +.I pagina +\&.\|.\|. +.SH DESCRIZIONE +.B %man% +è il paginatore dei manuali del sistema. Di solito ognuno degli argomenti +.I pagina +dati a +.B %man% +è il nome di un programma, di un'utility o di una funzione. +La +.I pagina di manuale +associata con ognuno di questi argomenti è poi trovata e mostrata. Una +.IR sezione , +se fornita, indirizzerà +.B %man% +a guardare solo in quella +.I sezione +del manuale. +L'azione predefinita è di ricercare in tutte le +.I sezioni +disponibili seguendo un ordine prestabilito e di mostrare solo la +prima +.I pagina +trovata, anche se +.I pagina +esiste in diverse +.IR sezioni . + +La seguente tabella mostra i numeri delle +.I sezioni +del manuale seguiti dai tipi di pagine che contengono + +.TS +tab (@); +l lx. +1@T{ +Programmi eseguibili e comandi della shell +T} +2@T{ +Chiamate al sistema (funzioni fornite dal kernel) +T} +3@T{ +Chiamate alle librerie (funzioni all'interno delle librerie di sistema) +T} +4@T{ +File speciali (di solito trovabili in \fI/dev\fR) +T} +5@T{ +Formati dei file e convenzioni p.es. \fI/etc/passwd\fR +T} +6@T{ +Giochi +T} +7@T{ +Pacchetti di macro e convenzioni p.es. \fBman\fR(7), \fBgroff\fR(7). +T} +8@T{ +Comandi per l'amministrazione del sistema (solitamente solo per root) +T} +9@T{ +Routine del kernel [\|Non standard\|] +T} +.TE + +Una +.I pagina +di manuale consta di diverse parti. + +Queste possono essere etichettate +.BR NOME " (NAME)," +.BR SINTASSI " (SYNOPSIS)," +.BR DESCRIZIONE " (DESCRIPTION)," +.BR OPZIONI " (OPTIONS)," +.BR FILE " (FILES)," +.BR "VEDERE ANCHE" " (SEE\ ALSO)," +.BR PROBLEMI " (BUGS)" +e +.BR AUTORE " (AUTHOR)." + +Le seguenti convenzioni si applicano alla sezione +.B SINTASSI +e possono essere usate come una guida per le altre sezioni. + +.TS +tab (@); +l lx. +\fBtesto in grassetto\fR@T{ +scrivere esattamente come mostrato. +T} +\fItesto in corsivo\fR@T{ +rimpiazzare con un argomento appropriato. +T} +[\|\fB\-abc\fR\|]@T{ +ognuno o tutti gli argomenti all'interno di [ ] sono opzionali. +T} +\fB\-a\|\fR|\|\fB\-b\fR@T{ +opzioni separate da | non possono essere usate assieme. +T} +\fIargomento\fB .\|.\|.\fR@T{ +\fIargomento\fR è ripetibile. +T} +[\|\fIespressione\fR\|]\fB .\|.\|.\fR@T{ +\fRl'intera \fIespressione\fR\ all'interno di [ ] è ripetibile. +T} +.TE + +L'illustrazione del comando o funzione è un modello che dovrebbe +corrispondere a tutte le possibili invocazioni. In alcuni casi è +preferibile illustrare diverse invocazioni che si escludono a vicenda + come mostrato nella sezione +.B SINTASSI +di questa pagina di manuale. +.SH ESEMPI +.TP \w'%man%\ 'u +.BI %man% \ ls +Mostra la pagina di manuale per la +.I voce +(programma) +.IR ls . +.TP +.BI %man%\ \-a \ intro +Mostra, in successione, tutte le pagine di manuale +.I intro +disponibili nel manuale. È possibile uscire tra due +visualizzazioni successive o saltarne una qualsiasi. +.TP +\fB%man% \-t \fIalias \fR|\fI lpr -Pps +Formatta la pagina di manuale indicata da +.RI ` alias ', +solitamente una pagina di manuale della shell, nel formato predefinito di +.B troff +o +.B groff +e la redireziona, tramite pipe, alla stampante chiamata +.IR ps . +L'output predefinito per +.B groff +è di solito in PostScript. +.B %man% \-\-help +dovrebbe mostrare quale preprocessore è collegato con l'opzione +.BR \-t . +.TP +.BI %man%\ \-l\ \-T dvi\ ./foo.1x.gz \ >\ ./foo.1x.dvi +Questo comando decomprime e formatta il sorgente nroff della pagina di +manuale +.I ./foo.1x.gz +in un file +.BR "device independent (dvi) " . +La redirezione è necessaria in quanto l'opzione +.B \-T +fa sì che l'output sia diretto verso lo +.B stdout +senza nessun paginatore. L'output può essere visto con un programma tipo +.B xdvi +o ulteriormente convertito in PostScript usando un programma tipo +.BR dvips. +.TP +.BI %man%\ \-k \ printf +Cerca la parola chiave +.I printf +nelle descrizioni brevi e nei nomi delle pagine considerandola una +espressione regolare. +Mostra qualsiasi corrispondenza. +Equivalente a +.BI %apropos%\ \-r \ printf . +.TP +.BI %man%\ \-f \ smail +Cerca le pagine di manuale indicate da +.I smail +e mostra una breve descrizione di tutte quelle trovate. +Equivalente a +.BI %whatis%\ \-r \ smail . +.SH PANORAMICA +Molte sono le opzioni disponibili per +.B %man% +in modo da fornire all'utente la maggior flessibilità +possibile. Possono essere fatti cambiamenti al percorso di ricerca, +all'ordine delle sezioni, al preprocessore per l'output, e ad altri +comportamenti e operazioni elencati in dettaglio più avanti. + +Se impostate, alcune variabili d'ambiente sono interrogate per +determinare le funzionalità di +.BR %man% . +È possibile impostare la variabile "omni comprensiva" +.RB $ MANOPT +ad una stringa qualsiasi nel formato della riga di comando, con +l'eccezione che ogni spazio che sia parte integrante dell'argomento +di un'opzione deve essere preceduto da un backslash (`\\'). +.B %man% +analizzerà +.RB $ MANOPT +prima di analizzare la propria riga di comando. Quelle opzioni che +richiedono un argomento, saranno ridefinite se le stesse opzioni si +trovano anche nella riga di comando. Per annullare tutte le +opzioni impostate in +.RB $ MANOPT , +può essere specificato +.B \-D +come opzione iniziale della riga di comando. +Ciò permette a %man% di "dimenticare" le opzioni specificate in +.RB $ MANOPT +sebbene debbano restare ancora valide. + +Le utility per le pagine di manuale raggruppate nel pacchetto +.B man-db +fanno un uso intenso delle cache di +.BR index . +Tali cache contengono informazioni come la posizione di ogni pagina di +manuale nel filesystem e cosa contiene il relativo +.I whatis +(breve descrizione della pagina di manuale), inoltre permettono a +.B %man% +di cercare le pagine molto più velocemente rispetto ad una ricerca +su file system per ogni pagine da cercare. +Se richiesto tramite l'opzione +.B \-u +.B %man% +può verificare che tali cache rimangano consistenti, in modo +da non dover lanciare manualmente del +software per aggiornare le tradizionali basi di dati di +.IR whatis . + +Se +.B %man% +non può trovare una base di dati +.B index +inizializzato da +.B %mandb% +per una particolare gerarchia di pagine di manuale, cercherà comunque +la pagina di manuale richiesta sebbene sarà necessario un globbing dei +file per effettuare la ricerca all'interno di quella gerarchia (N.d.T: +con globbing [jargon] si intende l'espansione dei caratteri speciali +all'interno di un nome costruito con wildcard \- caratteri jolly). +Invece se +.B %whatis% +o +.B %apropos% +non trovano la base di dati +.BR index , +proveranno comunque a estrarre le informazioni dalla base di dati +.I whatis +tradizionale. +.\"`User' manual page hierarchies will have +.\".B index +.\"caches created `on the fly'. +.\"" + +Queste utility supportano i file sorgente nroff compressi, che abbiano, +di default, una fra le seguenti estensioni +.BR .Z ", " .z " e " .gz . +È possibile trattare con qualsiasi estensione di file compresso, ma +questa informazione deve essere nota al momento della compilazione. +Inoltre, normalmente, qualsiasi pagina cat prodotta è compressa usando +.BR gzip . +Ognuna delle gerarchie `globali' delle pagine di manuale, come +.I /usr/share/man +o +.IR /usr/X11R6/man , +può avere una directory qualsiasi come gerarchia delle pagine cat. +Tradizionalmente le pagine cat sono salvate sotto la stessa gerarchia +delle pagine di manuale, ma per ragioni come quelle specificate nel +.BR "Linux File System Standard (FSSTND)" , +è meglio salvarle da qualche altra parte. Per i dettagli su come ciò +sia possibile, si legga +.BR manpath (5). +Per i dettagli sul perché fare ciò, si legga lo standard. + +Con questo pacchetto è disponibile il ``supporto internazionale'': le +pagine di manuale nella lingua nativa sono accessibili (se disponibili +nel proprio sistema) usando le funzioni +.IR locale . +Per attivare tale supporto, è necessario impostare +.RB $ LC_MESSAGES " e " +.RB $ LANG +o qualche altra variabile d'ambiente dipendente dal sistema, alla propria +lingua locale, solitamente specificata nel formato basato sul +.BR "POSIX 1003.1" : + +.\" +.\" Need a \c to make sure we don't get a space where we don't want one +.\"" +.RI < lingua >[\|\c +.B _\c +.RI < zona >\|[\|\c +.B .\c +.RI < set-di-caratteri >\|[\|\c +.B ,\c +.RI < versione >\|]\|]\|] + +Se la pagina desiderata è disponibile nel proprio +.IR locale , +sarà mostrata al posto della pagina standard (di solito in Inglese +Americano). + +Il supporto internazionale per i cataloghi di messaggi è un'altra +caratteristica di questo pacchetto e può essere attivato, sempre se +disponibile, nello stesso modo. Se si trova che le pagine di manuale e +i cataloghi dei messaggi forniti con questo pacchetto non sono +disponibili per la propria lingua e si vuole fornirli, si contatti +il manutentore il quale coordinerà tali attività. + +Per informazioni riguardanti altre caratteristiche ed estensioni +disponibili con questo paginatore dei manuali, si leggano i documenti +forniti con il pacchetto. +.SH COMPORTAMENTO PREDEFINITO +.B %man% +cercherà la pagina di manuale desiderata all'interno delle cache delle +basi di dati +.IR index . +Se l'opzione +.B \-u +viene specificata, è eseguita una verifica della +consistenza della cache per assicurarsi che le basi di dati riflettano +accuratamente il filesystem. Non è generalmente necessario eseguire +.B %mandb% +dopo che le cache sono state create inizialmente, finché una di questa +non sia in qualche modo corrotta. +Il controllo della cache su sistemi con molte pagine di manuale può +essere piuttosto lungo; per questo non viene svolto automaticamente, ma +gli amministratori di sistema possono esseguire +.B %mandb% +settimanalmente per aggiornare la base di dati. +Per superare eventuali problemi causati da cache non aggiornate +.B %man% +passa automaticamente al `file globbing' se una ricerca nella cache +non ha esito, allo stesso modo di quando la cache non è presente. + +Una volta che una pagina di manuale è stata localizzata, è eseguita +una verifica per scoprire se il relativo file `cat' preformattato +esiste già e se è più recente del file nroff. Se è così, questo file +preformattato è (di solito) decompresso e poi visualizzato tramite un +paginatore. Il paginatore può essere specificato in diversi modi +oppure viene usato quello predefinito (si veda l'opzione +.B \-P +per i dettagli). Se non c'è la pagina cat o è più vecchia del file +nroff, quest'ultimo è filtrato attraverso vari programmi ed è mostrato +immediatamente. + +Se può essere prodotto un file cat (esiste la relativa directory cat e +ha i permessi appropriati), +.B %man% +comprimerà e salverà il file cat in background. + +Quanti e quali filtri usare viene determinato in svariati modi. Per prima cosa è +interrogata l'opzione della riga di comando +.B \-p +o la variabile d'ambiente +.RB $ MANROFFSEQ . +Se +.B \-p +non è usata e la variabile d'ambiente non è impostata, viene analizzata +la riga iniziale del file troff per cercare una "stringa +preprocessore". Per contenere una stringa preprocessore valida, la +prima riga deve assomigliare a + +.B '\e" +.RB < stringa > + +dove +.B stringa +può essere una combinazione qualsiasi delle lettere descritte più +avanti dall'opzione +.BR \-p . + +Se nessuno dei metodi suddetti fornisce informazioni sui filtri, ne è +usato un insieme predefinito. + +Una pipeline di formattazione è creata dai filtri al formattatore +primario +.RB ( nroff +o +.RB [ tg ] roff +con +.BR \-t ) +ed eseguita. +Alternativamente, se esiste un programma eseguibile +.I mandb_nfmt +(o +.I mandb_tfmt +con +.BR \-t ) +nella radice dell'albero dei manuali, questo è eseguito. Gli viene +passato il file sorgente del manuale, la stringa preprocessore, ed +eventualmente il dispositivo specificato come argomento di +.BR \-T " o " \-E . +.\" ******************************************************************** +.SH OPZIONI +Le opzioni che non richiedono argomenti, duplicate nelle riga di +comando, in +.RB $ MANOPT , +o in entrambe sono dannose. Per le opzioni che richiedono un argomento, +ogni duplicazione annullerà il valore del precendente argomento. +.TP +.B \-l, \-\-local-file +Attiva il modo `locale'. Formatta e visualizza file di manuale locali +invece di effettuare una ricerca nella collezione di manuali del +sistema. Ogni argomento pagina sarà interpretato come un file sorgente +nroff nel formato corretto. +.\" File sorgente nroff con estensione di +.\" compressione supportata, saranno decompressi da %man% prima di essere +.\" visualizzati tramite i soliti filtri. +.\"" +Non è creato il file cat. Se '\-' è elencato fra gli argomenti, +l'input sarà preso dallo stdin. +Quando non è usata questa opzione, e man non trova la pagina +richiesta, prima di mostrare un messaggio d'errore, prova a +comportarsi come se fosse fornita questa opzione, usando il nome come +nome di un file e cercando una corrispondenza esatta. +.TP +.BI \-L\ locale ,\ \-\-locale= locale +.B %man% +di solito determinerà il proprio locale attuale chiamando la funzione C +.BR setlocale (3) +che interroga diverse variabili d'ambiente, tra le quali +.RB $ LC_MESSAGES +e +.RB $ LANG . +Per ridefinire temporaneamente il valore così determinato, si usi +questa opzione per fornire direttamente una stringa +.I locale +a +.BR %man% . +Si noti che ciò non avrà effetto finché non è iniziata realmente una +ricerca. L'output, come ad esempio il messaggio d'aiuto, sarà sempre +visualizzato nel locale determinato inizialmente. +.TP +.B \-D, \-\-default +Questa opzione è solitamente data come prima opzione e reinizializza +il comportamento di +.B %man% +a quello predefinito. È usata per reinizializzare quelle opzioni che possono +essere state impostate in +.RB $ MANOPT . +Qualsiasi opzione successiva +.B \-D +avrà il solito effetto. +.TP +.BI \-C\ file ,\ \-\-config\-file= file +Usa il file di configurazione speficiato al posto di +.IR ~/.manpath . +.TP +.BI \-M\ percorso ,\ \-\-manpath= percorso +Specifica un percorso man alternativo. Normalmente +.B %man% +usa il codice derivato da +.B %manpath% +per determinare il percorso di ricerca. Questa opzione ha priorità +sulla variabile d'ambiente +.RB $ MANPATH +e fa sì che questa e l'opzione +.B \-m +siano ignorate. + +Un percorso specificato come manpath deve essere la radice di una +gerarchia di pagine di manuali strutturate in sezioni come descritto +nel manuale di man-db (nella sezione "The manual page system"). +Per vedere le pagine di manuali esterne a questa gerarchia, si usi +l'opzione +.B \-l . +.TP +.BI \-P\ paginatore ,\ \-\-pager= paginatore +Specifica quale paginatore dell'output usare. Normalmente +.B %man% +usa +.BR %pager% . +Questa opzione ha priorità sulla variabile d'ambiente +.RB $ PAGER +e non va usata assieme con +.B \-f +o +.BR \-k . +.TP +.BI \-r\ prompt ,\ \-\-prompt= prompt +Se una versione recente di +.B less +è usata come paginatore, +.B %man% +proverà ad impostare il suo prompt e alcune sue opzioni. +Il prompt predefinito assomiglierà a + +.B \ Pagina di Manuale\c +.IB \ nome ( sez )\c +.BI \ riga \ x + +dove +.I nome +denota il nome della pagina di manuale, +.I sez +denota la sezione in cui è stata trovata e +.IR x +è il numero di riga corrente. +Ciò è ottenuto usando la variabile d'ambiente +.RB $ LESS . + +Fornendo l'opzione +.B \-r +seguita da una stringa si può modificare il prompt predefinito. +La stringa può contenere il testo +.B $MAN_PN +il quale sarà espanso nel nome della pagina di manuale corrente e il +nome della sua sezione racchiuso tra `(' e `)'. La stringa usata per +produrre il default potrebbe essere espressa come + +.B \e\ Pagina\e\ di\e\ Manuale\e\ \e$MAN_PN\e\ ?ltriga\e\ %lt?L/%L.: +.br +.B byte\e\ %bB?s/%s..?\e\ (FINE):?pB\ %pB\e\e%.. + +È stata spezzata in due righe solo per migliorarne la leggibilità. Per +il suo significato si veda la pagina di manuale +.BR less (1). +La stringa di prompt per prima cosa è valutata dalla shell. Perciò le +doppie virgolette `"', le virgolette rovesce ``' e i backslash `\\' +devono essere preceduti da `\\'. La stringa di prompt potrebbe +terminare con un `\\$' il quale può essere seguito da ulteriori +opzioni per less. Di default +.B %man% +imposta le opzioni +.BR \-ix8 . + +Se si vuole eliminare completamente la gestione del prompt da +parte di +.B %man% +si faccia uso della variabile d'ambiente +.RB $ MANLESS +descritta sotto. +.TP +.B \-7, \-\-ascii +Quando visualizza una pagina di manuale in +.IR ascii (7) +puro su di un terminale a 7 bit o su un emulatore di terminale, alcuni +caratteri potrebbero non essere visualizzati correttamente se si usa +il descrittore di dispositivo +.IR latin1 (7) +con il +.B GNU +.BR nroff . +Questa opzione permette alle pagine di manuale in +.I ascii +puro di essere visualizzate in +.I ascii +con il dispositivo +.IR latin1 . +Non tradurrà alcun testo +.IR latin1 . +La seguente tabella mostra le traduzioni effettuate: alcune parti +di essa potrebbero essere mostrate in maniera corretta solo usando +il dispositivo +.IR latin1 (7) +di +.B GNU +.BR nroff . + +.ie c \[shc] \ +. ds soft-hyphen \[shc] +.el \ +. ds soft-hyphen \(hy +.TS +tab (@); +l c c c. +Descrizione@Ottale@latin1@ascii +_ +trattino di continuazione@255@\*[soft-hyphen]@- +bullet (middle dot)@267@\(bu@o +accento acuto@264@\(aa@' +segno di moltiplicazione@327@\(mu@x +.TE + +Se la colonna +.I latin1 +è visualizzata correttamente, il proprio terminale può essere +configurato per i caratteri +.I latin1 +e questa opzione non è necessaria. +Se le colonne +.I latin1 +e +.I ascii +sono identiche, si sta leggendo questa pagina usando questa opzione +oppure +.B %man% +non l'ha formattata usando il descrittore di dispositivo +.IR latin1 . +Se manca la colonna +.I latin1 +o è corrotta, può essere necessario visualizzare le pagine di manuale +usando questa opzione. + +Questa opzione è ignorata quando si usano le opzioni +.BR \-t , +.BR \-H , +.B \-T +o +.B \-Z +e può essere inutile per +.B nroff +diversi dalla versione +.BR GNU . +.TP +.BI \-S\ lista ,\ \-\-sections= lista +Lista è un elenco ordinato di sezioni di manuale su +cui effettuare la ricerca. Usando questa opzione viene ignorata la +variabile d'ambiente +.RB $ MANSECT . +.TP +.B \-a, \-\-all +Normalmente, +.B %man% +uscirà dopo aver visualizzato la pagina di manuale più adatta che +trova. Usando questa opzione si forza +.B %man% +a visualizzare tutte le pagine di manuale con i nomi che corrispondono +al criterio di ricerca. +.TP +.B \-c, \-\-catman +Questa opzione non è di uso generale e dovrebbe essere usata solo dal +programma +.BR %catman% . +.TP +.B \-d, \-\-debug +Non mostra alcuna pagina di manuale, ma mostra un sacco di +informazioni per il debug. +.TP +.BI \-e\ sotto-estensione ,\ \-\-extension= sotto-estensione +Alcuni sistemi incorporano nella gerarchia principale delle pagine di +manuale grossi pacchetti di pagine di manuale, come quelle che +accompagnano il pacchetto +.BR Tcl . +Per ovviare ai problemi dovuti alla presenza di pagine di manuale con +lo stesso nome come +.BR exit (3), +le pagine di +.B Tcl +sono di solito assegnate alla sezione +.BR l . +Poiché questa non è una scelta fortunata, è ora possibile mettere le +pagine nella sezione corretta, ed in questo caso assegnare +l'estensione specifica +.BR exit (3tcl). +Durante il funzionamento normale, +.B %man% +visualizzerà +.BR exit (3) +piuttosto che +.BR exit (3tcl). +Per trattare questa situazione ed evitare la necessità di sapere in +quale sezione di trova la pagina di manuale richiesta, è ora possibile +dare a +.B %man% +una stringa di +.I sotto-estensione +che indica a quale pacchetto deve appartenere la pagina. Usando il +precedente esempio, passando l'opzione +.B \-e\ tcl +a +.B %man% +verrà ristretta la ricerca alle pagine che hanno estensione +.BR *tcl . +.TP +.B \-f, \-\-whatis +Equivalente a +.BR %whatis% . +Mostra, se disponibile, una breve descrizione tratta della pagine di +manuale. Si veda +.BR %whatis% (1) +per i dettagli. +.TP +.B \-h, \-\-help +Mostra un messaggio d'aiuto ed esce. +.TP +.B \-i, \-\-ignore\-case +Non fa distinzione tra maiuscole e minuscole durante la ricerca della +pagine. Questo è il comportamento normale +.TP +.B \-I, \-\-match\-case +Effettua la ricerca della pagina facendo distinzione tra lettere +minuscole e maiuscole. +.TP +.B \-k, \-\-apropos +Equivalente a +.BR %apropos% . +Cerca nelle descrizioni brevi delle pagine di manuale le occorrenze +delle parole chiave e visualizza qualsiasi corrispondenza. Si veda +.BR %apropos% (1) +per i dettagli. +.\" +.\" 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 alle pagine di manuale di altri sistemi +operativi, si può accedere a quest'ultime usando questa opzione. Per +cercare una pagina di manuale nella collezione delle pagine di manuale +di NewOS, si usi l'opzione +.B \-m +.BR NewOS . + +Il +.I sistema +specificato può essere una combinazione di nomi di sistemi operativi +separati da virgole. Per includere una ricerca fra le 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 \-p\ stringa ,\ \-\-preprocessor= stringa +Specifica la sequenza di preprocessori da lanciare prima di +.B nroff +o +.BR troff / groff . +Non tutte le installazioni avranno l'insieme completo di +preprocessori. Alcuni dei preprocessori e le lettere che li designano +sono: +.BR eqn " (" e ), +.BR grap " (" g ), +.BR pic " (" p ), +.BR tbl " (" t ), +.BR vgrind " (" v ), +.BR refer " (" r ). +Usando questa opzione viene ignorata la variabile d'ambiente +.RB $ MANROFFSEQ . +.B %zsoelim% +è sempre lanciato come primo preprocessore. +.TP +.B \-u, \-\-update +Questa opzione fa in modo che +.B %man% +effettui un controllo a livello di `inode' sulla propria base di dati +per assicurarsi che sia una accurata rappresentazione del file system. +Il suo effetto è positivo solo se +.B %man% +è installato con il bit setuid impostato. +.TP +.B \-t, \-\-troff +Usa +.I %troff% +per formattare la pagina di manuale nello stdout. Questa opzione non è +richiesta assieme a +.BR \-H , +.B \-T +o +.BR \-Z . +.TP +\fB\-T\fP[\fIdispositivo\fP], \fB\-\-troff\-device\fP[=\fIdispositivo\fP] +Questa opzione è usata per cambiare l'output di +.B groff +(o se possibile quello di +.BR troff ) +per adattarlo ad un dispositivo diverso da quello predefinito. Implica +.BR \-t . +Esempi (forniti con Groff-1.17) comprendono +.BR dvi ", " latin1 ", " ps ", " utf8 , +.BR X75 " e " X100 . +.TP +\fB\-X\fP[\fIdpi\fP], \fB\-\-gxditview\fP[=\fIdpi\fP] +Questa opzione mostra l'output di +.B groff +in una finestra grafica usando il programma +.BR gxditview . +.I dpi +(punti per pollice) può essere 75, 75-12, 100 o 100-12, con valore +predefinito 75; le varianti -12 usano un font da 12 punti. +Questa opzione implica +.B \-T +con i dispositivi X75, X75-12, X100, X100-12 rispettivamente. +.TP +.B \-Z, \-\-ditroff +.B groff +lancerà +.B troff +e poi userà un appropriato post-processore per produrre un output +adatto per il dispositivo scelto. Se +.I %troff% +è +.BR groff , +questa opzione è passata a +.B groff +e verrà soppresso l'uso del post-processore. Implica +.BR \-t . +.TP +\fB\-H\fP[\fIbrowser\fP], \fB\-\-html\fP[=\fIbrowser\fP] +Questa opzione indica a +.B groff +di produrre un output HTML, e mostra tale output in un browser +web. La scelta del browser è opzionale ed è determinata +dall'argomento opzionale +.I browser +se questo è fornito; altrimenti dalla variabile +.RB $ BROWSER +oppure dal valore definito durante la compilazione (in genere +.BR lynx ). +Questa opzione implica +.BR \-t , +e funziona solo con la versione +.B GNU +di +.BR troff . +.TP +.BI \-E\ dispositivo\fR,\ \fI \-\-encoding\fR=\fIdispositivo +Genera un output usando una codifica di caratteri diversa dal +valore predefinito. Per il modo nel quale +.B nroff +è strutturato, l'argomento di questa opzione deve essere un +dispositivo di +.B nroff +come +.BR ascii ", " latin1 " o " utf8 . +.TP +.B \-w, \-\-where, \-\-location +Non mostra veramente le pagine di manuale, ma stampa le posizioni dei +file che sarebbero stati formattati. +.TP +.B \-W, \-\-where\-cat, \-\-location\-cat +Non mostra veramente le pagine di manuale, ma stampa le posizioni dei +file cat che sarebbero stati visualizzati. +Se entrambi \-w e \-W vengono specificati, li stampa separati da uno spazio. +.TP +.B \-V, \-\-version +Mostra informazioni sulla versione. +.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 3 +Un processo figlio ha restituito uno stato d'uscita diverso da zero. +.TP +.B 16 +Almeno una delle pagine/file/parole chiave non esisteva o non aveva +corrispondenza. +.SH VARIABLI D'AMBIENTE +.\".TP \w'MANROFFSEQ\ \ 'u +.\"" +.TP +.B MANPATH +Se +.RB $ MANPATH +è impostata, il suo valore è usato come percorso per la ricerca delle +pagine di manuale. +.TP +.B MANROFFSEQ +Se +.RB $ MANROFFSEQ +è impostata, il suo valore è usato per determinare l'insieme dei +preprocessori attraverso i quali va passata la pagina di manuale. La +lista dei preprocessori predefiniti dipende dal sistema. +.TP +.B MANSECT +Se +.RB $ MANSECT +è impostata, il suo valore è una lista separata da `:' di sezioni ed è +usata per determinare in quali sezioni di manuale cercare e in quale +ordine. +.TP +.B PAGER +Se +.RB $ PAGER +è impostata, il suo valore è usato come il nome del programma da usare +per visualizzare la pagina di manuale. Di default, è usato +.BR %pager% . +.TP +.B MANLESS +Se +.RB $ MANLESS +è impostata, +.B %man% +non effettuerà alcuna operazione per impostare una stringa di prompt +per il pager +.BR less . +Invece, il valore di +.RB $ MANLESS +verrà passato senza modifiche +.RB $ LESS . +Ad esempio, per impostare il prompt a +\(lqla mia stringa prompt\(rq, impostare +.RB $ MANLESS +to +.RB \(oq \-Psla\ mia\ stringa\ prompt \(cq. +.TP +.B BROWSER +Se +.RB $ BROWSER +è impostata, il suo valore deve essere una lista di comandi separati +da virgole, ciascuno dei quali viene provato nell'ordine per cercare +di eseguire un browser web per +.B man +.BR \-\-html . +In ogni comando +.I %s +viene sostituito da un nome di file contiene l'output HTML di +.BR groff , +.I %% +viene sostituito da un singolo carattere di percento, e +.I %c +viene sostituito dal carattere di due punti. +.TP +.B SYSTEM +Se +.RB $ SYSTEM +è impostata, avrà lo stesso effetto dell'opzione +.B \-m stringa +dove stringa sarà preso come il contenuto di +.RB $ SYSTEM . +.TP +.B MANOPT +Se +.RB $ MANOPT +è impostata, sarà analizzata prima della riga di comando di +.B %man% +ed è supposta essere in formato simile. Poiché tutte le altre +variabili d'ambiente specifiche di +.B %man% +possono essere specificate come opzioni della riga di comando, e sono +quindi candidate per essere incluse in +.RB $ MANOPT +ci si può aspettare che diventeranno obsolete. +N.B.: Tutti gli spazi che dovrebbero essere interpretati come parte +dell'argomento di un opzione devono essere preceduti da `\\'. +.TP +.B MANWIDTH +Se +.RB $ MANWIDTH +è impostata, il suo valore sarà utilizzato come lunghezza della riga +per il quale le pagine di manuale verranno formattate. Se non viene +impostata, le pagine saranno formattate usando una lunghezza appropriata +al terminale in uso (tramite +.BR ioctl (2) +se disponibile, oppure il valore di +.RB $ COLUMNS , +o ancora usando il valore 80 se nessuno dei due metodi precedenti +funziona). +Le pagine cat verranno salvate solo le la lunghezza della linea di +terminale si trova tra 66 e 80 caratteri. +.TP +.BR LANG , " LC_MESSAGES" +A seconda del sistema e dell'implementazione, una o entrambe le variabili +.RB $ LANG +e +.RB $ LC_MESSAGES +saranno interrogate per determinare il locale corrente. +.B %man% +visualizzerà i suoi messaggi usando quel locale (se disponibile). Si veda +.BR setlocale (3) +per i dettagli. +.SH FILE +.TP +.I %manpath_config_file% +File di configurazione di man-db. +.TP +.I /usr/share/man +Una gerarchia di pagine di manuale globale. +.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 FSSTND. +.SH "VEDERE ANCHE" +.BR %mandb% (8), +.BR %manpath% (1), +.BR manpath (5), +.BR %apropos% (1), +.BR %whatis% (1), +.BR %catman% (8), +.BR less (1), +.BR nroff (1), +.BR troff (1), +.BR groff (1), +.BR %zsoelim% (1), +.BR setlocale (3), +.BR man (7), +.BR ascii (7), +.BR latin1 (7), +la pagina del pacchetto man-db, +.BR FSSTND . +.SH CRONOLOGIA +1990, 1991 \- Originalmente scritta da John W. Eaton (jwe@che.utexas.edu). + +23 Dicembre 1992: Rik Faith (faith@cs.unc.edu) applica le soluzioni ai +problemi fornite da Willem Kasdorp (wkasdo@nikhefk.nikef.nl). + +30 Aprile 1994 - 23 Febbraio 2000: Wilf. +(G.Wilford@ee.surrey.ac.uk) ha iniziato lo sviluppo e il mantenimento +di questo pacchetto con l'aiuto di un po' di gente. + +30 Ottobre 1996 - 30 Marzo 2001: Fabrizio Polacco <fpolacco@debian.org> +mantiene e migliora questo pacchetto per il progetto Debian, con +l'aiuto di tutta la comunità. + +31 Marzo 2001 - presente: Colin Watson <cjwatson@debian.org> + +Traduzione di Bortolozzo Giovanni (borto@pluto.linux.it) +Aggiornamento di Giuseppe Sacco <eppesuig@debian.org> |