kicad/Documentation/development/technical_todo.md

Technical To-Do List

Some work is blocked for technical reasons, and can only be done once certain other criteria are met (e.g. library versions).

Because KiCad supports distributions with relatively long support cycles, many of these workarounds will be required for some time, so they are easily forgotten.

This section collects these so they can be dealt with when the project's minimum version for that dependency is met. This kind of code should always be documented in detail at the place of use, so that it's clear what action should be taken in future.

[TOC]

C++ Versions

Newer C++ versions include features that make some of our current code unnecessary.

C++11

This C++ standard version is already used by KiCad, but much code that pre-dates the version switch exists and can be tidied.

• MUTEX can use std::mutex and remove the Boost mutex dependency and the whole ki_mutex.h header in favour of <mutex>.
• std::auto_ptr should be changed to std::unique_ptr. auto_ptr is removed entirely in C++17.

C++14

Compiler support:

• GCC: complete by GCC 5: GCC C++14 support.

Provides:

• std::make_unique is available. The "polyfill" in make_unique.h is no longer required and can be removed.

C++17

Compiler support:

• GCC: from GCC 5 to 7: GCC C++17 support.

Provides:

• OPT<> can be replaced with std::optional. Header core/optional.h can be removed and replaced with the built-in <optional>. Needs GCC 7.
• std::filesystem can replace boost::filesystem and the Boost dependency can be dropped entirely from the CMake files.

Compilers

Some compilers have bugs or limitations to C++ standard support.

GCC

Current versions:

• Debian Stretch: 6.3.0
• Ubuntu 14.04: 4.8.2
• Ubuntu 16.04: 5.3.1
• Ubuntu 18.04: 7.3.0

GCC 7

• Fixes bug #56480 (Explicit specialization in a different namespace). This means the BOOST_TEST_PRINT_NAMESPACE_OPEN macro is not required, a namespace alias can be used instead.

3rd Party Libraries

There are several places in KiCad where workarounds exist for defects in 3rd party library limitations or defects.

Boost

Current versions:

• Debian Stretch: 1.62
• Ubuntu 14.04: 1.54
• Ubuntu 16.04: 1.58
• Ubuntu 18.04: 1.65

1.59

• Boost 1.59 brings a major overhaul of the Boost test library.
  • Many "Polyfills" un unit_test_utils.h can be removed:
    • BOOST_TEST_CONTEXT and BOOST_TEST_INFO are available, remove the polyfill macros.
    • boost::unit_test::expected_failures is available, so can remove the HAVE_EXPECTED_FAILURES guard macro.
    • BOOST_TEST_PRINT_NAMESPACE_OPEN doesn't need to switch the namespace

1.64

• Boost test
  • Boost test print helper for nullptr_t exists, can remove our polyfill
  • The boost_test_print_type customisation point exists and the old code using BOOST_TEST_PRINT_NAMESPACE_OPEN can be converted to use that.

CMake

Current versions:

• Debian Stretch: 3.7.2
• Ubuntu 14.04: 2.8.12
• Ubuntu 16.04: 3.5.1
• Ubuntu 18.04: 3.10.2

3.1

• Can remove CMake policy CMP0025 from root CMake

3.3

• Can remove check for CMake policy CMP0063 entirely (the policy exists as of v3.3 and the default is correct).

3.5

• Can use target_link_libraries(foo Boost::boost) for Boost header-only libraries, rather than ${Boost_INCLUDE_DIRS}. C.f. Github commit

OpenSSL

Current versions:

• Debian Stretch: 1.0.1
• Ubuntu 14.04: 1.0.1
• Ubuntu 16.04: 1.0.2
• Ubuntu 18.04: 1.1.0

1.1.0

• Can remove all locking code from kicad_curl.cpp. From v1.1.0, this is no longer required. C.f. OpenSSL issue 1260

wxWidgets

Current versions:

• Debian Stretch: 3.0.2
• Ubuntu 14.04: 3.0.0
• Ubuntu 16.04: 3.0.2
• Ubuntu 18.04: 3.0.4

3.1

This is a development release, but it brings its own set of features and fixes. Most of these will not be available in general distributions until v3.2.

• DPI scaling on GTK+ available (also needs GTK+ 3.10). C.f. this commit dpi_scaling.cpp should continue to work normally, but the config should no longer be required and the scaling should auto-detect.