annotate lib/long-options.c @ 19190:9759915b2aca

all: prefer https: URLs
author Paul Eggert <eggert@cs.ucla.edu>
date Wed, 13 Sep 2017 00:48:18 -0700
parents 12df2165ec1c
children 10eb9086bea0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
1 /* Utility to accept --help and --version options as unobtrusively as possible.
4659
1b52171ed2f7 Remove K&R cruft.
Paul Eggert <eggert@cs.ucla.edu>
parents: 3966
diff changeset
2
18626
12df2165ec1c version-etc: new year
Paul Eggert <eggert@cs.ucla.edu>
parents: 18442
diff changeset
3 Copyright (C) 1993-1994, 1998-2000, 2002-2006, 2009-2017 Free Software
12518
b5e42ef33b49 update nearly all FSF copyright year lists to include 2009
Jim Meyering <meyering@redhat.com>
parents: 12421
diff changeset
4 Foundation, Inc.
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
5
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7302
diff changeset
6 This program is free software: you can redistribute it and/or modify
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
7 it under the terms of the GNU General Public License as published by
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7302
diff changeset
8 the Free Software Foundation; either version 3 of the License, or
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7302
diff changeset
9 (at your option) any later version.
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
10
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
11 This program is distributed in the hope that it will be useful,
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
14 GNU General Public License for more details.
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
15
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
16 You should have received a copy of the GNU General Public License
19190
9759915b2aca all: prefer https: URLs
Paul Eggert <eggert@cs.ucla.edu>
parents: 18626
diff changeset
17 along with this program. If not, see <https://www.gnu.org/licenses/>. */
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
18
649
89f4c1937ac7 update FSF address in copyright and remove any trailing blanks
Jim Meyering <jim@meyering.net>
parents: 446
diff changeset
19 /* Written by Jim Meyering. */
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
20
7302
8a1a9361108c * _fpending.c: Include <config.h> unconditionally, since we no
Paul Eggert <eggert@cs.ucla.edu>
parents: 6259
diff changeset
21 #include <config.h>
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
22
4771
ffc6ac581833 Merge version-etc-2 back into version-etc: Better way to internationalize
Bruno Haible <bruno@clisp.org>
parents: 4659
diff changeset
23 /* Specification. */
4659
1b52171ed2f7 Remove K&R cruft.
Paul Eggert <eggert@cs.ucla.edu>
parents: 3966
diff changeset
24 #include "long-options.h"
1b52171ed2f7 Remove K&R cruft.
Paul Eggert <eggert@cs.ucla.edu>
parents: 3966
diff changeset
25
4771
ffc6ac581833 Merge version-etc-2 back into version-etc: Better way to internationalize
Bruno Haible <bruno@clisp.org>
parents: 4659
diff changeset
26 #include <stdarg.h>
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
27 #include <stdio.h>
4771
ffc6ac581833 Merge version-etc-2 back into version-etc: Better way to internationalize
Bruno Haible <bruno@clisp.org>
parents: 4659
diff changeset
28 #include <stdlib.h>
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
29 #include <getopt.h>
2669
3668079f961d Include <stdlib.h>, for declaration of exit.
Jim Meyering <jim@meyering.net>
parents: 2507
diff changeset
30
1755
f486d0e61ad0 (parse_long_options): Remove version-, copyright-,
Jim Meyering <jim@meyering.net>
parents: 1727
diff changeset
31 #include "version-etc.h"
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
32
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
33 static struct option const long_options[] =
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
34 {
5813
6962b5c5069f Merge from coreutils.
Paul Eggert <eggert@cs.ucla.edu>
parents: 4934
diff changeset
35 {"help", no_argument, NULL, 'h'},
6962b5c5069f Merge from coreutils.
Paul Eggert <eggert@cs.ucla.edu>
parents: 4934
diff changeset
36 {"version", no_argument, NULL, 'v'},
6962b5c5069f Merge from coreutils.
Paul Eggert <eggert@cs.ucla.edu>
parents: 4934
diff changeset
37 {NULL, 0, NULL, 0}
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
38 };
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
39
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
40 /* Process long options --help and --version, but only if argc == 2.
16235
18a38c9615f0 In commentary, do not use ` to quote.
Paul Eggert <eggert@cs.ucla.edu>
parents: 16201
diff changeset
41 Be careful not to gobble up "--". */
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
42
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
43 void
1719
3a52df5cf257 (_): Define it.
Jim Meyering <jim@meyering.net>
parents: 1643
diff changeset
44 parse_long_options (int argc,
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
45 char **argv,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
46 const char *command_name,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
47 const char *package,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
48 const char *version,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
49 void (*usage_func) (int),
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
50 /* const char *author1, ...*/ ...)
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
51 {
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
52 int c;
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
53 int saved_opterr;
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
54
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
55 saved_opterr = opterr;
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
56
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
57 /* Don't print an error message for unrecognized options. */
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
58 opterr = 0;
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
59
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
60 if (argc == 2
880
3bee11a1c21d (parse_long_options): Compare getopt_long return
Jim Meyering <jim@meyering.net>
parents: 869
diff changeset
61 && (c = getopt_long (argc, argv, "+", long_options, NULL)) != -1)
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
62 {
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
63 switch (c)
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
64 {
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
65 case 'h':
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
66 (*usage_func) (EXIT_SUCCESS);
18442
5a47f1f1de9b long-options: avoid new GCC 7 warning from -Wimplicit-fallthrough
Jim Meyering <meyering@fb.com>
parents: 18189
diff changeset
67 break;
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
68
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
69 case 'v':
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
70 {
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
71 va_list authors;
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
72 va_start (authors, usage_func);
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
73 version_etc_va (stdout, command_name, package, version, authors);
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
74 exit (0);
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
75 }
446
8461c3b8595a Remove trailing white space.
Jim Meyering <jim@meyering.net>
parents: 317
diff changeset
76
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
77 default:
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
78 /* Don't process any other long-named options. */
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
79 break;
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
80 }
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
81 }
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
82
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
83 /* Restore previous value. */
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
84 opterr = saved_opterr;
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
85
869
ca8a87089389 (parse_long_options): Reset optind to zero
Jim Meyering <jim@meyering.net>
parents: 706
diff changeset
86 /* Reset this to zero so that getopt internals get initialized from
ca8a87089389 (parse_long_options): Reset optind to zero
Jim Meyering <jim@meyering.net>
parents: 706
diff changeset
87 the probably-new parameters when/if getopt is called later. */
ca8a87089389 (parse_long_options): Reset optind to zero
Jim Meyering <jim@meyering.net>
parents: 706
diff changeset
88 optind = 0;
317
b4df8eb979b6 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
89 }