Re: Notes about maint-guide...
On Wed, Feb 02, 2005 at 04:18:57PM +0100, Francesco P. Lovergine wrote:
> I'm referring to the original guide in english.
You mean current CVS HEAD.
> But for a few typos around, I read:
Thanks for proofreading:
missing articles
plural/singular
verb conjugation
...
Please commit any of these errors to CVS ASAP :-)
In addition I have few request:
Please make CVS commit to the content separate from typos.
Please mark typo correction as so in CVS log so translator have easier
time looking at the log in
http://cvs.debian.org/ddp/manuals.sgml/maint-guide/
> For clean room (chroot) build environment to verify the build
> dependencies, <package>pbuilder</package> package is very useful. This
> ensures clean build from source under the auto-builder for different
> architectures and avoid the severity serious FTBFS (Fails To Build From
> Source) bug WHICH IS ALWAYS IN THE RC (RELEASE CRITICAL) CATEGORY.
>
> Well, FTBS are serious only for supported architectures, that should be
> added. I'm not a native english speaker, anyway I could post a diff
> file with some changes to the guide...
(I am not even a native speaker of any Latin nor Germanic languages
which share good amount of grammer with English)
Yes, you are technically correct on FTBFS.
I kind of oversimplified situation because FTBFS situation caused by the
build dependancy issues are always RC. I think if it does not become
too complicated, making this more precise will be nice. Otherwise,
pointer to detailed explanation may be more appropriate for new
maintainer.
One of the driver for me to take initiative for updating to this shape
was that all NM should learn how to test package using pbuilder in early
stage of Debian experience.
I think official "Best Practice" and "Basic technical INfo" should stay
in the developer-reference and "Debian policy". maint-guide should be
tutorial with ample amounts of examples as current documentation.
In this respect, addition of followings are candidates if someone write
a short nice docs:
* packaging examples of using cdbs
* packaging examples of different autoconf/automake situations
Osamu
Reply to: