Opened at 2014-10-29T01:13:11Z
Closed at 2015-07-29T00:49:45Z
#2328 closed defect (fixed)
consider adding "install the python-dev package" step to quickstart
Reported by: | daira | Owned by: | warner |
---|---|---|---|
Priority: | normal | Milestone: | 1.10.2 |
Component: | documentation | Version: | 1.10.0 |
Keywords: | quickstart docs build | Cc: | |
Launchpad Bug: |
Description
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.
Change History (8)
comment:1 Changed at 2014-10-29T01:13:22Z by daira
- Owner changed from marlowe to zooko
comment:2 Changed at 2015-06-15T04:24:54Z by warner
- Milestone changed from undecided to 1.11.0
comment:3 Changed at 2015-07-17T21:40:22Z by daira
- Milestone changed from 1.11.0 to 1.10.2
comment:4 Changed at 2015-07-21T16:06:03Z by warner
- Owner changed from zooko to warner
comment:5 Changed at 2015-07-21T17:13:30Z by zooko
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 ?
comment:6 Changed at 2015-07-21T19:35:46Z by daira
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.
comment:7 Changed at 2015-07-21T19:37:38Z by zooko
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.)
comment:8 Changed at 2015-07-29T00:49:45Z by Brian Warner <warner@…>
- Resolution set to fixed
- Status changed from new to closed
note this might be "python-devel" on redhat-derived systems (including Fedora)