NAME¶

cs_man2pdf - create PDF file from manual page

SYNOPSIS¶

cs_man2pdf --help | --version
cs_man2pdf --dir <directory>
cs_man2pdf --rpm <installed_RPM>
cs_man2pdf <man_page> <section>

DESCRIPTION¶

cs_man2pdf creates a PDF file from an manual page.
Basically the command "man -Tps ... | ps2pdf - >..." is used. The resulting PDFs could be read with any PDF viewer on eBook devices, smartphones, or gaming consoles.

OPTIONS¶

--help
show help

--version
show version

--dir <directory>
convert man pages from directory

--rpm <rpm>
convert man pages from installed RPM

EXAMPLES¶

* create PDF for manual page stonith_sbd(7) and write the output into a file in the current working directory.

# cs_man2pdf stonith_sbd 7

* create PDF files for manual pages of OCF resource agents.

# apropos ocf_ | awk '$2~/7/ {print $1,"7"}' |\
while read; do cs_man2pdf $REPLY; done

* create PDF files for manual pages from directory ./mankind/.

# cs_man2pdf -d ./mankind/

* create PDF files for manual pages from installed RPM ClusterTools2.

# cs_man2pdf -r ClusterTools2

EXIT STATUS¶

0 Successful program execution.
>0 Usage, syntax or execution errors.

FILES¶

/usr/sbin/cs_man2pdf

the program itself

$PWD/<man_page>.<n>.pdf

the output file

BUGS¶

This script can only handle manual pages with up to two dots in the filename. Manual pages with double colons currently are not handled. I am sorry for Perl. When using --directory, a .gz suffix will make it to the PDF's filename.
Feedback is welcome, please mail to feedback@suse.com

SEE ALSO¶

man(1), apropos(1), whatis(1), mandb(8), ps2pdf(1), roff2html(1)

COPYRIGHT¶

(c) 2016-2019 B.Jin, L.Pinne, Germany.
cs_man2pdf comes with ABSOLUTELY NO WARRANTY.
For details see the GNU General Public License at http://www.gnu.org/licenses/gpl.html