String Pattern Matching: regex and Python regex documentation

[Xah Lee]

the Python regex documentation is available at:
http://xahlee.org/perl-python/python...module-re.html

Note that, i've just made the terms of use clear.

Also, can anyone answer what is the precise terms of license of the
official python documentation? The official python.org doc site is not
clear.

Note also, that the regex syntax used by Perl is the same as Python.
So, this section
http://xahlee.org/perl-python/python...re-syntax.html
which contains clear explanation of regex syntax, will be of interest
to Perl programers as well.

If you are studying regex, you might also be interested in this lisp
doc:
http://xahlee.org/elisp/Regular-Expressions.html

Also note, that the regex syntax, is one of unix's $free$ fuckup that
has damaged a entire computer industry for decades. ($free$ as drugs
given to children)

For some examples of corrective steps, see:

• Scsh manual, Chapter 6: Pattern-matching strings with regular
expressions
http://www.scsh.net/docu/html/man-Z-H-7.html

• Mathematica Book, section 2.8.4 String Patterns
http://documents.wolfram.com/mathema.../section-2.8.4

Xah
xa*@xahlee.org
∑ http://xahlee.org/

[Ilias Lazaridis]

[followup to c.l.py]

Xah Lee wrote:

the Python regex documentation is available at:
http://xahlee.org/perl-python/python...module-re.html

Note that, i've just made the terms of use clear.

Also, can anyone answer what is the precise terms of license of the
official python documentation? The official python.org doc site is not
clear.

I would be interested in this information, too.

Note also, that the regex syntax used by Perl is the same as Python.
So, this section
http://xahlee.org/perl-python/python...re-syntax.html
which contains clear explanation of regex syntax, will be of interest
to Perl programers as well.

....

Your tutorial has helped me to write my first regular expression:

http://dev.lazaridis.com/base/changeset/60

your notes about documentation are interesting, too:

http://xahlee.org/perl-python/re-write_notes.html

I have some notes, too:

http://case.lazaridis.com/wiki/Docu

-

I would like to read more on your website, but the usability is
terrible, mainly due to the missing navigation.

What about an exchange?

I assist you with the navigation. you will just need apache
server-side-include and one file "navigation.html", which will contail
all of the navigation, very simple.

And you make an real life example for a python regular expression use-case:

i want to scan a text for this line:

[[CustomAttributes(this=4,that=34,name='peter')]]

picking "this=4" ...

and add the attributes to an object.

object = addCustomAttributes(text)

(ok, the regex part would be enouth).

..

--
http://lazaridis.com

[Steve Holden]

Ilias Lazaridis wrote:

[followup to c.l.py]

Xah Lee wrote:

>>the Python regex documentation is available at:
http://xahlee.org/perl-python/python...module-re.html

Note that, i've just made the terms of use clear.

Also, can anyone answer what is the precise terms of license of the
official python documentation? The official python.org doc site is not
clear.

I would be interested in this information, too.

>>Note also, that the regex syntax used by Perl is the same as Python.
So, this section
http://xahlee.org/perl-python/python...re-syntax.html
which contains clear explanation of regex syntax, will be of interest
to Perl programers as well.

....

Your tutorial has helped me to write my first regular expression:

http://dev.lazaridis.com/base/changeset/60

your notes about documentation are interesting, too:

http://xahlee.org/perl-python/re-write_notes.html

I have some notes, too:

http://case.lazaridis.com/wiki/Docu

-

I would like to read more on your website, but the usability is
terrible, mainly due to the missing navigation.

What about an exchange?

I assist you with the navigation. you will just need apache
server-side-include and one file "navigation.html", which will contail
all of the navigation, very simple.

And you make an real life example for a python regular expression use-case:

i want to scan a text for this line:

[[CustomAttributes(this=4,that=34,name='peter')]]

picking "this=4" ...

and add the attributes to an object.

object = addCustomAttributes(text)

(ok, the regex part would be enouth).

..

Ilias Lazardis meets Xah Lee. I just *know* we're in for trouble now ...

regards
Steve
--
Steve Holden [phone] [phone]
Holden Web LLC/Ltd http://www.holdenweb.com
Skype: holdenweb http://holdenweb.blogspot.com
Recent Ramblings http://del.icio.us/steve.holden

[Paul McGuire]

"Steve Holden" <st***@holdenweb.comwrote in message
news:ma**************************************@pyth on.org...
<snip>

>
Ilias Lazardis meets Xah Lee. I just *know* we're in for trouble now ...

regards
Steve

A sign of the End Times, perhaps?

-- Paul

[John Machin]

