[issue19799] Clarifications for the documentation of pathlib

[Eli Bendersky]

Eli Bendersky added the comment:

Committed in 90b56ec318b6

--
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed
versions: +Python 3.2 -Python 3.4, Python 3.5

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[STINNER Victor]

STINNER Victor added the comment:

You can export the schema as SVG.

--

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[Eli Bendersky]

Eli Bendersky added the comment:

>
> STINNER Victor added the comment:
>
> Which tool did you use to draw this schema? You may attach also the source
> if someone would like to modify it in the future.
>

Sorry, but there's no source. I drew it graphically. But since I did it
with Google Drive's drawing program, I can just share out a link to the
editor -
https://docs.google.com/drawings/d/1F8do-1WL1sIGkZuiufcxcpZRtS0w4SwAowq-Uamrwt8/edit?usp=sharing

I suppose if someone wants to edit it they can copy the document and do
that.

--

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[STINNER Victor]

STINNER Victor added the comment:

Which tool did you use to draw this schema? You may attach also the source if 
someone would like to modify it in the future.

--

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[Eli Bendersky]

Changes by Eli Bendersky :


Added file: http://bugs.python.org/file32871/pathlib-inheritance.png

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[Eli Bendersky]

Eli Bendersky added the comment:

On Wed, Nov 27, 2013 at 6:21 AM, STINNER Victor wrote:

>
> STINNER Victor added the comment:
>
> Could you please attach the picture separatly?
>
>
Done

--

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[STINNER Victor]

STINNER Victor added the comment:

Could you please attach the picture separatly?

--
nosy: +haypo

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[Eli Bendersky]

Eli Bendersky added the comment:

Just in case it isn't: 
https://dl.dropboxusercontent.com/u/15602400/images/pathlib-inheritance.png

--

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[Antoine Pitrou]

Antoine Pitrou added the comment:

> Hopefully the image will be viewable in the code review tool

Apparently not :)

--

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[Eli Bendersky]

Eli Bendersky added the comment:

Attaching a new patch. Hopefully the image will be viewable in the code review 
tool

--
Added file: http://bugs.python.org/file32869/issue19799.2.patch

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[Antoine Pitrou]

Antoine Pitrou added the comment:

> Would you mind if I add a .png for the pathlib rst doc?

No, it sounds ok to me.

--

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[Eli Bendersky]

Changes by Eli Bendersky :


--
keywords: +patch
Added file: http://bugs.python.org/file32858/issue19799.initial.patch

___
Python tracker 

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

[issue19799] Clarifications for the documentation of pathlib

[Eli Bendersky]

New submission from Eli Bendersky:

Following up from Issue #19673; The initial patch clarifies the use cases of 
pure vs. concrete paths a bit and adds explicit signatures for the path class 
constructors (moving the construction discussion under the parent class).

Also, IMHO an inheritance diagram from PEP 428 is very relevant and useful. 
Would you mind if I add a .png for the pathlib rst doc?

--
assignee: eli.bendersky
components: Documentation
messages: 204477
nosy: eli.bendersky, pitrou
priority: normal
severity: normal
stage: patch review
status: open
title: Clarifications for the documentation of pathlib
type: enhancement
versions: Python 3.4, Python 3.5

___
Python tracker 

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