Mirrors/opensbi
1
0
Fork 1
mirror of https://github.com/riscv-software-src/opensbi.git synced 2025-08-24 15:31:22 +01:00
Code Issues Packages Projects Releases Wiki Activity

top: Update top-level README.md to build/install documentation PDF

Browse Source 
This patch updates top-level README.md for steps required to build
and install documentation PDF.

Signed-off-by: Anup Patel <anup.patel@wdc.com>
This commit is contained in:
Anup Patel
2019-01-14 11:48:38 +05:30
committed by Anup Patel
parent c2e0b02914
commit 64c68c03f3
1 changed files with 30 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
README.md
View File

@@ -67,27 +67,21 @@ should be *`qemu/virt`*.
To build *libsbi, libplatsbi, and firmwares* for a specific platform, run: To build *libsbi, libplatsbi, and firmwares* for a specific platform, run:
``` ```
make PLATFORM=<platform_subdir> make PLATFORM=<platform_subdir>
```
or or
```
make PLATFORM=<platform_subdir> O=<build_directory> make PLATFORM=<platform_subdir> O=<build_directory>
``` ```
To install *libsbi, headers, libplatsbi, and firmwares*, run: To install *libsbi, headers, libplatsbi, and firmwares*, run:
``` ```
make PLATFORM=<platform_subdir> install make PLATFORM=<platform_subdir> install
```
or or
make PLATFORM=<platform_subdir> I=<install_directory> install
```
make PLATFORM=<platform_subdir> I=<install_directory> install`
``` ```
In addition, platform specific make command-line options to top-level make In addition, platform specific make command-line options to top-level make
, such as *PLATFORM_<xyz>* or *FW_<abc>* can also be specified. These , such as *PLATFORM_<xyz>* or *FW_<abc>* can also be specified. These
options are described under *docs/platform/<platform_name>.md* and options are described under *`docs/platform/<platform_name>.md`* and
*docs/firmware/<firmware_name>.md*. *`docs/firmware/<firmware_name>.md`*.
Documentation Documentation
------------- -------------
@@ -95,15 +89,36 @@ Documentation
A more detailed documenation is under the *docs* directory and organized A more detailed documenation is under the *docs* directory and organized
as follows. as follows.
* *docs/platform_guide.md* - Guidelines for adding new platform support * *`docs/contributing.md`* - Guidelines for contributing to OpenSBI project
* *docs/library_usage.md* - Guidelines for using the static library * *`docs/platform_guide.md`* - Guidelines for adding new platform support
* *docs/platform/<platform_name>.md* - Platform specific documentation for * *`docs/library_usage.md`* - Guidelines for using the static library
the platform *<platform_name>* * *`docs/platform/<platform_name>.md`* - Documentation for the platform *<platform_name>*
* *docs/firmware/<firmware_name>.md* - Platform specific documentation for * *`docs/firmware/<firmware_name>.md`* - Documentation for the firmware *<firmware_name>*
the firmware *<firmware_name>*
The source code is also well documented. For source level documentation, The source code is also well documented. For source level documentation,
doxygen style is used. Please refer to [Doxygen manual] doxygen style is used. Please refer to [Doxygen manual]
(http://www.stack.nl/~dimitri/doxygen/manual.html) for details on this (http://www.stack.nl/~dimitri/doxygen/manual.html) for details on this
format. format.
The Doxygen can be installed on your debian build system using following:
```
sudo apt-get install doxygen doxygen-latex doxygen-doc doxygen-gui graphviz
```
To build a consolidated `refman.pdf` of all documenation, run:
```
make docs
or
make O=<build_directory> docs
```
**NOTE:** `refman.pdf` will be available under `<build_directory>/docs/latex`.
To install a consolidated `refman.pdf` of all documenation, run:
```
make install_docs
or
make I=<install_directory> install_docs
```
**NOTE:** `refman.pdf` will be installed under `<install_directory>/docs`.