Man pages to PDF or RTF?

2001-11-17 Thread Rafe B.

Hi.  Nother newbie windoze-user question.

I know this has been asked before, apologies 
and thanks in advance.

Is there a windoze util that will convert 
Linux man pages to RTF or PDF or Postscript?

Specifically, what is the format of man pages?
TeX/roff /troff/other ???  Is there a 
HOWTO for man-page format (There must also 
be a nifty indexing scheme, right?)

I really want printable files.  I know I can 
find the man pages in HTML format at many 
different websites -- that's not the point.

Furthermore, I'd prefer to be printing the 
man pages that live on my own debian installation, 
not some generic page off the web.



rafe b.




Re: Man pages to PDF or RTF?

2001-11-17 Thread Stig Brautaset
* Rafe B. [EMAIL PROTECTED] spake thus:
 Is there a windoze util that will convert Linux man pages to RTF or
 PDF or Postscript?

why would you want a windoze tool to do that?

 Specifically, what is the format of man pages?  TeX/roff /troff/other
 ???  Is there a HOWTO for man-page format (There must also be a nifty
 indexing scheme, right?)

Try the manpage for man (man man). It tells you how to make dvi-files
(from which you can create ps or pdf) or to make postscript-files and
directly piping it to a printer and all sorts of stuff.

Regards,
Stig

-- 
brautaset.org
Registered Linux User 107343



RE: Man pages to PDF or RTF?

2001-11-17 Thread Ted Harding
On 17-Nov-01 Rafe B. wrote:
 Is there a windoze util that will convert 
 Linux man pages to RTF or PDF or Postscript?
 
 Specifically, what is the format of man pages?
 TeX/roff /troff/other ???  Is there a 
 HOWTO for man-page format (There must also 
 be a nifty indexing scheme, right?)
 
 I really want printable files.  I know I can 
 find the man pages in HTML format at many 
 different websites -- that's not the point.

Don't bother with Windows. Use the -Tdevice
option to 'man' (this passes the option to 'groff').
The primary (source) format of man pages is that
of 'troff' source text, to be formatted using the
-man option to include the tmac.an macros
(don't worry, 'man' looks after all that).

So, if you want PostScript output, try (for example)

  man -Tps ls  man_ls.ps

and you will have the man page for 'ls' in PostScript
(view it with say 'gv' or print it as a PS file).

You can then convert it to PDF with ps2pdf (part of
'ghostscript').

Also, if you want DVI output, you could use -Tdvi
instead.

Hope this helps,
Ted.


E-Mail: (Ted Harding) [EMAIL PROTECTED]
Fax-to-email: +44 (0)870 167 1972
Date: 17-Nov-01   Time: 17:08:14
-- XFMail --



Re: Man pages to PDF or RTF?

2001-11-17 Thread Simon Law
On Sat, 17 Nov 2001, Rafe B. wrote:

 
 Hi.  Nother newbie windoze-user question.
 
 I know this has been asked before, apologies 
 and thanks in advance.
 
 Is there a windoze util that will convert 
 Linux man pages to RTF or PDF or Postscript?
 
 Specifically, what is the format of man pages?
 TeX/roff /troff/other ???  Is there a 
 HOWTO for man-page format (There must also 
 be a nifty indexing scheme, right?)
 
 I really want printable files.  I know I can 
 find the man pages in HTML format at many 
 different websites -- that's not the point.
 
 Furthermore, I'd prefer to be printing the 
 man pages that live on my own debian installation, 
 not some generic page off the web.

I can't think of a good way of doing this in Windows, unless you
have CygWin and GhostScript installed there.

What I =think= you can do, is something like this...

Go to a directory on your GNU/Linux machine, where you want to place
your PDFs, say /home/rafe/manpages

$ mkdir /home/rafe/manpages
$ cd /home/rafe/manpages

Then, copy your man directory over, so that you can work with them.

$ cp --recursive /usr/share/man/* .
$ cp --recursive /usr/local/man/* .

Now, you have a mirror of your manpages.  Run through them and write out
your PDFs.  (I am using a bash script to do this, convert to your
favourite shell.)

$ for i in `find .` ; do man -T -l $i | ps2pdf -  $i.pdf ; done

After this, you can delete your duplicate manpages, leaving only your
PDFs.

$ find . -name *.gz -exec rm -f '{}' ';'

Now, for this to work, you will need groff, gs, and man-db installed.
Good luck!

Simon