kicad/thirdparty/libcontext
Ian McInerney 20ec8ed303 Fix GitLab URLs to point to the correct project page
GitLab 16.0 removes support for URLs that don't contain /-/ after the
repository name, so the report bug feature and various links we had in
the source (including the git-fixes script) would lead to a 404 error.

See GitLab docs for deprecation/removal notice:
https://docs.gitlab.com/ee/update/deprecations.html?removal_milestone=16.0#legacy-urls-replaced-or-removed

Fixes: https://gitlab.com/kicad/code/kicad/-/issues/14759
2023-05-17 11:23:00 +01:00
..
CMakeLists.txt Make libcontext build statically 2023-04-10 21:22:04 -04:00
LICENSE.BOOSTv1_0 Move potrace and libcontext into thirdparty directory 2019-12-28 18:17:55 +00:00
README.txt Fix GitLab URLs to point to the correct project page 2023-05-17 11:23:00 +01:00
jump_arm64_aapcs_pe_armasm.asm Add windows arm64 support 2023-03-10 21:19:56 -05:00
jump_i386_ms_pe_masm.asm Add assembly based libcontext implementation for MSVC builds 2021-03-03 21:14:17 -05:00
jump_x86_64_ms_pe_masm.asm Fix fiber local storage offset (crashfix) 2021-03-03 21:14:17 -05:00
libcontext.cpp Fix the #ifdef for the release_fcontext stub 2023-04-10 19:12:27 -04:00
libcontext.h Fix libcontext arm64 build and purge winfiber 2023-04-10 18:07:35 -04:00
make_arm64_aapcs_pe_armasm.asm Add windows arm64 support 2023-03-10 21:19:56 -05:00
make_i386_ms_pe_masm.asm Add assembly based libcontext implementation for MSVC builds 2021-03-03 21:14:17 -05:00
make_x86_64_ms_pe_masm.asm Add assembly based libcontext implementation for MSVC builds 2021-03-03 21:14:17 -05:00

README.txt

This directory contains modified context switching code from the Boost library.

It is licensed under the Boost Software License, with the license text in this directory.

The reasons for creating a custom libcontext/coroutines library instead of using the Boost versions are described in several places. It was first introduced and discussed on the mailing list here: https://www.mail-archive.com/kicad-developers@lists.launchpad.net/msg23327.html


From https://gitlab.com/kicad/code/kicad/-/issues/237:

---------------

@ Tom, from reading the list messages it sounds like this was an ABI incompatibility (not API?) resulting from boost wanting MSVC build chain.

If that's the case, could we keep libcontext for MSW only?  That would resolve the platform issue as the *nix builds could use libboost context. We keep the API, so there's no KiCad changes.

---------------

@ Seth

There were multiple critical elements:
- the issue you mentioned was about building boost::context under mingw without having to get proprietary binaries for MASM/MASM64 (Microsoft Macro Assembler). This was fixed by Boost at some point in 2015.
- boost::context API is unstable - that is the definitions of jump_fcontext and make_fcontext change from time to time. We had to put a number of #ifdefs in KiCad coroutine library to accommodate for different versions of Boost.
- In the latest versions of Boost (at least 1.61 and newer), the fcontext api is no longer public (detail namespace). Therefore there's no guarantee of its stability. The now-official boost coroutine library is very complex and incomprehensible. Linking against a non-public API is not a good idea IMHO.
- Last but not least, since we moved to C++11, most features that used to be provided by Boost are now in the C++ standard library. I'd rather use C++11-features only in the longer run than rely on Boost.

All of the above forced me to develop libcontext, which is merely a two-file version of boost::context, including all original copyrights. I made it only for platforms I could test the library with.

@ tijuca: See above. We support x86, x86_64, ARM and ARM64 for now (although I've never met any KiCad user running it on an ARM box). I've never seen anyone trying to run Kicad on a PPC/Mips machine. As you correctly pointed out, armv5-t is a sort of historical instruction set by today's standards, so there's no need to worry about it. For other exotic platforms like PPC, SPARC, DEC Alpha, MIPS, PDP-10, old IBM mainframe or Commodore 64, I guess if someone still manages to use such a machine, writing a context switch function should be trivial to him/her.

Tom

----------------------------
From https://www.mail-archive.com/kicad-developers@lists.launchpad.net/msg31321.html

If we could depend on boost to stop changing their coroutine code every couple of version then we wouldn't have to fork it and maintain our own version.  Unfortunately, history has proven otherwise.  Your change would be the forth time this code as been changed to accommodate boost. The short answer is yes, we actually need our own coroutine code because we cannot depend on boost to not cut us off at the knees every few versions.  Maybe when couroutines are available in the standard c++ library, then we can get rid of our library.  Please do not change coroutine code without a really good reason.