On Fri, Sep 24, 2021 at 10:53 AM Junio C Hamano <gitster@xxxxxxxxx> wrote: > > > +'git send-email' [<options>] <file|directory>... > > +'git send-email' [<options>] <revision range> > > ... this is not improving Thiago's [3/3], I suspect. I think it does; after all, the original (which I know you proposed) did confuse Bagas who thought it might be missing the tagging of being optional. The other reasons why this might be better are : * because of the points and examples you provided, a vague [<options>] is better than something that might imply all options taken from format-patch make sense here, which IMHO might be difficult to understand as logical to you as an experienced user. * avoids "promoting" this mode, which is known to be problematic as it could lead to patch bombs without the proper review. it might even be worth adding mentions to --compose or --annotate to avoid that. Carlo
