[web] master update

Richard Levitte levitte at openssl.org
Sat Jul 6 06:33:00 UTC 2019


The branch master has been updated
       via  3b00096bd14d8a86ec486dcb132fe3055fc170df (commit)
      from  dd74209e0beb5fdcb99aa967aec90b1d9b95c322 (commit)


- Log -----------------------------------------------------------------
commit 3b00096bd14d8a86ec486dcb132fe3055fc170df
Author: Richard Levitte <levitte at openssl.org>
Date:   Sat Jun 22 09:44:24 2019 +0200

    When producing HTML man-pages, include the original base name
    
    For OpenSSL 1.1.0 and on, this isn't relevant any more, since all pod
    names should be one of the names in the NAME section.  However, 1.0.2
    pages were written differently, and people still refer to the original
    base name to look up documentation.
    
    Fixes openssl/openssl#9189
    
    Reviewed-by: Matt Caswell <matt at openssl.org>
    (Merged from https://github.com/openssl/web/pull/132)

-----------------------------------------------------------------------

Summary of changes:
 bin/mk-manpages | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/bin/mk-manpages b/bin/mk-manpages
index efc95b1..6b57ead 100755
--- a/bin/mk-manpages
+++ b/bin/mk-manpages
@@ -64,9 +64,17 @@ sub main {
                 print $fh $out or $class->die("Can't print $outinc: $!");
                 close($fh) or $class->die("Can't close $outinc: $!");
 
-                foreach my $htmlname (
-                    map { (my $x = $_) =~ s|/|-|g; $x }
-                        @{$data{names}}) {
+                my @htmlnames =
+                    map { (my $x = $_) =~ s|/|-|g; $x } @{$data{names}};
+                # Older OpenSSL pods have file names that do not correspond
+                # to any of the names in the NAME section.
+                # Strictly speaking, we shouldn't use that name, but HTML
+                # pages with that name have been produced in the past, so
+                # we keep doing so as long as it's relevant.
+                if (! grep { $_ eq $origbase } @htmlnames) {
+                    push @htmlnames, $origbase;
+                }
+                foreach my $htmlname (@htmlnames) {
                     my $htmlfile = File::Spec->catdir( "man$data{sectnum}",
                                                        "$htmlname.html" );
                     my $outhtml = File::Spec->catfile( $wwwdir, $htmlfile );


More information about the openssl-commits mailing list