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

[Sebastiaan Couwenberg]

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.

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.

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

-- 
 GPG Key ID: 4096R/6750F10AE88D4AF1
Fingerprint: 8182 DE41 7056 408D 6146  50D1 6750 F10A E88D 4AF1