mirror of
https://fuchsia.googlesource.com/third_party/pigweed.googlesource.com/pigweed/pigweed
synced 2024-09-21 14:16:26 +00:00
37 lines
754 B
ReStructuredText
37 lines
754 B
ReStructuredText
|
.. _chapter-docs:
|
||
|
|
||
|
.. default-domain:: cpp
|
||
|
|
||
|
.. highlight:: sh
|
||
|
|
||
|
----
|
||
|
docs
|
||
|
----
|
||
|
The Pigweed docs target assembles Pigweed's reStructuredText and markdown
|
||
|
documentation into a collection of HTML pages.
|
||
|
|
||
|
Building
|
||
|
========
|
||
|
To build for this target, change the ``pw_target_config`` GN build arg to point
|
||
|
to this target's configuration file.
|
||
|
|
||
|
.. code:: sh
|
||
|
|
||
|
$ gn gen --args='pw_target_config = "//targets/docs/target_config.gni"' out/docs
|
||
|
$ ninja -C out/docs
|
||
|
|
||
|
or
|
||
|
|
||
|
.. code:: sh
|
||
|
|
||
|
$ gn gen out/docs
|
||
|
$ gn args
|
||
|
# Modify and save the args file to update the pw_target_config.
|
||
|
pw_target_config = "//targets/docs/target_config.gni"
|
||
|
$ ninja -C out/docs
|
||
|
|
||
|
Output
|
||
|
======
|
||
|
Final HTML documentation will be placed in the ``gen/docs/html`` directory of
|
||
|
the build.
|