Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Minor POD issue (no trailing =back tag, specific to RHEL7 / perl 5.16+ / podlaters 2.5+) #30

Open
olagarde opened this issue Jan 6, 2018 · 1 comment

Comments

@olagarde
Copy link

olagarde commented Jan 6, 2018

RHEL7.4
kernel 3.10.0-693.11.6.el7.x86_64
perl perl-5.16.3-292.el7.x86_64
perl-podlators-2.5.1-3.el7.noarch
openca-ocspd-3.1.1.tar.gz

On the latest RHEL7 pod2man requires a closing =back before the final =cut in a pod doc, which {base}/docs/ocspd.3.pod is missing. RHEL6 and perl 5.10 doesn't split pod2man off from the main perl bundle and apparently allows an implicit closing =back (in this case, for closure of the last =over before the final =cut) . By the time you get to RHEL7 and perl 5.16 pod2man has peeled off into perl-podlators 2.5 as the "stock" setup, and podlaters chokes on the implicit/missing =back.

==== stock build ====
...
/usr/bin/pod2man --section=3 --c "OpenCA Contributed Manual" --r "openca-ocspd 3.1.1" ocspd.3.pod > ocspd.3
ocspd.3.pod around line 111: =over without closing =back
POD document had syntax errors at /usr/bin/pod2man line 69.
make[1]: *** [ocspd.3] Error 255
make[1]: Leaving directory '/home/olagarde/20171103-hpcmp-kerberos/BUILD_20180105.175215/openca-ocspd-3.1.1/docs'
...
==== diff-c thingy ====
$ diff -c ./openca-ocspd-3.1.1/docs/ocspd.3.pod.1 ./openca-ocspd-3.1.1/docs/ocspd.3.pod
*** ./openca-ocspd-3.1.1/docs/ocspd.3.pod.1 2018-01-05 18:33:23.382446909 -0600
--- ./openca-ocspd-3.1.1/docs/ocspd.3.pod 2018-01-05 18:33:52.735721320 -0600


*** 112,117 ****
--- 112,119 ----

L<openca(3)>,L<openssl(1)>, L<ocsp(1)>

+ =back
+
=cut

===== patched build =====
...
/usr/bin/pod2man --section=3 --c "OpenCA Contributed Manual" --r "openca-ocspd 3.1.1" ocspd.3.pod > ocspd.3
/usr/bin/pod2man --section=3 --c "OpenCA Contributed Manual" --r "openca-ocspd 3.1.1" ocspd.conf.3.pod > ocspd.conf.3
make[1]: Leaving directory `/home/olagarde/20171103-hpcmp-kerberos/BUILD_20180105.175215/openca-ocspd-3.1.1/docs'
...

@olagarde
Copy link
Author

olagarde commented Jan 6, 2018

Appears fixed in master clone so just waiting on the next release rollup(?)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant