Re: Bug#481129: Bug#671503: general: APT repository format is not documented

[Goswin von Brederlow <goswin-v-b@web.de>]

Julian Andres Klode <jak@debian.org> writes:

> On Fri, May 18, 2012 at 04:06:23PM +0200, Michal Suchanek wrote:
>> FWIW
>> 
>> posted on the wiki: http://wiki.debian.org/RepositoryFormat
>> 
>> Thanks
>> 
>> Michal
>
> I have now documented the Contents indices and the diffs
> as well, mostly (sans the exact format we use for the
> patches), and Translation indices. Now we're basically
> only missing details, it is fairly complete otherwise
> (i.e. we should have mentioned every file and field
> currently in use, but may not have explained all of
> them completely).
>
> We now have documented
>
> 	dists/$DIST/Release (and InRelease, Release.gpg)
> 	dists/$DIST/$COMP/binary-$ARCH/Packages
> 	dists/$DIST/$COMP/source/Sources
> 	dists/$DIST/$COMP/Contents-$ARCH.gz
> 	dists/$DIST/$COMP/i18n/{Index,Translation-*.bz2}
> 	*.diff/Index *.diff/%Y-%m-%d-%H%M.%S.gz
>
> The other Release files have been omitted, as they are not
> used anywhere. We are only missing udeb content files and
> packages files now, which are just small subsentences.
>
> In a few months, I'd like to rework this in DocBook form,
> and submit it to debian-policy for inclusion into official
> Policy, as a sub-policy like copyright-format.

This describes repositories of the form

deb uri suite component [...]


There should be a mention of flat repositories of the form

deb url path/

This changes nothing for the contents of files but it does change their
location and I think it's worth mentioning how that sources.list entry
maps to a repository.

MfG
        Goswin