diff options
| author | Phillip Lord | 2021-11-03 11:03:00 +0000 |
|---|---|---|
| committer | Phillip Lord | 2021-11-03 11:03:00 +0000 |
| commit | a16e66c68138801ea6d0de49d6889db1ce17c6fb (patch) | |
| tree | b54dc3fe7d397362c3f12bfe91a5a349ea2e7043 /admin | |
| parent | 6ab6b2f1c81148f4c77e2bac8d81ae7d6b6090c0 (diff) | |
| download | emacs-a16e66c68138801ea6d0de49d6889db1ce17c6fb.tar.gz emacs-a16e66c68138801ea6d0de49d6889db1ce17c6fb.zip | |
Clarify build environment
* admin/nt/dist-build/README-scripts:
Diffstat (limited to 'admin')
| -rw-r--r-- | admin/nt/dist-build/README-scripts | 27 |
1 files changed, 17 insertions, 10 deletions
diff --git a/admin/nt/dist-build/README-scripts b/admin/nt/dist-build/README-scripts index 26c3d1df72c..6b1adbe03e1 100644 --- a/admin/nt/dist-build/README-scripts +++ b/admin/nt/dist-build/README-scripts | |||
| @@ -3,6 +3,15 @@ Distribution Build Scripts for Windows | |||
| 3 | 3 | ||
| 4 | The scripts are used to build the binary distribution zip files for windows. | 4 | The scripts are used to build the binary distribution zip files for windows. |
| 5 | 5 | ||
| 6 | Environment | ||
| 7 | ----------- | ||
| 8 | |||
| 9 | A full installation of msys2 is required along for the build. The | ||
| 10 | various dependencies of Emacs need to be installed also. These change | ||
| 11 | over time, but are listed in build-deps-zips.py. | ||
| 12 | |||
| 13 | |||
| 14 | |||
| 6 | File System Organization | 15 | File System Organization |
| 7 | ------------------------ | 16 | ------------------------ |
| 8 | 17 | ||
| @@ -22,12 +31,12 @@ organized according to branches. | |||
| 22 | 31 | ||
| 23 | A checkout out of the master branch of the Emacs git repository. | 32 | A checkout out of the master branch of the Emacs git repository. |
| 24 | 33 | ||
| 25 | ~/emacs-build/git/emacs-$branch | 34 | ~/emacs-build/git/emacs-$major-version |
| 26 | 35 | ||
| 27 | A worktree of the git repository containing the current release | 36 | A worktree of the git repository containing the current release |
| 28 | branch. This has to be created by hand. | 37 | branch. This has to be created by hand. |
| 29 | 38 | ||
| 30 | ~/emacs-build/git/emacs-$version | 39 | ~/emacs-build/git/emacs-$release-version |
| 31 | 40 | ||
| 32 | A branch of the git repository containing the last release. The | 41 | A branch of the git repository containing the last release. The |
| 33 | build-zips.sh file will create this for you. | 42 | build-zips.sh file will create this for you. |
| @@ -67,8 +76,8 @@ uploaded. | |||
| 67 | Build Process | 76 | Build Process |
| 68 | ------------- | 77 | ------------- |
| 69 | 78 | ||
| 70 | For each major version | 79 | |
| 71 | ---------------------- | 80 | ### For each major version |
| 72 | 81 | ||
| 73 | The dependencies files need to be created. This can be around the time | 82 | The dependencies files need to be created. This can be around the time |
| 74 | of the pre-tests, then used for all releases of that version, to | 83 | of the pre-tests, then used for all releases of that version, to |
| @@ -92,8 +101,7 @@ files will be created in ~/emacs-upload from where they can be signed | |||
| 92 | and uploaded with `gnupload`. | 101 | and uploaded with `gnupload`. |
| 93 | 102 | ||
| 94 | 103 | ||
| 95 | For snapshots from Master | 104 | ### For snapshots from Master |
| 96 | ------------------------- | ||
| 97 | 105 | ||
| 98 | Snapshots are generally created from master when there is a release | 106 | Snapshots are generally created from master when there is a release |
| 99 | branch on which a release has already been created. At this point, | 107 | branch on which a release has already been created. At this point, |
| @@ -114,8 +122,7 @@ used. | |||
| 114 | Now, run `build-zips.sh -s` to build a snapshot release. | 122 | Now, run `build-zips.sh -s` to build a snapshot release. |
| 115 | 123 | ||
| 116 | 124 | ||
| 117 | For snapshots from a Release Branch | 125 | ### For snapshots from a Release Branch |
| 118 | ----------------------------------- | ||
| 119 | 126 | ||
| 120 | Snapshots can be built from a release branch; this is really only | 127 | Snapshots can be built from a release branch; this is really only |
| 121 | useful before a pre-test has happened. | 128 | useful before a pre-test has happened. |
| @@ -127,8 +134,8 @@ version number must be added to the command line with `build-zips.sh | |||
| 127 | the version (e.g emacs-27-2019-12-26.zip) rather than than the Emacs | 134 | the version (e.g emacs-27-2019-12-26.zip) rather than than the Emacs |
| 128 | version (e.g emacs-27.0.50.zip). | 135 | version (e.g emacs-27.0.50.zip). |
| 129 | 136 | ||
| 130 | For snapshots from another branch | 137 | |
| 131 | --------------------------------- | 138 | ### For snapshots from another branch |
| 132 | 139 | ||
| 133 | Snapshots can be build from any other branch. There is rarely a need | 140 | Snapshots can be build from any other branch. There is rarely a need |
| 134 | to do this, except where some significant, wide-ranging feature is | 141 | to do this, except where some significant, wide-ranging feature is |