Re: Marc Haber > if the Github templates are supposed to make things any easier, then > they lack docs. I understand that it is darn hard to track packages on > github since there are so many ways to do it right, but if that's not > possible, then the docs should not suggest that using v5 and the github > templates will solve all pains with versionmangle and ever-changing > links.
I've had similar problems. My main problem with the documentation is that general templates stuff (not just github) is distributed over debian-watch(5) and uscan-templates(5). In fact, the treatment of templates in debian-watch is *longer* than the whole uscan-templates documentation, so it looks like one doesn't have to read the latter at all. Yet, "Custom-Version" is only documented in uscan-templates. But debian-watch looks like a full specification of the version 5 syntax, so when Custom-Version isn't in there, it didn't occur to me at all that I should be looking at uscan-templates. The other way round, the default values of options are only documented in debian-watch, so when one wanted to change something, reading uscan-templates doesn't really help. The easiest fix might actually be to nuke uscan-templates(5) completely and move the few bits that it is adding to debian-watch(5). Christoph
