.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.8.
.TH CYTHON "1" "January 2019" "Cython version 0.29.2" "User Commands"
.SH NAME
Cython \- compile Cython code (.pyx) into C to build a Python extension
.SH SYNOPSIS
.B cython
[\fI\,options\/\fR] \fI\,sourcefile.{pyx,py} \/\fR...
.SH DESCRIPTION
Cython (http://cython.org) is a compiler for code written in the
Cython language.  Cython is based on Pyrex by Greg Ewing.
.SH OPTIONS
.TP
\fB\-V\fR, \fB\-\-version\fR
Display version number of cython compiler
.TP
\fB\-l\fR, \fB\-\-create\-listing\fR
Write error messages to a listing file
.TP
\fB\-I\fR, \fB\-\-include\-dir\fR <directory>
Search for include files in named directory
(multiple include directories are allowed).
.TP
\fB\-o\fR, \fB\-\-output\-file\fR <filename>
Specify name of generated C file
.TP
\fB\-t\fR, \fB\-\-timestamps\fR
Only compile newer source files
.TP
\fB\-f\fR, \fB\-\-force\fR
Compile all source files (overrides implied \fB\-t\fR)
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Be verbose, print file names on multiple compilation
.TP
\fB\-p\fR, \fB\-\-embed\-positions\fR
If specified, the positions in Cython files of each
function definition is embedded in its docstring.
.TP
\fB\-\-cleanup\fR <level>
Release interned objects on python exit, for memory debugging.
Level indicates aggressiveness, default 0 releases nothing.
.TP
\fB\-w\fR, \fB\-\-working\fR <directory>
Sets the working directory for Cython (the directory modules
are searched from)
.TP
\fB\-\-gdb\fR
Output debug information for cygdb
.TP
\fB\-\-gdb\-outdir\fR <directory>
Specify gdb debug information output directory. Implies \fB\-\-gdb\fR.
.TP
\fB\-D\fR, \fB\-\-no\-docstrings\fR
Strip docstrings from the compiled module.
.TP
\fB\-a\fR, \fB\-\-annotate\fR
Produce a colorized HTML version of the source.
.TP
\fB\-\-annotate\-coverage\fR <cov.xml>
Annotate and include coverage information from cov.xml.
.TP
\fB\-\-line\-directives\fR
Produce #line directives pointing to the .pyx source
.TP
\fB\-\-cplus\fR
Output a C++ rather than C file.
.TP
\fB\-\-embed[=\fR<method_name>]
Generate a main() function that embeds the Python interpreter.
.TP
\fB\-2\fR
Compile based on Python\-2 syntax and code semantics.
.TP
\fB\-3\fR
Compile based on Python\-3 syntax and code semantics.
.TP
\fB\-\-3str\fR
Compile based on Python\-3 syntax and code semantics without
assuming unicode by default for string literals under Python 2.
.TP
\fB\-\-lenient\fR
Change some compile time errors to runtime errors to
improve Python compatibility
.TP
\fB\-\-capi\-reexport\-cincludes\fR
Add cincluded headers to any auto\-generated header files.
.TP
\fB\-\-fast\-fail\fR
Abort the compilation on the first error
.TP
\fB\-\-warning\-errors\fR, \fB\-Werror\fR
Make all warnings into errors
.TP
\fB\-\-warning\-extra\fR, \fB\-Wextra\fR
Enable extra warnings
.HP
\fB\-X\fR, \fB\-\-directive\fR <name>=<value>[,<name=value,...] Overrides a compiler directive
.HP
\fB\-E\fR, \fB\-\-compile\-time\-env\fR name=value[,<name=value,...] Provides compile time env like DEF would do.