Bug#481129: Bug#671503: general: APT repository format is not documented
Excerpts from Julian Andres Klode's message of Fri May 18 18:49:10 +0200 2012:
> 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.
>
Yes, looks fairly complete.
The formatting is not consistent but that will have to be changed for
docbook anyway.
Also would need some proof-reading. If nothing else somebody should look
in a few weeks from now if it still makes sense ;-)
I put a link on the RepositoryHowto page for more exposure.
I am not so sure documenting Debian installer files is tremendously
useful. I don't think anyone outside Debian Installer team makes Debian
Installer repositories and there are other aspects of Debian Installer
that would need to be documented in order for it to be usable for
'outside' people in non-default configurations.
Thanks
Michal
Reply to: