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

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

 



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

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

_______________________________________________
virt-tools-list mailing list
virt-tools-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/virt-tools-list




[Index of Archives]     [Linux Virtualization]     [KVM Development]     [CentOS Virtualization]     [Netdev]     [Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]     [Video 4 Linux]

  Powered by Linux