[issue16240] Document a way to escape metacharacters in glob/fnmatch

[Serhiy Storchaka]

Serhiy Storchaka added the comment:

Thank you, Ezio.  Can we now continue with issue8402?

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16240] Document a way to escape metacharacters in glob/fnmatch

[Ezio Melotti]

Ezio Melotti added the comment:

Finalized!

--
assignee: docs@python -> ezio.melotti
priority: high -> normal
resolution:  -> fixed
stage: needs patch -> committed/rejected
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16240] Document a way to escape metacharacters in glob/fnmatch

[Serhiy Storchaka]

Serhiy Storchaka added the comment:

Ezio, feel free to finalize this.  For me all variants look good.

--
keywords:  -patch
stage: patch review -> needs patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16240] Document a way to escape metacharacters in glob/fnmatch

[Ezio Melotti]

Ezio Melotti added the comment:

For a literal match, wrap the meta-characters in brackets.  For example, 
``'[?]'`` matches the character ``'?'``.

Stating the goal at the beginning of the sentence will make this easier to find 
while skimming through the doc.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16240] Document a way to escape metacharacters in glob/fnmatch

[Serhiy Storchaka]

Serhiy Storchaka added the comment:

My patch was only example.  Commit what you feel is better.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16240] Document a way to escape metacharacters in glob/fnmatch

[Fred L. Drake, Jr.]

Fred L. Drake, Jr. added the comment:

Better (IMO):

Wrap the meta-characters in brackets for a literal match.  For example, 
``'[?]'`` matches the character ``'?'``.

--
nosy: +fdrake

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16240] Document a way to escape metacharacters in glob/fnmatch

[Ezio Melotti]

Ezio Melotti added the comment:

I would use "It is possible to remove" rather than "One can remove", but 
otherwise the patch LGTM.

--
nosy: +eric.araujo, ezio.melotti, terry.reedy
stage: needs patch -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16240] Document a way to escape metacharacters in glob/fnmatch

[Serhiy Storchaka]

Changes by Serhiy Storchaka :


--
stage:  -> needs patch
type: behavior -> enhancement

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16240] Document a way to escape metacharacters in glob/fnmatch

[Serhiy Storchaka]

New submission from Serhiy Storchaka:

fnmatch.translate's docstraing says "There is no way to quote 
meta-characters.", but this is wrong. One can remove the special meaning of 
``'?'``, ``'*'`` and ``'['`` by wrapping them between square brackets. Thus, 
``'[?]'`` matches the literal character ``'?'``.

There are a lot of related issues: issue8402, issue13929, issue9358, 
issue738389, issue738361, issue1580472, issue5852.

--
assignee: docs@python
components: Documentation
files: fnmatch_doc_escape.patch
keywords: easy, patch
messages: 172976
nosy: docs@python, serhiy.storchaka
priority: high
severity: normal
status: open
title: Document a way to escape metacharacters in glob/fnmatch
type: behavior
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4
Added file: http://bugs.python.org/file27581/fnmatch_doc_escape.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com