man: release man2html.1 [JM:00383]

[linuxjm/jm.git] / manual / man / draft / man1 / man2html.1

diff --git a/manual/man/draft/man1/man2html.1 b/manual/man/draft/man1/man2html.1
index 8eb536f..b4d5a7b 100644 (file)
--- a/manual/man/draft/man1/man2html.1
+++ b/manual/man/draft/man1/man2html.1
@@ -2,10 +2,14 @@
 .\" Man page for man2html
 .\" aeb, 980101
 .\"
-.\" 
-.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
+.\"
+.\" Japanese Version Copyright (c) 1997 NAKANO Takeo all rights reserved.
 .\" Translated Thu Mar 5 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
 .\"
+.\"
+.\" Updated Fri Aug 19 02:54:00 JST 2011
+.\"         by TACHIBANA Akira <tati@kc5.so-net.ne.jp>
+.\"
 .TH man2html 1 "1 January 1998"
 .LO 1
 .\"O .SH NAME
@@ -17,23 +21,21 @@ man2html \- 
 man2html [options] [file]
 .\"O .SH DESCRIPTION
 .SH ÀâÌÀ
-.\"O .B man2html
+.B man2html
 .\"O converts a manual page as found in
-.\"O .I file
+¤Ï
+.I file
 .\"O (or stdin, in case no file argument, or the argument "-", is given)
 .\"O from man-style nroff into html, and prints the result on stdout.
 .\"O It does support tbl but does not know about eqn.
 .\"O The exit status is 0. If something goes wrong,
 .\"O an error page is printed on stdout.
-.B man2html
-¤Ï
-.I file
 ¤È¤·¤Æ»ØÄꤵ¤ì¤¿¥Õ¥¡¥¤¥ë (¥Õ¥¡¥¤¥ë°ú¤­¿ô¤¬¤Ê¤«¤Ã¤¿¤ê¡¢ "-" ¤¬»ØÄꤵ¤ì
 ¤¿¾ì¹ç¤Ïɸ½àÆþÎÏ) ¤òÊÑ´¹¤·¤Æ¡¢ man ¥¹¥¿¥¤¥ë¤Î nroff ¤«¤é html ¤òÀ¸À®¤·¡¢
 ·ë²Ì¤òɸ½à½ÐÎϤËɽ¼¨¤·¤Þ¤¹¡£ tbl ¤Ï¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Þ¤¹¤¬ eqn ¤Ï¤·¤Æ¤¤¤Þ
 ¤»¤ó¡£ÊÖ¤êÃͤϾï¤Ë 0 ¤Ç¤¹¡£¤Ê¤Ë¤«ÌäÂ꤬µ¯¤³¤Ã¤¿¾ì¹ç¤Ï¡¢¥¨¥é¡¼¥Ú¡¼¥¸¤¬
 ɸ½à½ÐÎϤËɽ¼¨¤µ¤ì¤Þ¤¹¡£
- 
+
 .\"O This can be used as a stand-alone utility, but is mainly intended
 .\"O as an auxiliary, to enable users to browse their man pages using
 .\"O a html browser like
@@ -56,10 +58,9 @@ man2html [options] [file]
 ./" in the environment.)
 
 .\"O The main part of
-.\"O .B man2html
+.B man2html
 .\"O is the troff-to-html engine written by Richard Verhoeven (rcb5@win.tue.nl).
 .\"O It adds hyperlinks for the following constructs:
-.B man2html
 ¤Î¼çÍ×Éô¤Ï Richard Verhoeven (rcb5@win.tue.nl) ¤Ë¤è¤Ã¤Æ½ñ¤«¤ì¤¿ 
 troff-to-html ¥¨¥ó¥¸¥ó¤Ç¤¹¡£¤³¤ì¤Ï°Ê²¼¤Î¤è¤¦¤Ê·Á¼°¤Î¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤òÉÕ
 ²Ã¤·¤Þ¤¹¡£
