From: Paul Eggert Date: Tue, 27 Sep 2016 00:00:03 +0000 (-0700) Subject: Regexp Functions doc minor fixes X-Git-Tag: emacs-25.1.90~156 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=bbf1ffd7c74bdf3ea766580788f7f4adb98a47f0;p=emacs.git Regexp Functions doc minor fixes * doc/lispref/searching.texi (Regexp Functions): Fix misspelling of “matching”. Use @table for table. Reformat code example to fit into info file width (Bug#17862). --- diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi index a335e89985f..579460f3227 100644 --- a/doc/lispref/searching.texi +++ b/doc/lispref/searching.texi @@ -950,37 +950,41 @@ more efficient, but is almost never worth the effort.}. The optional argument @var{paren} can be any of the following: -a string - the resulting regexp is preceded by @var{paren} and followed by - @samp{\)}, e.g. use @samp{"\\(?1:"} to produce an explicitly - numbered group. +@table @asis +@item a string +The resulting regexp is preceded by @var{paren} and followed by +@samp{\)}, e.g. use @samp{"\\(?1:"} to produce an explicitly +numbered group. -@code{words} - the resulting regexp is surrounded by @samp{\<\(} and @samp{\)\>}. +@item @code{words} +The resulting regexp is surrounded by @samp{\<\(} and @samp{\)\>}. -@code{symbols} - the resulting regexp is surrounded by @samp{\_<\(} and @samp{\)\_>} - (this is often appropriate when maching programming-language - keywords and the like). +@item @code{symbols} +The resulting regexp is surrounded by @samp{\_<\(} and @samp{\)\_>} +(this is often appropriate when matching programming-language +keywords and the like). -non-@code{nil} - the resulting regexp is surrounded by @samp{\(} and @samp{\)}. +@item non-@code{nil} +The resulting regexp is surrounded by @samp{\(} and @samp{\)}. -@code{nil} - the resulting regexp is surrounded by @samp{\(?:} and @samp{\)}, - if it is necessary to ensure that a postfix operator appended to - it will apply to the whole expression. +@item @code{nil} +The resulting regexp is surrounded by @samp{\(?:} and @samp{\)}, +if it is necessary to ensure that a postfix operator appended to +it will apply to the whole expression. +@end table The resulting regexp of @code{regexp-opt} is equivalent to but usually more efficient than that of a simplified version: @example (defun simplified-regexp-opt (strings &optional paren) - (let ((parens (cond ((stringp paren) (cons paren "\\)")) - ((eq paren 'words) '("\\<\\(" . "\\)\\>")) - ((eq paren 'symbols) '("\\_<\\(" . "\\)\\_>")) - ((null paren) '("\\(?:" . "\\)")) - (t '("\\(" . "\\)"))))) + (let ((parens + (cond + ((stringp paren) (cons paren "\\)")) + ((eq paren 'words) '("\\<\\(" . "\\)\\>")) + ((eq paren 'symbols) '("\\_<\\(" . "\\)\\_>")) + ((null paren) '("\\(?:" . "\\)")) + (t '("\\(" . "\\)"))))) (concat (car paren) (mapconcat 'regexp-quote strings "\\|") (cdr paren))))