Conan 1.40 Documentation

### Conan 1.40 Documentation Summary #### 1. Version Stability Conan 1.X versions, including 1.40, are stable with no breaking changes, ensuring compatibility across all 1.0 recipes and commands. #### 2. Road to Conan 2.0 - Development for Conan 2.0 has begun, with plans to introduce breaking changes and modernize the codebase. - A future section will provide updates on Conan 2.0, including new features and deprecations. - The `CONAN_V2_MODE` environment variable is available to raise errors for deprecated features in Conan 2.0. #### 3. Integrations - **Compilers**: Conan supports major compilers like GCC, Clang, Intel, and Visual Studio. Custom compilers can be added. - **Build Systems**: Conan integrates with build systems using generators and build helpers to translate settings into build system-specific arguments. #### 4. Key Features and Changes - **SSL Certificates**: Fixes to handle SSL certificate issues in Conan updates. - **Xcode 13 Support**: Added support for Xcode 13/Apple Clang 13.0. - **CMake Layout**: Default source folder for `cmake_layout()` changed from `src` to `.`. - **Patch Tools**: Restored `base_path` argument for patching in `conan.tools.files`. #### 5. Python 2 Deprecation - Conan 1.22 and later no longer support Python 2. New features will only be available in Python 3. - Users are encouraged to migrate to Python 3, but feedback on Python 2 support is welcome. #### 6. Installation and Upgrade - **Upgrade**: Use `pip install conan --upgrade` or download the latest installer. - **Settings Management**: Settings files are updated during upgrades unless modified locally. - **Cache Management**: Clear the cache with `rm -rf ~/.conan` if inconsistencies arise. #### 7. Future Developments - Conan 2.0 will introduce significant changes, including new features and deprecations. - The community is involved in shaping the next major release. This summary highlights the key updates, features, and future directions for Conan 1.40, ensuring compatibility and guiding users toward upcoming changes.