@@ -80,21 +81,22 @@ name@host   "mailto:name@host"
 .\"O is generated, so that it is easier to find one's way
 .\"O in large man pages like
 .\"O .BR bash (1).
-(ºÇ½é¤Î¥ê¥ó¥¯¤Ï¥ª¥×¥·¥ç¥ó¤Ë¤è¤Ã¤ÆÊѹ¹¤Ç¤­¤Þ¤¹ - °Ê²¼¤Îµ­½Ò¤ò»²¾È¤Î¤³¤È)
+(¾å¤ËÎóµó¤·¤¿¤â¤Î¤ÎÆâ¡¢ºÇ½é¤Î¤â¤Î¤Ë¤Ä¤¤¤Æ¤Ï¥ª¥×¥·¥ç¥ó¤Ë¤è¤Ã¤ÆÄ´À°¤Ç¤­¤Þ¤¹ - °Ê²¼¤Îµ­½Ò¤ò»²¾È¤Î¤³¤È)
 ¥ê¥ó¥¯Àè¤Î³Îǧ¤Ï¹Ô¤ï¤ì¤º¡¢¥ê¥ó¥¯À褬¸ºß¤·¤Æ¤¤¤Ê¤¯¤Æ¤â¥ê¥ó¥¯¹Ô¤¬À¸À®
 ¤µ¤ì¤Þ¤¹¡£Ê¸½ñÆâÉô¤Ç¤Î¡¢¥»¥¯¥·¥ç¥ó¤Ê¤É¤Ø¤Î¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤âÀ¸À®¤µ¤ì¤Þ¤¹¡£
 ¤·¤¿¤¬¤Ã¤Æ
 .BR bash (1)
-¤Ê¤É¤ÎÂ礭¤Ê¥Þ¥ó¡¦¥Ú¡¼¥¸¤ÇɬÍפÊÉôʬ¤òõ¤¹¤Î¤¬³Ú¤Ë¤Ê¤ê¤Þ¤¹¡£
+¤Ê¤É¤ÎÂ礭¤Ê man ¥Ú¡¼¥¸¤ÇɬÍפÊÉôʬ¤òõ¤¹¤Î¤¬³Ú¤Ë¤Ê¤ê¤Þ¤¹¡£
 
 .\"O .SH OPTIONS
-.SH ¥ª¥×¥·¥ç¥ó
 .\"O When reading from stdin, it is not always clear how to
 .\"O do .so expansion. The \-D option allows a script to define
 .\"O the working directory.
-ɸ½àÆþÎϤ«¤éÆɤ߹þ¤à¤È¤­¡¢ .so ¤ÎŸ³«¤Ë´Ø¤·¤Æ¤Ï¤Ã¤­¤ê¤·¤Ê¤¤¾ì¹ç¤â¤¢¤ê
-¤Þ¤¹¡£ \-D ¥ª¥×¥·¥ç¥ó¤òÍѤ¤¤ì¤Ð¡¢¥¹¥¯¥ê¥×¥È¤«¤é¥ï¡¼¥­¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê
-¤ò»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£
+.SH ¥ª¥×¥·¥ç¥ó
+ɸ½àÆþÎϤ«¤éÆɤ߹þ¤à¾ì¹ç¤Ï¡¢.so ¤ÎŸ³«¤ò¤É¤¦¤¹¤ë¤«¤¬É¬¤º¤·¤â
+ÌÀÇò¤Ç¤Ï¤¢¤ê¤Þ¤»¤ó¡£¤½¤¦¤¤¤¦¤È¤­¤Ç¤â¡¢\-D ¥ª¥×¥·¥ç¥ó¤ò»È¤¨¤Ð¡¢
+¥¹¥¯¥ê¥×¥È¤ÎÊý¤Ç¥ï¡¼¥­¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤Î°ÌÃÖ¤òÌÀ¼¨¤¹¤ë¤³¤È¤¬
+¤Ç¤­¤Þ¤¹¡£
 .LP
 .TP
 .B \-\^D pathname
