aboutsummaryrefslogtreecommitdiffstats
path: root/admin
diff options
context:
space:
mode:
authorPhillip Lord2021-11-03 11:03:00 +0000
committerPhillip Lord2021-11-03 11:03:00 +0000
commita16e66c68138801ea6d0de49d6889db1ce17c6fb (patch)
treeb54dc3fe7d397362c3f12bfe91a5a349ea2e7043 /admin
parent6ab6b2f1c81148f4c77e2bac8d81ae7d6b6090c0 (diff)
downloademacs-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-scripts27
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
4The scripts are used to build the binary distribution zip files for windows. 4The scripts are used to build the binary distribution zip files for windows.
5 5
6Environment
7-----------
8
9A full installation of msys2 is required along for the build. The
10various dependencies of Emacs need to be installed also. These change
11over time, but are listed in build-deps-zips.py.
12
13
14
6File System Organization 15File System Organization
7------------------------ 16------------------------
8 17
@@ -22,12 +31,12 @@ organized according to branches.
22 31
23A checkout out of the master branch of the Emacs git repository. 32A 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
27A worktree of the git repository containing the current release 36A worktree of the git repository containing the current release
28branch. This has to be created by hand. 37branch. This has to be created by hand.
29 38
30~/emacs-build/git/emacs-$version 39~/emacs-build/git/emacs-$release-version
31 40
32A branch of the git repository containing the last release. The 41A branch of the git repository containing the last release. The
33build-zips.sh file will create this for you. 42build-zips.sh file will create this for you.
@@ -67,8 +76,8 @@ uploaded.
67Build Process 76Build Process
68------------- 77-------------
69 78
70For each major version 79
71---------------------- 80### For each major version
72 81
73The dependencies files need to be created. This can be around the time 82The dependencies files need to be created. This can be around the time
74of the pre-tests, then used for all releases of that version, to 83of 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
92and uploaded with `gnupload`. 101and uploaded with `gnupload`.
93 102
94 103
95For snapshots from Master 104### For snapshots from Master
96-------------------------
97 105
98Snapshots are generally created from master when there is a release 106Snapshots are generally created from master when there is a release
99branch on which a release has already been created. At this point, 107branch on which a release has already been created. At this point,
@@ -114,8 +122,7 @@ used.
114Now, run `build-zips.sh -s` to build a snapshot release. 122Now, run `build-zips.sh -s` to build a snapshot release.
115 123
116 124
117For snapshots from a Release Branch 125### For snapshots from a Release Branch
118-----------------------------------
119 126
120Snapshots can be built from a release branch; this is really only 127Snapshots can be built from a release branch; this is really only
121useful before a pre-test has happened. 128useful before a pre-test has happened.
@@ -127,8 +134,8 @@ version number must be added to the command line with `build-zips.sh
127the version (e.g emacs-27-2019-12-26.zip) rather than than the Emacs 134the version (e.g emacs-27-2019-12-26.zip) rather than than the Emacs
128version (e.g emacs-27.0.50.zip). 135version (e.g emacs-27.0.50.zip).
129 136
130For snapshots from another branch 137
131--------------------------------- 138### For snapshots from another branch
132 139
133Snapshots can be build from any other branch. There is rarely a need 140Snapshots can be build from any other branch. There is rarely a need
134to do this, except where some significant, wide-ranging feature is 141to do this, except where some significant, wide-ranging feature is