path: root/Documentation/technical/api-parse-options.txt
diff options
authorRené Scharfe <>2011-09-28 17:44:30 (GMT)
committerJunio C Hamano <>2011-09-28 19:46:21 (GMT)
commit6acec0380bfcd5e3f91c9100bf4d415db8f7acfd (patch)
tree16f376495294910ce5ab5b52415a4e8a774d5936 /Documentation/technical/api-parse-options.txt
parentf858c646b5428519c4f847c5f15a9ead72a62b16 (diff)
parseopt: add OPT_NOOP_NOARG
Add OPT_NOOP_NOARG, a helper macro to define deprecated options in a standard way. The help text is taken from the no-op option -r of git revert. The callback could be made to emit a (conditional?) warning later. And we could also add OPT_NOOP (requiring an argument) etc. as needed. Signed-off-by: Rene Scharfe <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/technical/api-parse-options.txt')
1 files changed, 5 insertions, 0 deletions
diff --git a/Documentation/technical/api-parse-options.txt b/Documentation/technical/api-parse-options.txt
index acf1760..4b92514 100644
--- a/Documentation/technical/api-parse-options.txt
+++ b/Documentation/technical/api-parse-options.txt
@@ -204,6 +204,11 @@ There are some macros to easily define options:
"auto", set `int_var` to 1 if stdout is a tty or a pager,
0 otherwise.
+`OPT_NOOP_NOARG(short, long)`::
+ Introduce an option that has no effect and takes no arguments.
+ Use it to hide deprecated options that are still to be recognized
+ and ignored silently.
The last element of the array must be `OPT_END()`.