@@ -114,15 +116,17 @@ pathname 
 Í¿¤¨¤é¤ì¤¿¥¨¥é¡¼¥á¥Ã¥»¡¼¥¸¤ò´Þ¤à¥¨¥é¡¼¥Ú¡¼¥¸¤ò½ÐÎϤ·¤Þ¤¹¡£
 .LP
 .\"O The general form of a hyperlink generated for a man page reference is
-»²¾ÈÀ褬¥Þ¥ó¡¦¥Ú¡¼¥¸¤Ç¤¢¤ë¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¡¢°ìÈ̤˰ʲ¼¤Î¤è¤¦¤Ê·Á¼°¤ÇÀ¸À®
+»²¾ÈÀ褬 man ¥Ú¡¼¥¸¤Ç¤¢¤ë¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤Ï¡¢°ìÈ̤˰ʲ¼¤Î¤è¤¦¤Ê·Á¼°¤ÇÀ¸À®
 ¤µ¤ì¤Þ¤¹¡£
 .IP
 <method:cgipath><man2htmlpath><separator><manpage>
 .LP
+(ÌõÃí: method ¤Ï¡¢URL ¥¹¥­¡¼¥à¤ò»Ø¤·¤Þ¤¹¡£°Ê²¼¤Ç¤Ï¥á¥½¥Ã¥É¤È¸Æ¤Ó¤Þ¤¹¡£)
+.LP
 .\"O with a default as shown above. The parts of this hyperlink
 .\"O are set using the various options.
-¥Ç¥Õ¥©¥ë¥È¤Ï¾å¤ÎÄ̤ê¤Ç¤¹¤¬¡¢¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤Î³ÆÉô¤Ï³Æ¼ï¥ª¥×¥·¥ç¥ó
-¤òÍѤ¤¤ë¤³¤È¤Ç¤¤¤í¤¤¤íÀßÄê¤Ç¤­¤Þ¤¹¡£
+¥Ç¥Õ¥©¥ë¥È¤Ï¾åµ­ foo(3x) ¤Ç¼¨¤·¤¿Ä̤ê¤Ç¤¹¤¬¡¢¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤Î³ÆÉô¤Ï
+³Æ¼ï¥ª¥×¥·¥ç¥ó¤òÍѤ¤¤ë¤³¤È¤Ç¤¤¤í¤¤¤íÀßÄê¤Ç¤­¤Þ¤¹¡£
 .TP
 .B \-\^h
 .\"O Set method:cgipath to http://localhost. This is the default.
@@ -132,7 +136,7 @@ method:cgipath 
 .\"O Set method:cgipath to
 .\"O .RI http:// host.domain:port .
 method:cgipath ¤ò
-.RI htttp:// host.domain:port
+.RI http:// host.domain:port
 ¤ËÀßÄꤷ¤Þ¤¹¡£
 .TP
 .B \-\^l
@@ -163,6 +167,10 @@ man2htmlpath 
 .B \-\^q
 .\"O Set separator to '?'. This is the default.
 ¥»¥Ñ¥ì¡¼¥¿¡¼¤ò '?' ¤ËÀßÄꤷ¤Þ¤¹¡£¥Ç¥Õ¥©¥ë¥È¤Ç¤¹¡£
+.TP
+.B \-\^r
+.\"O Use relative html paths, instead of cgi-bin paths.
+cgi-bin path ¤ÎÂå¤ï¤ê¤Ë¡¢ÁêÂÐ html path ¤ò»ÈÍѤ·¤Þ¤¹¡£
 .LP
 .\"O On a machine without running
 .\"O .BR httpd ,
@@ -174,25 +182,27 @@ man2htmlpath 
 .\"O The option \-l (for `lynxcgi') selects the former behaviour.
 .\"O With it, the default cgipath is \fI/home/httpd\fP.
 .B httpd
