From e33d6115ee4ea76941d092b72ae06d22415f8e90 Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Tue, 14 Jul 2020 22:33:56 +0300
Subject: Documentation tweaks

---
 bdep/new.cli | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

(limited to 'bdep/new.cli')

diff --git a/bdep/new.cli b/bdep/new.cli
index 3508465..2ae24de 100644
--- a/bdep/new.cli
+++ b/bdep/new.cli
@@ -278,7 +278,7 @@ namespace bdep
 
      The project type can be specified with the \c{\b{--type}|\b{-t}} option.
      The \cb{empty} project type is language-agnostic with the semantics and
-     valid sub-options for the rest being language-dependant, as described
+     valid sub-options for the rest being language-dependent, as described
      next. If unspecified, an executable project is created by default.
 
      \dl|
@@ -795,10 +795,12 @@ namespace bdep
    Note that while the same physical layout can be achieved with various
    combinations of source prefix and subdirectory, there will be differences
    in semantics since the headers in the project are included with the source
-   subdirectory (if any) as a prefix.
+   subdirectory (if any) as a prefix. See \l{intro#proj-struct Canonical
+   Project Structure} for details.
 
    As we have already seen, the source subdirectory can be customized with the
-   \cb{subdir} project type sub-option. For example:
+   \cb{subdir} project type sub-option. For example (pass \cb{-l\ c++,cpp} for
+   the \cb{.hpp}/\cb{.cpp} naming scheme):
 
    \
    # libhello/hello/
@@ -941,11 +943,11 @@ namespace bdep
    $ tree libhello/
    libhello/
    └── src/
-       ├── hello/
-       │   └── hello.cxx
-       └── include/
-           └── hello/
-               └── hello.hxx
+       ├── include/
+       │   └── hello/
+       │       └── hello.hxx
+       └── hello/
+           └── hello.cxx
    \
 
    A similar layout but without the source subdirectory in \c{src/}:
-- 
cgit v1.1