classification
Title: Minor change to https://docs.python.org/3.6/extending/building.html
Type: behavior Stage:
Components: Documentation Versions: Python 3.6
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: ArthurGoldberg, docs@python, rhettinger
Priority: normal Keywords:

Created on 2017-04-06 02:29 by ArthurGoldberg, last changed 2017-04-06 02:43 by rhettinger.

Messages (2)
msg291203 - (view) Author: Arthur Goldberg (ArthurGoldberg) Date: 2017-04-06 02:29
The core example on this page starts:

from distutils.core import setup, Extension

module1 = Extension('demo',
                    sources = ['demo.c'])

...

I suggest that 'sources = ['demo.c']' be changed to 'sources = ['demomodule.c']', because this would make the example consistent with https://docs.python.org/3.6/extending/extending.html which says: "Begin by creating a file spammodule.c. (Historically, if a module is called spam, the C file containing its implementation is called spammodule.c; ... )"
This minor change may help encourage this standard practice.

Arthur
msg291204 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2017-04-06 02:43
I'm not really sure that is a standard or even a best practice.  I think some people do it and some don't.
History
Date User Action Args
2017-04-06 02:43:59rhettingersetnosy: + rhettinger
messages: + msg291204
2017-04-06 02:29:36ArthurGoldbergcreate