Documentation should state clearly the differences between "pysetup run install_dist" and "pysetup install"

[alexis]

BPO	14949
Nosy	@ncoghlan, @tarekziade, @merwok

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = 'https://github.com/merwok'
closed_at = <Date 2014-03-12.10:11:45.897>
created_at = <Date 2012-05-29.10:22:39.024>
labels = ['easy']
title = 'Documentation should state clearly the differences between "pysetup run install_dist" and "pysetup install"'
updated_at = <Date 2014-03-12.10:11:45.895>
user = 'https://bugs.python.org/alexis'

bugs.python.org fields:

activity = <Date 2014-03-12.10:11:45.895>
actor = 'eric.araujo'
assignee = 'eric.araujo'
closed = True
closed_date = <Date 2014-03-12.10:11:45.897>
closer = 'eric.araujo'
components = ['Distutils2']
creation = <Date 2012-05-29.10:22:39.024>
creator = 'alexis'
dependencies = []
files = []
hgrepos = []
issue_num = 14949
keywords = ['easy']
message_count = 5.0
messages = ['161867', '161883', '161884', '161886', '213237']
nosy_count = 4.0
nosy_names = ['ncoghlan', 'tarek', 'eric.araujo', 'alexis']
pr_nums = []
priority = 'normal'
resolution = 'out of date'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue14949'
versions = ['Python 3.3']

[alexis]

The packaging tutorial currently talks about "pysetup run install_dist" and "pysetup install" which aren't doing the same thing: one fetches the dependencies while the other doesn't.

This should be stated clearly.

[merwok]

That’s the difference between actions and commands, which people always understand very well when I explain it. I don’t remember if I already have written something in my big doc patch (bpo-12779); if you want I can check tonight and tell you if I did it or if you can do it.

[merwok]

See also bpo-13160.

[alexis]

That would be helpful yep. I can add this in the docs if you've not done it already.

[merwok]

This is now obsolete. The new packaging guide will hopefully make a clear distinction between “setup.py install” and “pip install”, and future developments may altogether remove “setup.py install”.