2 .\" Man page for man2html
6 .\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
7 .\" Translated Thu Mar 5 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
9 .TH man2html 1 "1 January 1998"
12 .\"O man2html \- format a manual page in html
14 man2html \- ¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤òÀ°·Á¤·¤Æ html ¤Ë¤¹¤ë
17 man2html [options] [file]
21 .\"O converts a manual page as found in
23 .\"O (or stdin, in case no file argument, or the argument "-", is given)
24 .\"O from man-style nroff into html, and prints the result on stdout.
25 .\"O It does support tbl but does not know about eqn.
26 .\"O The exit status is 0. If something goes wrong,
27 .\"O an error page is printed on stdout.
31 ¤È¤·¤Æ»ØÄꤵ¤ì¤¿¥Õ¥¡¥¤¥ë (¥Õ¥¡¥¤¥ë°ú¤¿ô¤¬¤Ê¤«¤Ã¤¿¤ê¡¢ "-" ¤¬»ØÄꤵ¤ì
32 ¤¿¾ì¹ç¤Ïɸ½àÆþÎÏ) ¤òÊÑ´¹¤·¤Æ¡¢ man ¥¹¥¿¥¤¥ë¤Î nroff ¤«¤é html ¤òÀ¸À®¤·¡¢
33 ·ë²Ì¤òɸ½à½ÐÎϤËɽ¼¨¤·¤Þ¤¹¡£ tbl ¤Ï¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Þ¤¹¤¬ eqn ¤Ï¤·¤Æ¤¤¤Þ
34 ¤»¤ó¡£ÊÖ¤êÃͤϾï¤Ë 0 ¤Ç¤¹¡£¤Ê¤Ë¤«ÌäÂ꤬µ¯¤³¤Ã¤¿¾ì¹ç¤Ï¡¢¥¨¥é¡¼¥Ú¡¼¥¸¤¬
35 ɸ½à½ÐÎϤËɽ¼¨¤µ¤ì¤Þ¤¹¡£
37 .\"O This can be used as a stand-alone utility, but is mainly intended
38 .\"O as an auxiliary, to enable users to browse their man pages using
39 .\"O a html browser like
43 .\"O .BR netscape (1).
44 ¤³¤ì¤Ï¥¹¥¿¥ó¥É¥¢¥í¡¼¥ó¤Î¥æ¡¼¥Æ¥£¥ê¥Æ¥£¤È¤·¤Æ¤â»È¤¨¤Þ¤¹¤¬¡¢¼ç¤ÊÌÜŪ¤Ï¡¢
45 ¥æ¡¼¥¶¡¼¤¬ man ¥Ú¡¼¥¸¤ò
49 ¤Ê¤É¤Î html ¥Ö¥é¥¦¥¶¤òÍѤ¤¤Æ¸«¤ë¤³¤È¤¬¤Ç¤¤ë¤è¤¦¤Ë¤¹¤ë¤¿¤á¤ÎÊä½õ¤ò¤¹¤ë
53 ./" for info on how to browse man pages via
55 ./" Usually it would suffice to put "MANHTMLPAGER=/usr/bin/lynx"
56 ./" in the environment.)
60 .\"O is the troff-to-html engine written by Richard Verhoeven (rcb5@win.tue.nl).
61 .\"O It adds hyperlinks for the following constructs:
63 ¤Î¼çÍ×Éô¤Ï Richard Verhoeven (rcb5@win.tue.nl) ¤Ë¤è¤Ã¤Æ½ñ¤«¤ì¤¿
64 troff-to-html ¥¨¥ó¥¸¥ó¤Ç¤¹¡£¤³¤ì¤Ï°Ê²¼¤Î¤è¤¦¤Ê·Á¼°¤Î¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤òÉÕ
69 foo(3x) "http://localhost/cgi-bin/man/man2html?3x+foo"
70 method://string "method://string"
71 www.host.name "http://www.host.name"
72 ftp.host.name "ftp://ftp.host.name"
73 name@host "mailto:name@host"
74 <string.h> "file:/usr/include/string.h"
77 .\"O (The first of these can be tuned by options - see below.)
78 .\"O No lookup is done - the links generated need not exist.
79 .\"O Also an index with internal hyperlinks to the various sections
80 .\"O is generated, so that it is easier to find one's way
81 .\"O in large man pages like
83 (ºÇ½é¤Î¥ê¥ó¥¯¤Ï¥ª¥×¥·¥ç¥ó¤Ë¤è¤Ã¤ÆÊѹ¹¤Ç¤¤Þ¤¹ - °Ê²¼¤Îµ½Ò¤ò»²¾È¤Î¤³¤È)
84 ¥ê¥ó¥¯Àè¤Î³Îǧ¤Ï¹Ô¤ï¤ì¤º¡¢¥ê¥ó¥¯À褬¸ºß¤·¤Æ¤¤¤Ê¤¯¤Æ¤â¥ê¥ó¥¯¹Ô¤¬À¸À®
85 ¤µ¤ì¤Þ¤¹¡£Ê¸½ñÆâÉô¤Ç¤Î¡¢¥»¥¯¥·¥ç¥ó¤Ê¤É¤Ø¤Î¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤âÀ¸À®¤µ¤ì¤Þ¤¹¡£
88 ¤Ê¤É¤ÎÂ礤ʥޥ󡦥ڡ¼¥¸¤ÇɬÍפÊÉôʬ¤òõ¤¹¤Î¤¬³Ú¤Ë¤Ê¤ê¤Þ¤¹¡£
92 .\"O When reading from stdin, it is not always clear how to
93 .\"O do .so expansion. The \-D option allows a script to define
94 .\"O the working directory.
95 ɸ½àÆþÎϤ«¤éÆɤ߹þ¤à¤È¤¡¢ .so ¤ÎŸ³«¤Ë´Ø¤·¤Æ¤Ï¤Ã¤¤ê¤·¤Ê¤¤¾ì¹ç¤â¤¢¤ê
96 ¤Þ¤¹¡£ \-D ¥ª¥×¥·¥ç¥ó¤òÍѤ¤¤ì¤Ð¡¢¥¹¥¯¥ê¥×¥È¤«¤é¥ï¡¼¥¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê
97 ¤ò»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
101 .\"O Strip the last two parts from the pathname, and do a
102 .\"O \fIchdir\fP(\fIdir\fP) before starting the conversion.
103 pathname ¤ÎºÇ¸å¤ÎÆó¤Äʬ¤ò¼è¤ê½ü¤¡¢ÊÑ´¹¤ò¹Ô¤¦Á°¤Ë¤½¤³¤Ë
104 \fIchdir\fP(\fIdir\fP) ¤·¤Þ¤¹¡£
106 .\"O The \-E option allows the easy generation of error messages
107 .\"O from a cgi script.
108 \-E ¥ª¥×¥·¥ç¥ó¤òÍѤ¤¤ë¤È cgi ¥¹¥¯¥ê¥×¥È¤«¤é´Êñ¤Ë¥¨¥é¡¼¥á¥Ã¥»¡¼¥¸¤òÀ¸
109 À®¤¹¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
113 .\"O Output an error page containing the given error message.
114 Í¿¤¨¤é¤ì¤¿¥¨¥é¡¼¥á¥Ã¥»¡¼¥¸¤ò´Þ¤à¥¨¥é¡¼¥Ú¡¼¥¸¤ò½ÐÎϤ·¤Þ¤¹¡£
116 .\"O The general form of a hyperlink generated for a man page reference is
117 »²¾ÈÀ褬¥Þ¥ó¡¦¥Ú¡¼¥¸¤Ç¤¢¤ë¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¡¢°ìÈ̤˰ʲ¼¤Î¤è¤¦¤Ê·Á¼°¤ÇÀ¸À®
120 <method:cgipath><man2htmlpath><separator><manpage>
122 .\"O with a default as shown above. The parts of this hyperlink
123 .\"O are set using the various options.
124 ¥Ç¥Õ¥©¥ë¥È¤Ï¾å¤ÎÄ̤ê¤Ç¤¹¤¬¡¢¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤Î³ÆÉô¤Ï³Æ¼ï¥ª¥×¥·¥ç¥ó
125 ¤òÍѤ¤¤ë¤³¤È¤Ç¤¤¤í¤¤¤íÀßÄê¤Ç¤¤Þ¤¹¡£
128 .\"O Set method:cgipath to http://localhost. This is the default.
129 method:cgipath ¤ò http://localhost ¤Ë¤·¤Þ¤¹¡£¥Ç¥Õ¥©¥ë¥È¤Ç¤¹¡£
131 .BI \-\^H " host[.domain][:port]"
132 .\"O Set method:cgipath to
133 .\"O .RI http:// host.domain:port .
135 .RI htttp:// host.domain:port
139 .\"O Set method:cgipath to
140 .\"O .RI lynxcgi: /home/httpd .
142 .RI lynxcgi: /home/httpd
146 .\"O Set method:cgipath to
147 .\"O .RI lynxcgi: dir .
152 .BI \-\^M " man2htmlpath"
153 .\"O Set the man2htmlpath to use. The default is
154 .\"O .IR /cgi-bin/man/man2html .
155 man2htmlpath ¤òÀßÄꤷ¤Þ¤¹¡£¥Ç¥Õ¥©¥ë¥È¤Ï
156 .I /cgi-bin/man/man2html
160 .\"O Set separator to '/'.
161 ¥»¥Ñ¥ì¡¼¥¿¡¼¤ò '/' ¤ËÀßÄꤷ¤Þ¤¹¡£
164 .\"O Set separator to '?'. This is the default.
165 ¥»¥Ñ¥ì¡¼¥¿¡¼¤ò '?' ¤ËÀßÄꤷ¤Þ¤¹¡£¥Ç¥Õ¥©¥ë¥È¤Ç¤¹¡£
167 .\"O On a machine without running
171 .\"O to browse the man pages, using the lynxcgi method.
172 .\"O When some http daemon is running, lynx, or any other browser,
173 .\"O can be used to browse the man pages, using the http method.
174 .\"O The option \-l (for `lynxcgi') selects the former behaviour.
175 .\"O With it, the default cgipath is \fI/home/httpd\fP.
177 ¤¬²ÔÆ°¤·¤Æ¤¤¤Ê¤¤¥Þ¥·¥ó¤Ç¤Ï¡¢
179 ¤Ç lynxcgi ¤òÍѤ¤¤ì¤Ð¥Þ¥ó¡¦¥Ú¡¼¥¸¤ò±ÜÍ÷¤¹¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
180 http ¥Ç¡¼¥â¥ó¤¬²ÔÆ°¤·¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢ lynx ¤Ç¤â¾¤Î¥Ö¥é¥¦¥¶¤Ç¤â±ÜÍ÷¤Ç¤
181 ¤Þ¤¹¡£¥ª¥×¥·¥ç¥ó \-l (`lynxcgi' ¤Î°ÕÌ£) ¤ÏÁ°¼Ô¤òÁªÂò¤·¤Þ¤¹¡£¤³¤ì¤ò»ØÄê
182 ¤¹¤ë¤È¡¢¥Ç¥Õ¥©¥ë¥È¤Î cgipath ¤Ï \fI/home/httpd/\fP ¤Ë¤Ê¤ê¤Þ¤¹¡£
184 .\"O In general, a cgi script can be called by
185 °ìÈÌ¤Ë¤Ï cgi ¥¹¥¯¥ê¥×¥È¤Ï
187 <path_to_script>/<more_path>?<query>
189 ¤Î¤è¤¦¤Ê¤«¤¿¤Á¤Ç¸Æ¤Ö¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
190 .\"O and the environment variables PATH_INFO and QUERY_STRING
191 .\"O will be set to <more_path> and <query>, respectively.
192 .\"O Since lynxcgi does not handle the PATH_INFO part, we generate
193 .\"O hyperlinks with `?' as a separator by default.
194 .\"O The option \-p (for `path') selects '/' as a separator, while
195 .\"O the option \-q (for `query') selects '?' as a separator.
196 ´Ä¶ÊÑ¿ô PATH_INFO ¤È QUERY_STRING ¤¬¤½¤ì¤¾¤ì <more_path> ¤È <query>
197 ¤ËÀßÄꤵ¤ì¤Þ¤¹¡£ lynxcgi ¤Ï PATH_INFO Éôʬ¤ò°·¤¦¤³¤È¤¬¤Ç¤¤Ê¤¤¤Î¤Ç¡¢¥Ç
198 ¥Õ¥©¥ë¥È¤Ç¤Ï `?' ¤ò¥»¥Ñ¥ì¡¼¥¿¡¼¤È¤¹¤ë¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤òÀ¸À®¤¹¤ë¤³¤È¤Ë¤·
199 ¤Þ¤·¤¿¡£¥ª¥×¥·¥ç¥ó `\-p' (`path' ¤Î°ÕÌ£) ¤Ï '/' ¤ò¥»¥Ñ¥ì¡¼¥¿¡¼¤Ë¤·¤Þ¤¹¡£
200 °ìÊý `\-q' (`query' ¤Î°ÕÌ£) ¤Ï '?' ¤ò¥»¥Ñ¥ì¡¼¥¿¡¼¤Ë¤·¤Þ¤¹¡£
202 .\"O The option \-H \fIhost\fP will specify the host to use
203 .\"O (instead of \fIlocalhost\fP). A cgi script could use
204 ¥ª¥×¥·¥ç¥ó \-H \fIhost\fP ¤Ï (\fIlocalhost\fP ¤ÎÂå¤ï¤ê¤Ë) ÍѤ¤¤ë¥Û¥¹¥È
205 ¤ò»ØÄꤷ¤Þ¤¹¡£´Ä¶ÊÑ¿ô SERVER_NAME ¤¬ÀßÄꤵ¤ì¤Æ¤¤¤ì¤Ð¡¢ cgi ¥¹¥¯¥ê¥×
208 man2html -H $SERVER_NAME
210 .\"O if the variable SERVER_NAME is set. This would allow your machine
211 .\"O to act as a server and export man pages.
212 ¤Î¤è¤¦¤ËÍѤ¤¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£¤³¤ì¤Ë¤è¤Ã¤Æ¡¢¤ª»È¤¤¤Î¥Þ¥·¥ó¤ò¡¢¥Þ¥ó¡¦¥Ú¡¼
213 ¥¸¤òÄ󶡤¹¤ë¥µ¡¼¥Ð¡¼¤Î¤è¤¦¤ËÆ°ºî¤µ¤»¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
217 .\"O There are many heuristics. The output will not always be perfect.
218 .\"O The lynxcgi method will not work if lynx was compiled without
219 .\"O selecting support for it. There may be problems with security.
220 ¿¤¯¤Îȯ¸«Åª¼êË¡ (heuristic) ¤¬ÍѤ¤¤é¤ì¤Æ¤¤¤Þ¤¹¡£½ÐÎϤϾï¤Ë´°Á´¤Ç¤¢¤ë
221 ¤È¤Ï¸Â¤ê¤Þ¤»¤ó¡£ lynxcgi ¤Ï¡¢¤³¤ì¤ò¥µ¥Ý¡¼¥È¤¹¤ë¤è¤¦¤ËÁªÂò¤·¤Æ lynx ¤ò
222 ¥³¥ó¥Ñ¥¤¥ë¤·¤Ê¤±¤ì¤ÐÆ°ºî¤·¤Þ¤»¤ó¡£¥»¥¥å¥ê¥Æ¥£¾å¤ÎÌäÂ꤬¤¢¤ë¤«¤â¤·¤ì¤Þ