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

[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: