#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

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

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

In 4bb12887f4952a20e1373f75c85de6dd5fd79e87/trunk:

quickstart: Mention python-dev package for Python.h

Closes ticket:2328.

Note: See TracTickets for help on using tickets.