/usr/share/doc/libgdamm5.0-doc/docs/doc-postprocess.pl is in libgdamm5.0-doc 4.99.6-0ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 | package main;
# Copyright (c) 2009 Openismus GmbH <http://www.openismus.com/>
#
# This file is part of mm-common.
#
# mm-common is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published
# by the Free Software Foundation, either version 2 of the License,
# or (at your option) any later version.
#
# mm-common is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with mm-common. If not, see <http://www.gnu.org/licenses/>.
use strict;
use warnings;
use bytes;
use File::Glob qw(:glob);
use File::Spec;
use Getopt::Long qw(:config no_getopt_compat no_ignore_case require_order bundling);
sub path_basename ($)
{
my ($path) = @_;
my $basename = File::Spec->splitpath($path);
return $basename;
}
sub exit_help ()
{
my $script_name = path_basename($0) || 'doc-postprocess.pl';
print <<"EOF";
Usage: perl $script_name [OPTION]... [PATTERN]...
Post-process the Doxygen-generated HTML files matching PATTERN.
Options:
-?, --help display this help and exit
EOF
exit;
}
sub error (@)
{
my $script_name = path_basename($0);
$script_name =~ s/\.[^.]*$//s if (defined $script_name);
print STDERR ($script_name || 'doc-postprocess', ': ', @_, "\n");
exit 1;
}
GetOptions('help|?' => \&exit_help)
or exit 2;
foreach my $filename (map(bsd_glob($_, GLOB_NOSORT), @ARGV))
{
my @buf;
my $file;
open($file, '<', $filename) and (@buf = <$file>) and close($file)
or error('Failed to read ', path_basename($filename), ': ', $!);
foreach (@buf)
{
if (/<a class="el"/)
{
# return value
s/ & */& /;
s/ \* */* /;
# parameters
s/ &/&/g;
s/&\b/& /g;
s/ \*/*/g;
s/\*\b/* /g;
# templates
s/\btemplate</template </;
}
elsif (/<td class="md(?:name)?"/)
{
# left parenthesis
s/\( */(/;
# return value
s/ & /& /g;
s/ \* /* /g;
# parameters
s/ & */& /g;
s/ \* */* /g;
# templates
s/\btemplate</template </;
}
else
{
# template decls
s/^(<h\d>|)template</$1template </;
}
s/©/©/g;
s/—/—/g;
s/–/–/g;
s/ * */ /g;
s/(?<=\S)\s{2,}/ /g;
# These doxygen attributes seem to help doxygen link documentation using the tags,
# but they are not necessary at this final stage.
s/doxygen=\"(.*)\"/ /g;
}
# write the whole buffer back
open($file, '>', $filename) and print $file (@buf) and close($file)
or error('Failed to write ', path_basename($filename), ': ', $!);
}
exit;
|