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:
Mariatta
2017-11-21 15:04:15 -05:00
committed by Zachary Ware
parent 4b29e0458f
commit ffe559ef64
2 changed files with 65 additions and 6 deletions

View File

@@ -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
View 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