tag 640737 + patch
thanks
Dear all,
to summarise:
* http://www.debian.org/doc/packaging-manuals/copyright-format// will
allow the copyright-format specification to become a multi-page HTML
document if
it gets significantly expanded, but on the other hand, somebody downloading
the
current one-page spec will get a file called ‘index.html’.
* Rebuilding the distributed document at each upload may cause it to change in
layout or in checksum, but on the other hand ensures that it is continuously
buildable.
My point of view is that the copyright-format specification is not likely to be
enlarged to the point of neeeding to separate its chapters in different files
(there is SPDX…) and that the source document uses only simple DocBook 4.5 tags
which makes it very unlikely to become unbuildable with the default XSL
stylesheet it uses. Moreover, I am biased by the culture in my profession to
not change even a single comma of a published work, so my personnal preference
would have been to distribute files like copyright-format-1.0.html, committed
with their source in the debian-policy Git repository. This said, this point of
view had no support from other participants in this discussion.
So I propose to do the following, in line with the other propositions.
a) Apply the attached patch to point at
http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ in the spec.
b) When the 1.0 version is finalised, (re)build at each upload
copyright-format/copyright-format.xml,
copyright-format/copyright-format-1.0.xml, and so on for the future
revisions.
c) Distribute the versionned and unversionned HTML and text builds in the
debian-policy binary package. (Assuming that if since nobody proposed to
stop
distributing the unversionned build, it is that people want it to stay).
I will propose a patch to implement the building and distribution of released
versions and current draft, but before doing so, I would like to know if it
would be acceptable to have them in /usr/share/doc/debian-policy, or if the
published versions should be in a separate directory.
Have a nice day,
--
Charles
>From f1458e166554bcb1928e7d74e54af5ea873d8dc4 Mon Sep 17 00:00:00 2001
From: Charles Plessy
Date: Wed, 5 Oct 2011 22:22:22 +0900
Subject: [PATCH] Use
http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
as URI.
---
copyright-format/copyright-format.xml |8
1 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/copyright-format/copyright-format.xml b/copyright-format/copyright-format.xml
index d6790aa..c4e47b3 100644
--- a/copyright-format/copyright-format.xml
+++ b/copyright-format/copyright-format.xml
@@ -185,7 +185,7 @@
Format
Required single line: URI of the format specification, such as:
- http://www.debian.org/doc/copyright-format/1.0
+ http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
@@ -278,7 +278,7 @@
Example header paragraph
-Format:
+Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/;
Upstream-Name: SOFTware
Upstream-Contact: John Doe
Source: http://www.example.com/software/project
@@ -1060,7 +1060,7 @@ also delete it here.
A possible debian/copyright file for the program
X Solitaire distributed in the Debian source package
xsol:
-