summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* doc: spelling fixes in doc/, comments and old ChangeLogJosh Soref2023-05-101-1/+1
| | | | | | * ChangeLog-2009: Fix spelling errors. * bootstrap: Likewise. * doc/grep.texi: Likewise.
* doc: improve doc for -P '\d'Paul Eggert2023-04-291-8/+5
| | | | | | | | | | | | This follows up to Carlo Marcelo Arenas Belón’s email <https://lists.gnu.org/r/grep-devel/2023-04/msg00017.html> that proposed changing the code too. These patches change only the documentation since we’re so near a release. * NEWS: Be less optimistic about the fix for -P '\d', and warn that behavior is likely to change again. * doc/grep.texi (grep Programs): Be less specific about -P \d behavior, since it’s still in flux. Warn about mismatching Unicode versions, or disagreements about obscure constructs.
* doc: say that `-f -` reads patterns from stdinJim Meyering2023-04-292-0/+6
| | | | | | | | * doc/grep.texi (Matching Control): Mention that when -f's FILE is -, grep reads patterns from stdin. * doc/grep.in.1: Likewise. * THANKS.in: Add the name. Suggested by Sebastian Carlos in https://bugs.gnu.org/63146
* doc: avoid capital sharp S with TeXPaul Eggert2023-03-221-1/+7
| | | | | | Do not use “ẞ” (U+1E9E, LATIN CAPITAL LETTER SHARP S) in tex, as texinfo version 2023-03-04.12 complains “Character missing, sorry: LONG S.”
* doc: clarify BRE vs ERE (bug#62272)Paul Eggert2023-03-202-11/+13
|
* grep: -P (--perl-regexp) \D once again works like [^0-9]Jim Meyering2023-03-191-13/+7
| | | | | | | | | | | * NEWS: Mention \D, too. * doc/grep.texi: Likewise * src/pcresearch.c (pcre_pattern_expand_backslash_d): Handle \D. Also, ifdef-out this new function and its call site when not needed. * tests/pcre-ascii-digits: Test \D, too. Tighten one test by using returns_ 1. Add comments and tests that work only with 10.43 and newer. Paul Eggert raised the issue of \D in https://bugs.gnu.org/62267#8
* grep: forward port to PCRE2 10.43Paul Eggert2023-03-191-7/+11
| | | | | | | | | | | * doc/grep.texi: Document this. * src/grep.c: Move recent changes into pcresearch.c. (P_MATCHER_INDEX): Remove. (pcre_pattern_expand_backslash_d): Move from here ... * src/pcresearch.c: ... to here. (PCRE2_EXTRA_ASCII_BSD): Default to 0. (Pcompile): Use PCRE2_EXTRA_ASCII_BSD if available, and expand \d to [0-9] otherwise.
* doc: distinguish Perl from PCREPaul Eggert2023-03-191-0/+6
| | | | * doc/grep.texi: Mention that PCRE might not match Perl exactly.
* grep: -P (--perl-regexp) \d: match only ASCII digitsJim Meyering2023-03-181-0/+31
| | | | | | | | | | | | | | | | Prior to grep-3.9, the PCRE matcher had always treated \d just like [0-9]. grep-3.9's fix for \w and \b mistakenly relaxed \d to also match multibyte digits. * src/grep.c (P_MATCHER_INDEX): Define enum. (pcre_pattern_expand_backslash_d): New function. (main): Call it for -P. * NEWS (Bug fixes): Mention it. * doc/grep.texi: Document it: with -P, \d matches only ASCII digits. Provide a PCRE documentation URL and an example of how to use (?s) with -z. * tests/pcre-ascii-digits: New test. * tests/Makefile.am (TESTS): Add that file name. Reported as https://bugs.gnu.org/62267
* doc: remove mention of unused _N_GNU_nonoption_argv_flags_ envvarJim Meyering2023-03-092-37/+0
| | | | | | | | | * doc/grep.texi (Environment Variables): This environment variable has not been usable for decades. Remove its documentation. * doc/grep.in.1: Likewise. Reported by Emanuele Torre torreemanuele6@gmail.com in https://bugs.gnu.org/62052 * THANKS.in: Add the name.
* maint: update copyright datesJim Meyering2023-01-014-4/+5
|
* doc: improve GREP_COLORS doc (Bug#57696)Paul Eggert2022-09-092-4/+4
|
* Fix obsolescence doc for egrep, fgrepPaul Eggert2022-09-061-3/+3
|
* doc: document \] and \}Paul Eggert2022-06-041-1/+7
| | | | | | * doc/grep.texi (Special Backslash Expressions) (Problematic Expressions): Document that grep supports \] and \} as extensions to POSIX.
* maint: include fdl.texi in version control, per gnulib module adviceJim Meyering2022-05-292-1/+505
| | | | | | | * bootstrap.conf (gnulib_modules): Remove fdl. * doc/.gitignore: Do not list fdl.texi * doc/fdl.texi: New file. * cfg.mk (FILTER_LONG_LINES): Add doc/fdl.texi.
* grep: document --color[=WHEN] more carefullyPaul Eggert2022-05-291-4/+16
|
* grep: deprecate GREP_COLORPaul Eggert2022-05-292-67/+32
| | | | | | This is to avoid confusion such as that reported by Cholden in: https://bugs.gnu.org/55641 * src/grep.c (main): Warn if GREP_COLOR has an effect.
* doc: document regex corner cases betterPaul Eggert2022-05-221-56/+168
| | | | | | | | | * doc/grep.texi (Environment Variables) (Fundamental Structure, Character Classes and Bracket Expressions) (Special Backslash Expressions, Back-references and Subexpressions) (Basic vs Extended): Say more precisely what happens with problematic regular expressions. (Problematic Expressions): New section.
* doc: document regex corner cases betterPaul Eggert2022-05-211-11/+46
| | | | | | | | | * doc/grep.texi (Environment Variables) (Fundamental Structure, Character Classes and Bracket Expressions) (The Backslash Character and Special Expressions) (Back-references and Subexpressions, Basic vs Extended) (Basic vs Extended): Say more precisely what happens with oddball regular expressions.
* grep: assume POSIX.1-2017 for [:space:]Paul Eggert2022-05-211-6/+2
| | | | | | | * src/dfasearch.c (dfawarn): Always call dfaerror now, regardless of POSIXLY_CORRECT. * tests/warn-char-classes: Omit test of POSIX.1-2008 behavior, since POSIX.1-2017 allows the GNU behavior.
* doc: omit -y from grep man pagePaul Eggert2022-05-191-4/+0
| | | | | The obsolete -y option has been omitted from --help for a while, and now’s a good time to omit it from the man page too.
* grep: document -m betterPaul Eggert2022-05-162-0/+14
| | | | | | * doc/grep.in.1, doc/grep.texi: Document behavior of -m 0 and -m -1. This documents longstanding behavior, and is consistent with how git grep -m will likely behave.
* maint: spelling fixesPaul Eggert2022-05-142-3/+3
|
* doc: more on leading ‘-’Paul Eggert2022-02-271-9/+23
| | | | * doc/grep.texi (Usage): Expand on leading ‘-’ problems (Bug#54174).
* doc: mention issues with set -ePaul Eggert2022-02-241-0/+24
| | | | * doc/grep.texi (Usage, Performance): Mention early exits (Bug#54035).
* bug#52958: [PATCH] doc: fix man page syntax errorsOndřej Fiala2022-01-021-4/+11
| | | | | | * doc/grep.in.1: Fix syntax errors. Introduced by commit v3.6-5-g91ce9cd. Copyright-paperwork-exempt: Yes
* maint: make update-copyrightJim Meyering2022-01-013-3/+3
|
* doc: --invert-match is described "above" --count, not belowHelge Kreutzmann2021-12-201-1/+1
| | | | * doc/grep.in.1 (--count): s/below/above/.
* doc: update to match recent "Binary files" changePaul Eggert2021-11-221-2/+1
| | | | Suggested by Duncan Roe (Bug#51860#25).
* doc: "binary file matches" -> stderr [Bug#51860]Paul Eggert2021-11-202-2/+2
|
* grep: migrate to pcre2Carlo Marcelo Arenas Belón2021-11-142-5/+5
| | | | | | | | | | | | | | | | | | | | | | Mostly a bug by bug translation of the original code to the PCRE2 API. Code still could do with some optimizations but should be good as a starting point. The API changes the sign of some types and therefore some ugly casts were needed, some of the changes are just to make sure all variables fit into the newer types better. Includes backward compatibility and could be made to build all the way to 10.00, but assumes a recent enough version and has been tested with 10.23 (from CentOS 7, the oldest). Performance seems equivalent, and it also seems functionally complete. * m4/pcre.m4 (gl_FUNC_PCRE): Check for PCRE2, not the original PCRE. * src/pcresearch.c (struct pcre_comp, jit_exec) (Pcompile, Pexecute): Use PCRE2, not the original PCRE. * tests/filename-lineno.pl: Adjust to match PCRE2 diagnostics.
* doc: document interval expression limitationsPaul Eggert2021-08-271-1/+14
| | | | | * doc/grep.texi (Basic vs Extended, Performance): Document limitations of interval expressions (Bug#44538).
* doc: modernize portability advicePaul Eggert2021-08-161-20/+5
| | | | | | | | * doc/grep.texi (General Output Control, Basic vs Extended): No need to complicate the portability advice by talking about 7th edition grep, since it’s no longer a practical porting target. Instead, mention only Solaris 10 grep, the last practical holdout of somewhat-traditional grep.
* egrep, fgrep: now obsoletePaul Eggert2021-08-164-35/+27
| | | | | | | | | | | | | * NEWS: Mention this (see bug#49996). * doc/Makefile.am (egrep.1 fgrep.1): Remove. All uses removed. * doc/grep.in.1, doc/grep.texi (grep Programs): Remove documentation for egrep, fgrep. * doc/grep.texi (Usage): Add FAQ for egrep and fgrep. * src/Makefile.am (shell_does_substrings): Substitute for ${0##*/}, not for ${0%/\*} (which was not being used anyway). * src/egrep.sh: Issue an obsolescence warning. * tests/fedora: Use "grep -F" instead of "fgrep" in diagnostics, as this tests "grep -F" not "fgrep".
* doc: update cites and authorsPaul Eggert2021-08-141-3/+18
|
* doc: man: add --group-separator/--no-group-separatorKevin Locke2021-08-061-0/+20
| | | | | | * doc/grep.in.1: Add copy of docs for --group-separator from doc/grep.texi. Add copy of docs for --no-group-separator from doc/grep.texi.
* doc: note that -H is a GNU extension in man page, tooMateusz Okulus2021-06-191-0/+1
| | | | * doc/grep.in.1 (-H): Mention that this is a GNU extension.
* doc: improve examples and wordingPaul Eggert2021-06-101-9/+8
| | | | | * doc/grep.texi (The Backslash Character and Special Expressions) (Usage): Improve doc (Bug#48948).
* doc: man: fix -L description and improve -l'sJim Meyering2021-01-312-4/+2
| | | | | | | | | | * doc/grep.texi (-L): Remove erroneous sentence about stopping early. With -L, grep cannot stop scanning early. (-l): Tweak existing wording. * doc/grep.in.1: Remove the -L sentence here, too. (-l): Copy the sentence from grep.texi, to clarify: it's only per-file scanning that stops upon match. Reported by Robert Bruntz in http://debbugs.gnu.org/46179
* doc: further clarify regexp structurePaul Eggert2021-01-011-19/+45
| | | | | | * doc/grep.texi (Fundamental Structure) (Back-references and Subexpressions, Basic vs Extended): Further clarifications.
* doc: update grep.texi cite to 2021Paul Eggert2021-01-011-1/+1
|
* maint: run "make update-copyright"Paul Eggert2021-01-013-3/+3
|
* doc: clarify special chars and }Paul Eggert2020-12-291-16/+21
| | | | | | | | | | * doc/grep.texi (Fundamental Structure) (Character Classes and Bracket Expressions) (The Backslash Character and Special Expressions, Anchoring) (Basic vs Extended): Clarify which characters are special, and why \ is needed before } in grep even though } is not special. Use Posix terminology for ordinary and special characters and for interval expressions.
* doc: fix missing right curly braceMarek Suppa2020-12-291-3/+3
| | | | | | * doc/grep.texi (Basic vs Extended Regular Expressions): Mention that the right curly brace (}) meta-character must be backslash-escaped. It had been omitted from the list.
* grep: use of --unix-byte-offsets (-u) now elicits a warningJim Meyering2020-12-251-14/+0
| | | | | | | * NEWS (Change in behavior): Mention this. * src/grep.c (main): Warn about each use of obsolete --unix-byte-offsets (-u). * doc/grep.in.1 (-u): Remove its documentation.
* doc: adjust man page syntaxHelge Kreutzmann2020-12-231-5/+5
| | | | | | | | * doc/grep.in.1: Mark some manual names with B<...>. Mark PATTERNS with I<...>. Drop final period in SEE ALSO. With suggestions from of several members of the manpage-l10n translation community. This resolves https://bugs.gnu.org/45353
* grep: remove GREP_OPTIONSPaul Eggert2020-11-032-29/+14
| | | | | | | | | | | | * NEWS: Mention this. * doc/grep.in.1: Remove GREP_OPTIONS documentation. * doc/grep.texi (Environment Variables): Move GREP_OPTIONS stuff into a “no longer implemented” paragraph. * src/grep.c (prepend_args, prepend_default_options): Remove. (main): Do not look at GREP_OPTIONS. * tests/Makefile.am (TESTS_ENVIRONMENTS): * tests/init.cfg (vars_): Remove GREP_OPTIONS.
* doc: document --include/--exclude betterPaul Eggert2020-10-032-0/+15
| | | | | | | | Problem reported by John Ruckstuhl (Bug#43782). * doc/grep.texi (File and Directory Selection): Document what happens if contradictory options are given, or if no option matches a file name. * doc/grep.in.1:
* doc: improve --line-buffer docPaul Eggert2020-09-221-2/+5
| | | | | | * doc/grep.texi (Other Options): Document --line-buffered more carefully, and say what happens when it is not used. Problem reported by Dan Jacobson (Bug#35339).
* doc: say how to match chars by codePaul Eggert2020-09-211-16/+68
| | | | | | | From a suggestion in Bug#41004. * doc/grep.texi (Character Encoding, Matching Non-ASCII): New sections. Move some material from Environment Variables into these sections.
View Lorry Controller Status