-¤¬²ÔÆ°¤·¤Æ¤¤¤Ê¤¤¥Þ¥·¥ó¤Ç¤Ï¡¢
+¤¬²ÔƯ¤·¤Æ¤¤¤Ê¤¤¥Þ¥·¥ó¤Ç¤Ï¡¢lynxcgi ¥á¥½¥Ã¥É¤ò»ÈÍѤ¹¤ë¤È¡¢
+.B lynx
+¤Ç man ¥Ú¡¼¥¸¤ò±ÜÍ÷¤¹¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£
+http ¥Ç¡¼¥â¥ó¤¬²ÔÆ°¤·¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢http ¥á¥½¥Ã¥É¤ò»È¤¨¤Ð¡¢
 .B lynx
-¤Ç lynxcgi ¤òÍѤ¤¤ì¤Ð¥Þ¥ó¡¦¥Ú¡¼¥¸¤ò±ÜÍ÷¤¹¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£
-http ¥Ç¡¼¥â¥ó¤¬²ÔÆ°¤·¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢ lynx ¤Ç¤â¾¤Î¥Ö¥é¥¦¥¶¤Ç¤â±ÜÍ÷¤Ç¤­
-¤Þ¤¹¡£¥ª¥×¥·¥ç¥ó \-l (`lynxcgi' ¤Î°ÕÌ£) ¤ÏÁ°¼Ô¤òÁªÂò¤·¤Þ¤¹¡£¤³¤ì¤ò»ØÄê
-¤¹¤ë¤È¡¢¥Ç¥Õ¥©¥ë¥È¤Î cgipath ¤Ï \fI/home/httpd/\fP ¤Ë¤Ê¤ê¤Þ¤¹¡£
+¤Ç¤â¾¤Î¥Ö¥é¥¦¥¶¤Ç¤â man ¥Ú¡¼¥¸¤Î±ÜÍ÷¤¬²Äǽ¤Ç¤¹¡£
+¥ª¥×¥·¥ç¥ó \-l (`lynxcgi' ¤Î°ÕÌ£) ¤ÏÁ°¼Ô¤ÎÆ°ºî¤òÁªÂò¤·¤Þ¤¹¡£
+¤½¤Î¾ì¹ç¡¢¥Ç¥Õ¥©¥ë¥È¤Î cgipath ¤Ï \fI/home/httpd\fP ¤Ë¤Ê¤ê¤Þ¤¹¡£
 
 .\"O In general, a cgi script can be called by
 °ìÈÌ¤Ë¤Ï cgi ¥¹¥¯¥ê¥×¥È¤Ï
 .IP
 <path_to_script>/<more_path>?<query>
 .LP
-¤Î¤è¤¦¤Ê¤«¤¿¤Á¤Ç¸Æ¤Ö¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£
 .\"O and the environment variables PATH_INFO and QUERY_STRING
 .\"O will be set to <more_path> and <query>, respectively.
 .\"O Since lynxcgi does not handle the PATH_INFO part, we generate
 .\"O hyperlinks with `?' as a separator by default.
 .\"O The option \-p (for `path') selects '/' as a separator, while
 .\"O the option \-q (for `query') selects '?' as a separator.
+¤Î¤è¤¦¤Ê¤«¤¿¤Á¤Ç¸Æ¤Ö¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£
 ´Ä¶­ÊÑ¿ô PATH_INFO ¤È QUERY_STRING ¤¬¤½¤ì¤¾¤ì <more_path> ¤È <query> 
 ¤ËÀßÄꤵ¤ì¤Þ¤¹¡£ lynxcgi ¤Ï PATH_INFO Éôʬ¤ò°·¤¦¤³¤È¤¬¤Ç¤­¤Ê¤¤¤Î¤Ç¡¢¥Ç
 ¥Õ¥©¥ë¥È¤Ç¤Ï `?' ¤ò¥»¥Ñ¥ì¡¼¥¿¡¼¤È¤¹¤ë¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤òÀ¸À®¤¹¤ë¤³¤È¤Ë¤·
@@ -209,8 +219,8 @@ man2html -H $SERVER_NAME
 .LP
 .\"O if the variable SERVER_NAME is set.  This would allow your machine
 .\"O to act as a server and export man pages.
-¤Î¤è¤¦¤ËÍѤ¤¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£¤³¤ì¤Ë¤è¤Ã¤Æ¡¢¤ª»È¤¤¤Î¥Þ¥·¥ó¤ò¡¢¥Þ¥ó¡¦¥Ú¡¼
-¥¸¤òÄ󶡤¹¤ë¥µ¡¼¥Ð¡¼¤Î¤è¤¦¤ËÆ°ºî¤µ¤»¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£
+¤Î¤è¤¦¤ËÍѤ¤¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£¤³¤ì¤Ë¤è¤Ã¤Æ¡¢¤ª»È¤¤¤Î¥Þ¥·¥ó¤ò¡¢man ¥Ú¡¼¥¸¤ò
+Ä󶡤¹¤ë¥µ¡¼¥Ð¡¼¤Î¤è¤¦¤ËÆ°ºî¤µ¤»¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£
 
 .\"O .SH BUGS
 .SH ¥Ð¥°
@@ -218,9 +228,22 @@ man2html -H $SERVER_NAME
 .\"O The lynxcgi method will not work if lynx was compiled without
 .\"O selecting support for it.  There may be problems with security.
 ¿¤¯¤Îȯ¸«Åª¼êË¡ (heuristic) ¤¬ÍѤ¤¤é¤ì¤Æ¤¤¤Þ¤¹¡£½ÐÎϤϾï¤Ë´°Á´¤Ç¤¢¤ë
-¤È¤Ï¸Â¤ê¤Þ¤»¤ó¡£ lynxcgi ¤Ï¡¢¤³¤ì¤ò¥µ¥Ý¡¼¥È¤¹¤ë¤è¤¦¤ËÁªÂò¤·¤Æ lynx ¤ò
-¥³¥ó¥Ñ¥¤¥ë¤·¤Ê¤±¤ì¤ÐÆ°ºî¤·¤Þ¤»¤ó¡£¥»¥­¥å¥ê¥Æ¥£¾å¤ÎÌäÂ꤬¤¢¤ë¤«¤â¤·¤ì¤Þ
-¤»¤ó¡£
+¤È¤Ï¸Â¤ê¤Þ¤»¤ó¡£ lynxcgi ¥á¥½¥Ã¥É¤Ï¡¢¤³¤ì¤ò¥µ¥Ý¡¼¥È¤¹¤ë¤è¤¦¤ËÁªÂò¤·¤Æ
+.B lynx
+¤ò¥³¥ó¥Ñ¥¤¥ë¤·¤Ê¤±¤ì¤ÐÆ°ºî¤·¤Þ¤»¤ó¡£
+¥»¥­¥å¥ê¥Æ¥£¾å¤ÎÌäÂ꤬¤¢¤ë¤«¤â¤·¤ì¤Þ¤»¤ó¡£
+
+.\"O .SH AUTHOR
+.SH ºî¼Ô
+.\"O Richard Verhoeven was the original author of
+.\"O .BR "man2html" .
+.\"O Michael Hamilton and Andries Brouwer subsequently improved on it.  
+.\"O Federico Lucifredi <flucifredi@acm.org> is the current maintainer.
+.BR "man2html"
+¤Î¸¶ºî¼Ô¤Ï Richard Verhoeven ¤Ç¤¹¡£
+Michael Hamilton ¤È Andries Brouwer ¤¬¤½¤Î¸å¤Î²þÎɤò¹Ô¤¤¤Þ¤·¤¿¡£
+¸½ºß¤Î¥á¥ó¥Æ¥Ê¡¼¤Ï Federico Lucifredi <flucifredi@acm.org> ¤Ç¤¹¡£
+
 
 .\"O .SH "SEE ALSO"
 .SH ´ØÏ¢¹àÌÜ