summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* doc: improve documentation of character classes in the man pageReuben Thomas2011-07-151-5/+4
| | | | * doc/grep.in.1: Reword documentation of character classes.
* doc: improve documentation of character classesPaolo Bonzini2011-06-291-13/+13
| | | | | | * doc/grep.texi (Character classes): Mention explicitly when examples refer to the C locale, explain better the general meaning of character classes.
* doc: correct comment about mmapReuben Thomas2011-05-021-1/+1
| | | | | * doc/grep.texi (Other Options) [--mmap]: This option is now ignored, so using it can have no effect on performance.
* maint: update from gnulibJim Meyering2011-02-281-6/+7
| | | | | | * bootstrap: Update from gnulib. * tests/init.sh: Likewise. * gnulib: Update to latest.
* doc: remove erroneous "{,m}" item from grep man pageJim Meyering2011-01-051-5/+0
| | | | | * doc/grep.in.1: Remove item describing bogus {,m} regex notation. Reported by Fernando Basso.
* maint: update copyright year ranges to include 2011Jim Meyering2011-01-034-6/+5
| | | | Run "make update-copyright", so "make syntax-check" works in 2011.
* grep: diagnose and exit-2 for bogus REs like [:space:], [:digit:], etc.Jim Meyering2010-09-011-6/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When I make a mistake like this: grep '[:lower:]' ... be it in a script or on the command line, I want to know about it as soon as possible. I don't want grep to print a mere warning that it is interpreting this suspicious and almost guaranteed-wrong regular expression as a set of just 6 bytes. And I certainly don't want grep to silently do the wrong thing, even if that would be officially standards-conforming. It's obvious that I intended [[:lower:]], and I want my error to be diagnosed in a way that is most likely to get my attention. Thus, with this change, grep now prints a diagnostic and exits with status 2 the moment it encounters an offending [:char_class:] construct. This changes the way grep works by default, rather than putting this new behavior on an option. A new option would seldom be used in scripts (not portable), and would probably be used only rarely by those who need it the most. This new functionality provides a valuable safety measure and incurs truly negligible risk. For strict POSIX compliance, set POSIXLY_CORRECT in your environment. That disables this new feature. Revert the changes from commit 2cd3bcea, "grep: add --warnings={always,never,auto}.", and then do the following: * src/dfasearch.c (dfawarn): Call getenv("POSIXLY_CORRECT") here; Remove "warning: " from the diagnostic, now that it's more than a warning, and exit with status 2. * NEWS (New features): Describe the new semantics. * tests/warn-char-classes: Adjust one test to accommodate this change. * doc/grep.texi (Character Classes and Bracket Expressions): Document. (Environment Variables): Cross-reference it. Remove reference to obsolete getopt illegal vs. invalid difference. Thanks to Paul Eggert for suggestions and an initial prod.
* doc: document \s and \SPaolo Bonzini2010-07-161-0/+6
| | | | | * doc/grep.texi (The Backslash Character and Special Expressions): Document \s and \S escapes.
* doc: discuss matches that span two or more linesKarl Berry2010-05-291-1/+30
| | | | | * doc/grep.texi (Usage): Discuss matching across lines. (Character Classes and Bracket Expressions) <[:space:]>: refer to it.
* build: update gnulib submodule to latest; adaptJim Meyering2010-04-131-1/+0
| | | | | | | * COPYING: Remove empty line. * README: Likewise. * doc/fdl.texi: Likewise. * tests/backref-word: Likewise.
* doc: fix typo: s/AM_V_AT/AM_V_at/Jim Meyering2010-04-011-2/+2
| | | | | | * doc/Makefile.am (egrep.1 fgrep.1): The former has case consistent with its sister variable, AM_V_GEN, but the latter is the one that actually works.
* doc: generated files are best made read-only, ...Jim Meyering2010-04-011-2/+3
| | | | | | | | ...to minimize risk of accidentally modifying the generated file rather than its template. These are tiny, so no risk, but it's a good to be consistent, so generated files are easier to spot. * doc/Makefile.am (egrep.1 fgrep.1): When generating these files, ensure that they too are created read-only.
* doc: generate grep.1 from templateJim Meyering2010-04-012-7/+9
| | | | | | | | | | | | | * doc/Makefile.am (grep.1): New rule. (CLEANFILES): Add grep.1 to the list. * .gitignore: Add /doc/grep.1 * doc/grep.in.1: Replace hard-coded "2.5.1-cvs" with @VERSION@. Update copyright year list. Omit the line-splitting \(co directive so that update-copyright will perform future updates automatically. Egmont Koblinger reported the outdated version string and copyright year list in the man page: http://savannah.gnu.org/bugs/?29390
* doc: prepare to generate grep.1Jim Meyering2010-04-011-0/+0
| | | | | * doc/grep.1: Rename to... * doc/grep.in.1: ...this.
* build: make doc/Makefile.am cleaner and more robustJim Meyering2010-03-291-9/+4
| | | | | | | | | * doc/Makefile.am (egrep.1 fgrep.1): Generate robustly, i.e., do not redirect directly to $@. Use $(AM_V_GEN). Do not distribute intermediate files like fgrep.man and egrep.man. Likewise, do not use them to generate their %.1 images. Instead, generate the .1 files directly.
* grep: remove --mmapPaolo Bonzini2010-03-221-6/+4
| | | | | | | | | | | | | | | mmap is a bad idea for sequentially accessed file because it will cause a page fault for every read page. Just consider it a failed experiment, and ignore --mmap while accepting it for backwards compatibility. * configure.ac (AC_FUNC_MMAP): Remove. * doc/grep.texi (Other options): Say --mmap is ignored. * src/grep.c (mmap_option): Remove. (long_options): Do not reference it. (bufmapped, initial_bufoffset): Remove. (reset, fillbuf): Remove HAVE_MMAP code. (grepfile): Remove bufmapped reference. (usage): Say --mmap is ignored.
* grep(1) man page: touchup --label optionMike Frysinger2010-03-061-2/+5
| | | | | | | * doc/grep.1 (--label): Don't italicize ending period. Point to -H option. Signed-off-by: Mike Frysinger <vapier@gentoo.org>
* doc: improve the discussion of PCREReuben Thomas2010-03-062-7/+15
| | | | | | * doc/grep.1: Add a sentence about Perl regular expressions, and point to pcresyntax(3) and pcrepattern(3). * doc/grep.texi: Likewise.
* add --group-separator=FOO and --no-group-separatorPaolo Bonzini2010-02-221-5/+19
| | | | | | | | | | | * src/grep.c (group_separator): New. (long_options): Add --group-separator=FOO and --no-group-separator. (prtext): Print group_separator instead of SEP_STR_GROUP. Optionally suppress the separator altogether. (main) Handle GROUP_SEPARATOR_OPTION. * doc/grep.texi (Context control): Document it. * NEWS: Mention it. * tests/yesno.sh: Add testcases.
* maint: update all FSF copyright year lists to include 2010Jim Meyering2010-01-013-4/+5
| | | | | | Use this command: git ls-files |grep -vE '^(\..*|COPYING|gnulib)$' |xargs \ env UPDATE_COPYRIGHT_USE_INTERVALS=1 build-aux/update-copyright
* Improve description of --labelPaolo Bonzini2009-12-222-6/+6
| | | | | | | Fixes bug 22681. * doc/grep.1 (--label): Use -H in the example, improve wording. * doc/grep.texi (Output Line Prefix Control): Likewise.
* build: add several build- and release-related gnulib modulesJim Meyering2009-11-301-0/+1
| | | | | | * bootstrap.conf (gnulib_modules): Add announce-gen update-copyright do-release-commit-and-tag git-version-gen gnu-web-doc-update gnupload maintainer-makefile useless-if-before-free
* remove useless AUTOMAKE_OPTIONSPaolo Bonzini2009-11-201-2/+0
| | | | | | * doc/Makefile.am: Remove AUTOMAKE_OPTIONS. * lib/posix/Makefile.am: Remove AUTOMAKE_OPTIONS. * vms/Makefile.am: Remove AUTOMAKE_OPTIONS.
* move .cvsignore files to .gitignorePaolo Bonzini2009-11-201-3/+1
|
* update/add copyright noticesKarl Berry2009-01-302-3/+5
|
* missed addKarl Berry2008-12-171-0/+506
|
* move exit status and program variants to under InvokingKarl Berry2008-12-121-5/+9
| | | | | * doc/grep.texi (Exit Status, grep Programs): move these nodes to under Invoking.
* no node pointers; downcase cindex entriesKarl Berry2008-12-121-13/+17
| | | | | * doc/grep.texi: remove all remaining node pointers; downcase cindex entries.
* have just fdl in the manual, since that is the usual conventionKarl Berry2008-12-112-820/+40
| | | | | | | | | | | * doc/grep.texi (Copying): update url's. (GNU General Public License): remove node. (GNU Free Documentation License): @include fdl.texi instead. (@copying): update to v1.3 or later. * doc/fdl.texi: new file, copied from http://www.gnu.org/licenses/fdl.texi. * doc/Makefile.am (grep_TEXINFOS): new variable to get fdl.texi. Also add usual GPL license statement.
* combine all into a single indexKarl Berry2008-12-111-30/+7
| | | | | | | * doc/grep.texi (Index): Merge in Concept Index node, to have only one index. Arrange @syncodeindex's accordingly. * doc/grep.texi (@copying): use @copying; move @contents to beginning; rearrange other frontmatter in the conventional ways.
* use @copying, other frontmatter tweaksKarl Berry2008-12-101-65/+24
|
* * tests/foad1.h: Comment out cases that are known to fail. TheseTony Abou-Assaleh2008-02-072-4/+6
| | | | | | | | | | | | should be uncommented after the 2.5.4 release. * tests/yesno.sh: Likewise. * doc/grep.1: Update description of -e PATTERN; from Benno Schulenberg * doc/grep.texi: Likewise. * tests/foad1.h: Comment out cases that are known to fail. These * tests/yesno.sh: Likewise. * doc/grep.1: Update description of -e PATTERN; from Benno Schulenberg * doc/grep.texi: Likewise.
* --exclude-dirBernhard Rosenkraenzer2006-08-182-7/+16
| | | | | * lib/savedir.c, lib/savedir.h, src/grep.c, doc/*: Add --exclude-dir option (patch #5051)
* Changes from comment attached to patch 4610Bernhard Rosenkraenzer2006-08-181-11/+11
|
* Apply documentation patch (#4610)Bernhard Rosenkraenzer2006-08-182-909/+1656
|
* * doc/grep.1, doc/grep.texi: Advise users to test forCharles Levert2005-11-092-1/+16
| | | | | | "exit_status > 1" instead of "exit_status == 2" in order to detect errors, for portability with other POSIX-compliant implementations.
* * README.DOS, TODO, grep.spec, doc/grep.1, doc/grep.texi,Charles Levert2005-11-082-38/+59
| | | | | | | | | | | | src/grep.h, po/da.po, po/nb.po, po/no.po, po/sv.po: Replace all capitalized "Grep" by a lowercase "grep", except in citations. Reported by Benno Schulenberg <benno@nietvergeten.nl> from the <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=190551> entry in the Debian bug tracker. * doc/grep.1, doc/grep.texi: Explain that the "egrep" and "fgrep" commands are deprecated and provided for historical applications. Replace some "egrep" uses by "grep -E" to promote the newer usage. Typeset "zgrep" as a command. Fix some spacing and punctuation bugs.
* Rewrite a poorly written usage example.Julian Foad2005-11-081-9/+11
| | | | | * doc/grep.texi: Rewrite a poorly written usage example about back-references, and tweak another. New text by Benno Schulenberg.
* typoStepan Kasal2005-09-271-2/+2
| | | | * doc/grep.1: Fix a typo.
* * src/grep.c (print_line_middle): In case of an empty match,Charles Levert2005-08-242-15/+17
| | | | | | | | | | make minimal progress and continue instead of aborting process of the remainder of the line, in case there's still an upcoming non-empty match. * tests/foad1.sh: Add two tests for this. * doc/grep.texi, doc/grep.1: Document this behavior, since --only-matching and --color are GNU extensions which are otherwise unspecified by POSIX or other standards.
* * doc/grep.texi: Add missing green color in GREP_COLORS description.Charles Levert2005-07-052-28/+29
| | | | * doc/grep.1: Fix typo and reorganize GREP_COLORS documentation.
* * src/grep.c: The new -T/--initial-tab framework, onlyCharles Levert2005-06-212-1/+33
| | | | | | | partially used at this point to make for a simpler initial patch in CVS. A subset of patch #3644 on Savannah. The option name/calling convention is the same as for GNU diff. * doc/grep.texi, doc/grep.1: Document -T/--initial-tab.
* * src/grep.c: The new GREP_COLORS (plural) framework, onlyCharles Levert2005-06-212-12/+80
| | | | | | | | | | partially used at this point to make for a simpler initial patch in CVS. A subset of patch #3644 on Savannah. * src/grep.c (color_cap_ne_fct, color_cap_xm_fct, print_filename, print_sep, parse_grep_colors): New functions. * src/grep.c (prtext, grepfile, main): Existing functions modified to use the new framework. * doc/grep.texi, doc/grep.1: Document GREP_COLORS.
* Update FSF's civic address, zip code, and citizen relocation code.Charles Levert2005-05-021-5/+5
| | | | | * 78 files: Update FSF's civic address, zip code, and citizen relocation code.
* Document USG grep -s too.Julian Foad2005-04-112-14/+22
| | | | Based on a patch by Paul Eggert; suggested by Keith Marshall.
* more phrasing fixesStepan Kasal2004-12-152-4/+3
|
* Minor fixes of phrasing.Julian Foad2004-12-152-9/+14
| | | | | | * doc/grep.texi: Minor fixes of phrasing. * doc/grep.1: Likewise. * src/grep.c: Likewise.
* fix docs, mainly about --include and --excludeStepan Kasal2004-12-082-25/+23
| | | | | | | | | | | * src/grep.c (usage): Use ``FILE_PATTERN'' for --include and --exclude, change ``only print'' to ``print only''. * doc/grep.1: Likewise; state that wildcard matching is used. Move some options so that they are sorted alphabetically. * dfa.c, NEWS: Fix typos. * src/grep.c (usage): Clean up several details in the usage string. * doc/grep.1: Fix descriptions of --include and --exclude. * doc/grep.texi: Likewise.
* fix for current automake, drop support of legacy autotoolsStepan Kasal2004-11-201-1/+4
| | | | | | | | | | * ./cvsignore: Amended several .cvsignore files and removed *.gmo, acinclude.m4 and stamp-h.in from the root one. * m4/init.m4: Nuked, it was breaking current automake. * m4/Makefile.m4: Removed init.m4. * autogen.m4: Drop support for legacy autoconf; tell whether the auto tools exited successfully or not; fix the permissions of tests/*.sh--CVS doesn't provide a way to fix it.
* bug report address changeStepan Kasal2004-11-192-6/+3
| | | | | | | | Change bug-gnu-utils address to bug-grep, on many places; there is no need to have the word ``grep'' in subject then. Thanks to Tony Abou-Assaleh and Benno Schulenberg for pointing out this. * 2.5.1 Release.