From 5280f9a0cd1f9ba200422ebba65d1e0133410995 Mon Sep 17 00:00:00 2001 From: Kaz Kylheku Date: Sat, 13 Sep 2014 09:43:21 -0700 Subject: Initial. --- man2html/locales/en/hman.1 | 69 +++++++++++++++++ man2html/locales/en/man2html.1 | 151 +++++++++++++++++++++++++++++++++++++ man2html/locales/fr/man2html.1 | 165 +++++++++++++++++++++++++++++++++++++++++ man2html/locales/it/hman.1 | 71 ++++++++++++++++++ man2html/locales/it/man2html.1 | 153 ++++++++++++++++++++++++++++++++++++++ 5 files changed, 609 insertions(+) create mode 100644 man2html/locales/en/hman.1 create mode 100644 man2html/locales/en/man2html.1 create mode 100644 man2html/locales/fr/man2html.1 create mode 100644 man2html/locales/it/hman.1 create mode 100644 man2html/locales/it/man2html.1 (limited to 'man2html/locales') 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" + "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 + +.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 +/? +.LP +and the environment variables PATH_INFO and QUERY_STRING +will be set to and , 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 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" + "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 + +.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 +/? +.LP +et les variables d'environnement PATH_INFO et QUERY_STRING seront positionnées +respectivement à et . +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 + 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à +.\" Revisione a cura di Vieri Giugni +.\" 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à +.\" Revisione a cura di Vieri Giugni +.\" 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" + "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 + +.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 +/? +.LP +e le variabili d'ambiente PATH_INFO e QUERY_STRING +verranno impostate rispettivamente in e . +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) -- cgit v1.2.3