[PATCH v2 12/15] scripts: kernel-doc: Transform documentation into POD (12/15)

From: Tomasz Warniełło
Date: Sun Jan 02 2022 - 23:56:06 EST


Step 12) Archive the pre-git museum

Jonathan Corbet suggested in a reply to my version 1, that these records
can go, since that's what the git log is for. I don't agree.

The log begins at 1da177e4c3f41524e886b7f1b8a0c1fc7321cac2. That's from
2005. One of those entries is indeed logged, so kudos for having me check
this. But not the older ones. Of course they can be found indirectly,
but then...

Why not just let them embellish the script tail?

As you can see, they don't even require any formatting there.

Are you sure you don't want them?

See step 1 for the series details.

Signed-off-by: Tomasz Warniełło <tomasz.warniello@xxxxxxxxx>
---
scripts/kernel-doc | 43 ++++++++++++++++++++++---------------------
1 file changed, 22 insertions(+), 21 deletions(-)

diff --git a/scripts/kernel-doc b/scripts/kernel-doc
index 8069d1d29841..51e813a84d8b 100755
--- a/scripts/kernel-doc
+++ b/scripts/kernel-doc
@@ -54,31 +54,10 @@ See Documentation/doc-guide/kernel-doc.rst for the documentation comment syntax.

# more perldoc at the end of the file

-# 18/01/2001 - Cleanups
-# Functions prototyped as foo(void) same as foo()
-# Stop eval'ing where we don't need to.
-# -- huggie@xxxxxxxx
-
-# 27/06/2001 - Allowed whitespace after initial "/**" and
-# allowed comments before function declarations.
-# -- Christian Kreibich <ck@xxxxxxxxx>
-
# Still to do:
# - add perldoc documentation
# - Look more closely at some of the scarier bits :)

-# 26/05/2001 - Support for separate source and object trees.
-# Return error code.
-# Keith Owens <kaos@xxxxxxxxxx>
-
-# 23/09/2001 - Added support for typedefs, structs, enums and unions
-# Support for Context section; can be terminated using empty line
-# Small fixes (like spaces vs. \s in regex)
-# -- Tim Jansen <tim@xxxxxxxxxx>
-
-# 25/07/2012 - Added support for HTML5
-# -- Dan Luedtke <mail@xxxxxxxx>
-
## init lots of data

my $errors = 0;
@@ -2518,3 +2497,25 @@ Treat warnings as errors.
=back

=cut
+
+PRE-GIT MUSEUM
+
+Original formatting preserved for its historical value.
+
+# 18/01/2001 - Cleanups
+# Functions prototyped as foo(void) same as foo()
+# Stop eval'ing where we don't need to.
+# -- huggie@xxxxxxxx
+
+# 27/06/2001 - Allowed whitespace after initial "/**" and
+# allowed comments before function declarations.
+# -- Christian Kreibich <ck@xxxxxxxxx>
+
+# 26/05/2001 - Support for separate source and object trees.
+# Return error code.
+# Keith Owens <kaos@xxxxxxxxxx>
+
+# 23/09/2001 - Added support for typedefs, structs, enums and unions
+# Support for Context section; can be terminated using empty line
+# Small fixes (like spaces vs. \s in regex)
+# -- Tim Jansen <tim@xxxxxxxxxx>
--
2.30.2