mirror of
https://github.com/tbsdtv/linux_media.git
synced 2025-07-23 20:51:03 +02:00
Merge tag 'driver-core-5.10-rc3' of git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core
Pull driver core documentation fixes from Greg KH: "Some small Documentation fixes that were fallout from the larger documentation update we did in 5.10-rc2. Nothing major here at all, but all of these have been in linux-next and resolve build warnings when building the documentation files" * tag 'driver-core-5.10-rc3' of git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core: Documentation: remove mic/index from misc-devices/index.rst scripts: get_api.pl: Add sub-titles to ABI output scripts: get_abi.pl: Don't let ABI files to create subtitles docs: leds: index.rst: add a missing file docs: ABI: sysfs-class-net: fix a typo docs: ABI: sysfs-driver-dma-ioatdma: what starts with /sys
This commit is contained in:
@@ -287,6 +287,8 @@ my $bondary = qr { (?<![\w\/\`\{])(?=[\w\/\`\{])|(?<=[\w\/\`\{])(?![\w\/\`\{]) }
|
||||
sub output_rest {
|
||||
create_labels();
|
||||
|
||||
my $part = "";
|
||||
|
||||
foreach my $what (sort {
|
||||
($data{$a}->{type} eq "File") cmp ($data{$b}->{type} eq "File") ||
|
||||
$a cmp $b
|
||||
@@ -306,6 +308,21 @@ sub output_rest {
|
||||
$w =~ s/([\(\)\_\-\*\=\^\~\\])/\\$1/g;
|
||||
|
||||
if ($type ne "File") {
|
||||
my $cur_part = $what;
|
||||
if ($what =~ '/') {
|
||||
if ($what =~ m#^(\/?(?:[\w\-]+\/?){1,2})#) {
|
||||
$cur_part = "Symbols under $1";
|
||||
$cur_part =~ s,/$,,;
|
||||
}
|
||||
}
|
||||
|
||||
if ($cur_part ne "" && $part ne $cur_part) {
|
||||
$part = $cur_part;
|
||||
my $bar = $part;
|
||||
$bar =~ s/./-/g;
|
||||
print "$part\n$bar\n\n";
|
||||
}
|
||||
|
||||
printf ".. _%s:\n\n", $data{$what}->{label};
|
||||
|
||||
my @names = split /, /,$w;
|
||||
@@ -352,6 +369,12 @@ sub output_rest {
|
||||
|
||||
if (!($desc =~ /^\s*$/)) {
|
||||
if ($description_is_rst) {
|
||||
# Remove title markups from the description
|
||||
# Having titles inside ABI files will only work if extra
|
||||
# care would be taken in order to strictly follow the same
|
||||
# level order for each markup.
|
||||
$desc =~ s/\n[\-\*\=\^\~]+\n/\n\n/g;
|
||||
|
||||
# Enrich text by creating cross-references
|
||||
|
||||
$desc =~ s,Documentation/(?!devicetree)(\S+)\.rst,:doc:`/$1`,g;
|
||||
|
Reference in New Issue
Block a user