Hi everyone I currently have no time to update the documents. Also, I haven't done any Debian-specific development in a while, so I'd probably be the wrong person to update them anyway.
I fully agree with all of your proposals. Please feel free to redirect/edit/remove/mark the documents as obsolete as you see fit. Thank you for your work. Greetings, Aaron On Sat, Dec 5, 2009 at 3:14 AM, Osamu Aoki <[email protected]> wrote: > Hi Aaron and others: > > I thank Aaron's contribution and propose followings: > > Proposal: > > 1. "Debian Repository HOWTO" > > Unless someone strongly objects, I propose "Debian Repository HOWTO" to > be marked obsolete in its text clearly and move its lead-in index at > http://www.debian.org/doc/devel-manuals to > http://www.debian.org/doc/ddp#other to reflect current status. > > (I am not suggesting to remove these as web pages.) > > 2. "Distributing Debs" > > > http://www.debian.org/doc/manuals/distribute-deb/distribute-deb.html#package-repository > > Also I propose to update "Creating a Package Repository" in his "How > Software Producers Can Distribute Their Products Directly in DEB Format" > to point to: > > http://wiki.debian.org/HowToSetupADebianRepository > > 3. "Distributing Debs" > > I see other contents are getting somewhat outdated. If someone wish to > update this to newer situation 7 years after original situation, we > welcome such contribution. Please file proposed patch etc. :-) > > This is nice entry tutorial documentation candidate which cover contents > outside of maint-guide("Debian New Maintainers' Guide") > > Rationale: > > See message exchange between me and Karl on your document and > apt-ftparchive. > > On Thu, Dec 03, 2009 at 09:08:54AM +1030, Karl Goetz wrote: > > On Wed, 2 Dec 2009 23:21:00 +0900 > > Osamu Aoki <[email protected]> wrote: > ... > > > It is used to generate packages/sources/contents lists only. > > > It does not /move/. > > > > Which brings us back to the first point. [1] states > > "apt-ftparchive is used to move a collection of Debian package > > files ...". > > But it _does_ _not_ move anything! It generates files. it doesn't > > _move_ them. > > [1] > > > http://www.debian.org/doc/manuals/repository-howto/repository-howto.en.html#pools > > Now I see Karl's point. This may be what happens with an outdated > document. > Debian is moving target. > > I agree that this is incorrect at least for archive after we introduced > pool > system. (This may have been correct long time before when we did not have > pool > and moved package to release name based repository. I do not > remember...) > > Current man page of apt-ftparchive states: > > apt-ftparchive - Utility to generate index files > ... > apt-ftparchive is the command line tool that generates the index > files > that APT uses to access a distribution source. The index files should > be generated on the origin site based on the content of that site. > > There are no /move/ mentioned :-) > > I just put small notice at problematic location only now. But this > document is quite prominent at: > http://www.debian.org/doc/devel-manuals > > As I read Aaron's document, this is pre-secureAPT and linked to > obsoleted apt-howto. This was never release as package. Unless Aaron > updates this to be current, I think we need to move this to obsoleted > documentation and mark these so to prevent people mislead. > > I also recall Aaron recommended repropro due to limitation Aaron felt > with apt-ftparchive. (I can not find URL now but it was somewhere like: > http://www.isotton.com ) > > Actual APT archive information is summarized at: > http://wiki.debian.org/HowToSetupADebianRepository > > I think apt-ftparchive is useful and I have created APT package system > documentation in line with the recent secureAPT etc. in Debian Reference > for normal users too: > > http://www.debian.org/doc/manuals/debian-reference/ch02.en.html > > http://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_debian_package_management_internals > > http://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_small_public_package_archive > > "Debian Policy" and "Developers Reference" have been updated so they are > much easier to understand too. > > Osamu > >
