Notes to Early Readers

This is an early work-in-progress version of A Pragmatic Journey into C++ Modules. I’m publishing on LeanPub to release early and often. One reason is to gain feedback from early readers on unclear material or technical mistakes that need correction.

As an early reader, you obtain the book at a discount and receive updates and the final book at no additional charge. That’s your reward for being an early adopter. I thank you for helping me and for your patience during the process.

I hope to have the book finished by the end of May 2025.

When you comment, please mention the version you are using — PDF or EPub, the page and/or section, and the date of the release.

You can send comments to pragmatic@mysticlakesoftware.com.

2025-03-11, 12:07 a.m

First release.

• The material up through Chapter 5 is complete, so I’m most interested in reviews for them.

2025-03-16

Second release.

• Changed section titles to conform across chapters.
• Added section on partitions and code without explanation. Partitions don’t want to build with CMake but are okay with GCC and Clang command lines. There is another version of Clang command lines that doesn’t want to work. Spent way too much time fighting with these problems.
• Deep dive chapter incomplete but some substantive material there.
• Marked chapters and section with (WIP) to indicate they are incomplete.
• Comparison of Header and Module Builds (WIP) added.
• Hid some raw chapters

2025-03-22

Work toward third release

• Deep dive into modules chapter.
• Renamed projects
• Added Sphynx project

2025-03-24

Third release

• Editing throughout to clarify
• Dropped discussion of CMake and clang-tools on command line since Bill Hoffman advised they weren’t necessary and it now works. Perhaps a reboot or install of Clang 20 fixed the problem.