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

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



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

On 07/10/2013 12:14 PM, Leonardo Garcia wrote:
> From: Leonardo Garcia <lagarcia 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


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