Ramkumar Ramachandra <artagnon@xxxxxxxxx> writes: > I agree that the "confusion" paragraph after [--] [<path>] can be > improved, but putting [--] in a paragraph of its own sounds like an > overkill. Apart from other things, it means that every single git > command would need an identical [--] paragraph for consistency. That is not a problem. We need to say what command line argument X (e.g. <path>, but not limited to it) does in all pages for commands that pay attention to X anyway. A more important reason to have them as separate entries is to avoid giving a wrong impression that "--" is somehow related to <path>, which is where the mistake in the synopsis "[[--] <path>...]" that started this thread comes from. -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html