Search code examples
copensslmanpage

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: enter image description here


Solution

  • "=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<>.