diff options
author | Ewout van Bekkum <ewout@google.com> | 2020-07-17 16:34:00 -0700 |
---|---|---|
committer | CQ Bot Account <commit-bot@chromium.org> | 2020-07-18 02:38:39 +0000 |
commit | e072fabcf02499a0537530ea392923c8373592b6 (patch) | |
tree | b91909f4602b811c5fc756c45818632a3f3ad392 /docs/module_structure.rst | |
parent | 8aa0292bea75651e862c6ab3e9b5baf1b4bb2c9e (diff) | |
download | pigweed-e072fabcf02499a0537530ea392923c8373592b6.tar.gz |
docs: some more minor updates
Fixes some errors and some stale references and formats.
Change-Id: I5a2f6d4a20591b61ae49eaab3310dc7abf51d83d
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/14122
Reviewed-by: Keir Mierle <keir@google.com>
Commit-Queue: Ewout van Bekkum <ewout@google.com>
Diffstat (limited to 'docs/module_structure.rst')
-rw-r--r-- | docs/module_structure.rst | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/docs/module_structure.rst b/docs/module_structure.rst index 2f51ef054..6774ffdf7 100644 --- a/docs/module_structure.rst +++ b/docs/module_structure.rst @@ -93,7 +93,7 @@ Example module structure code_relating_to_subfeature/... Module name -~~~~~~~~~~~ +----------- Pigweed upstream modules are always named with a prefix ``pw_`` to enforce namespacing. Projects using Pigweed that wish to make their own modules can use whatever name they like, but we suggest picking a short prefix to namespace @@ -101,10 +101,10 @@ your product (e.g. for an Internet of Toast project, perhaps the prefix could be ``it_``). C++ file and directory locations -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +-------------------------------- C++ public headers -^^^^^^^^^^^^^^^^^^ +~~~~~~~~~~~~~~~~~~ Located ``{pw_module_dir}/public/<module>``. These are headers that must be exposed due to C++ limitations (i.e. are included from the public interface, but are not intended for public use). @@ -143,7 +143,7 @@ the public interface, but are not intended for use), place the headers in a that, there is the ``public_overrides/`` directory. Public override headers -^^^^^^^^^^^^^^^^^^^^^^^ +~~~~~~~~~~~~~~~~~~~~~~~ Located ``{pw_module_dir}/public_overrides/<module>``. In general, the Pigweed philosophy is to avoid having "things hiding under rocks", and having header files with the same name that can override each other is considered a rock @@ -175,7 +175,7 @@ For example, the ``pw_unit_test`` module provides a header override for Note that the overrides are in a separate directory ``public_overrides``. C++ implementation files -^^^^^^^^^^^^^^^^^^^^^^^^ +~~~~~~~~~~~~~~~~~~~~~~~~ Located ``{pw_module_dir}/``. C++ implementation files go at the top level of the module. Implementation files must always use "" style includes. |