kdevelop/kdev-python/README.packagers

0001 This information is intended for package mantainers.
0002
0003 First of all, thanks for packaging this software! If you encounter
0004 any issues which you think should be fixed upstream, please report
0005 a bug or send a patch, I'll be happy to accept it if it makes sense.
0006
0007 Notes
0008 =====
0009 This is a collection of notes about what might be of interest,
0010 related to packaging.
0011
0012 Supported Python versions
0013 -------------------------
0014 Python 2 support was dropped, and we just support the latest few minor
0015 releases of Python 3 right now.
0016
0017 NOTE: Since we use the upstream CPython parser, compiling against an old
0018  version will restrict kdev-python's syntax support to that version.
0019 This will cause false-positive warnings to the user and failed type-inference
0020  for newer Python code. Then we get bug reports upstream for features that
0021  were already implemented.
0022
0023 Please compile against the newest supported version unless there is no other
0024  possible alternative.
0025
0026 Python fork
0027 -----------
0028 This branch, which contains the python3 version of kdev-python, does no longer
0029 contain a fork of python. Instead, it links against your system's python.
0030 Python is both a build- and a runtime dependency of this program.
0031
0032 documentation_data directory
0033 ----------------------------
0034 This directory does NOT contain user documentation for the plugin.
0035 It MUST be packaged together with the program, as it contains runtime
0036 data which is necessary for the program to work correctly (such as
0037 representations of python's built-in data types, which are then read
0038 by the parser etc.).
0039
0040 Licensing notes
0041 ---------------
0042 The following files are not copyrighted:
0043 Everything in duchain/tests/data/
0044 Everything in documentation_files/
0045 Everything in correction_files/
0046 Everything in app_templates/
0047 example_ast.py