Re: DEP-5 format definition hell
On Sun, May 29, 2011 at 01:57:29PM +0200, Sven Hoexter wrote: Hi, I currently see a wild mix of different format definitions used by people hitting debian-mentors. While I personally don't care as long as the copyright file is complete I don't think this fulfills the goal of this DEP. It would be nice if the involved people would clarify what should be used. So far I've seen the following referenced: a) SVN revisions of the mdwn file (seems to be ok) IMHO this is the preferred (and the only correct) format - there was a revision of DEP-5 itself that changed the examples to use that after some discussion. However, as pointed out in a follow-up, the URL itself might need to be changed after the Alioth migration... and time will show what it needs to be changed *to* :) b) http://dep.debian.net/deps/dep5/ (seems to be not that wrong but exactly this current document claims that a revision of the mdwn file should be used) Hm, does it really? Yes, it used to - but I think it doesn't right now. (see the description of the Format header) c) a wiki page (rejected that one, seems wrong to me) This used to be correct during the initial discussion of the idea of machine-readable copyright files; it became incorrect the moment DEP 5 was created as such :) d) broken links (obviously rejected) True, that :) G'luck, Peter -- Peter Pentchev r...@ringlet.net r...@freebsd.org pe...@packetscale.com PGP key:http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 What would this sentence be like if it weren't self-referential? signature.asc Description: Digital signature
Re: DEP-5 format definition hell
On Sun, May 29, 2011 at 01:57:29PM +0200, Sven Hoexter wrote: I currently see a wild mix of different format definitions used by people hitting debian-mentors. While I personally don't care as long as the copyright file is complete I don't think this fulfills the goal of this DEP. This is because DEP5 is not finalized yet. When its inclusion into the debian-policy package is final, the official copy of the spec will be at a URL that will be like this: http://www.debian.org/doc/debian-policy/copyright-format/1.0 When this is ready, there will be an announcement on debian-devel-announce and every other Format: URL will need to be amended. Until then, use whatever you feel best like. The spec suggests something like this: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=filerev=REVISION which seems like a reasonable thing to do, since it documents what version of the spec the file is written against. -- Freedom-based blog/wiki/web hosting: http://www.branchable.com/ -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: http://lists.debian.org/20110529155332.ga18...@havelock.liw.fi
Re: DEP-5 format definition hell
On 05/29/2011 11:53 PM, Lars Wirzenius wrote: On Sun, May 29, 2011 at 01:57:29PM +0200, Sven Hoexter wrote: I currently see a wild mix of different format definitions used by people hitting debian-mentors. While I personally don't care as long as the copyright file is complete I don't think this fulfills the goal of this DEP. This is because DEP5 is not finalized yet. When its inclusion into the debian-policy package is final, the official copy of the spec will be at a URL that will be like this: http://www.debian.org/doc/debian-policy/copyright-format/1.0 When this is ready, there will be an announcement on debian-devel-announce and every other Format: URL will need to be amended. Until then, use whatever you feel best like. The spec suggests something like this: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=filerev=REVISION which seems like a reasonable thing to do, since it documents what version of the spec the file is written against. I think it'd be great if what you wrote above was also at: http://dep.debian.net/deps/dep5/ Cheers, Thomas P.S: What's blocking DEP5 from reaching the policy? I think it's great the way it is right now already... -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: http://lists.debian.org/4de27cbe.8030...@debian.org
Re: DEP-5 format definition hell
Thomas Goirand z...@debian.org writes: P.S: What's blocking DEP5 from reaching the policy? I think it's great the way it is right now already... It's already in the Policy package and was aging there for one release to be sure we didn't mess anything up when rewriting it to DocBook. Please review the version currently included in the debian-policy package and report any issues. The intention is to make it official with the next Policy release (where official of course doesn't mean that people are required to use it). -- Russ Allbery (r...@debian.org) http://www.eyrie.org/~eagle/ -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: http://lists.debian.org/87k4d91j9u@windlord.stanford.edu