[virt-tools-list] [virt-manager][PATCH 3/3] Update man page author section.

Cole Robinson crobinso at redhat.com
Wed Jul 10 17:03:58 UTC 2013


Thanks, I pushed the first two. But see below.

On 07/10/2013 12:14 PM, Leonardo Garcia wrote:
> From: Leonardo Garcia <lagarcia at br.ibm.com>
> 
> ---
>  man/virt-manager.pod |    2 +-
>  1 files changed, 1 insertions(+), 1 deletions(-)
> 
> diff --git a/man/virt-manager.pod b/man/virt-manager.pod
> index f8e4d4b..a33955e 100644
> --- a/man/virt-manager.pod
> +++ b/man/virt-manager.pod
> @@ -85,7 +85,7 @@ Standard GTK options like --g-fatal-warnings are also accepted.
>  
>  =head1 AUTHOR
>  
> -Written by Daniel P. Berrange and Cole Robinson.
> +Written by Daniel P. Berrange, Cole Robinson, and Leonardo Garcia.
>  
>  =head1 BUGS
>  

I always took this to mean 'virt-manager authors' and not specifically 'man
page authors', but it appears there's examples of both in the wild. It's tough
to do lists like this without overlooking someone or creating maintenance
burden. My recommendation for this in order is:

1) Drop the AUTHORS section from every man page
2) Clarify the AUTHORS section from each man page to mean 'application
authors', drop all hardcoded names, and say 'see the git log' or provide a
link to cgit.
3) Clarify that this is 'man page authors' Be fair and do some git archaeology
to determine every person that has touched these files and list them all (I
actually won't take a patch for this, just listing it for completeness).

- Cole




More information about the virt-tools-list mailing list