consider adding "install the python-dev package" step to quickstart #2328

Closed
opened 2014-10-29 01:13:11 +00:00 by daira · 5 comments
daira commented 2014-10-29 01:13:11 +00:00
Owner

When building Tahoe-LAFS on Unix-like platforms without the python-dev package installed, the error is typically:

fatal error: Python.h: No such file or directory

I know zooko wants to minimize the complexity of the quickstart instructions, but since this error can be fixed in many cases by running "sudo apt-get install python-dev" (or equivalent for other package managers), we might consider mentioning that in quickstart.

When building Tahoe-LAFS on Unix-like platforms without the python-dev package installed, the error is typically: ``` fatal error: Python.h: No such file or directory ``` I know zooko wants to minimize the complexity of the quickstart instructions, but since this error can be fixed in many cases by running "sudo apt-get install python-dev" (or equivalent for other package managers), we might consider mentioning that in quickstart.
tahoe-lafs added the
documentation
normal
defect
1.10.0
labels 2014-10-29 01:13:11 +00:00
tahoe-lafs added this to the undecided milestone 2014-10-29 01:13:11 +00:00
warner modified the milestone from undecided to 1.11.0 2015-06-15 04:24:54 +00:00
tahoe-lafs modified the milestone from 1.11.0 to 1.10.2 2015-07-17 21:40:22 +00:00

note this might be "python-devel" on redhat-derived systems (including Fedora)

note this might be "python-devel" on redhat-derived systems (including Fedora)
zooko was unassigned by warner 2015-07-21 16:06:03 +00:00
warner self-assigned this 2015-07-21 16:06:03 +00:00

My objection to this is that it is platform-specific, i.e. it will make Windows users think that the quickstart doesn't apply to them. On the other hand, people keep telling me that the whole idea of a platform-portable quickstart is impossible and/or not needed, so maybe instead of adding "python-dev" to the quickstart we should rm the quickstart and redirect all links that used to go to the quickstart to https://tahoe-lafs.org/trac/tahoe-lafs/wiki/Installation ?

My objection to this is that it is platform-specific, i.e. it will make Windows users think that the quickstart doesn't apply to them. On the other hand, people keep telling me that the whole idea of a platform-portable quickstart is impossible and/or not needed, so maybe instead of adding "python-dev" to the quickstart we should rm the quickstart and redirect all links that used to go to the quickstart to <https://tahoe-lafs.org/trac/tahoe-lafs/wiki/Installation> ?
daira commented 2015-07-21 19:35:46 +00:00
Author
Owner

Removing quickstart would be out-of-scope for 1.10.2. Adding a note about python-dev or python-devel would not be. I think that an explicit "This is not needed on Windows." would be sufficient to avoid the impression that quickstart doesn't apply to Windows users.

Removing quickstart would be out-of-scope for 1.10.2. Adding a note about python-dev or python-devel would not be. I think that an explicit "This is not needed on Windows." would be sufficient to avoid the impression that quickstart doesn't apply to Windows users.

Bleh, I give it -0. Also remember that python-dev/python-devel is not needed if the C-containing deps are already installed or if binary eggs of them are available.

(-0 means go ahead, and just endure my angry stares stabbing into your back as you do it.)

Bleh, I give it -0. Also remember that `python-dev`/`python-devel` is not needed if the C-containing deps are already installed or if binary eggs of them are available. (-0 means go ahead, and just endure my angry stares stabbing into your back as you do it.)
Brian Warner <warner@lothar.com> commented 2015-07-29 00:49:45 +00:00
Author
Owner

In /tahoe-lafs/trac-2024-07-25/commit/4bb12887f4952a20e1373f75c85de6dd5fd79e87:

quickstart: Mention python-dev package for Python.h

Closes ticket:2328.
In [/tahoe-lafs/trac-2024-07-25/commit/4bb12887f4952a20e1373f75c85de6dd5fd79e87](/tahoe-lafs/trac-2024-07-25/commit/4bb12887f4952a20e1373f75c85de6dd5fd79e87): ``` quickstart: Mention python-dev package for Python.h Closes ticket:2328. ```
tahoe-lafs added the
fixed
label 2015-07-29 00:49:45 +00:00
Sign in to join this conversation.
No Milestone
No Assignees
3 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Reference: tahoe-lafs/trac-2024-07-25#2328
No description provided.