diff options
Diffstat (limited to 'man2html/locales')
-rw-r--r-- | man2html/locales/en/hman.1 | 69 | ||||
-rw-r--r-- | man2html/locales/en/man2html.1 | 151 | ||||
-rw-r--r-- | man2html/locales/fr/man2html.1 | 165 | ||||
-rw-r--r-- | man2html/locales/it/hman.1 | 71 | ||||
-rw-r--r-- | man2html/locales/it/man2html.1 | 153 |
5 files changed, 609 insertions, 0 deletions
diff --git a/man2html/locales/en/hman.1 b/man2html/locales/en/hman.1 new file mode 100644 index 0000000..4676f55 --- /dev/null +++ b/man2html/locales/en/hman.1 @@ -0,0 +1,69 @@ +.\" Copyright (c) 1998 Andries Brouwer +.\" +.\" You may distribute under the terms of the GNU General Public +.\" License as specified in the README file that comes with the man 1.0 +.\" distribution. +.TH hman 1 "19 January 1998" +.LO 1 +.SH NAME +hman \- browse the on-line manual pages +.SH SYNOPSIS +.B hman +[ -P \fIbrowser\fP ] [ -H \fIhost\fP ] [ \fIsection\fP ] \fIname\fP +.br +.B hman +[ -P \fIbrowser\fP ] [ -H \fIhost\fP ] [ \fIsection\fP ] [ index ] +.SH DESCRIPTION +The +.B hman +script is an interface to man2html(1) that allows you to enter man page +requests at the command line and view the output in your favourite +browser. +The behaviour reminds of that of +.BR man (1) +so that many people will be able to alias +.B hman +to +.BR man . +If the browser used is netscape, and an incarnation of netscape +is running already, +.B hman +will pass the request to the existing browser. + +.SH OPTIONS +.TP +.B \-\^P " browser" +Specify which browser (like lynx, xmosaic, arena, chimera, +netscape, amaya, ...) to use. +This option overrides the +.B MANHTMLPAGER +environment variable. +The default is the non-httpd version of +.BR lynx . +.TP +.B \-\^H " host" +Specify from what host to get the man pages. +This option overrides the +.B MANHTMLHOST +environment variable. +The default is +.BR localhost . + +.SH ENVIRONMENT +.TP +MANHTMLPAGER +The default browser to use is selected using this environment variable. +.TP +MANHTMLHOST +The default host to use is selected using this environment variable. + +.SH "SEE ALSO" +.BR man (1), +.BR man2html (1), +.BR arena (1), +.BR lynx (1), +.BR netscape (1), +.BR xmosaic (1), +.BR glimpse (1) + +http://www.mcom.com/newsref/std/x-remote.html diff --git a/man2html/locales/en/man2html.1 b/man2html/locales/en/man2html.1 new file mode 100644 index 0000000..c1c25b3 --- /dev/null +++ b/man2html/locales/en/man2html.1 @@ -0,0 +1,151 @@ +'\" t +.\" Man page for man2html +.\" aeb, 980101 +.\" +.TH man2html 1 "1 January 1998" +.LO 1 +.SH NAME +man2html \- format a manual page in html +.SH SYNOPSIS +man2html [options] [file] +.SH DESCRIPTION +.B man2html +converts a manual page as found in +.I file +(or stdin, in case no file argument, or the argument "-", is given) +from man-style nroff into html, and prints the result on stdout. +It does support tbl but does not know about eqn. +The exit status is 0. If something goes wrong, +an error page is printed on stdout. + +This can be used as a stand-alone utility, but is mainly intended +as an auxiliary, to enable users to browse their man pages using +a html browser like +.BR lynx (1), +.BR xmosaic (1) +or +.BR netscape (1). +./" (See +./" .BR man (1) +./" for info on how to browse man pages via +./" .BR man2html . +./" Usually it would suffice to put "MANHTMLPAGER=/usr/bin/lynx" +./" in the environment.) + +The main part of +.B man2html +is the troff-to-html engine written by Richard Verhoeven (rcb5@win.tue.nl). +It adds hyperlinks for the following constructs: +.LP +.TS +l l. +foo(3x) "http://localhost/cgi-bin/man/man2html?3x+foo" +method://string "method://string" +www.host.name "http://www.host.name" +ftp.host.name "ftp://ftp.host.name" +name@host "mailto:name@host" +<string.h> "file:/usr/include/string.h" +.TE +.LP +(The first of these can be tuned by options - see below.) +No lookup is done - the links generated need not exist. +Also an index with internal hyperlinks to the various sections +is generated, so that it is easier to find one's way +in large man pages like +.BR bash (1). + +.SH OPTIONS +When reading from stdin, it is not always clear how to +do .so expansion. The \-D option allows a script to define +the working directory. +.LP +.TP +.B \-\^D pathname +Strip the last two parts from the pathname, and do a +\fIchdir\fP(\fIdir\fP) before starting the conversion. +.LP +The \-E option allows the easy generation of error messages +from a cgi script. +.LP +.TP +.B \-\^E string +Output an error page containing the given error message. +.LP +The general form of a hyperlink generated for a man page reference is +.IP +<method:cgipath><man2htmlpath><separator><manpage> +.LP +with a default as shown above. The parts of this hyperlink +are set using the various options. +.TP +.B \-\^h +Set method:cgipath to http://localhost. This is the default. +.TP +.BI \-\^H " host[.domain][:port]" +Set method:cgipath to +.RI http:// host.domain:port . +.TP +.B \-\^l +Set method:cgipath to +.RI lynxcgi: /home/httpd . +.TP +.BI \-\^L " dir" +Set method:cgipath to +.RI lynxcgi: dir . +.TP +.BI \-\^M " man2htmlpath" +Set the man2htmlpath to use. The default is +.IR /cgi-bin/man/man2html . +.TP +.B \-\^p +Set separator to '/'. +.TP +.B \-\^q +Set separator to '?'. This is the default. +.TP +.B \-\^r +Use relative html paths, instead of cgi-bin paths. +.LP +On a machine without running +.BR httpd , +one can use +.B lynx +to browse the man pages, using the lynxcgi method. +When some http daemon is running, lynx, or any other browser, +can be used to browse the man pages, using the http method. +The option \-l (for `lynxcgi') selects the former behaviour. +With it, the default cgipath is \fI/home/httpd\fP. + +In general, a cgi script can be called by +.IP +<path_to_script>/<more_path>?<query> +.LP +and the environment variables PATH_INFO and QUERY_STRING +will be set to <more_path> and <query>, respectively. +Since lynxcgi does not handle the PATH_INFO part, we generate +hyperlinks with `?' as a separator by default. +The option \-p (for `path') selects '/' as a separator, while +the option \-q (for `query') selects '?' as a separator. + +The option \-H \fIhost\fP will specify the host to use +(instead of \fIlocalhost\fP). A cgi script could use +.IP +man2html -H $SERVER_NAME +.LP +if the variable SERVER_NAME is set. This would allow your machine +to act as a server and export man pages. + +.SH BUGS +There are many heuristics. The output will not always be perfect. +The lynxcgi method will not work if lynx was compiled without +selecting support for it. There may be problems with security. + +.SH AUTHOR +Richard Verhoeven was the original author of +.BR "man2html" . +Michael Hamilton and Andries Brouwer subsequently improved on it. +Federico Lucifredi <flucifredi@acm.org> is the current maintainer. + +.SH "SEE ALSO" +.BR lynx (1), +.BR man (1) diff --git a/man2html/locales/fr/man2html.1 b/man2html/locales/fr/man2html.1 new file mode 100644 index 0000000..1e99cd8 --- /dev/null +++ b/man2html/locales/fr/man2html.1 @@ -0,0 +1,165 @@ +'\" t +.\" Man page for man2html +.\" aeb, 980101 +.\" +.TH man2html 1 "1er janvier 1998" "Manuel Linux" "Commandes utilisateur" +.LO 1 +.SH NOM +man2html \- formate une page de manuel en html +.SH SYNOPSIS +man2html [options] [fichier] +.SH DESCRIPTION +.B man2html +convertit une page de manuel telle que trouvée dans +.I fichier +(ou l'entrée standard stdin si aucun argument fichier n'est donné +ou si l'argument «\ -\ » est donné) à partir du format nroff +(celui des pages de manuels) vers un format html et affiche le résultat +sur la sortie standard (stdout). +.B man2html +supporte +.BR tbl (1) +mais ne connaît rien à propos de +.BR eqn (1). +Le code de sortie est 0. Si quelque chose va mal, une page d'erreur +est affichée sur la sortie standard stdout. + +Cette commande peut être utilisée seule mais a été principalement conçue pour +être un auxiliaire afin que les utilisateurs puissent naviguer dans les pages +de manuel avec un navigateur html comme +.BR lynx (1), +.BR xmosaic (1) +ou +.BR netscape (1). +./" (See +./" .BR man (1) +./" for info on how to browse man pages via +./" .BR man2html . +./" Usually it would suffice to put "MANHTMLPAGER=/usr/bin/lynx" +./" in the environment.) + +La plus grande partie de +.B man2html +est l'engin «\ troff-vers-html\ » écrit par Richard Verhoeven (rcb5@win.tue.nl). +Il ajoute des hyperliens aux constructions suivantes\ : +.LP +.TS +l l. +foo(3x) "http://localhost/cgi-bin/man/man2html?3x+foo" +method://string "method://string" +www.host.name "http://www.host.name" +ftp.host.name "ftp://ftp.host.name" +name@host "mailto:name@host" +<string.h> "file:/usr/include/string.h" +.TE +.LP +(La première de celles\-ci peut être ajustée par des options - voir plus loin.) +Aucune consultation n'est effectuée - les liens générés n'ont pas besoin +d'exister. Un index avec des hyperliens internes vers les diverses +sections est également créé rendant plus facile la navigation dans les grandes +pages comme +.BR bash (1). + +.SH OPTIONS +Lorsqu'on lit à partir de stdin, il n'est pas toujours évident de savoir +comment se fait l'expansion .so. L'option \-D permet à un script de définir +le répertoire de travail. +.LP +.TP +.B \-\^D chemin +Retire les deux derniers éléments du chemin et effectue un changement +de répertoire courant \fIchdir\fP(\fIdir\fP) avant de débuter la conversion. +.LP +L'option \-E option facilite la production de messages d'erreurs à partir +de scripts cgi. +.LP +.TP +.B \-\^E chaîne +Produire en sortie une page d'erreur contenant le message d'erreur donné. +.LP +La forme générale d'un hyperlien généré pour référencer une page de manuel est +.IP +<method:cgipath><man2htmlpath><separator><manpage> +.LP +qui est d'ailleurs la forme par défaut. Les éléments de cet hyperlien sont +positionnés en utilisant diverses options. +.TP +.B \-\^h +Positionner method:cgipath à http://localhost. +C'est le comportement par défaut. +.TP +.BI \-\^H " hôte[.domaine][:port]" +Positionner method:cgipath à +.RI http:// hôte.domaine:port . +.TP +.B \-\^l +Positionner method:cgipath à +.RI lynxcgi: /home/httpd . +.TP +.BI \-\^L " dir" +Positionner method:cgipath à +.RI lynxcgi: dir . +.TP +.BI \-\^M " man2htmlpath" +Positionner le chemin vers man2html à utiliser. La valeur par défaut est +.IR /cgi-bin/man/man2html . +.TP +.B \-\^p +Positionner le séparateur à «\ /\ ». +.TP +.B \-\^q +Positionner le séparateur à «\ ?\ ». C'est la valeur par défaut. +.TP +.B \-\^r +Utiliser des chemins html relatifs plutôt que les chemins cgi-bin. +.LP +Sur une machine sur laquelle +.BR httpd +ne tourne pas, vous pouvez utiliser +.B lynx +pour naviguer dans les pages de manuel en utilisant la méthode lynxcgi. +Lorsqu'un démon http est en service, vous pouvez utiliser lynx ou n'importe +quel autre navigateur pour parcourir les pages de manuel en utilisant +la méthode http. +L'option \-l (pour «\ lynxcgi\ ») sélectionne ce fonctionnement. +Avec elle, le chemin cgi par défaut est \fI/home/httpd\fP. + +En général, un script cgi peut être appelé de la façon suivante +.IP +<path_to_script>/<more_path>?<query> +.LP +et les variables d'environnement PATH_INFO et QUERY_STRING seront positionnées +respectivement à <more_path> et <query>. +Puisque lynxcgi ne gère pas l'élément PATH_INFO, nous allons générer des +hyperliens avec «\ ?\ » comme séparateur par défaut. +L'option \-p (pour «\ path\ ») sélectionne «\ /\ » comme séparateur, alors que +l'option \-q (for «\ query\ ») sélectionne «\ ?\ ». + +L'option \-H \fIhost\fP spécifiera l'hôte à utiliser +(à la place \fIlocalhost\fP). Un script cgi pourra utiliser +.IP +man2html -H $SERVER_NAME +.LP +si la variable SERVER_NAME est positionnée. Cela permettra à votre machine +de fonctionner en tant que serveur et d'exporter les pages manuel. + +.SH BOGUES +Il y a beaucoup d'heuristiques. La sortie produite ne sera pas toujours +parfaite. La méthode lynxcgi ne fonctionnera pas si lynx a été compilé sans +le support de celle-ci. Il peut y avoir des problèmes de sécurité. + +.SH "VOIR AUSSI" +.BR lynx (1), +.BR man (1) + +.SH TRADUCTION +.PP +Ce document est une traduction réalisée par Alain Portal +<aportal AT univ-montp2 DOT fr> le 1er juin 2005 et mise à jour +le 7 novembre 2005. +.PP +L'équipe de traduction a fait le maximum pour réaliser une adaptation +française de qualité. La version anglaise la plus à jour de ce document est +toujours consultable via la commande\ : «\ \fBLANG=en\ man\ 1\ man2html\fR\ ». +N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute +erreur dans cette page de manuel. diff --git a/man2html/locales/it/hman.1 b/man2html/locales/it/hman.1 new file mode 100644 index 0000000..730de9c --- /dev/null +++ b/man2html/locales/it/hman.1 @@ -0,0 +1,71 @@ +.\" Copyright (c) 1998 Andries Brouwer
+.\"
+.\" You may distribute under the terms of the GNU General Public
+.\" License as specified in the README file that comes with the man 1.0
+.\" distribution.
+.\" Traduzione da man-1.6d di Giulio Daprelà <giulio@pluto.it>
+.\" Revisione a cura di Vieri Giugni <v.giugni@gmail.com>
+.\" agosto 2006
+.\"
+.TH hman 1 "19 Gennaio 1998"
+.LO 1
+.SH NOME
+hman \- naviga le pagine di manuale on-line
+.SH SINTASSI
+.B hman
+[ -P \fIbrowser\fP ] [ -H \fIhost\fP ] [ \fIsection\fP ] \fIname\fP
+.br
+.B hman
+[ -P \fIbrowser\fP ] [ -H \fIhost\fP ] [ \fIsection\fP ] [ index ]
+.SH DESCRIZIONE
+Lo script
+.B hman
+è un'interfaccia per man2html(1), che permette di inserire richieste di man
+page dalla linea di comando e vedere l'output nel browser
+preferito.
+Il comportamento ricorda quello di
+.BR man (1)
+perciò molte persone potranno utilizzare un alias da
+.B hman
+a
+.BR man .
+Se il browser usato è netscape, e una copia di netscape
+è già in esecuzione,
+.B hman
+passerà la richiesta a quest'ultima
+
+.SH OPZIONI
+.TP
+.B \-\^P " browser"
+Specifica quale browser (lynx, xmosaic, arena, chimera,
+netscape, amaya, ...) usare.
+Questa opzione sovrascrive la variabile d'ambiente
+.B MANHTMLPAGER .
+Il valore predefinito è la versione non-httpd di
+.BR lynx .
+.TP
+.B \-\^H " host"
+Specifica da quale host prendere le man page.
+Questa opzione sovrascrive la variabile d'ambiente
+.B MANHTMLHOST .
+Il valore predefinito è
+.BR localhost .
+
+.SH AMBIENTE
+.TP
+MANHTMLPAGER
+Il browser predefinito in uso è selezionato da questa variabile d'ambiente.
+.TP
+MANHTMLHOST
+L'host predefinito in uso è selezionato da questa variabile d'ambiente.
+
+.SH "VEDERE ANCHE"
+.BR man (1),
+.BR man2html (1),
+.BR arena (1),
+.BR lynx (1),
+.BR netscape (1),
+.BR xmosaic (1),
+.BR glimpse (1)
+
+http://www.mcom.com/newsref/std/x-remote.html
diff --git a/man2html/locales/it/man2html.1 b/man2html/locales/it/man2html.1 new file mode 100644 index 0000000..45feef0 --- /dev/null +++ b/man2html/locales/it/man2html.1 @@ -0,0 +1,153 @@ +'\" t
+.\" Man page for man2html
+.\" aeb, 980101
+.\"
+.\" Traduzione da man-1.6d di Giulio Daprelà <giulio@pluto.it>
+.\" Revisione a cura di Vieri Giugni <v.giugni@gmail.com>
+.\" giugno 2006
+.\"
+.TH man2html 1 "1 gennaio 1998"
+.LO 1
+.SH NOME
+man2html \- formatta una pagina di manuale in html
+.SH SINTASSI
+man2html [options] [file]
+.SH DESCRIZIONE
+.B man2html
+converte una pagina di manuale che si trova in
+.I file
+(o standard input (stdin); nel caso non venga fornito alcun file come
+argomento, o sia indicato "-", come argomento)
+dallo stile man nroff in html, e stampa il risultato in standard output (stdout).
+Supporta tbl, ma non conosce eqn.
+Lo stato di uscita è 0. Se qualcosa va male
+viene stampata su stdout una pagina di errore.
+
+Può essere usato come utilità stand-alone, ma è pensato principalmente
+come ausilio per permettere agli utenti di navigare le proprie man page
+usando un browser html come
+.BR lynx (1),
+.BR xmosaic (1)
+o
+.BR netscape (1).
+./" (See
+./" .BR man (1)
+./" for info on how to browse man pages via
+./" .BR man2html .
+./" Usually it would suffice to put "MANHTMLPAGER=/usr/bin/lynx"
+./" in the environment.)
+
+La parte principale di
+.B man2html
+è il motore da troff a html scritto da Richard Verhoeven (rcb5@win.tue.nl).
+Esso aggiunge dei collegamenti ipertestuali per i seguenti costrutti:
+.LP
+.TS
+l l.
+foo(3x) "http://localhost/cgi-bin/man/man2html?3x+foo"
+method://string "method://string"
+www.host.name "http://www.host.name"
+ftp.host.name "ftp://ftp.host.name"
+name@host "mailto:name@host"
+<string.h> "file:/usr/include/string.h"
+.TE
+.LP
+(Il primo di questi può essere controllato dalle opzioni - vedere sotto).
+Non viene fatto nessun controllo - i collegamenti generati non sono
+necessari o indispensabili.
+Inoltre viene generato un indice con collegamenti interni alle varie sezioni,
+in modo che sia più facile effettuare ricerche personalizzate in pagine di
+manuale grandi come
+.BR bash (1).
+
+.SH OPZIONI
+Quando si legge da stdin non è sempre chiaro come effettuare l'espansione
+.so . L'opzione \-D permette a uno script di definire la
+directory di lavoro.
+.LP
+.TP
+.B \-\^D pathname
+Estrae le ultime due parti dal percorso, ed esegue
+\fIchdir\fP(\fIdir\fP) prima di iniziare la conversione.
+.LP
+L'opzione \-E permette una facile generazione di messaggi di errore
+da uno script cgi.
+.LP
+.TP
+.B \-\^E string
+Genera una pagina di errore contenente il messaggio di errore che si è verificato.
+.LP
+La forma generale di un collegamento ipertestuale creato per una
+man page di riferimento è
+.IP
+<method:cgipath><man2htmlpath><separator><manpage>
+.LP
+con un valore predefinito come mostrato sopra. Le parti di questo collegamento
+ipertestuale sono impostate usando le varie opzioni.
+.TP
+.B \-\^h
+Set method:cgipath to http://localhost. Questo è il valore predefinito.
+.TP
+.BI \-\^H " host[.domain][:port]"
+Set method:cgipath to
+.RI http:// host.domain:port .
+.TP
+.B \-\^l
+Set method:cgipath to
+.RI lynxcgi: /home/httpd .
+.TP
+.BI \-\^L " dir"
+Set method:cgipath to
+.RI lynxcgi: dir .
+.TP
+.BI \-\^M " man2htmlpath"
+Imposta il man2htmlpath da usare. Il valore predefinito è
+.IR /cgi-bin/man/man2html .
+.TP
+.B \-\^p
+Imposta '/' come separatore.
+.TP
+.B \-\^q
+Imposta '?' come separatore. Questo è il valore predefinito.
+.TP
+.B \-\^r
+Usa percorsi html relativi, invece dei percorsi cgi-bin.
+.LP
+Su una macchina, senza eseguire
+.BR httpd ,
+si può usare
+.B lynx
+per navigare le man page, usando il metodo lynxcgi.
+Quando è attivo qualche demone http, lynx, o qualunque altro browser,
+può essere usato per navigare le man page, usando il metodo http.
+L'opzione \-l (per `lynxcgi') seleziona il comportamento precedente.
+Con esso, il valore predefinito di cgipath è \fI/home/httpd\fP.
+
+In generale, uno script cgi può essere chiamato da
+.IP
+<path_to_script>/<more_path>?<query>
+.LP
+e le variabili d'ambiente PATH_INFO e QUERY_STRING
+verranno impostate rispettivamente in <more_path> e <query>.
+Poiché lynxcgi non gestisce la parte PATH_INFO, vengono generati
+collegamenti ipertestualil con `?' come separatore predefinito.
+L'opzione \-p (per `path') seleziona '/' come separatore, mentre
+l'opzione \-q (per `query') seleziona '?' come separatore.
+
+L'opzione \-H \fIhost\fP specificherà l'host da usare
+(invece di \fIlocalhost\fP). Uno script cgi può usare
+.IP
+man2html -H $SERVER_NAME
+.LP
+se è impostata la variabile SERVER_NAME . Questo permetterà alla propria
+macchina di comportarsi come un server ed esportare man page.
+
+.SH BUG
+Ci sono molti fattori difficilmente prevedibili. L'output potrebbe non
+essere sempre perfetto. Il metodo lynxcgi non funzionerà se lynx è stato
+compilato senza selezionare il supporto per quest'ultimo. Ci potrebbero
+essere problemi di sicurezza.
+
+.SH "VEDERE ANCHE"
+.BR lynx (1),
+.BR man (1)
|