summaryrefslogtreecommitdiff
path: root/admin/nt/dist-build
diff options
context:
space:
mode:
authorPhillip Lord <phillip.lord@russet.org.uk>2021-11-03 11:03:00 +0000
committerPhillip Lord <phillip.lord@russet.org.uk>2021-11-03 11:03:00 +0000
commita16e66c68138801ea6d0de49d6889db1ce17c6fb (patch)
treeb54dc3fe7d397362c3f12bfe91a5a349ea2e7043 /admin/nt/dist-build
parent6ab6b2f1c81148f4c77e2bac8d81ae7d6b6090c0 (diff)
downloademacs-a16e66c68138801ea6d0de49d6889db1ce17c6fb.tar.gz
emacs-a16e66c68138801ea6d0de49d6889db1ce17c6fb.tar.bz2
emacs-a16e66c68138801ea6d0de49d6889db1ce17c6fb.zip
Clarify build environment
* admin/nt/dist-build/README-scripts:
Diffstat (limited to 'admin/nt/dist-build')
-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
The scripts are used to build the binary distribution zip files for windows.
+Environment
+-----------
+
+A full installation of msys2 is required along for the build. The
+various dependencies of Emacs need to be installed also. These change
+over time, but are listed in build-deps-zips.py.
+
+
+
File System Organization
------------------------
@@ -22,12 +31,12 @@ organized according to branches.
A checkout out of the master branch of the Emacs git repository.
-~/emacs-build/git/emacs-$branch
+~/emacs-build/git/emacs-$major-version
A worktree of the git repository containing the current release
branch. This has to be created by hand.
-~/emacs-build/git/emacs-$version
+~/emacs-build/git/emacs-$release-version
A branch of the git repository containing the last release. The
build-zips.sh file will create this for you.
@@ -67,8 +76,8 @@ uploaded.
Build Process
-------------
-For each major version
-----------------------
+
+### For each major version
The dependencies files need to be created. This can be around the time
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
and uploaded with `gnupload`.
-For snapshots from Master
--------------------------
+### For snapshots from Master
Snapshots are generally created from master when there is a release
branch on which a release has already been created. At this point,
@@ -114,8 +122,7 @@ used.
Now, run `build-zips.sh -s` to build a snapshot release.
-For snapshots from a Release Branch
------------------------------------
+### For snapshots from a Release Branch
Snapshots can be built from a release branch; this is really only
useful before a pre-test has happened.
@@ -127,8 +134,8 @@ version number must be added to the command line with `build-zips.sh
the version (e.g emacs-27-2019-12-26.zip) rather than than the Emacs
version (e.g emacs-27.0.50.zip).
-For snapshots from another branch
----------------------------------
+
+### For snapshots from another branch
Snapshots can be build from any other branch. There is rarely a need
to do this, except where some significant, wide-ranging feature is