=head1 NAME

dgrep, degrep, dfgrep, dzgrep -- grep through files belonging to an installed Debian package

=head1 SYNOPSIS

B<dgrep> [I<most grep options>] I<pattern> I<package>...

B<dgrep> B<--help>

=head1 DESCRIPTION

B<dgrep> invokes grep(1) on each file in one or more installed Debian 
packages.

It passes the I<package> argument(s) to dglob(1) to retrieve a list of files 
in those packages. You can use POSIX regular expressions for the package 
names.

If B<dgrep> is invoked as B<degrep>, B<dfgrep> or B<dzgrep> then egrep(1), 
fgrep(1) or zgrep(1) is used instead of B<grep>.

=head1 OPTIONS

B<dgrep> supports most of grep(1)'s options. Please refer to your 
B<grep> documentation (i.e. the manpage or the texinfo manual) for
a complete listing. Only a few options are excluded because they do not 
conform with the intended behaviour, see the list below.

=head2 Options of grep that are not supported by dgrep

=over 4

=item B<-r>, B<--recursive>, B<-d> I<recurse>, B<--directories>=I<recurse>

=item B<-d> I<read>, B<--directories>=I<read>

B<dgrep> searches only in the "normal" files of a package. It skips all
directories and symlinks. Therefor the options of
grep that are specific to directories are not supported.

=back

=head1 AUTHOR

Matt Zimmerman <mdz@debian.org>

This manpage was written by Frank Lichtenheld <frank@lichtenheld.de>.

=head1 COPYRIGHT AND LICENCE

Copyright (C) 2001 Matt Zimmerman <mdz@debian.org>.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

On Debian systems, a copy of the GNU General Public License may be
found in /usr/share/common-licenses/GPL.

=head1 SEE ALSO

grep(1), egrep(1), fgrep(1), zgrep(1), dglob(1), regex(7), dpkg(8)
