[Bug 70062] New: Apache mod_rewrite Int roduction: recommends “the PCRE man pages ”

[email protected] Thu, 21 May 2026 12:42:36 +0000
Newsgroups gmane.comp.apache.documentation
Message-ID <[email protected]/bugzilla/>
https://bz.apache.org/bugzilla/show_bug.cgi?id=70062

            Bug ID: 70062
           Summary: Apache mod_rewrite Introduction: recommends “the PCRE
                    man pages”
           Product: Apache httpd-2
           Version: 2.5-HEAD
          Hardware: All
               URL: https://httpd.apache.org/docs/trunk/en/rewrite/intro.h
                    tml#regex
                OS: All
            Status: UNCONFIRMED
          Severity: enhancement
          Priority: P4
         Component: Documentation
          Assignee: [email protected]
          Reporter: [email protected]
  Target Milestone: ---

The Regular Expressions section of the Apache mod_rewrite Introduction
contains:
> In this document, we do not attempt to provide a detailed reference to regular expressions. For that, we recommend the PCRE man pages, the Perl regular expression man page, and Mastering Regular Expressions, by Jeffrey Friedl (the third edition is from 2006, but regular expression syntax is essentially unchanged, and this remains the definitive reference on the subject).
> 
“PCRE man pages” labels a link to https://www.pcre.org/pcre.txt
I am not aware of great documentation for PCRE, but that is surely not the
first page readers should be referred to at this point. PCRE is a library even
more complicated than mod_rewrite itself, and that page concatenates all its
manpages into a single plain text file, much of which is entirely irrelevant
for httpd users. Moreover, httpd no longer uses PCRE[1], having switched to
PCRE2.

I would strongly recommend replacing at least that link (the first 2 would
probably be best) with pcre2syntax(3):
https://www.pcre.org/current/doc/html/pcre2syntax.html
By the way, “Perl Compatible Regular Expressions” is plural.

🅭🄍: https://www.philippecloutier.com/Common+infrastructure+licensing#its

-- 
You are receiving this mail because:
You are the assignee for the bug.