[website] 01/01: Improve cowbuilder set up section

[Ross Gammon]

Hi Bas,

On 05/02/16 23:25, Sebastiaan Couwenberg wrote:
> Hi Ross,
>
> On 05-02-16 22:12, Ross Gammon wrote:
>>      Improve cowbuilder set up section
>>      
>>      Move the pbuilder hooks section up so that you don't create the chroot
>>      without it. Don't use ambiguous ~ for path to hooks. Add information
>>      about updating the chroot. Add a link to setting up multiple distributions.
> I'm not really happy with this change. The flow of the 'Creating the
> cowbuilder chroot' section doesn't make sense any more.
The previous flow did not make sense to me :-) But after the moves & 
changes I was cross-eyed from all the tags!

> Plus the ~ is still used in the example command making it must be the
> same as the preceding example setup of the lintian hook.
>
> Using `git-pbuilder` only for the update command also doesn't make
> sense. `cowbuilder --update ...` should be used to remain consistent
> with the create instructions. git-pbuilder is an alternative that should
> be documented as such. The DIST & ARCH env vars should not be included
> in the <command> element and their values should be enclosed in
> <replaceable> tags.
>
> I've pushed some changes to address the above. I've not pushed changes
> for the below.

Thanks. That, (and what you suggest below) is probably a better way to 
address what was confusing people previously.

>
> If you want to configure the hooks after creating a chroot, you need to
> set the option in ~/.pbuilderc or use the --update and --override-config
> options to change the chroot.
>
> The 'Other useful set up tips' section should be merged into the 'Tips &
> tricks' section, it doesn't belong in the cowbuilder setup section.
>
> The link to the pbuilder wiki needs to be removed or include a warning
> that it documents multiple distributions for pbuilder not cowbuilder as
> used by git-buildpackage.
>
> Kind Regards,
>
> Bas

Expect another tweak later today. I won't publish without a double-check.

That is if the Debian Med guys don't give me other work to do. :-) I 
have joined their sprint.

Cheers,

Ross