Bug#72949: PROPOSED] 00/10/02 Policy aspects of the packaging manual
Hi,
>>"Julian" == Julian Gilbey <J.D.Gilbey@qmw.ac.uk> writes:
Julian> [Hi! I'm sort of beginning to get my head out from under the water
Julian> again, although I will be around rather sporadically for the next few
Julian> weeks still.]
Well, I seem to be the one swamped under now (I have a new
job, and I had to learn a new language, real time corba, and
architect a solution for a small project in under two weeks time)
Julian> Next, the copyright statement on lines 8--12 is inconsistent with
Julian> that which appears later on.
I was hurried when I made that up; we need to look at the
copyright on the packaging manual (the old one) and use ot when we
merge the documents together.
Julian> The paragraph beginning on line 156 (New versions of this document)
Julian> will need to be corrected to point to the correct location of this
Julian> document wherever it ends up.
Moot if this is going to be merged into policy document.
Julian> The paragraph beginning at line 273, referring to package names:
Julian> They must be at least two characters long and must start
Julian> with an alphanumeric character. The use lowercase package
Julian> names is strongly recommended unless the package you're
Julian> building (or referring to, in other fields) is already
Julian> using uppercase.</p>
Julian> I thought we lowercase the name whatever? In potato, there is not a
Julian> single package with any uppercase characters in the name.
Umm, no. I went through hell trying to move from CGI-modules
to cgi-modules; I agree that this is now moot. However, I do not want
to really _change_ current doctrine beyond adding the may/must/should
conformance.
Julian> Paragraph beginning line 303, describing Standards-Version:
Julian> Its format is the same as that of a version number except
Julian> that no epoch or Debian revision is allowed - see <ref
Julian> id="versions">.</p>
Julian> This isn't really correct; it has a much more restricted format, as
Julian> described in the Policy manual. (majorX.majorY.minorX[.minorY], all
Julian> of which are numbers.)
The policy version should be the final one, yes.
Julian> Should the "unusual circumstances" described in the footnote there
Julian> (line 398) be elucidated? I don't remember off-hand where
Julian> descriptions of bug fixes for stable and frozen are found, but it
Julian> would make sense to refer to that doc.
Lets make a note to ourselves to do that, but since this is
not really policy, I'd not hold up tings for that
Julian> Line 704: don't we encourage touching build-stamp rather than build
Julian> nowadays, with "build: build-stamp" and "build-stamp:" doing the work?
Julian> (See, eg, debhelper examples.)
I don't have debhelper on my machines, but I'll try and see if
I can install it. I am not sure we should be taking much of a stance
here; we should just provide a non-binding example.
mment" in a changelog terminating line?)
Julian> The section beginning line 972 on defining an alternative changelog
Julian> format is incomplete: it does not say how to do it or what is required
Julian> of a format. Somewhere this should be specified, perhaps in an
Julian> appendix to the policy document. I could probably write it, as long
Julian> as someone like Wichert or one of the other dpkg developers is
Julian> prepared to check it.
Actually, that should be removed from policy, and moved to
dpkg documentation.
manoj
--
The Least Successful Police Dogs America has a very strong candidate
in "La Dur", a fearsome looking schnauzer hound, who was retired from
the Orlando police force in Florida in 1978. He consistently refused
to do anything which might ruffle or offend the criminal classes. His
handling officer, Rick Grim, had to admit: "He just won't go up and
bite them. I got sick and tired of doing that dog's work for him."
The British contenders in this category, however, took things a stage
further. "Laddie" and "Boy" were trained as detector dogs for drug
raids. Their employment was terminated following a raid in the
Midlands in 1967. While the investigating officer questioned two
suspects, they patted and stroked the dogs who eventually fell asleep
in front of the fire. When the officer moved to arrest the suspects,
one dog growled at him while the other leapt up and bit his
thigh. Stephen Pile, "The Book of Heroic Failures"
Manoj Srivastava <srivasta@debian.org> <http://www.debian.org/%7Esrivasta/>
1024R/C7261095 print CB D9 F4 12 68 07 E4 05 CC 2D 27 12 1D F5 E8 6E
1024D/BF24424C print 4966 F272 D093 B493 410B 924B 21BA DABB BF24 424C
Reply to: