[copyright-format] Format URL and installation on www.debian.org (Re: Bug#640737: [copyright-format] misc. changes from driver.)
Le Mon, Sep 26, 2011 at 02:07:52PM -0700, Russ Allbery a écrit :
> David Prévot <taffit@debian.org> writes:
>
> > I don't now what is the supposed name of the DEP5 document inside the
> > debian-policy package, but it would be highly appreciated if the “1.0”
> > part could be easily parsable from the document name, at worse from the
> > document itself (in a reliable way).
>
> We should be able to do that.
>
> > Another side issue: in a few years, after some updates of the
> > copyright-format policy (e.g. version 4.2), it will be a bit painful to
> > rebuild the website from scratch, since one will have to dig up old
> > debian-policy packages in order to retrieve all copyright-format
> > versions…
>
> I'm moderately tempted to just keep all the old versions in the
> debian-policy package to solve that problem. It would mean that any build
> system issues would have to be done across all the old versions of the
> document we have available, but it seems worth it to have stable URLs.
Dear all,
Here is one simple solution:
- In the debian-policy package, copyright-format/copyright-format.xml is the
working document, which contains a disclaimer and a reference to the stable
version on www.debian.org.
- Published versions are stored in the debian-policy in copyright-format/published/,
as XML source and HTML and text documents, without makefile as they are final
versions, under names like copyright-format/published/copyright-format-1.0.html.
- The ‘7doc’ cron job on www.debian.org installs a hard-coded list of copyright-format
versions, on URIs like ‘http://www.debian.org/doc/packaging-manuals/copyright-format-1.0.html’;
Depending how often the spec is updated (hopefully not often), the file listing
in http://www.debian.org/doc/packaging-manuals/ will grow, but if it really becomes a
problem, the directory could get a proper WML index.
- Thanks to content negociation on www.debian.org, the current URI for the
spec would be http://www.debian.org/doc/packaging-manuals/copyright-format-1.0
Just let me know if you would like patches.
Have a nice day,
--
Charles Plessy
Tsurumi, Kanagawa, Japan
Reply to: