diff options
| author | Boris Kolpackov <boris@codesynthesis.com> | 2018-10-04 05:09:29 +0200 |
|---|---|---|
| committer | Boris Kolpackov <boris@codesynthesis.com> | 2018-10-04 05:09:29 +0200 |
| commit | 060973ff774eaaee029945b40584f4cbb25c8041 (patch) | |
| tree | 3a8eaed38e28914a174239c0eccf89f4932b2bed /doc | |
| parent | 04ffbbe777f6fb345037ded2d62a745baad38f25 (diff) | |
Add note on C++ module interface unit naming to manual
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/manual.cli | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/manual.cli b/doc/manual.cli index d6d4a00..f588e24 100644 --- a/doc/manual.cli +++ b/doc/manual.cli @@ -654,7 +654,14 @@ inclusion scheme where each header is prefixed with its project name. It also has a predictable name where users can expect to find our project's source code. Finally, this layout prevents clutter in the project's root directory which usually contains various other files. See \l{intro#structure-canonical -Canonical Project Structure} for more information.| +Canonical Project Structure} for more information. + +Note also that while we can name our header and source files however we like +(but, again, see \l{intro#structure-canonical Canonical Project Structure} for +some sensible guidelines), C++ module interface files need to embed a +sufficient amount of the module name suffix in their names to unambiguously +resolve all the modules within a project. See \l{#cxx-modules-build +Building Modules} for details.| The source subdirectory \c{buildfile} is identical to the simple project's minus the parts moved to \c{root.build}: |