man-pages/man1/dh_installmanpages.1.html
2021-03-31 01:06:50 +01:00

116 lines
3.2 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of DH_INSTALLMANPAGES</TITLE>
</HEAD><BODY>
<H1>DH_INSTALLMANPAGES</H1>
Section: Debhelper (1)<BR>Updated: 2020-03-27<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
dh_installmanpages - old-style man page installer (deprecated)
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>dh_installmanpages</B> [<I>debhelper options</I>] [<I>file</I> ...]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>dh_installmanpages</B> is a debhelper program that is responsible for
automatically installing man pages into <I>usr/share/man/</I>
in package build directories.
<P>
This is a DWIM-style program, with an interface unlike the rest of
debhelper. It is deprecated, and you are encouraged to use
<B><A HREF="/cgi-bin/man/man2html?1+dh_installman">dh_installman</A></B>(1) instead.
<P>
<B>dh_installmanpages</B> scans the current directory and all subdirectories for
filenames that look like man pages. (Note that only real files are looked
at; symlinks are ignored.) It uses <B><A HREF="/cgi-bin/man/man2html?1+file">file</A></B>(1) to verify that the files are
in the correct format. Then, based on the files' extensions, it installs
them into the correct man directory.
<P>
All filenames specified as parameters will be skipped by <B>dh_installmanpages</B>.
This is useful if by default it installs some man pages that you do not
want to be installed.
<P>
After the man page installation step, <B>dh_installmanpages</B> will check to see
if any of the man pages are <I>.so</I> links. If so, it changes them to symlinks.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><I>file</I> ...<DD>
Do not install these files as man pages, even if they look like valid man
pages.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>BUGS</H2>
<B>dh_installmanpages</B> will install the man pages it finds into <B>all</B> packages
you tell it to act on, since it can't tell what package the man
pages belong in. This is almost never what you really want (use <B>-p</B> to work
around this, or use the much better <B><A HREF="/cgi-bin/man/man2html?1+dh_installman">dh_installman</A></B>(1) program instead).
<P>
Files ending in <I>.man</I> will be ignored.
<P>
Files specified as parameters that contain spaces in their filenames will
not be processed properly.
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)
<P>
This program is a part of debhelper.
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>
Joey Hess &lt;<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="2"><A HREF="#lbAB">NAME</A><DD>
<DT id="3"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="4"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="5"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="6"><A HREF="#lbAF">BUGS</A><DD>
<DT id="7"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="8"><A HREF="#lbAH">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:10 GMT, March 31, 2021
</BODY>
</HTML>