[libvirt] [PATCHv2 01/16] command: move all docs into .c file
Daniel P. Berrange
berrange at redhat.com
Thu Jul 21 11:18:49 UTC 2011
On Tue, Jul 19, 2011 at 10:20:24PM -0600, Eric Blake wrote:
> We already have a precedent of function documentation in C files,
> where it is closer to the implementation (witness libvirt.h vs.
> libvirt.c); maintaining docs in both files risks docs going stale.
>
> While I was at it, I used consistent doxygen style on all comments.
>
> * src/util/command.h: Remove duplicate docs, and move unique
> documentation...
> * src/util/command.c: ...here.
> Suggested by Matthias Bolte.
> ---
>
> prereq patch to 2/16 (not directly related to bypass-cache, but I
> don't want to rebase across this one)
>
> v2: no change from v1, previously posted here:
> https://www.redhat.com/archives/libvir-list/2011-July/msg00879.html
>
> src/util/command.c | 371 ++++++++++++++++++++++++++++++++++++++++------------
> src/util/command.h | 223 ++------------------------------
> 2 files changed, 299 insertions(+), 295 deletions(-)
ACK, trivial NFC
Daniel
--
|: http://berrange.com -o- http://www.flickr.com/photos/dberrange/ :|
|: http://libvirt.org -o- http://virt-manager.org :|
|: http://autobuild.org -o- http://search.cpan.org/~danberr/ :|
|: http://entangle-photo.org -o- http://live.gnome.org/gtk-vnc :|
More information about the libvir-list
mailing list