Document how to update source dependencies. (GH-3)
Update the README with the instructions, and convert to reST. Also adds download links for the sources.
This commit is contained in:
@@ -1,6 +0,0 @@
|
|||||||
# cpython-source-deps
|
|
||||||
Source for packages that the cpython build process depends on
|
|
||||||
|
|
||||||
It is currently expected that this will only be useful on Windows,
|
|
||||||
and in any case you should never need to clone this repository
|
|
||||||
unless you are updating its contents.
|
|
||||||
65
README.rst
Normal file
65
README.rst
Normal file
@@ -0,0 +1,65 @@
|
|||||||
|
cpython-source-deps
|
||||||
|
===================
|
||||||
|
|
||||||
|
Source for packages that the CPython build process depends on.
|
||||||
|
|
||||||
|
It is currently expected that this will only be useful on Windows,
|
||||||
|
and in any case you should never need to clone this repository
|
||||||
|
unless you are updating its contents.
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
Updating Source Dependencies
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
The procedure for updating the different source dependencies are similar. Below
|
||||||
|
is an example for updating SQLite::
|
||||||
|
|
||||||
|
|
||||||
|
1. Fork and clone this repository.
|
||||||
|
|
||||||
|
2. Checkout a new branch off the ``sqlite`` branch. Assuming this repo is set
|
||||||
|
as your ``upstream``::
|
||||||
|
|
||||||
|
git checkout -b <branch-name>-sqlite upstream/sqlite
|
||||||
|
|
||||||
|
3. Download SQLite source from `sqlite.org <https://www.sqlite.org>`_.
|
||||||
|
|
||||||
|
4. Unzip it to the branch checked out in step 2.
|
||||||
|
|
||||||
|
5. Commit and push the changes.
|
||||||
|
|
||||||
|
6. Create the PR, with ``sqlite`` as the base branch.
|
||||||
|
|
||||||
|
Once the PR has been merged, tag the commit as ``sqlite-<full version to be used in CPython's PCbuild/get_externals.bat>``.
|
||||||
|
|
||||||
|
For updating ``sqlite``, ``bzip2``, ``xz``, and ``zlib``, follow the above
|
||||||
|
instructions.
|
||||||
|
|
||||||
|
For ``tcl`` and ``tk``, after step 5, `cpython-bin-deps
|
||||||
|
<https://github.com/python/cpython-bin-deps/>`_
|
||||||
|
needs to be updated.
|
||||||
|
|
||||||
|
For ``openssl``, step 5 will be more complicated :)
|
||||||
|
|
||||||
|
|
||||||
|
Download links
|
||||||
|
--------------
|
||||||
|
|
||||||
|
- ``sqlite``: https://www.sqlite.org/download.html
|
||||||
|
- ``bzip2``: http://www.bzip.org/downloads.html
|
||||||
|
- ``xz``: https://tukaani.org/xz/
|
||||||
|
- ``zlib``: https://zlib.net/
|
||||||
|
- ``tcl``/``tk``: https://tcl.tk/software/tcltk/download.html
|
||||||
|
- ``openssl``: https://www.openssl.org/source/
|
||||||
|
|
||||||
|
|
||||||
|
Tagging the commit
|
||||||
|
------------------
|
||||||
|
|
||||||
|
Using the ``sqlite`` branch as an example::
|
||||||
|
|
||||||
|
git checkout -b sqlite-tag upstream/sqlite
|
||||||
|
git tag sqlite-3.21.0.0 # replace 3.21.0.0 with the correct version.
|
||||||
|
git push --tags upstream
|
||||||
|
|
||||||
Reference in New Issue
Block a user