]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - debian/rules
autopkgtest: new specification for autopkgtest/DEP-8 tests
[debian/debian-policy.git] / debian / rules
index 1e31ad42664f77226b76326e76606098a9eabab2..2a3a76e51e39a146286b7ff58a2e708c30c1383c 100755 (executable)
 #!/usr/bin/make -f
-############################ -*- Mode: Makefile -*- ###########################
-## rules ---
-## Author          : Manoj Srivastava ( srivasta@tiamat.datasync.com )
-## Created On      : Thu Oct 29 15:35:55 1998
-## Created On Node  : tiamat.datasync.com
-## Last Modified By : Manoj Srivastava
-## Last Modified On : Tue Oct 26 15:20:25 2004
-## Last Machine Used: glaurung.internal.golden-gryphon.com
-## Update Count            : 62
-## Status          : Unknown, Use with caution!
-## HISTORY         :
-## Description     :
-## $Id$
-###############################################################################
-
-ifdef ARCH
-  ha:=-a$(ARCH)
-endif
-
-# set the dpkg-architecture vars; but we don't use them, so we'll comment out
-export DEB_BUILD_ARCH      ?= $(shell dpkg-architecture $(ha) -qDEB_BUILD_ARCH)
-export DEB_BUILD_GNU_CPU   ?= $(shell dpkg-architecture $(ha) -qDEB_BUILD_GNU_CPU)
-export DEB_BUILD_GNU_SYSTEM?= $(shell dpkg-architecture $(ha) -qDEB_BUILD_GNU_SYSTEM)
-export DEB_BUILD_GNU_TYPE  ?= $(shell dpkg-architecture $(ha) -qDEB_BUILD_GNU_TYPE)
-export DEB_HOST_ARCH       ?= $(shell dpkg-architecture $(ha) -qDEB_HOST_ARCH)
-export DEB_HOST_GNU_CPU    ?= $(shell dpkg-architecture $(ha) -qDEB_HOST_GNU_CPU)
-export DEB_HOST_GNU_SYSTEM ?= $(shell dpkg-architecture $(ha) -qDEB_HOST_GNU_SYSTEM)
-export DEB_HOST_GNU_TYPE   ?= $(shell dpkg-architecture $(ha) -qDEB_HOST_GNU_TYPE)
-
-arch   := $(shell dpkg --print-installation-architecture)
-
-# Basic information
+
+# Basic package information.
 package := $(shell grep Source debian/control | sed 's/^Source: //')
 date   := $(shell date +"%Y-%m-%d")
