Hi
I have encountered a problem whilst building the HTML documentation. All
appears to build successfully, however when I view the file
crypto/crypto.html and click on the link "dsa", this takes me to
apps/dsa.html instead of the expected crypto/dsa.html.
Interestingly the documentation on www.openssl.org does not exhibit this
behavior so either this is a newly introduced problem or it is something
peculiar to my build environment (possibly to do with the version of
pod2html?). I am running Ubuntu 11.10 on AMD64. Perl reports its version as:
This is perl 5, version 12, subversion 4 (v5.12.4) built for
x86_64-linux-gnu-thread-multi
Investigating the problem further I believe the issue is with this line
in Makefile.org:
| pod2html --podroot=doc --htmlroot=..
--podpath=apps:crypto:ssl \
Due to the way podpath is set up pod2html will always search apps first,
followed by crypto, followed by ssl. Since dsa.html will exist in both
apps and crypto, it always finds the apps version first and never the
one in crypto.
A simple change to Makefile.org to always search in the current
directory first resolves this issue:
| pod2html --podroot=doc --htmlroot=..
--podpath=$$subdir:apps:crypto:ssl \
I have attached a patch file making the above change taken against the
cvs HEAD.
Thanks
Matt
Only in openssl-work: Makefile
Only in openssl-work: Makefile.bak
diff -ur openssl-orig/Makefile.org openssl-work/Makefile.org
--- openssl-orig/Makefile.org 2011-11-12 11:57:54.000000000 +0000
+++ openssl-work/Makefile.org 2012-01-07 22:41:07.673912426 +0000
@@ -714,7 +714,7 @@
echo "installing html/$$fn.$(HTMLSUFFIX)"; \
cat $$i \
| sed -r 's/L<([^)]*)(\([0-9]\))?\|([^)]*)(\([0-9]\))?>/L<\1|\3>/g' \
- | pod2html --podroot=doc --htmlroot=.. --podpath=apps:crypto:ssl \
+ | pod2html --podroot=doc --htmlroot=.. --podpath=$$subdir:apps:crypto:ssl \
| sed -r 's/<!DOCTYPE.*//g' \
> $(INSTALL_PREFIX)$(HTMLDIR)/$$subdir/$$fn.$(HTMLSUFFIX); \
$(PERL) util/extract-names.pl < $$i | \
