Add remarks to dpkg-scansources and dpkg-scanpackages

man pages about the need to compress the generated files
to be able to access them via apt. Closes: #65839

debian/changelog

@@ -1,5 +1,10 @@
 dpkg (1.13.20~) UNRELEASED; urgency=low
 
+  [ Frank Lichtenheld ]
+  * Add remarks to dpkg-scansources and dpkg-scanpackages
+    man pages about the need to compress the generated files
+    to be able to access them via apt. Closes: #65839
+
   [ Updated dpkg Translations ]
   * Portuguese (Miguel Figueiredo).
   * Polish (Robert Luberda).

man/C/dpkg-scanpackages.1

@@ -13,7 +13,7 @@
 .\" You should have received a copy of the GNU General Public
 .\" License along with dpkg; if not, write to the Free Software
 .\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
-.TH dpkg\-scanpackages 1 "2006-02-28" "Debian Project" "dpkg utilities"
+.TH dpkg\-scanpackages 1 "2006-05-10" "Debian Project" "dpkg utilities"
 .SH NAME
 dpkg\-scanpackages - create Packages files
 .
@@ -32,6 +32,7 @@ dpkg\-scanpackages - create Packages files
 .B dpkg\-scanpackages
 sorts through a tree of Debian binary packages and creates a Packages
 file, used by
+.BR apt (8),
 .BR dselect (1),
 etc, to tell the user what packages are available for installation. These
 Packages files are the same as those found on Debian archive sites
@@ -40,6 +41,16 @@ and CD-ROMs. You might use
 yourself if making a directory of local packages to install on a cluster
 of machines.
 .PP
+.B Note:
+If you want to access the generated Packages file with
+.B apt
+you will probably need to compress the file with
+.BR gzip (1)
+(generating a Packages.gz file). apt ignores uncompressed Packages
+files except on local access (i.e.
+.B file://
+sources).
+.PP
 .I binarydir
 is the name of the binary tree to process (for example,
 .BR contrib/binary\-i386 ).

man/C/dpkg-scansources.1

@@ -1,4 +1,4 @@
-.TH dpkg\-scansources 1 "2006-02-28" "Debian Project" "dpkg utilities"
+.TH dpkg\-scansources 1 "2006-05-10" "Debian Project" "dpkg utilities"
 .SH "NAME"
 dpkg\-scansources \- search for '.dsc' files and build the 'Sources' index
 .
@@ -29,6 +29,16 @@ The \fIpath-prefix\fR, if given, is prepended to the directory field in the
 generated source index. You generally use this to make the directory
 fields contain the path from the top of the Debian archive hierarchy.
 .
+.PP
+.B Note:
+If you want to access the generated Sources file with
+.B apt
+you will probably need to compress the file with
+.BR gzip (1)
+(generating a Source.gz file). apt ignores uncompressed Sources files
+except on local access (i.e.
+.B file://
+sources).
 .SH "OPTIONS"
 .IP "\fB\-\-debug\fR" 4
 Turn debugging on.

man/ChangeLog

@@ -1,3 +1,10 @@
+2006-05-10  Frank Lichtenheld  <djpig@debian.org>
+
+	* C/dpkg-scanpackages.1: Add remark that apt ignores
+	uncompressed Packages files on non-local access.
+	* C/dpkg-scansources.1: Likewise (with Sources instead of
+	Packages files of course).
+
 2006-05-10  Stepan Golosunov  <stepan@golosunov.pp.ru>
 
 	* ru/dpkg.1.ru.po: Typo fix ("|<" -> "I<").