-version := $(shell awk -F '[()]' '/^$(package)/{ print $$2; exit }' debian/changelog)
-
-# Location of the source dir
-SRCTOP   := $(CURDIR)
-TMPTOP   := $(SRCTOP)/debian/tmp
-DOCDIR   := $(TMPTOP)/usr/share/doc/$(package)
-LIBDIR   := $(TMPTOP)/usr/share/doc-base
-
-sanitycheck := debian/rules policy.sgml
-
-SGML_FILES := policy menu-policy mime-policy policy-process perl-policy
-DESC_FILES := debian-policy debian-menu-policy debian-perl-policy \
-              debian-mime-policy debian-policy-process debconf-spec fhs
-
-# While we have two versions of the FHS installed in the source package,
-# we need to modify this to handle it.  This is the easiest way to do it.
-# FHS_ARCHIVE := $(wildcard fhs*.tar.gz)
-FHS_ARCHIVE  := fhs-2.3-source.tar.gz
-FHS_HTML     := fhs-2.3.html
-FHS_FILES    := fhs-2.3.ps.gz fhs-2.3.txt.gz fhs-2.3.pdf.gz
-FHS_NEW_ARCHIVE  := 
-FHS_NEW_HTML     := 
-FHS_NEW_FILES    := 
-
-POLICY_FILES = $(SGML_FILES:=.sgml) $(SGML_FILES:=.txt.gz) \
-              virtual-package-names-list.txt \
-              upgrading-checklist.txt libc6-migration.txt version.ent \
-               debconf_spec/debconf_specification.html \
-               debconf_spec/debconf_specification.txt.gz \
-               policy.ps.gz policy.pdf.gz
-
-# policy.{pdf,ps,tpt,txt} are generated files
-FILES_TO_CLEAN  = debian/files debian/buildinfo  debian/substvars \
-                 debian/postinst debian/prerm \
-                 version.ent upgrading-checklist.txt \
-                 $(SGML_FILES:=.txt.gz) $(SGML_FILES:=.html.tar.gz) \
-                 policy.pdf.gz policy.ps.gz \
-                 debconf_specification.xml.tar.gz \
-                  policy.pdf policy.ps policy.txt policy.
-
-STAMPS_TO_CLEAN := stamp-policy stamp-build
-DIRS_TO_CLEAN   := debian/tmp fhs $(SGML_FILES:=.html)
-
-
-install_file    := install -p  -o root -g root  -m  644
-install_program := install -p  -o root -g root  -m  755
-make_directory  := install -p -d       -o root -g root  -m  755
-
-
-all build: stamp-build
-stamp-build: version.ent $(sanitycheck)
+version := $(shell dpkg-parsechangelog | awk '/^Version:/ { print $$2; exit }')
+
+# Currently, emacs23 is required (xemacs is not sufficient).
+EMACS   := emacs24
+
+# Location of the source and build directories.
+SRCTOP := $(CURDIR)
+TMPTOP := $(SRCTOP)/debian/tmp
+DOCDIR := $(TMPTOP)/usr/share/doc/$(package)
+LIBDIR := $(TMPTOP)/usr/share/doc-base
+
+# SGML source files in the top-level directory.  We do some common actions
+# with each of these: validate, build text, HTML, and one-page HTML output,
+# and generate a tarball of the source.
+SGML_FILES  := policy menu-policy perl-policy upgrading-checklist
+
+# org-mode source files in the top-level directory.  We generate text and
+# HTML versions from these.
+ORG_FILES   := Process README
+
+# doc-base description files for the documents we include.
+DESC_FILES  := copyright-format-1.0 debian-policy debian-menu-policy \
+              debian-perl-policy debconf-spec fhs autopkgtest
+
+# Our local copy of the File Hierarchy Standard.  We don't build this from
+# source, but we do have a copy of the source in FHS_ARCHIVE.
+FHS_ARCHIVE := fhs-2.3-source.tar.gz
+FHS_FILES   := fhs-2.3.html fhs-2.3.ps.gz fhs-2.3.txt.gz fhs-2.3.pdf.gz
+
+# A list of the simple Policy files that we include in the documentation
+# directory of the generated package.  The tarballs of source are handled
+# separately, as are the directories of HTML output.
+POLICY_FILES := $(SGML_FILES:=.sgml) $(SGML_FILES:=.txt.gz)            \
+               $(SGML_FILES:=-1.html) version.ent                      \
+               virtual-package-names-list.txt libc6-migration.txt      \
+               copyright-format/copyright-format-1.0.html              \
+               copyright-format/copyright-format-1.0.txt.gz            \
+               autopkgtest/autopkgtest.html                            \
+               autopkgtest/autopkgtest.txt.gz                          \
+               debconf_spec/debconf_specification.html                 \
+               debconf_spec/debconf_specification.txt.gz               \
+               policy.ps.gz policy.pdf.gz README.txt README.html       \
+               Process.txt Process.html
+
+# Used by the clean rules.  STAMPS_TO_CLEAN are the stamp files used to tell
+# make that a target has completed, and are removed first.  FILES_TO_CLEAN
+# are individual generated files to remove.  DIRS_TO_CLEAN are entire
+# directories to remove.
+STAMPS_TO_CLEAN := stamp-binary stamp-build
+DIRS_TO_CLEAN   := $(SGML_FILES:=.html) debian/tmp fhs
+FILES_TO_CLEAN := $(SGML_FILES:=.txt) $(SGML_FILES:=.txt.gz)           \
+                  $(SGML_FILES:=.html.tar.gz) $(SGML_FILES:=-1.html)   \
+                  $(ORG_FILES:=.html) $(ORG_FILES:=.txt)               \
+                  policy.pdf.gz policy.ps.gz                           \
+                  policy.pdf policy.ps policy.tpt policy.txt           \
+                  copyright-format/version.xml                         \
+                  autopkgtest/version.txt                              \
+                  debconf_spec/include/version.xml version.ent         \
+                  copyright-format.xml.tar.gz                          \
+                  debconf_specification.xml.tar.gz                     \
+                  debian/files
+
+# Install files and directories with the correct ownership and permissions.
+install := install -p -o root -g root -m 644
+mkdir   := install -d -o root -g root -m 755
+
+
+all build build-indep: stamp-build
+build-arch:
+stamp-build: version.ent copyright-format/version.xml \
+            autopkgtest/version.txt \
+            debconf_spec/include/version.xml
        $(MAKE) $(SGML_FILES:=.sgml.validate) \
                $(SGML_FILES:=.html.tar.gz) \
