[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: repository-howto etc.: action plan proposal

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.


On Sat, Dec 5, 2009 at 3:14 AM, Osamu Aoki <osamu@debian.org> wrote:
Hi Aaron and others:

I thank Aaron's contribution and propose followings:


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"


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:


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")


See message exchange between me and Karl on your document and

On Thu, Dec 03, 2009 at 09:08:54AM +1030, Karl Goetz wrote:
> On Wed, 2 Dec 2009 23:21:00 +0900
> Osamu Aoki <osamu@debian.org> 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

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:

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:

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:


"Debian Policy" and "Developers Reference" have been updated so they are
much easier to understand too.


Reply to: