Skip to content

Commit e0c5353

Browse files
LewisPringleLewisPringle
committed
release notes
1 parent 3e3840e commit e0c5353

File tree

1 file changed

+77
-105
lines changed

1 file changed

+77
-105
lines changed

‎Release-Notes.md‎

Lines changed: 77 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -7,36 +7,35 @@ especially those they need to be aware of when upgrading.
77

88
## History
99

10+
### 3.0d21 {2025-07-28} {[diff](../../compare/3.0d20...3.0d21)}
1011

11-
## 3.0d21 PREP
12-
13-
### major change
12+
#### TLDR
1413
- Configure / build system now much more driven off pkgconfig files
1514
- stroika-frameworks.pc has little to it but a requires of stroika-foundation.pc
1615
- stroika-foundation.pc has all the requires on third party components it is built off (e.g xerces, boost, libcurl, etc)
1716
and depends on stroika-platform
1817
- stroika-platform.pc contains all the 'native platform' library depenencies, and C #defines etc for std c++ libraries, etc.
1918

19+
#### Upgrade Notes (3.0d20 to 3.0d21)
2020

21-
### UPGRADE NOTES
22-
upgrade notes
23-
24-
in makefiles
21+
##### in makefiles
2522

26-
lose deprecated
23+
- lose deprecated
24+
~~~
2725
include $(StroikaRoot)ScriptsLib/Makefile-Common.mk
26+
~~~
2827

29-
lose
28+
- lose
29+
~~~
3030
ifneq ($(CONFIGURATION),)
3131
-include $(StroikaRoot)IntermediateFiles/$(CONFIGURATION)/Configuration.mk
3232
endif
33-
33+
~~~
3434

3535
replacigin with if needed
3636
include $(StroikaRoot)ScriptsLib/SharedMakeVariables-Default.mk
3737

38-
39-
move to SrcDir/ObjDir to top of file, for example:
38+
- move to SrcDir/ObjDir to top of file, for example:
4039

4140
export TOP_ROOT=$(abspath ../../)/
4241
StroikaRoot := $(TOP_ROOT)ThirdPartyComponents/Stroika/StroikaRoot/
@@ -53,7 +52,6 @@ include $(StroikaRoot)ScriptsLib/SharedMakeVariables-Default.mk
5352
preferable after define of Objs
5453

5554

56-
5755
-LinkerArgs_LibDependencies += -lexiv2 -lexpat -lz
5856
+LDFLAGS += -lexiv2 -lexpat -lz
5957

@@ -70,6 +68,72 @@ with
7068
#include "Stroika/Current-Version.h"
7169

7270

71+
#### Change Details
72+
73+
- Documentation
74+
- Minor Changes
75+
- Build System
76+
- Docker
77+
- changed dockerfiles to always install python3 - not conditionally (cuz switching more of scripts over from perl to python, I think)
78+
- get openssh to autostart on dev containers
79+
- lose no longer needed [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]'Tls12,Tls13' from windows
80+
Dockerfiles
81+
- VS_17_14_8
82+
- use msys 2025-06-22 release
83+
- allow ACTUAL_RUN_CMD arg to RunInDockerEnvironemt script, and use to add start-stroika-dev-containers to makefile, and have them auto-restart on reboot - autostarting ssh
84+
85+
- Makefiles
86+
- get rid of commented out/deprecated makefile variables: StroikaFoundationSupportLibs PKG_CONFIG_STATIC_COMPONENTS, and TPP_PKG_CONFIG_PATH
87+
- Comment out STRIP_INCLUDE_COMPILER_FLAGS since unused and appears obosolete (Makefile-Common.mk)
88+
- moved SharedMakeVariables-Default.mk StroikaLibDir to be (StroikaPlatformTargetBuildDir)lib/ (added lib/)
89+
- Big makefile refactoring - deprecating ScriptsLib/Makefile-Common.mk - just include SharedMakeVariables-Default.mk instead;
90+
- ObjDir/SrcDir declared at top of file
91+
- cleanup WIN_USE_PROGRAM_DATABASE (largely unused anymore) feature to use StroikaLibDir name so works with new location of stroika libraries
92+
- MSYS2_ARG_CONV_EXCL BWA still needed (docuemnted why) - needed more complex BWA in ScriptsLib/ApplyConfiguration fpr MSYS2_ARG_CONV_EXCL issue
93+
- lose extra no longer needed include IntermediateFiles//Configuration.mk in each makefile - now done in ScriptsLib/SharedMakeVariables-Default.mk
94+
- moved ThirdPartyComponents builds output to StroikaPlatformTargetBuildDir (one level up) - so more like standard unix --prefix and stroika libs all together with those of other libraries (for more use of .pc files)
95+
(instead of $(StroikaRoot)Builds/$(CONFIGURATION))
96+
- better docs/warnings in ScriptsLib/SharedBuildRules-Default.mk
97+
- moved SED makefile variable into ScriptsLib/SharedMakeVariables-Default.mk
98+
- added TOP_ROOT to SharedMakeVariables-Default.mk
99+
- minor cleanup to Tests/Makefile-Test-Template.mk
100+
- use DETECTED_HOST_OS MSYS insetad of BuildPlatform is VisualStudio for one BWA specific to MSYS
101+
- lose obsolete LinkerArgs_StroikaDependentLibDependencies from SharedMakeVariables-Default.mk
102+
- cleanups to DEFAULT_LINK_LINE makefile macro (e.g LinkerArgs_ExtraSuffix changes)
103+
- cleanup makefile reacent changes (and lose deprecated LinkerArgs_LibDependencies from SharedMakeVariables.mk)
104+
- more makefile cleanups: SharedMakeVariables-Default.mk - lose deprecated LinkerArgs_LibDependencies, and cleanup RC_FLAGS/MIDL_FLAGS, StroikaRoot_MIXED cleanup
105+
- lose PKG_CONFIG_STROIKA_DEPENDS_ON - from ApplyConfiguraiton/Configuration.mk etc - largely unused(done via pkgconfig)
106+
- progress on new Platform_LDFLAGS define in SharedMakeVariables-Default.mk
107+
- Added ObjDir_ToolsSafe to SharedMakeVariables-Default.mk
108+
109+
- Scripts
110+
- configure
111+
- revised configuration INCLUDES handling - replaced INCLUDES_PATH in ConfigurationFiles/X.xml with PLATFORM_INCLUDES_PATH and PLATFORM_INCLUDES_PATH
112+
- Lose INCLUDES_PATH from ConfigurationFiles /x.xml
113+
- use the name PLATFORM_CFLAGS instead of CFLAGS (and same for CXXFLAGS)
114+
- no longer need to add onfigurationName/ThirdPartyComponents/lib/... to @LinkerArgs_LibPath_ADD
115+
- dont print VSVARS_PLATFORM_INCLUDES_PATH to config file if not needed
116+
- renamed CONFIGFILE entry LinkerArgs_LibPath -> Platform_LinkerArgs_LibPath and LinkerArgs_LibDependencies -> Platform_LinkerArgs_LibDependencies;
117+
- dont add LinkerArgs_LibDependencies_ADD to linker-args any longer (using boost.pc); push (@packageCfgNames, boost); various makefile cleanups (esp to third party components) to get more working using --libs and pkg-config
118+
- renamed LinkerArgs_ExtraPrefix -> Platform_LinkerArgs_ExtraPrefix and LinkerArgs_ExtraSuffix -> Platform_LinkerArgs_ExtraSuffix; and draft DEFAULT_LINK_LINE2
119+
- lose support for EXTRA_COMPILER_ARGS in configuration
120+
- configure: just include Builds/1042configurationName/include in INCLUDES_PATH_ADD instead of FOUNDATION_INCLUDES_PATH
121+
- -noexp -noimplib linker args for visual studio to avoid 'Creating library ...'' message from linker
122+
- moved Stroika-Current-Version.h to Builds/$CONFIG/include/Stroika; renamed Stroika-Current-Version to Stroika/Current-Version.h
123+
- lose IntermediateFiles from FOUNDATION_INCLUDES_PATH
124+
- renmamed configfile variable PkgConfigNames -> Foundation_PkgConfigNames
125+
- Always add Builds/$configurationName/include/ to include path in configure: even if no third party components (for stroika-version.h)
126+
127+
- fixed stroika foundation/frameworks library names to fit with new .pc file usage
128+
- **new** CreatePackageConfigFiles
129+
- ApplyConfiguration
130+
- call CreatePackageConfigFiles
131+
- updated configure and ApplyConfiguration (etc) to store FOUNDATION_CPPFLAGS_NOTINCLUDES and PLATFORM_CPPFLAGS_NOTINCLUDES instead of CPPFLAGS_NOTINCLUDES
132+
- **new** SplitCFLAGS
133+
- new script pkg-config-msvc, new file boost/boost.pc;
134+
- RunLocalWindowsDockerRegressionTests
135+
- lose DOCKER_NETWORK flag support and instead better document to use the dns: 8.8.8.8 config setting to fix this problem
136+
73137
- Library
74138
- Common
75139
- **new** LazyType_t
@@ -79,124 +143,32 @@ with
79143
- Memory
80144
- deprecated Memory::NEltsOf - use std::size() or std::ssize() instead
81145

