Re: [PATCH 1 of 1] docs/overview.txt: Provide short mercurial HOWTO

["Yann E. MORIN" <yann dot morin dot 1998 at anciens dot enib dot fr>]

Titus, All,

On Saturday 22 May 2010 00:55:27 Titus von Boxberg wrote:
> I understood from my experiments (shortly after I
> accidentally hg-email-bombed sourceware.org with a multimegabyte patch by
> a too eager attempt of resending the readlink vs. test -L patch ;-)
> that the whole hg email command and the numbers it gives in the subject do not have anything to
> do with the mq managed patch series.
> Your calculation of 'x' above is only true by coincidence if you start with
> an empty patch queue in a nonmodified repo clone and then after patching use --outgoing.
> 
> E.g. the referenced email was sent using the -r command line argument. I have now
> 10 patches in my mq queue, 9 with the mac os stuff,
> and this HOWTO is the 10th patch, series index 9.
> However, this email was sent with the subject "1 of 1" you can see above.

Totaly aggreed, but for the sake of simplicity, let's not make this HOWTO a
complete rewrite of the Hg manual. Once the user grasps the basics, he/she
will be able to do trickier stuff.

And people are now used to the kernel-style of mail-patches, with the
now traditional 0/N .. N/N terminology. Hopefully they are! ;-)

Let's keep it that way because this is exactly what the end user will see
the first time he/she sends a patch series, with --outgoing. Except that
in my proposed rewrite, --outgoing is no longer explained:

---8<---
The flag --outgoing selects all patches fromn the series that are currently
applied. If you want to send all the series, then run 'hg qpush -a'.
---8<---

Regards,
Yann E. MORIN.

-- 
.-----------------.--------------------.------------------.--------------------.
|  Yann E. MORIN  | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +33 662 376 056 | Software  Designer | \ / CAMPAIGN     |  ___               |
| +33 223 225 172 `------------.-------:  X  AGAINST      |  \e/  There is no  |
| http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL    |   v   conspiracy.  |
'------------------------------^-------^------------------^--------------------'



--
For unsubscribe information see http://sourceware.org/lists.html#faq