[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Qemu-block] [PATCH v2 03/22] maint: Allow for EXAMPLES in texi2pod

From: Eric Blake
Subject: Re: [Qemu-block] [PATCH v2 03/22] maint: Allow for EXAMPLES in texi2pod
Date: Fri, 4 Jan 2019 17:45:51 -0600
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.3.1

On 12/18/18 7:46 AM, Vladimir Sementsov-Ogievskiy wrote:
> 15.12.2018 16:53, Eric Blake wrote:
>> The next commit will add an EXAMPLES section to qemu-nbd.8;
>> for that to work, we need to recognize EXAMPLES in texi2pod,
>> and we need to make all man pages be regenerated since the
>> output of texi2pod can be different.
>> Signed-off-by: Eric Blake <address@hidden>

>> +qemu.1: qemu-doc.texi qemu-options.texi qemu-monitor.texi \
>> +    qemu-monitor-info.texi scripts/texi2pod.pl
>> +qemu.1: qemu-option-trace.texi scripts/texi2pod.pl
> I think, no needs to add scripts/texi2pod.pl to both qemu.1: lines, as they 
> should be
> merged anyway. And if you want to add line breaking anyway, it looks better 
> to use one qemu.1:
> dependency line.

Easy to fix.

> On the other hand, it may be better to add MANS variable as subset of DOCS to 
> combine all man page targets,
> and than do like $(MANS): scripts/texi2pod.pl.. (and recombine DOCS, using 
> MANS ofcourse)
> Hm, and I don't see here docs/interop/qemu-ga-ref.7 and 
> docs/interop/qemu-qmp-ref.7,
> which exist in DOCS.

Oh, good point. The .txt files should also have the dependency - in
general, ALL generated documentation should depend on the generator, not
just the man pages.  I'll have to think about respinning this patch.

Eric Blake, Principal Software Engineer
Red Hat, Inc.           +1-919-301-3226
Virtualization:  qemu.org | libvirt.org

Attachment: signature.asc
Description: OpenPGP digital signature

reply via email to

[Prev in Thread] Current Thread [Next in Thread]