[dpkg] 95/192: man: Add new man page for debian/rules

Tue Oct 17 11:04:04 UTC 2017

This is an automated email from the git hooks/post-receive script.

infinity0 pushed a commit to branch pu/reproducible_builds
in repository dpkg.

commit ba9acf9f64928adf15e4ad470ac15c19ec095fab
Author: Guillem Jover <guillem at debian.org>
Date:   Wed Aug 17 00:56:38 2016 +0200

    man: Add new man page for debian/rules
---
 debian/changelog         |  1 +
 debian/dpkg-dev.manpages |  1 +
 man/Makefile.am          |  2 ++
 man/deb-src-rules.man    | 88 ++++++++++++++++++++++++++++++++++++++++++++++++
 man/po/po4a.cfg          |  3 ++
 5 files changed, 95 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 570f4bc..41dbfc6 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -49,6 +49,7 @@ dpkg (1.19.0) UNRELEASED; urgency=medium
       reference. Closes: #872309
     - Use correct name for archname validator value in dpkg(1) man page.
       Reported by Niels Thykier <niels at thykier.net.
+    - Add new deb-src-rules(5) man page.
   * Code internals:
     - Switch perl code to use -> operator for function variables.
   * Build system:
diff --git a/debian/dpkg-dev.manpages b/debian/dpkg-dev.manpages
index 96543e7..d48a2b4 100644
--- a/debian/dpkg-dev.manpages
+++ b/debian/dpkg-dev.manpages
@@ -5,6 +5,7 @@ debian/tmp/usr/share/man/*/deb-control.5
 debian/tmp/usr/share/man/*/deb-conffiles.5
 debian/tmp/usr/share/man/*/deb-src-control.5
 debian/tmp/usr/share/man/*/deb-src-files.5
+debian/tmp/usr/share/man/*/deb-src-rules.5
 debian/tmp/usr/share/man/*/deb-version.7
 debian/tmp/usr/share/man/*/deb-substvars.5
 debian/tmp/usr/share/man/*/deb-origin.5
diff --git a/man/Makefile.am b/man/Makefile.am
index 6405f0b..a88d92c 100644
--- a/man/Makefile.am
+++ b/man/Makefile.am
@@ -8,6 +8,7 @@ man_MANS = \
 	deb-control.5 \
 	deb-src-control.5 \
 	deb-src-files.5 \
+	deb-src-rules.5 \
 	deb-version.7 \
 	deb-shlibs.5 \
 	deb-split.5 \
@@ -89,6 +90,7 @@ EXTRA_DIST = \
 	deb-split.man \
 	deb-src-control.man \
 	deb-src-files.man \
+	deb-src-rules.man \
 	deb-substvars.man \
 	deb-symbols.man \
 	deb-triggers.man \
diff --git a/man/deb-src-rules.man b/man/deb-src-rules.man
new file mode 100644
index 0000000..19a8f72
--- /dev/null
+++ b/man/deb-src-rules.man
@@ -0,0 +1,88 @@
+.\" dpkg manual page - deb-src-rules(5)
+.\"
+.\" Copyright © 2016-2017 Guillem Jover <guillem at debian.org>
+.\"
+.\" This is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" This is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
+.
+.TH deb\-src\-rules 5 "2017-09-05" "Debian Project" "dpkg utilities"
+.SH NAME
+deb\-src\-rules \- Debian source package rules file
+.
+.SH SYNOPSIS
+debian/rules
+.
+.SH DESCRIPTION
+This file contains the instructions necessary to build the binary packages
+from the source package.
+.PP
+The \fIdebian/rules\fP file is an executable Makefile, with a shebang that
+is usually set to "#!/usr/bin/make -f".
+.PP
+It must support the following make targets:
+
+.TP
+.B clean
+Clean up the source tree, by undoing any change done by any of the build
+and binary targets.
+This target will be called with root privileges.
+.TP
+.B build\-indep
+Build architecture independent files required to build any architecture
+independent binary package.
+If there are no architecture indepdenent binary packages to generate,
+the target must still exist but do nothing.
+This target must not require root privileges.
+.TP
+.B build\-arch
+Build architecture dependent files required to build any architecture
+dependent binary package.
+If there are no architecture dependent binary packages to generate,
+the target must still exist but do nothing.
+This target must not require root privileges.
+.TP
+.B build
+Build architecture independent and dependent files, either by depending
+(at least transitively) on \fBbuild\-indep\fP and/or \fBbuild\-arch\fP or
+by inlining what those targets would do.
+This target must not require root privileges.
+.TP
+.B binary\-indep
+Build architecture independent binary packages.
+This target must depend (at least transitively) on either \fBbuild\-indep\fP
+or \fBbuild\fP.
+This target will be called with root privileges.
+.TP
+.B binary\-arch
+Build architecture dependent binary packages.
+This target must depend (at least transitively) on either \fBbuild\-arch\fP
+or \fBbuild\fP.
+This target will be called with root privileges.
+.TP
+.B binary
+Build architecture independent and dependent binary packages, either by
+depending (at least transitively) on \fBbinary\-indep\fP and/or
+\fBbinary\-arch\fP or by inlining what those targets would do.
+This target will be called with root privileges.
+.
+.SH SEE ALSO
+.ad l
+.nh
+.BR dpkg\-architecture (1),
+.BR dpkg\-vendor (1),
+.BR dpkg\-buildflags (1),
+.BR dpkg\-parsechangelog (1),
+.BR dpkg\-shlibdeps (1),
+.BR dpkg\-gencontrol (1),
+.BR dpkg\-deb (1),
+.BR dpkg\-distaddfile (1).
diff --git a/man/po/po4a.cfg b/man/po/po4a.cfg
index 3aeb93c..142b95c 100644
--- a/man/po/po4a.cfg
+++ b/man/po/po4a.cfg
@@ -31,6 +31,9 @@
 [type:man] deb-src-files.man $lang:$lang/deb-src-files.man \
            add_$lang:po/$lang.add
 
+[type:man] deb-src-rules.man $lang:$lang/deb-src-rules.man \
+           add_$lang:po/$lang.add
+
 [type:man] deb-split.man $lang:$lang/deb-split.man \
            add_$lang:po/$lang.add
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/dpkg.git

