[issue7386] More precise document on os.path.normpath()
Georg Brandl ge...@python.org added the comment: Fixed in r83547. -- resolution: - fixed status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue7386 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
More precise document on os.path.normpath()
After I tried os.path.normpath(), it is clear that the function doesn't return the trailing '/', if the path is a directory. But this fact is not documented. Should this be documented in future release of python. Also, I found the documentation of some functions in os.path are not clear. I have to try them in order to understand them for corner cases. I'm wondering if I can join the people who maintain the document to help improve it. -- http://mail.python.org/mailman/listinfo/python-list
Re: More precise document on os.path.normpath()
On Mon, Nov 23, 2009 at 8:52 PM, Peng Yu pengyu...@gmail.com wrote: After I tried os.path.normpath(), it is clear that the function doesn't return the trailing '/', if the path is a directory. But this fact is not documented. Should this be documented in future release of python. Also, I found the documentation of some functions in os.path are not clear. I have to try them in order to understand them for corner cases. I'm wondering if I can join the people who maintain the document to help improve it. -- Just file a bug report listing what part you find unclear and what you suggest they put to clarify it. http://mail.python.org/mailman/listinfo/python-list -- http://mail.python.org/mailman/listinfo/python-list
Re: More precise document on os.path.normpath()
On Nov 23, 5:59 pm, Benjamin Kaplan benjamin.kap...@case.edu wrote: On Mon, Nov 23, 2009 at 8:52 PM, Peng Yu pengyu...@gmail.com wrote: After I tried os.path.normpath(), it is clear that the function doesn't return the trailing '/', if the path is a directory. But this fact is not documented. Should this be documented in future release of python. Also, I found the documentation of some functions in os.path are not clear. I have to try them in order to understand them for corner cases. I'm wondering if I can join the people who maintain the document to help improve it. Just file a bug report listing what part you find unclear and what you suggest they put to clarify it. The documentation does not and should not try to document every little detail of every function. For that matter, nor should comp.lang.python. Python is open source, anyone can look at the implementation to see how it behaves. The source code is the right place to seek answers about arcane minutae like when os.path.normpath appends a backslash. Not the Python docuementation, and definitely not this newsgroup. Carl Banks -- http://mail.python.org/mailman/listinfo/python-list
Re: More precise document on os.path.normpath()
Peng Yu wrote: After I tried os.path.normpath(), it is clear that the function doesn't return the trailing '/', if the path is a directory. But this fact is not documented. Should this be documented in future release of python. Also, I found the documentation of some functions in os.path are not clear. I have to try them in order to understand them for corner cases. I'm wondering if I can join the people who maintain the document to help improve it. os.path is designed for OS-agnostic path manipulation. The textual representation of the output of os.path is irrelevant. If a trailing '/' doesn't affect the ability to open the directory or file or os.path.join or whatever, it is irrelevant to os.path. If the trailing / does affect those abilities, though, it is a bug in os.path. -- http://mail.python.org/mailman/listinfo/python-list
[issue7386] More precise document on os.path.normpath()
New submission from pengyu.ut pengyu...@gmail.com: os.path.normpath() doesn't return the trailing '/', if the path is a directory. But the document doesn't mention this fact. I recommend document this feature. -- assignee: georg.brandl components: Documentation messages: 95661 nosy: georg.brandl, pengyu.ut severity: normal status: open title: More precise document on os.path.normpath() versions: Python 2.7 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue7386 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue7387] More precise document on os.path.normpath()
New submission from pengyu.ut pengyu...@gmail.com: os.path.normpath() doesn't return the trailing '/', if the path is a directory. But the document doesn't mention this fact. I recommend document this feature. -- assignee: georg.brandl components: Documentation messages: 95662 nosy: georg.brandl, pengyu.ut severity: normal status: open title: More precise document on os.path.normpath() versions: Python 2.7 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue7387 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue7387] More precise document on os.path.normpath()
Changes by Benjamin Peterson benja...@python.org: -- resolution: - duplicate status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue7387 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com