starfive-tech/u-boot.git/doc/api/index.rst, branch master

doc: add include/lmb.h to the HTML documentation

2021-11-20T09:53:00+00:00

Correct Sphinx style comments in include/lmb.h Add the logical memory block API to the HTML documentation. Signed-off-by: Heinrich Schuchardt Acked-by: Ilias Apalodimas

doc: add system reset to API documentation

2021-10-21T01:46:03+00:00

Complete the Sphinx documentation in include/sysreset.h Add the include to the generated HTML documentation of the U-Boot API. Signed-off-by: Heinrich Schuchardt

doc: fix doc/develop/logging.rst

2021-01-27T11:52:57+00:00

Sphinx 3 builds fail due to doc/develop/logging.rst producing duplicate labels. Include logging.h only once in the API section and use cross-references for the enums log_level_t and log_category_t. Signed-off-by: Heinrich Schuchardt

doc: add sandbox API

2020-11-05T16:11:31+00:00

Add sandbox API to generated HTML documentation Signed-off-by: Heinrich Schuchardt Reviewed-by: Simon Glass

lib: Add getopt

2020-10-30T14:56:11+00:00

Some commands can get very unweildy if they have too many positional arguments. Adding options makes them easier to read, remember, and understand. This implementation of getopt has been taken from barebox, which has had option support for quite a while. I have made a few modifications to their version, such as the removal of opterr in favor of a separate getopt_silent function. In addition, I have moved all global variables into struct getopt_context. The getopt from barebox also re-orders the arguments passed to it so that non-options are placed last. This allows users to specify options anywhere. For example, `ls -l foo/ -R` would be re-ordered to `ls -l -R foo/` as getopt parsed the options. However, this feature conflicts with the const argv in cmd_tbl->cmd. This was originally added in 54841ab50c ("Make sure that argv[] argument pointers are not modified."). The reason stated in that commit is that hush requires argv to stay unmodified. Has this situation changed? Barebox also uses hush, and does not have this problem. Perhaps we could use their fix? I have assigned maintenance of getopt to Simon Glass, as it is currently only used by the log command. I would also be fine maintaining it. Signed-off-by: Sean Anderson

doc: Document timer API

2020-10-22T13:54:53+00:00

This adds kerneldocs for . I don't know who should maintain doc/api/timer.rst, since the timer subsystem seems to be maintained by SoC maintainers. MAINTAINERS is left un-updated for the moment. Signed-off-by: Sean Anderson Reviewed-by: Simon Glass

pinctrl: Reformat documentation in dm/pinctrl.h

2020-10-08T15:42:36+00:00

This normalizes the documentation to conform to kernel-doc style [1]. It also moves the documentation for pinctrl_ops inline, and adds argument and return-value documentation. I have kept the usual function style for these comments. I could not find any existing examples of function documentation inside structs. [1] https://www.kernel.org/doc/html/latest/doc-guide/kernel-doc.html Signed-off-by: Sean Anderson Reviewed-by: Simon Glass

doc: random number generation

2020-06-14T19:07:20+00:00

Add random number generation APIs to the HTML documentation. Fix style issues. Signed-off-by: Heinrich Schuchardt

doc: dfu: add DFU to HTML documentation

2020-05-25T15:54:53+00:00

Add the device firmware update functions to the generated HTML documentation. Signed-off-by: Heinrich Schuchardt Acked-by: Lukasz Majewski

doc: add Unicode functions to API description

2020-05-09T07:30:28+00:00

Add include/charset.h to generated HTML documentation Signed-off-by: Heinrich Schuchardt