Paul McGuire wrote:

"Steve Holden" <st***@holdenweb.comwrote in message
news:ma**************************************@pyth on.org...
<snip>

Ilias Lazardis meets Xah Lee. I just *know* we're in for trouble now ...

regards
Steve

A sign of the End Times, perhaps?

Indeed. Armageddon outa here ;-)

[Jürgen Exner]

Ilias Lazaridis wrote:

Xah Lee wrote:

>the Python regex documentation is available at:
http://xahlee.org/perl-python/python...module-re.html

Yeah, sure, and the Perl regex documentation is available at 'perldoc
perlre'.
So what? Is that anything new or surprising?

jue

[Xah Lee]

Xah Lee wrote:
« the Python regex documentation is available at:
http://xahlee.org/perl-python/python...module-re.html ...»

Jürgen Exner wrote:
«Yeah, sure, and the Perl regex documentation is available at 'perldoc
perlre'. So what? Is that anything new or surprising?»

It is of interest and new, because it is a rewrite of Python's
documentation. And it is of interest to Perlers, because Perl and
Python uses the same regex syntax.

The purpose of this rewrite, is to fix Python's lousy documentation,
and to demonstrate a style of technical writing, where precision and
clarity is the prime directive.

It demonstrates a style of documentation, where the philosophy is
task-oriented and uses examples sans misgivings. (in this aspect, it
is similar to the style of Perl's official documentation.)

Further, the exposition style focuses on the manifestation of the
language elements, as a piece of mathematics, a style often found in
functional language's documentations. It is opposed to, treating the
language as a state machine or compiler engine, which are often
necessarily the approach of imperative languages's documentations.

This project was undertaken as a response to a challenge put forth to
me with a $100 reward, on 2005-04-12 on comp.lang.python newsgroup. I
never received the due reward.

Thanks.

Xah
xa*@xahlee.org
∑ http://xahlee.org/

[Steve Holden]

Xah Lee wrote:

Xah Lee wrote:
« the Python regex documentation is available at:
http://xahlee.org/perl-python/python...module-re.html ...»

Jürgen Exner wrote:
«Yeah, sure, and the Perl regex documentation is available at 'perldoc
perlre'. So what? Is that anything new or surprising?»

It is of interest and new, because it is a rewrite of Python's
documentation. And it is of interest to Perlers, because Perl and
Python uses the same regex syntax.

The purpose of this rewrite, is to fix Python's lousy documentation,
and to demonstrate a style of technical writing, where precision and
clarity is the prime directive.

It demonstrates a style of documentation, where the philosophy is
task-oriented and uses examples sans misgivings. (in this aspect, it
is similar to the style of Perl's official documentation.)

Further, the exposition style focuses on the manifestation of the
language elements, as a piece of mathematics, a style often found in
functional language's documentations. It is opposed to, treating the
language as a state machine or compiler engine, which are often
necessarily the approach of imperative languages's documentations.

This project was undertaken as a response to a challenge put forth to
me with a $100 reward, on 2005-04-12 on comp.lang.python newsgroup. I
never received the due reward.

Your reading skills must be terrible. You never received the reward
because it never became due. I offered you $100 if (I believe) five
regular readers of c.l.py wrote me to say your version was an
improvement on the original documentation.

So far (it's now been over a year since your publication, IIRC) not one
single person has written to me. So while your version of the docs may
have some merit, it certainly doesn't fulfil the advertised requirements
for the reward. Which therefore isn't due.

regards
Steve
--
Steve Holden [phone] [phone]
Holden Web LLC/Ltd http://www.holdenweb.com
Skype: holdenweb http://holdenweb.blogspot.com
Recent Ramblings http://del.icio.us/steve.holden

[Ilias Lazaridis]

Steve Holden wrote:

Xah Lee wrote:

....

This project was undertaken as a response to a challenge put forth to
me with a $100 reward, on 2005-04-12 on comp.lang.python newsgroup. I
never received the due reward.

Your reading skills must be terrible. You never received the reward
because it never became due. I offered you $100 if (I believe) five
regular readers of c.l.py wrote me to say your version was an
improvement on the original documentation.

So far (it's now been over a year since your publication, IIRC) not one
single person has written to me. So while your version of the docs may
have some merit, it certainly doesn't fulfil the advertised requirements
for the reward. Which therefore isn't due.

This justification sounds rational.

Possibly this should be published in a seperate topic, asking people to
review the 2 doc's, whilst giving publically(!) their vote.

Finally, all this can contribute to better python documentation (and,
sorry, python doc's need _really_ a rework).

--
http://lazaridis.com