Re: [PATCHv3] docs: Improve patch submission guidelines

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

 



On 07/12/2012 03:44 AM, Michal Privoznik wrote:
> We should really advise (new) developers to send rebased patches
> that apply cleanly and use git-send-email rather than all other
> obscure ways.
> ---
> diff to v2:
> -Eric's suggestions worked in
> 
>  HACKING              |   37 ++++++++++++++++++++++++++++++++++++-
>  docs/hacking.html.in |   49 ++++++++++++++++++++++++++++++++++++++++++++-----
>  2 files changed, 80 insertions(+), 6 deletions(-)

ACK with one spelling nit fixed.

> +++ b/docs/hacking.html.in
> @@ -11,19 +11,58 @@
>  
>        <li><p>Post patches in unified diff format.  A command similar to this
>          should work:</p>
> -<pre>
> +<del><pre>

I'm not familiar with the <del> tag, but assume it made a useful
difference.  At any rate, the toolchain didn't choke on it.

> +  git send-email --cover-letter --no-chain-reply-to --annotate --to=libvir-list@xxxxxxxxxx master
> +</pre>
> +        <p>For a single patch you can omit <code>--cover-letter</code>, but
> +        series of a two or more patches needs a cover letter. If you get tired
> +        of typing <code>--to=libvir-list@xxxxxxxxxx</code> designation you can
> +        set it in git config:</p>
> +<pre>
> +  git config sendemail.to libvir-list@xxxxxxxxxx

Maybe also mention that you can set aliases to cut down on typing:

git config alias.mysend \
  'send-email --cover-letter --no-chain-reply-to --annotate'

(untested, though, so I'm okay if you save it for a separate patch after
actually testing it).

> +</pre>
> +        <p>Please follow this as close as you can, especially the rebase and
> +        git send-email part, as it makes life easier for other developers to
> +        review your patch set. One should avoid sending patches as attachments,
> +        but rather send them in email body among with commit message. If a

s/among/along/

-- 
Eric Blake   eblake@xxxxxxxxxx    +1-919-301-3266
Libvirt virtualization library http://libvirt.org



Attachment: signature.asc
Description: OpenPGP digital signature

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list

[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]