82-
83-
- Makefiles
84-
- get rid of commented out/deprecated makefile variables: StroikaFoundationSupportLibs PKG_CONFIG_STATIC_COMPONENTS, and TPP_PKG_CONFIG_PATH
85-
- Comment out STRIP_INCLUDE_COMPILER_FLAGS since unused and appears obosolete (Makefile-Common.mk)
86-
- moved SharedMakeVariables-Default.mk StroikaLibDir to be (StroikaPlatformTargetBuildDir)lib/ (added lib/)
87-
- Big makefile refactoring - deprecating ScriptsLib/Makefile-Common.mk - just include SharedMakeVariables-Default.mk instead;
88-
- ObjDir/SrcDir declared at top of file
89-
- cleanup WIN_USE_PROGRAM_DATABASE (largely unused anymore) feature to use StroikaLibDir name so works with new location of stroika libraries
90-
- MSYS2_ARG_CONV_EXCL BWA still needed (docuemnted why) - needed more complex BWA in ScriptsLib/ApplyConfiguration fpr MSYS2_ARG_CONV_EXCL issue
91-
- lose extra no longer needed include IntermediateFiles//Configuration.mk in each makefile - now done in ScriptsLib/SharedMakeVariables-Default.mk
92-
- moved ThirdPartyComponents builds output to StroikaPlatformTargetBuildDir (one level up) - so more like standard unix --prefix and stroika libs all together with those of other libraries (for more use of .pc files)
93-
(instead of $(StroikaRoot)Builds/$(CONFIGURATION))
94-
- better docs/warnings in ScriptsLib/SharedBuildRules-Default.mk
95-
- moved SED makefile variable into ScriptsLib/SharedMakeVariables-Default.mk
96-
- added TOP_ROOT to SharedMakeVariables-Default.mk
97-
- minor cleanup to Tests/Makefile-Test-Template.mk
98-
- use DETECTED_HOST_OS MSYS insetad of BuildPlatform is VisualStudio for one BWA specific to MSYS
99-
- lose obsolete LinkerArgs_StroikaDependentLibDependencies from SharedMakeVariables-Default.mk
100-
- cleanups to DEFAULT_LINK_LINE makefile macro (e.g LinkerArgs_ExtraSuffix changes)
101-
- cleanup makefile reacent changes (and lose deprecated LinkerArgs_LibDependencies from SharedMakeVariables.mk)
102-
- more makefile cleanups: SharedMakeVariables-Default.mk - lose deprecated LinkerArgs_LibDependencies, and cleanup RC_FLAGS/MIDL_FLAGS, StroikaRoot_MIXED cleanup
103-
- lose PKG_CONFIG_STROIKA_DEPENDS_ON - from ApplyConfiguraiton/Configuration.mk etc - largely unused(done via pkgconfig)
104-
- progress on new Platform_LDFLAGS define in SharedMakeVariables-Default.mk
105-
- Added ObjDir_ToolsSafe to SharedMakeVariables-Default.mk
106-
107-
- Scripts
108-
- configure
109-
- revised configuration INCLUDES handling - replaced INCLUDES_PATH in ConfigurationFiles/X.xml with PLATFORM_INCLUDES_PATH and PLATFORM_INCLUDES_PATH
110-
- Lose INCLUDES_PATH from ConfigurationFiles /x.xml
111-
- use the name PLATFORM_CFLAGS instead of CFLAGS (and same for CXXFLAGS)
112-
- no longer need to add onfigurationName/ThirdPartyComponents/lib/... to @LinkerArgs_LibPath_ADD
113-
- dont print VSVARS_PLATFORM_INCLUDES_PATH to config file if not needed
114-
- renamed CONFIGFILE entry LinkerArgs_LibPath -> Platform_LinkerArgs_LibPath and LinkerArgs_LibDependencies -> Platform_LinkerArgs_LibDependencies;
115-
- dont add LinkerArgs_LibDependencies_ADD to linker-args any longer (using boost.pc); push (@packageCfgNames, boost); various makefile cleanups (esp to third party components) to get more working using --libs and pkg-config
116-
- renamed LinkerArgs_ExtraPrefix -> Platform_LinkerArgs_ExtraPrefix and LinkerArgs_ExtraSuffix -> Platform_LinkerArgs_ExtraSuffix; and draft DEFAULT_LINK_LINE2
117-
- lose support for EXTRA_COMPILER_ARGS in configuration
118-
- configure: just include Builds/1042configurationName/include in INCLUDES_PATH_ADD instead of FOUNDATION_INCLUDES_PATH
119-
-noexp -noimplib linker args for visual studio to avoid Creating library ... message from linker
120-
- moved Stroika-Current-Version.h to Builds/$CONFIG/include/Stroika; renamed Stroika-Current-Version to Stroika/Current-Version.h
121-
122-
- lose IntermediateFiles from FOUNDATION_INCLUDES_PATH
123-
- renmamed configfile variable PkgConfigNames -> Foundation_PkgConfigNames
124-
- Always add Builds/$configurationName/include/ to include path in configure: even if no third party components (for stroika-version.h)
125-
126-
- fixed stroika foundation/frameworks library names to fit with new .pc file usage
127-
- **new** CreatePackageConfigFiles
128-
- ApplyConfiguration
129-
- call CreatePackageConfigFiles
130-
- updated configure and ApplyConfiguration (etc) to store FOUNDATION_CPPFLAGS_NOTINCLUDES and PLATFORM_CPPFLAGS_NOTINCLUDES instead of CPPFLAGS_NOTINCLUDES
131-
- **new** SplitCFLAGS
132-
- new script pkg-config-msvc, new file boost/boost.pc;
133-
134146
- ThirdPartyComponents
135147
- generate/fix pkgconfig files for sqlite, and zlib (static); lose explicit link dependencies in configure script (replacing with adding those pkgfiles to list of pkgconfig file names - using stroika-foundatipn.pc
136148
- libcurl
137149
- tried 8.15.0; revert to curl 8.12.1, cuz 8.15.0 seems to have same cookie bug (caught by asan - maybe)
138-
139150
- lzma
140151
- lzma.pc support
141152
- xerces
142153
- fixed xerces build code to use .pc file (instead of configure add of libs etc)
143154
- libxml2
144155
- makefile tweak to workaround issues with stroika-foundation.pc file (still experiemntal windows only)
145156
- libxml2 2.14.5
146-
147157
- mongocxxdriver
148158
- 4.1.1
149-
150159
- sqlite
151160
- 3.50.2
152-
153161
- zlib
154162
- minor tweaks makefile
155-
156-
157163
- Tests
158164
- Added -I${ObjDir_ToolsSafe} to CPPFLAGS for Tests makefile template and fixed ref to where to #include from for test/34
159-
160165
- docker tests
161166
- windows - docker image mem usage size upped 12G to 13G cuz sometiems runs out
162-
163167
- Tools
164168
- HTMLViewCompiler
165169
- moved HTMLViewCompiler install to bin directory
166170

167171

168-
- Docker
169-
- changed dockerfiles to always install python3 - not conditionally (cuz switching more of scripts over from perl to python, I think)
170-
- get openssh to autostart on dev containers
171-
172-
173-
- VS_17_14_8
174-
175-
#if 0
176-
177-
"in docker container, use msys 2025-06-22 release"
178-
179-
#lose
180-
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]'Tls12,Tls13'; \
181-
182-
commit 94800dfb3b5689b970cbc60297ec4bc258d6211f
183-
Author: Lewis G. Pringle, Jr. <[email protected]>
184-
Date: Mon Jul 14 09:07:58 2025 -0400
185-
186-
allow ACTUAL_RUN_CMD arg to RunInDockerEnvironemt script, and use to add start-stroika-dev-containers to makefile, and have them auto-restart on reboot - autostarting ssh
187-
188-
commit 331d06dd43b190767b3277bb8cc332571cde7cb2
189-
Author: Lewis Pringle <[email protected]>
190-
Date: Tue Jul 15 13:04:23 2025 -0400
191-
192-
lose DOCKER_NETWORK flag support in RunLocalWindowsDockerRegressionTests and instead better document to use the dns: 8.8.8.8 config setting to fix this problem
193-
194-
#endif
195-
196-
197-
198-
199-
200172

201173

202174
----------------------------

0 commit comments

Comments
 (0)