Commit graph

13 commits

Author SHA1 Message Date
Josef Schlehofer
de13f35827
python: readme: drop from table of contents removed sections
Fixes: 446bc30c52 ("python: Remove
PKG_BUILD_DIR/PKG_UNPACK sections from readme")

Signed-off-by: Josef Schlehofer <pepe.schlehofer@gmail.com>
2020-01-27 14:26:07 +01:00
Jeffery To
dad0415215 python: Fix filespec example in readme
While the filespec example is technically correct, the more likely
scenario is that the files to be omitted would be inside of a package
subdirectory.

This adds an example_package directory into the example to illustrate
this case.

Signed-off-by: Jeffery To <jeffery.to@gmail.com>
2019-11-07 22:32:57 +08:00
Jeffery To
6f987b727f python: Add pypi.mk usage to readme
This adds documentation on including pypi.mk and its required/optional
variables to the Python section readme.

Signed-off-by: Jeffery To <jeffery.to@gmail.com>
2019-11-05 03:28:12 +08:00
Jeffery To
446bc30c52 python: Remove PKG_BUILD_DIR/PKG_UNPACK sections from readme
PKG_BUILD_DIR now takes variants into account
(openwrt/openwrt@e545fac8d9), so it should
not be necessary for Python packages to set these variables anymore.

Signed-off-by: Jeffery To <jeffery.to@gmail.com>
2019-11-05 02:20:37 +08:00
Jeffery To
4521b13477 python: Clarify README for Python 2-only libraries
This clarifies that Python 2-only libraries will have a Python 3 version
added, instead of being replaced by a Python 3 version (before the 2020
mass removal).

Signed-off-by: Jeffery To <jeffery.to@gmail.com>
2019-06-19 21:09:10 +08:00
Alexandru Ardelean
d607b4da7b lang: python: readme: document mechanism for corner-case python[3]-package.mk location
After some thinking over this, documenting this behavior makes sense
versus adding some functionst to handle this.
There is some validity/use-cases where some users may want to reference
a python[3]-package.mk from some other location as well as have the
flexibility to change it (locally). One example can be when the local
`packages` is renamed to something else.

This does not fall on the responsibility of the Python maintainers, but
it can be documented.

Signed-off-by: Alexandru Ardelean <ardeleanalex@gmail.com>
2019-05-28 21:38:01 +03:00
Eneas U de Queiroz
36d0c59e99
python: README.md: adjust recursive dep text, misc
Adding the conditionals to DEPENDS should not cause circular
dependencies any more.  This adjusts the text to point out that it used
to be a problem, and if it happens again, one should open an issue.

Also, some spotted trivial errors were fixed.

Signed-off-by: Eneas U de Queiroz <cote2004-github@yahoo.com>
2019-05-20 16:17:30 -03:00
Alexandru Ardelean
dab8f49f82 lang/python/README.md: add note about use in other packages feeds
By popular demand, via:
   https://github.com/openwrt/packages/issues/8892#issuecomment-489992926

Signed-off-by: Alexandru Ardelean <ardeleanalex@gmail.com>
2019-05-08 14:49:04 +03:00
Rosen Penev
efbcf695b8
Merge pull request #8786 from commodo/readme-encodings-update
python/README.md: fix note about python[3]-codecs
2019-05-03 12:45:12 -07:00
Alexandru Ardelean
d0fcfc52a1 python/README.md: fix note about python[3]-codecs
The note was note correct when mentioning encodings vs python[3]-codecs.
This change fixes this confusion.

Signed-off-by: Alexandru Ardelean <ardeleanalex@gmail.com>
2019-05-03 22:34:51 +03:00
Jeffery To
3a036339e8 python/README: Add deprecation notice / schedule
This describes the proposal outlined in #8520, with a few
additions/modifications:

* Describes the handling of the Python 2 interpreter

* Allows for normal updates of Python 2 libraries that share the same
  Makefile as their Python 3 version

* Mass removal event has a name

Supersedes #8788.

Signed-off-by: Jeffery To <jeffery.to@gmail.com>
2019-05-04 02:13:11 +08:00
Jeffery To
f16064783c python: Update readme
This adds more details on the PYTHON[3]_PKG_SETUP_* variables, the
filespec format, and the build/install processes in general.

Signed-off-by: Jeffery To <jeffery.to@gmail.com>
2019-04-08 21:21:21 +08:00
Alexandru Ardelean
77bce0c672 lang/python/README.md: add doc describing the lang/python subtree
It was a semi-popular request a while back that I put off for a while.
Here's a quick doc.
I'll update it later as things change and I don't forget.
It also lets other people update if something is wrong.

Signed-off-by: Alexandru Ardelean <ardeleanalex@gmail.com>
2019-01-08 17:38:16 +02:00