diff options
author | Andrew Gallant <jamslam@gmail.com> | 2018-09-07 11:57:47 -0400 |
---|---|---|
committer | Andrew Gallant <jamslam@gmail.com> | 2018-09-07 12:06:05 -0400 |
commit | 3b5cdea862e3c4d6346bbef2449523e8c3790b4e (patch) | |
tree | 47602c45ca479da54ab810ae15bbcb9e52fa3cd1 | |
parent | 54b3e9eb10bebb33de799bc14616a0d72165583a (diff) |
doc: minor touchups to API docs
-rw-r--r-- | grep-printer/src/standard.rs | 5 | ||||
-rw-r--r-- | grep-regex/src/matcher.rs | 11 |
2 files changed, 12 insertions, 4 deletions
diff --git a/grep-printer/src/standard.rs b/grep-printer/src/standard.rs index 6c8976b8..6ead1db6 100644 --- a/grep-printer/src/standard.rs +++ b/grep-printer/src/standard.rs @@ -239,8 +239,9 @@ impl StandardBuilder { /// which may either be in index form (e.g., `$2`) or can reference named /// capturing groups if present in the original pattern (e.g., `$foo`). /// - /// For documentation on the full format, please see the `Matcher` trait's - /// `interpolate` method. + /// For documentation on the full format, please see the `Capture` trait's + /// `interpolate` method in the + /// [grep-printer](https://docs.rs/grep-printer) crate. pub fn replacement( &mut self, replacement: Option<Vec<u8>>, diff --git a/grep-regex/src/matcher.rs b/grep-regex/src/matcher.rs index 5589508c..831d573b 100644 --- a/grep-regex/src/matcher.rs +++ b/grep-regex/src/matcher.rs @@ -323,8 +323,15 @@ impl RegexMatcher { /// Create a new matcher from the given pattern using the default /// configuration, but matches lines terminated by `\n`. /// - /// This returns an error if the given pattern contains a literal `\n`. - /// Other uses of `\n` (such as in `\s`) are removed transparently. + /// This is meant to be a convenience constructor for using a + /// `RegexMatcherBuilder` and setting its + /// [`line_terminator`](struct.RegexMatcherBuilder.html#method.line_terminator) + /// to `\n`. The purpose of using this constructor is to permit special + /// optimizations that help speed up line oriented search. These types of + /// optimizations are only appropriate when matches span no more than one + /// line. For this reason, this constructor will return an error if the + /// given pattern contains a literal `\n`. Other uses of `\n` (such as in + /// `\s`) are removed transparently. pub fn new_line_matcher(pattern: &str) -> Result<RegexMatcher, Error> { RegexMatcherBuilder::new() .line_terminator(Some(b'\n')) |