Re: [PATCH 3/3] doc: give examples for send-email cc-cmd operation

[Eric Sunshine <sunshine@sunshineco.com>]

On Mon, Jul 20, 2015 at 3:14 PM, Eric Sunshine <sunshine@sunshineco.com> wrote:
> If you really want to give an example of how to use --cc-cmd
> (--to-cmd) with a plain text file holding email addresses, maybe
> something like this instead:
>
> Create an EXAMPLES section.
>
> Make the bare-bones, static address list script the first example:
>
>     #!/bin/sh
>     echo <<\EOF
>     person1@example.com
>     person2@example.com
>     EOF
>
> Then add an example showing how to take the fixed address list from a
> plain text file. Have the user create the following script (let's call
> it "anticat") which cat's all of its input arguments except the final
> one, which is the patch itself:
>
>     #!/bin/sh
>     while test $# -gt 1
>     do
>         cat $1
>         shift
>     done
>
> And, to use: --to-cccmd='anticat myaddresses.txt'

I forgot to add that even this is iffy as an example because it
depends upon the current implementation passing the cmd string to a
shell, which might not always be the case, and might not be reliably
implemented that way on some platforms (such as Windows).