1
In order to have the manual pages recreated at build time, they must be removed
2
from our package tree. We do this simply by omitting the prebuilt manual pages
3
from our SVN. When using svn-upgrade, this must be done manually post-upgrade
4
to avoid confusing subversion, or else if the debian/rules clean target is used
5
in the package svn working copy (default svn-buildpackage behaviour) the
6
prebuilt manual pages would be removed without subversion knowing about it.
8
svn revert wpa_supplicant/doc/docbook/*.5 wpa_supplicant/doc/docbook/*.8
9
svn delete wpa_supplicant/doc/docbook/*.5 wpa_supplicant/doc/docbook/*.8
12
Prebuilt manual pages are supplied upstream releases, but are not present in
13
git snapshots. Rebuilding the manual pages at build time yields two advantages:
15
1. No need to modify build rules when packaging git snapshots
17
2. Allows opportunity to patch in debian specific documentation to enhance user
21
It is expected that dpkg-source will warn about their removal:
23
dpkg-source: building wpasupplicant using existing wpasupplicant_0.6.2.orig.tar.gz
24
dpkg-source: building wpasupplicant in wpasupplicant_0.6.2-1.diff.gz
25
dpkg-source: warning: ignoring deletion of file wpa_supplicant/doc/docbook/wpa_supplicant.8
26
dpkg-source: warning: ignoring deletion of file wpa_supplicant/doc/docbook/wpa_supplicant.conf.5
27
dpkg-source: warning: ignoring deletion of file wpa_supplicant/doc/docbook/wpa_priv.8
28
dpkg-source: warning: ignoring deletion of file wpa_supplicant/doc/docbook/wpa_passphrase.8
29
dpkg-source: warning: ignoring deletion of file wpa_supplicant/doc/docbook/wpa_gui.8
30
dpkg-source: warning: ignoring deletion of file wpa_supplicant/doc/docbook/wpa_cli.8
31
dpkg-source: warning: ignoring deletion of file wpa_supplicant/doc/docbook/wpa_background.8
32
dpkg-source: building wpasupplicant in wpasupplicant_0.6.2-1.dsc