Merge tag 'docs-5.18-2' of git://git.lwn.net/linux
authorLinus Torvalds <torvalds@linux-foundation.org>
Thu, 31 Mar 2022 19:10:42 +0000 (12:10 -0700)
committerLinus Torvalds <torvalds@linux-foundation.org>
Thu, 31 Mar 2022 19:10:42 +0000 (12:10 -0700)
Pull more documentation updates from Jonathan Corbet:
 "Some late-arriving documentation improvements.

  This is mostly build-system fixes from Mauro and Akira; I also took
  the liberty of dropping in my 'messy diffstat' document"

* tag 'docs-5.18-2' of git://git.lwn.net/linux:
  docs: Add a document on how to fix a messy diffstat
  docs: sphinx/requirements: Limit jinja2<3.1
  Documentation: kunit: Fix cross-referencing warnings
  scripts/kernel-doc: change the line number meta info
  scripts/get_abi: change the file/line number meta info
  docs: kernel_include.py: add sphinx build dependencies
  docs: kernel_abi.py: add sphinx build dependencies
  docs: kernel_feat.py: add build dependencies
  scripts/get_feat.pl: allow output the parsed file names
  docs: kfigure.py: Don't warn of missing PDF converter in 'make htmldocs'
  Documentation: Fix duplicate statement about raw_spinlock_t type

1  2 
scripts/get_abi.pl

diff --combined scripts/get_abi.pl
@@@ -92,7 -92,6 +92,7 @@@ sub parse_abi 
        my $mode = (stat($file))[2];
        return if ($mode & S_IFDIR);
        return if ($file =~ m,/README,);
 +      return if ($file =~ m,/\.,);
  
        my $name = $file;
        $name =~ s,.*/,,;
@@@ -327,7 -326,7 +327,7 @@@ sub output_rest 
                my @filepath = split / /, $data{$what}->{filepath};
  
                if ($enable_lineno) {
-                       printf "#define LINENO %s%s#%s\n\n",
+                       printf ".. LINENO %s%s#%s\n\n",
                               $prefix, $file[0],
                               $data{$what}->{line_no};
                }
@@@ -988,7 -987,7 +988,7 @@@ abi_book.pl - parse the Linux ABI file
  B<abi_book.pl> [--debug <level>] [--enable-lineno] [--man] [--help]
               [--(no-)rst-source] [--dir=<dir>] [--show-hints]
               [--search-string <regex>]
 -             <COMAND> [<ARGUMENT>]
 +             <COMMAND> [<ARGUMENT>]
  
  Where B<COMMAND> can be:
  
@@@ -1023,7 -1022,7 +1023,7 @@@ logic (B<--no-rst-source>)
  
  =item B<--enable-lineno>
  
- Enable output of #define LINENO lines.
+ Enable output of .. LINENO lines.
  
  =item B<--debug> I<debug level>