This file is indexed.

/usr/share/doc/gengetopt/README.Debian is in gengetopt 2.22.6+dfsg0-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
gengetopt for Debian
----------------------

Here is a feature comparison of six command line parser generators.

package			clig	genparse gaa	autogen	gengetopt wyg
			[1]	[2]	[3]	[4]	[5]	[6]
runs per project [7]	many	many	many	many	once	many	
input			file	file	file	file	file	file
C language app		yes	yes	yes	yes	yes	yes
shell script app	no	no	no	yes	no	no
package result		parser	parser	parser	parser	main.c	parser

config file input	no	no	yes	yes	no	yes
environment input	no	no	no	yes	no	no
config file output	no	no	no	yes	no	no
command line		yes	yes	yes	yes	yes	yes

short options		[8]	yes	yes	yes	yes	yes
combined short options	no	yes	yes	yes	yes	yes
long options		[8]	yes	yes	yes	yes	yes
parameter types		4	5	5	any	11	4
callback functions	no	yes	yes	yes	yes	no
multiple parameters	yes	no	no	yes	no	no
optional parameters	yes	no	no	yes	no	no
default values		yes	yes	yes	yes	no	yes
range checks		yes	yes	no	no	no	no
option data		struct	struct	struct	struct	variables struct

usage()			yes	yes	yes	yes	yes	yes
man page		yes	no	no	no	no	no
makefile		no	no	no	no	no	no

developer dependencies	tcl	none	none	none	none	bison,flex
user dependencies	none	none	none	[9]	none	none

 [1] clig is the only tool that generates a skeleton man page.  It
also updates a previously generated man page.
 [2,3] genparse and gaa have very similar capabilities.  genparse
supports range checks, and gaa supports option input from a
configuration file as well as the command line.  NOTE HOWEVER: gaa is
not maintained upstream.
 [4] autogen has many capabilities, but here we concentrate on the
portion called AutoOpts.  AutoOpts is the most general of these
programs, and has the most extensive documentation.  It is the only
one that supports shell scripts as well as C programs.  It also
supports input from a configuration file or the environment.
 [5] gengetopt is the only one that generates a skeleton main.c
instead of a separate parsing function.
 [6] wyg uses flex and bison to generate a configuration file parser,
but uses getopt_long to parse the command line options.
 [7] A program run "once" produces files which the user is expected to
edit.  If it's run again, the user would lose his edits.  A program
supporting "many" runs, the user is not expected to edit the result.
Thus, to change the interface (to add an option, for example), the
user could edit the description file and re-run the parser generator.
 [8] xlig supports either a short or long name for a given option, but
not both, and in either case it is introduced by a single dash.
 [9] There is a user-visible dependency iff the developer does a
dynamic link to the libopts.so library.  Developers are free to either
link statically or ship libopts.so with their product.  A Debian
package would need only a dependency on the package supplying libopts
(libopts2, at present).

.


 -- James R. Van Zandt <jrv@vanzandt.mv.com>, Sun, 20 Jun 1999 10:15:03 -0400