+                $(SGML_FILES:=-1.html) \
                $(SGML_FILES:=.txt.gz) \
                policy.ps.gz policy.pdf.gz
-       links -dump upgrading-checklist.html | perl -pe 's/[\r\0]//g' > \
-                    upgrading-checklist.txt
+       $(MAKE) $(ORG_FILES:=.html) \
+               $(ORG_FILES:=.txt)
+       $(MAKE) -C copyright-format all
+       $(MAKE) -C autopkgtest all
        $(MAKE) -C debconf_spec all
+       cd copyright-format && \
+               GZIP=-n9 tar -zcf ../copyright-format.xml.tar.gz *
+       cd debconf_spec && \
+               GZIP=-n9 tar -zcf ../debconf_specification.xml.tar.gz *
        touch stamp-build
 
-configure: version.ent
+# Create the version files for inclusion in the various documents.  We want
+# to put the Policy version and date in each document, even if they
+# separately have their own versions.
+configure: version.ent copyright-format/version.xml \
+          autopkgtest/version.txt \
+          debconf_spec/include/version.xml
 version.ent: debian/changelog
        rm -f $@
        echo "<!entity version \"$(version)\">" >> $@
        echo "<!entity date    \"$(date)\">"    >> $@
-
-clean: $(sanitycheck)
-# Undoes the effect of `make -f debian/rules build'.
+copyright-format/version.xml: debian/changelog
+       rm -f $@
+       echo '<?xml version="1.0" standalone="no"?>' >  $@
+       echo '<!ENTITY version "$(version)">'        >> $@
+       echo '<!ENTITY date    "$(date)">'           >> $@
+debconf_spec/include/version.xml: debian/changelog
+       rm -f $@
+       echo '<?xml version="1.0" standalone="no"?>' >  $@
+       echo '<!ENTITY version "$(version)">'        >> $@
+       echo '<!ENTITY date    "$(date)">'           >> $@
+autopkgtest/version.txt: debian/changelog
+       rm -f $@
+       echo                                     > $@
+       echo '---'                               >> $@
+       echo 'Debian Policy $(version), $(date)' >> $@
+
+clean:
+       rm -f $(STAMPS_TO_CLEAN)
+       $(MAKE) -C copyright-format clean
+       $(MAKE) -C autopkgtest clean
        $(MAKE) -C debconf_spec clean
-       rm -f  $(FILES_TO_CLEAN) $(STAMPS_TO_CLEAN)
+       rm -f $(FILES_TO_CLEAN)
        rm -rf $(DIRS_TO_CLEAN)
