diff mbox series

[1/1] doc: android/boot-image: invalid C declaration

Message ID 20201230165522.107618-1-xypron.glpk@gmx.de
State Accepted
Commit 51549711b5960f2280629fe6231a07338bbcd57c
Delegated to: Tom Rini
Headers show
Series [1/1] doc: android/boot-image: invalid C declaration | expand

Commit Message

Heinrich Schuchardt Dec. 30, 2020, 4:55 p.m. UTC
make htmldocs results in an error:

doc/android/boot-image.rst:33:
WARNING: Unparseable C cross-reference: 'struct andr_img_hdr'
Invalid C declaration: Expected identifier in nested name, got keyword:
struct [error at 6]

Follow the style prescribed in
https://www.kernel.org/doc/html/latest/doc-guide/kernel-doc.html#highlights-and-cross-references

Add missing definite article.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
---
 doc/android/boot-image.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

--
2.29.2

Comments

Tom Rini Jan. 5, 2021, 12:54 p.m. UTC | #1
On Wed, Dec 30, 2020 at 05:55:22PM +0100, Heinrich Schuchardt wrote:

> make htmldocs results in an error:
> 
> doc/android/boot-image.rst:33:
> WARNING: Unparseable C cross-reference: 'struct andr_img_hdr'
> Invalid C declaration: Expected identifier in nested name, got keyword:
> struct [error at 6]
> 
> Follow the style prescribed in
> https://www.kernel.org/doc/html/latest/doc-guide/kernel-doc.html#highlights-and-cross-references
> 
> Add missing definite article.
> 
> Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>

Applied to u-boot/master, thanks!
diff mbox series

Patch

diff --git a/doc/android/boot-image.rst b/doc/android/boot-image.rst
index 195da688f4..8648ab721b 100644
--- a/doc/android/boot-image.rst
+++ b/doc/android/boot-image.rst
@@ -30,9 +30,10 @@  next image headers:

 v2, v1 and v0 formats are backward compatible.

-Android Boot Image format is represented by :c:type:`struct andr_img_hdr` in
-U-Boot, and can be seen in ``include/android_image.h``. U-Boot supports booting
-Android Boot Image and also has associated command
+The Android Boot Image format is represented by
+:c:type:`struct andr_img_hdr <andr_img_hdr>` in U-Boot, and can be seen in
+``include/android_image.h``. U-Boot supports booting Android Boot Image and also
+has associated command

 Booting
 -------