pod2man fails with expected text not a number

问题

I am building a legacy version of openSSL to do some testing, but the build is failing. I have already fixed several things, but now have got a new one, the log is reporting that it fails when installing the man pages.

        created directory `/Users/AuserName/Documents/proj/folderName/folderNameA/OpenSSL/tt/OpenSSL-for-iPhone/bin/iPhoneSimulator10.3-i386.sdk/man'
        created directory `/Users/AuserName/Documents/proj/folderName/folderNameA/OpenSSL/tt/OpenSSL-for-iPhone/bin/iPhoneSimulator10.3-i386.sdk/man/man1'
        created directory `/Users/AuserName/Documents/proj/folderName/folderNameA/OpenSSL/tt/OpenSSL-for-iPhone/bin/iPhoneSimulator10.3-i386.sdk/man/man3'
        created directory `/Users/AuserName/Documents/proj/folderName/folderNameA/OpenSSL/tt/OpenSSL-for-iPhone/bin/iPhoneSimulator10.3-i386.sdk/man/man5'
        created directory `/Users/AuserName/Documents/proj/folderName/folderNameA/OpenSSL/tt/OpenSSL-for-iPhone/bin/iPhoneSimulator10.3-i386.sdk/man/man7'
        installing man1/CA.pl.1
        installing man1/asn1parse.1
        installing man1/ca.1
        installing man1/ciphers.1
        installing man1/cms.1
        cms.pod around line 457: Expected text after =item, not a number
        cms.pod around line 461: Expected text after =item, not a number
        cms.pod around line 465: Expected text after =item, not a number
        cms.pod around line 470: Expected text after =item, not a number
        cms.pod around line 474: Expected text after =item, not a number
        POD document had syntax errors at /usr/bin/pod2man5.18 line 72.

The pod files contents in the image so you can see the line numbers:

回答1:

"=item" can only be followed by an option string like in this example:

=item B<--option>

and if you want to pass in values to options, you do something like this:

=item B<--option>=I<value>

Note that the option string has to be enclosed in B<> and the value string has to be enclosed in I<>.

回答2:

It seems that pod2man doesn't dislike numbers in general, but dislikes one specific number: Zero. So try to change all cases of =item 0. to =item 1. and bump potential further =item <some number> by adding 1, too.

Worked fine for me for fixing the same issue in the POD of Net::IRC.

来源：https://stackoverflow.com/questions/45573151/pod2man-fails-with-expected-text-not-a-number

标签

OpenSSL

manpage