Messages in this thread Patch in this message | | | From | Tomasz Warniełło <> | Subject | [PATCH v2 04/15] scripts: kernel-doc: Transform documentation into POD (4/15) | Date | Mon, 3 Jan 2022 05:43:37 +0100 |
| |
Step 4) Translate the DESCRIPTION section
Notes: - an article addition - paragraphing correction
See step 1 for the series details.
Signed-off-by: Tomasz Warniełło <tomasz.warniello@gmail.com> --- scripts/kernel-doc | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-)
diff --git a/scripts/kernel-doc b/scripts/kernel-doc index 9be526073b75..c58c812c74cb 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc @@ -41,6 +41,15 @@ kernel-doc - Print formatted kernel documentation to stdout Run `kernel-doc -h` for details. +=head1 DESCRIPTION + +Read C language source or header FILEs, extract embedded documentation comments, +and print formatted documentation to standard output. + +The documentation comments are identified by the "/**" opening comment mark. + +See Documentation/doc-guide/kernel-doc.rst for the documentation comment syntax. + =cut # 18/01/2001 - Cleanups @@ -72,12 +81,6 @@ sub usage { my $message = <<"EOF"; Usage: $0 [OPTION ...] FILE ... -Read C language source or header FILEs, extract embedded documentation comments, -and print formatted documentation to standard output. - -The documentation comments are identified by "/**" opening comment mark. See -Documentation/doc-guide/kernel-doc.rst for the documentation comment syntax. - Output format selection (mutually exclusive): -man Output troff manual page format. This is the default. -rst Output reStructuredText format. -- 2.30.2
| |