Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(12)

Side by Side Diff: Doc/library/packaging.compiler.rst

Issue 10639: reindent.py converts newlines to platform default
Patch Set: Created 8 years, 8 months ago
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
View unified diff | Download patch
« no previous file with comments | « Doc/library/os.rst ('k') | Doc/library/packaging.database.rst » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 :mod:`packaging.compiler` --- Compiler classes 1 :mod:`packaging.compiler` --- Compiler classes
2 ============================================== 2 ==============================================
3 3
4 .. module:: packaging.compiler 4 .. module:: packaging.compiler
5 :synopsis: Compiler classes to build C/C++ extensions or libraries. 5 :synopsis: Compiler classes to build C/C++ extensions or libraries.
6 6
7 7
8 This subpackage contains an abstract base class representing a compiler and 8 This subpackage contains an abstract base class representing a compiler and
9 concrete implementations for common compilers. The compiler classes should not 9 concrete implementations for common compilers. The compiler classes should not
10 be instantiated directly, but created using the :func:`new_compiler` factory 10 be instantiated directly, but created using the :func:`new_compiler` factory
(...skipping 350 matching lines...) Expand 10 before | Expand all | Expand 10 after
361 The following methods invoke stages in the build process. 361 The following methods invoke stages in the build process.
362 362
363 363
364 .. method:: CCompiler.compile(sources[, output_dir=None, macros=None, include _dirs=None, debug=0, extra_preargs=None, extra_postargs=None, depends=None]) 364 .. method:: CCompiler.compile(sources[, output_dir=None, macros=None, include _dirs=None, debug=0, extra_preargs=None, extra_postargs=None, depends=None])
365 365
366 Compile one or more source files. Generates object files (e.g. transforms a 366 Compile one or more source files. Generates object files (e.g. transforms a
367 :file:`.c` file to a :file:`.o` file.) 367 :file:`.c` file to a :file:`.o` file.)
368 368
369 *sources* must be a list of filenames, most likely C/C++ files, but in rea lity 369 *sources* must be a list of filenames, most likely C/C++ files, but in rea lity
370 anything that can be handled by a particular compiler and compiler class ( e.g. 370 anything that can be handled by a particular compiler and compiler class ( e.g.
371 an ``'msvc'`` compiler can handle resource files in *sources*). Return a list of 371 an ``'msvc'`` compiler` can handle resource files in *sources*). Return a list of
372 object filenames, one per source filename in *sources*. Depending on the 372 object filenames, one per source filename in *sources*. Depending on the
373 implementation, not all source files will necessarily be compiled, but all 373 implementation, not all source files will necessarily be compiled, but all
374 corresponding object filenames will be returned. 374 corresponding object filenames will be returned.
375 375
376 If *output_dir* is given, object files will be put under it, while retaini ng 376 If *output_dir* is given, object files will be put under it, while retaini ng
377 their original path component. That is, :file:`foo/bar.c` normally compil es to 377 their original path component. That is, :file:`foo/bar.c` normally compil es to
378 :file:`foo/bar.o` (for a Unix implementation); if *output_dir* is *build*, then 378 :file:`foo/bar.o` (for a Unix implementation); if *output_dir* is *build*, then
379 it would compile to :file:`build/foo/bar.o`. 379 it would compile to :file:`build/foo/bar.o`.
380 380
381 *macros*, if given, must be a list of macro definitions. A macro definiti on is 381 *macros*, if given, must be a list of macro definitions. A macro definiti on is
(...skipping 283 matching lines...) Expand 10 before | Expand all | Expand 10 after
665 | | extension depends on | | 665 | | extension depends on | |
666 +------------------------+--------------------------------+------------------ ---------+ 666 +------------------------+--------------------------------+------------------ ---------+
667 | *language* | extension language (i.e. | string | 667 | *language* | extension language (i.e. | string |
668 | | ``'c'``, ``'c++'``, | | 668 | | ``'c'``, ``'c++'``, | |
669 | | ``'objc'``). Will be detected | | 669 | | ``'objc'``). Will be detected | |
670 | | from the source extensions if | | 670 | | from the source extensions if | |
671 | | not provided. | | 671 | | not provided. | |
672 +------------------------+--------------------------------+------------------ ---------+ 672 +------------------------+--------------------------------+------------------ ---------+
673 673
674 .. [#] For values documented as lists, the given type is the type of each elemen t. 674 .. [#] For values documented as lists, the given type is the type of each elemen t.
OLDNEW
« no previous file with comments | « Doc/library/os.rst ('k') | Doc/library/packaging.database.rst » ('j') | no next file with comments »

RSS Feeds Recent Issues | This issue
This is Rietveld 894c83f36cb7+