.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.11.
.TH MKID "1" "August 2012" "mkid - 4.5" "User Commands"
.SH NAME
mkid \- Build an identifier database
.SH SYNOPSIS
.B mkid
[\fIOPTION\fR]... [\fIFILE\fR]...
.SH DESCRIPTION
Build an identifier database.
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIOUTFILE\fR
file name of ID database output
.TP
\fB\-f\fR, \fB\-\-file\fR=\fIOUTFILE\fR
synonym for \fB\-\-output\fR
.TP
\fB\-i\fR, \fB\-\-include\fR=\fILANGS\fR
include languages in LANGS (default: "C C++ asm")
.TP
\fB\-x\fR, \fB\-\-exclude\fR=\fILANGS\fR
exclude languages in LANGS
.HP
\fB\-l\fR, \fB\-\-lang\-option\fR=\fIL\fR:OPT pass OPT as a default for language L (see below)
.TP
\fB\-m\fR, \fB\-\-lang\-map\fR=\fIMAPFILE\fR
use MAPFILE to map file names onto source language
.TP
\fB\-d\fR, \fB\-\-default\-lang\fR=\fILANG\fR
make LANG the default source language
.TP
\fB\-p\fR, \fB\-\-prune\fR=\fINAMES\fR
exclude the named files and/or directories
.TP
\fB\-v\fR, \fB\-\-verbose\fR
report per file statistics
.TP
\fB\-s\fR, \fB\-\-statistics\fR
report statistics at end of run
.TP
\fB\-\-files0\-from\fR=\fIF\fR
tokenize only the files specified by
NUL\-terminated names in file F
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
FILE may be a file name, or a directory name to recursively search.
If no FILE is given, the current directory is searched by default.
Note that the `\-\-include' and `\-\-exclude' options are mutually\-exclusive.
.PP
The following arguments apply to the language\-specific scanners:
.SS "C language:"
.TP
\fB\-k\fR,\-\-keep=CHARS
Allow CHARS in single\-token strings, keep the result
.TP
\fB\-i\fR,\-\-ignore=CHARS
Allow CHARS in single\-token strings, toss the result
.TP
\fB\-u\fR,\-\-strip\-underscore
Strip a leading underscore from single\-token strings
.SS "C++ language:"
.TP
\fB\-k\fR,\-\-keep=CHARS
Allow CHARS in single\-token strings, keep the result
.TP
\fB\-i\fR,\-\-ignore=CHARS
Allow CHARS in single\-token strings, toss the result
.TP
\fB\-u\fR,\-\-strip\-underscore
Strip a leading underscore from single\-token strings
.SS "Java language:"
.TP
\fB\-k\fR,\-\-keep=CHARS
Allow CHARS in single\-token strings, keep the result
.TP
\fB\-i\fR,\-\-ignore=CHARS
Allow CHARS in single\-token strings, toss the result
.TP
\fB\-u\fR,\-\-strip\-underscore
Strip a leading underscore from single\-token strings
.SS "Assembly language:"
.TP
\fB\-c\fR,\-\-comment=CHARS
Any of CHARS starts a comment until end\-of\-line
.TP
\fB\-k\fR,\-\-keep=CHARS
Allow CHARS in tokens, and keep the result
.TP
\fB\-i\fR,\-\-ignore=CHARS
Allow CHARS in tokens, and toss the result
.TP
\fB\-u\fR,\-\-strip\-underscore
Strip a leading underscore from tokens
.TP
\fB\-n\fR,\-\-no\-cpp
Don't handle C pre\-processor directives
.SS "Text language:"
.TP
\fB\-i\fR,\-\-include=CHAR\-CLASS
Treat characters of CHAR\-CLASS as token constituents
.TP
\fB\-x\fR,\-\-exclude=CHAR\-CLASS
Treat characters of CHAR\-CLASS as token delimiters
.SS "Perl language:"
.TP
\fB\-i\fR,\-\-include=CHAR\-CLASS
Treat characters of CHAR\-CLASS as token constituents
.TP
\fB\-x\fR,\-\-exclude=CHAR\-CLASS
Treat characters of CHAR\-CLASS as token delimiters
.TP
\fB\-d\fR,\-\-dtags
Include documentation tags
.PP
Lisp language:
.SH "REPORTING BUGS"
Report bugs to bug\-idutils@gnu.org