bugGNU Octave - Bugs: bug #39431, regexp: documentation needs to be...

 
 

bug #39431: regexp: documentation needs to be expanded

Submitter:  Rik <rik5>
Submitted:  Mon 08 Jul 2013 12:08:54 AM UTC
   
 
Category:  Documentation Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Documentation
Status:  Fixed Assigned to:  None
Originator Name:  Open/Closed:  * Closed
Release:  * dev Operating System:  * Any
Fixed Release:  9.1.0 Planned Release:  9.1.0
* Mandatory Fields

Add a New Comment Rich Markup
   

Jump to the original submission

Thu 02 May 2024 11:44:07 PM UTC, comment #8: 

This seems fine.  Marking bug as Fixed and closing report.

Rik <rik5>
Group administrator
Tue 27 Feb 2024 04:34:08 AM UTC, comment #7: 

added PRCE reference link in
https://hg.savannah.gnu.org/hgweb/octave/rev/6ed312edd0d4

if that seems sufficient, this can probably be closed.

Nicholas Jankowski <nrjank>
Group Member
Mon 26 Feb 2024 10:47:04 PM UTC, comment #6: 

I think the shorter text link is preferable.  If people want to go deep, then they can find more documentation.  But most people just want to quickly grab the basics.

Rik <rik5>
Group administrator
Mon 26 Feb 2024 10:02:13 PM UTC, comment #5: 

ok the pcre docs really just point to pcre2, and they've end-of-life'd pcre, so makes sense to point to some subset of

https://www.pcre.org/current/doc/html/

but much of that is sepcific to library use/installation, etc. to just reference matching/syntax/language related issues, maybe links to:

https://www.pcre.org/current/doc/html/pcre2pattern.html
"Specification of the regular expressions supported by PCRE2"

and/or summary list:
https://www.pcre.org/current/doc/html/pcre2syntax.html
"Syntax quick-reference summary"

Nicholas Jankowski <nrjank>
Group Member
Mon 26 Feb 2024 09:48:08 PM UTC, comment #4: 

haven't searched yet but assuming here's a doc location difference, we should point to PCRE or PCRE2?

Nicholas Jankowski <nrjank>
Group Member
Mon 26 Feb 2024 09:28:46 PM UTC, comment #3: 

I think this is a good idea.  It would be nice to have some self-contained documentation on regexp within Octave, but the reality is that almost everyone is connected to the Internet while coding and can go consult a reference.

Under the hood, Octave uses the Perl Compatible Regular Expression (PCRE) library.  Hence, pointing to Perl regexp documentation would be appropriate.  There are various sites that document regexp for various flavors such as Perl, POSIX, Java, etc.  That would be a worthy second choice.

Rik <rik5>
Group administrator
Mon 26 Feb 2024 09:12:20 PM UTC, comment #2: 

Don't think this has changed in a decade. 

All mention of regexp appears to be located here:

https://docs.octave.org/latest/Searching-and-Replacing-in-Strings.html

Is this something we can add an external reference to address? If we are just implementing e.g., the posix standard I don't think the octave docs need to be a full regexp reference except to capture what is unique/different.


Nicholas Jankowski <nrjank>
Group Member
Mon 21 Nov 2016 10:20:56 PM UTC, comment #1: 

This (documentation) seems to be still missing in Octave 4.2.0.

Hartmut <hardy>
Mon 08 Jul 2013 12:08:54 AM UTC, original submission:  

The documentation for regexp is missing some useful available features.  Here are some that I noticed.

1) Lookaround operators such as (?=), (?!), (?<=), (?<!)

2) POSIX character classes [[:class:]] where class might be "alpha" or "alnum" or ...

3) non-greedy (?) and atomic (+) adjectives for repetition quantifiers [*+?].

4) Backreferences in patterns such as \1 or \k<name>

5) Comments within patternns using (?# comment ) syntax

6) Discussion of escape sequence processing such as '\n' => newline.

7) Expanded discussion of named tokens

8) Conditional patterns based on prior subpattern capture

Rik <rik5>
Group administrator

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by nrjank (Posted a comment)
  • -email is unavailable- added by hardy (Posted a comment)
  • -email is unavailable- added by rik5 (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only group members can vote.

     

    Follow 7 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2024-05-02 rik5 StatusReady For Test Fixed
        Open/ClosedOpen Closed
        Fixed ReleaseNone 9.1.0
        Planned ReleaseNone 9.1.0
    2024-02-27 nrjank StatusNeed Info Ready For Test
    2024-02-26 nrjank StatusConfirmed Need Info
    2013-07-08 rik5 StatusNone Confirmed

    Back to the top

    Powered by Savane 3.14-f13d.
    Corresponding source code