File: dgrep.pod

package info (click to toggle)
debian-goodies 0.27%2Betch1
  • links: PTS
  • area: main
  • in suites: etch
  • size: 160 kB
  • ctags: 61
  • sloc: sh: 518; python: 370; makefile: 43
file content (64 lines) | stat: -rw-r--r-- 1,867 bytes parent folder | download | duplicates (6)
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
=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)