Fossil SCM

Add explanation of how to use this script (and how not to break the build)

danshearer 2021-03-17 12:38 trunk
Commit e11efff8e4de0aefcfb2a78b7c985374114e5439014aefee09c073e469d27cf3
1 file changed +18 -7
+18 -7
--- src/makemake.tcl
+++ src/makemake.tcl
@@ -1,23 +1,34 @@
11
#!/usr/bin/tclsh
22
#
3
-# Run this Tcl script to generate the various makefiles for a variety
4
-# of platforms. Files generated include:
3
+# ### Run this Tcl script EVERY time you modify it in any way! ###
4
+#
5
+# This Tcl script generates make files for various platforms. The makefiles
6
+# then need to be committed.
7
+#
8
+# If you modify this file then:
9
+#
10
+# 1. cd src; tclsh makemake.tcl
11
+#
12
+# 2. if errors are reported, fix them and go to step 1
13
+#
14
+# 3. if "fossil diff" reports changes in any of the generated
15
+# files, commit the changed files to the repo
16
+#
17
+# Files generated include:
518
#
619
# src/main.mk # makefile for all unix systems
720
# win/Makefile.mingw # makefile for mingw on windows
821
# win/Makefile.* # makefiles for other windows compilers
922
#
10
-# Run this script while in the "src" subdirectory. Like this:
11
-#
12
-# tclsh makemake.tcl
13
-#
1423
# Add new source files by listing the files (without their .c suffix)
1524
# in the "src" variable. Add new resource files to the "extra_files"
1625
# variable. There are other variables that you can alter, down to
1726
# the "STOP HERE" comment. The stuff below "STOP HERE" should rarely need
18
-# to change.
27
+# to change. After modification, go to step 1 above.
28
+#
29
+# Delete unused source files in the "src" variable, then go to step 1 above.
1930
#
2031
#############################################################################
2132
2233
# Basenames of all source files that get preprocessed using
2334
# "translate" and "makeheaders". To add new C-language source files to the
2435
--- src/makemake.tcl
+++ src/makemake.tcl
@@ -1,23 +1,34 @@
1 #!/usr/bin/tclsh
2 #
3 # Run this Tcl script to generate the various makefiles for a variety
4 # of platforms. Files generated include:
 
 
 
 
 
 
 
 
 
 
 
 
 
5 #
6 # src/main.mk # makefile for all unix systems
7 # win/Makefile.mingw # makefile for mingw on windows
8 # win/Makefile.* # makefiles for other windows compilers
9 #
10 # Run this script while in the "src" subdirectory. Like this:
11 #
12 # tclsh makemake.tcl
13 #
14 # Add new source files by listing the files (without their .c suffix)
15 # in the "src" variable. Add new resource files to the "extra_files"
16 # variable. There are other variables that you can alter, down to
17 # the "STOP HERE" comment. The stuff below "STOP HERE" should rarely need
18 # to change.
 
 
19 #
20 #############################################################################
21
22 # Basenames of all source files that get preprocessed using
23 # "translate" and "makeheaders". To add new C-language source files to the
24
--- src/makemake.tcl
+++ src/makemake.tcl
@@ -1,23 +1,34 @@
1 #!/usr/bin/tclsh
2 #
3 # ### Run this Tcl script EVERY time you modify it in any way! ###
4 #
5 # This Tcl script generates make files for various platforms. The makefiles
6 # then need to be committed.
7 #
8 # If you modify this file then:
9 #
10 # 1. cd src; tclsh makemake.tcl
11 #
12 # 2. if errors are reported, fix them and go to step 1
13 #
14 # 3. if "fossil diff" reports changes in any of the generated
15 # files, commit the changed files to the repo
16 #
17 # Files generated include:
18 #
19 # src/main.mk # makefile for all unix systems
20 # win/Makefile.mingw # makefile for mingw on windows
21 # win/Makefile.* # makefiles for other windows compilers
22 #
 
 
 
 
23 # Add new source files by listing the files (without their .c suffix)
24 # in the "src" variable. Add new resource files to the "extra_files"
25 # variable. There are other variables that you can alter, down to
26 # the "STOP HERE" comment. The stuff below "STOP HERE" should rarely need
27 # to change. After modification, go to step 1 above.
28 #
29 # Delete unused source files in the "src" variable, then go to step 1 above.
30 #
31 #############################################################################
32
33 # Basenames of all source files that get preprocessed using
34 # "translate" and "makeheaders". To add new C-language source files to the
35

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button