Re: Bug#481129: Bug#671503: general: APT repository format is not documented
Julian Andres Klode <firstname.lastname@example.org> writes:
> On Fri, May 18, 2012 at 04:06:23PM +0200, Michal Suchanek wrote:
>> posted on the wiki: http://wiki.debian.org/RepositoryFormat
> 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)
> *.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.