-       rm -f core `find . \( -name '*.orig' -o -name '*.rej' -o \
-         -name '*~' -o -name '*.bak' -o -name '#*#' -o \
-         -name '.*.orig' -o -name '.*.rej' -o -name '.SUMS' -o \
+       rm -f core `find . \( -name '*.orig' -o -name '*.rej' -o        \
+         -name '*~' -o -name '*.bak' -o -name '#*#' -o                 \
+         -name '.*.orig' -o -name '.*.rej' -o -name '.SUMS' -o         \
          -size 0 \) -print` TAGS
 
 
-binary:                binary-indep binary-arch
-binary-arch:   build $(sanitycheck)
-# There are no architecture-dependent files to be uploaded
-# generated by this package.  If there were any they would be
-# made here.
-
-binary-indep:  stamp-policy
-stamp-policy:  build $(sanitycheck)
-       @test $$(id | sed -e 's/(.*$$//' -e 's/^uid=//') || \
-               (echo need root priviledges; exit 1)
-#      This is unnecessary; commenting out
-#      test -f stamp-build     || $(MAKE) -f        debian/rules build
-       rm -rf                  $(TMPTOP)
-       $(make_directory)       $(TMPTOP)/DEBIAN
-       $(make_directory)       $(DOCDIR)/fhs
-       $(make_directory)       $(LIBDIR)
-       # create a substvar to reference from debian/control so that
-       # we don't hardcode the policy compliance of the policy
-       # package.  I guess some might question this but I take it as
-       # a given that the debian-policy pkg must always comply with
-       # itself...
-       echo "debian-policy:Version=$(version)"      > debian/substvars
-       $(install_file)     $(POLICY_FILES)          $(DOCDIR)/
-       $(install_file)     debian/changelog         $(DOCDIR)/
-       # Be more specific with file compression
-       gzip -f9            $(DOCDIR)/*.txt $(DOCDIR)/*.sgml \
-                               $(DOCDIR)/changelog
-# These are allready compressed
-       #$(install_file)    $(FHS_NEW_FILES)         $(DOCDIR)/fhs/
-       $(install_file)     $(FHS_FILES)             $(DOCDIR)/fhs/
-       $(install_file)     debian/copyright         $(DOCDIR)/
-       GZIP=-9 cd debconf_spec && \
-         tar -zcf ../debconf_specification.xml.tar.gz *
-       $(install_file)     debconf_specification.xml.tar.gz $(DOCDIR)/
-       @set -ex; \
-       for file in $(DESC_FILES); do \
-         $(install_file) $$file.desc $(LIBDIR)/$$file; \
+binary: binary-indep binary-arch
+binary-arch:
+binary-indep: stamp-binary
+stamp-binary: stamp-build
+       @test $$(id | sed -e 's/(.*$$//' -e 's/^uid=//') -eq 0 || \
+           (echo 'You must run this as root (or use fakeroot)' >&2; exit 1)
+       rm -rf          $(TMPTOP)
+       $(mkdir)        $(TMPTOP)/DEBIAN
+       $(mkdir)        $(DOCDIR)/fhs
+       $(mkdir)        $(LIBDIR)
+#
+# Install simple files.
+#
+       $(install)      $(POLICY_FILES)         $(DOCDIR)/
+       $(install)      $(FHS_FILES)            $(DOCDIR)/fhs/
+       $(install)      debian/changelog        $(DOCDIR)/
+       $(install)      debian/copyright        $(DOCDIR)/
+#
+# Install DocBook XML source.
+#
+       $(install)      copyright-format.xml.tar.gz             $(DOCDIR)/
+       $(install)      debconf_specification.xml.tar.gz        $(DOCDIR)/
+#
+# Install generated HTML directories.
+#
+       @set -ex; for file in $(SGML_FILES); do                 \
+               tar -C $(DOCDIR) -zxf $$file.html.tar.gz;       \
        done
-       @set -ex; \
-       for file in $(SGML_FILES); do \
-         tar -C $(DOCDIR) -zxf $$file.html.tar.gz; \
+#
+# Make upgrading-checklist-1.html a symlink to the copy in the policy.html
+# directory.  This is temporary until it becomes a proper appendix.
+#
+       rm -f $(DOCDIR)/upgrading-checklist-1.html
+       ln -s policy.html/upgrading-checklist.html \
+               $(DOCDIR)/upgrading-checklist-1.html
+#
+# Install doc-base files.
+#
+       @set -ex; for file in $(DESC_FILES); do                 \
+               $(install) $$file.desc $(LIBDIR)/$$file;        \
        done
-       $(install_file)     $(FHS_HTML)   $(DOCDIR)/fhs
-       @set -ex; \
-       cd debian/tmp; \
-       find . -type f -printf '%P\0' | xargs -r0 md5sum > DEBIAN/md5sums
-       sed -e 's/#PACKAGE#/$(package)/g' debian/postinst.in > debian/postinst
-       sed -e 's/#PACKAGE#/$(package)/g' debian/prerm.in > debian/prerm
-       $(install_program)  debian/postinst          debian/tmp/DEBIAN/
-       $(install_program)  debian/prerm             debian/tmp/DEBIAN/
-       dpkg-gencontrol     -p$(package) -Pdebian/tmp -isp
-       chown               -R root:root debian/tmp
-       chmod               -R go=rX debian/tmp
-       dpkg                --build debian/tmp ..
-       touch               stamp-policy
-
-
-.PHONY: configure build binary binary-arch binary-indep clean checkroot
-
-#Local variables:
-#mode: makefile
-#End:
+#
+# Compress files and build MD5 checksums.
+#
+       gzip -f9 $(DOCDIR)/*.sgml $(DOCDIR)/changelog
+       gzip -f9 -n $(DOCDIR)/*.txt
+       @set -ex; cd debian/tmp; \
+       find . -path './DEBIAN' -prune -o -type f -printf '%P\0' \
+               | xargs -r0 md5sum > DEBIAN/md5sums
+#
+# Build the package.
+#
+       dpkg-gencontrol -p$(package) -Pdebian/tmp
+       chown -R root:root debian/tmp
+       chmod -R go=rX debian/tmp
+       dpkg --build debian/tmp ..
+       touch stamp-binary
+
+
+.PHONY: all configure build build-arch build-indep binary binary-arch
+.PHONY: binary-indep clean