[libvirt] [PATCH] Fix several formatting mistakes in doc

[Eric Blake]

On 03/31/2011 08:13 AM, Eric Blake wrote:
>> This exposes several problems in the docs/Makefile.am
>>
>>  - make clean doesn't work in a VPATH build because
>>    for some reason the HTML is generated in the $srcdir
> 
> Intentional - docs are machine independent and therefore may be
> distributed, and by distributing them, others don't have to have the
> tools to rebuild them.  Distributed files should generally be built in
> srcdir
> 
>>    and so 'rm -f *.html' misses the files
> 
> So that's the real bug - the clean hook needs to be prefixed with $(srcdir).

Actually, 'make clean' must _not_ remove generated files.  Otherwise,
there's no point in shipping them pre-generated - the first 'make clean'
would nuke them and the user without the tools to regenerate them would
be stuck.  Rather, 'make maintainer-clean' should be taught how to
remove them, since the maintainer is expected to have the necessary
extra prerequisite tools.

-- 
Eric Blake   eblake at redhat.com    +1-801-349-2682
Libvirt virtualization library http://libvirt.org

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 619 bytes
Desc: OpenPGP digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20110331/a8b9e201/attachment-0001.sig>