openssl3.2 - .pod文件的查看方法

.pod文件的查看方法

概述

看到openssl源码目录下有很多.pod文件, 软件发布的帮助内容都在里面.

当make install后, 大部分的.pod都会转成html文件, 但是有一部分不在转换的范围内.
我知道openssl是用perl干的这事, 还没有去makefile中去查 make install的实现.
找到一种方法, 将pod文件转成html文件, 先用着.

笔记

在本地计算机先找了一圈, 看看还有没有其他软件也有pod文件转html的功能, 找到了:P
我计算机上装了MATLAB-R2022a, 其中有个批处理, 叫pod2html.bat, 看名字挺像. 试试好使.

初步的解决方法

在matlab目录找到pod2html.bat

在自己的工具目录, 建立一个bat. 里面将pod2html.bat的path加入path环境变量, 再启动cmd.

set path=D:\MATLAB\R2022a\sys\perl\win32\bin;%path%
call cmd

然后双击这个cmd, 就可以运行pod2html.bat了
cd /d 转到需要看.pod文件的目录.

cd /d D:\3rd_prj\crypt\openssl-3.2.0\doc\internal\man7

用pod2html.bat进行文件转换, 将.pod转成.html就可以用浏览器看了.

pod2html -infile build.info.pod -outfile build.info.html

备注 - pod2html.bat的详细用法

自带帮助, pod2html.bat --help 就能看到怎么用.

D:\3rd_prj\crypt\openssl-3.2.0\doc\internal\man7>pod2html --help
Usage:  D:\MATLAB\R2022a\sys\perl\win32\bin/pod2html.bat --help --htmldir=<name> --htmlroot=<URL>
           --infile=<name> --outfile=<name>
           --podpath=<name>:...:<name> --podroot=<name>
           --cachedir=<name> --flush --recurse --norecurse
           --quiet --noquiet --verbose --noverbose
           --index --noindex --backlink --nobacklink
           --header --noheader --poderrors --nopoderrors
           --css=<URL> --title=<name>

  --[no]backlink  - turn =head1 directives into links pointing to the top of
                      the page (off by default).
  --cachedir      - directory for the directory cache files.
  --css           - stylesheet URL
  --flush         - flushes the directory cache.
  --[no]header    - produce block header/footer (default is no headers).
  --help          - prints this message.
  --htmldir       - directory for resulting HTML files.
  --htmlroot      - http-server base directory from which all relative paths
                      in podpath stem (default is /).
  --[no]index     - generate an index at the top of the resulting html
                      (default behaviour).
  --infile        - filename for the pod to convert (input taken from stdin
                      by default).
  --outfile       - filename for the resulting html file (output sent to
                      stdout by default).
  --[no]poderrors - include a POD ERRORS section in the output if there were
                      any POD errors in the input (default behavior).
  --podpath       - colon-separated list of directories containing library
                      pods (empty by default).
  --podroot       - filesystem base directory from which all relative paths
                      in podpath stem (default is .).
  --[no]quiet     - suppress some benign warning messages (default is off).
  --[no]recurse   - recurse on those subdirectories listed in podpath
                      (default behaviour).
  --title         - title that will appear in resulting html file.
  --[no]verbose   - self-explanatory (off by default).

好像Perl就自带这个BAT

又全盘搜了一下, 看到perl就自带这个bat…

END