在 pod item 中使用星号作为文本

Question

我正在以 POD 格式编写我的 perl 文档
我的问题是，我想要一个名为 * 的项目标签

我试过=item * 、 =item S<*> 、 =item Z<>*和=item E<42>

所有方法都被解释为项目符号，但我希望星号被解释为普通文本
任何想法，我如何在不添加更多文本（如=item "*"情况下解决这个问题？

我不确定这是否有帮助，但这是一个小例子（我放弃了空行）：

=pod
=head1 HEAD
=over 4
=item a
A
=item *
B
=item c
C
=back
=cut

在使用 pod2text、pod2html 等之前，我使用podchecker检查我的文档。
它说=item type mismatch ('definition' vs. 'bullet')
我一开始没有说这个，因为我认为每个转换器都取决于 podchecker 的解释

Answer 1

如果您显示您正在寻找的确切输出以及您获得的输出，这将有所帮助。

我可以让星号出现在perldoc的输出中，只要我把它设为第二个=item ：

=head1 OPTIONS

=over 5

=item help

Help me!

=item *

Asterisk

=back

=cut

这是我从perldoc得到的输出：

OPTIONS
       help Help me!

       *    Asterisk

这是来自perlpod的相关引用：

也许最重要的是，保持项目一致：要么对所有项目使用“=item *”，以生成子弹； 或使用“=item 1.”、“=item 2.”等，生成编号列表； 或使用“=item foo”、“=item bar”等——即，看起来不像子弹或数字的东西。

如果您从项目符号或数字开始，请坚持使用它们，因为格式化程序使用第一个“=item”类型来决定如何格式化列表。

另请参阅：避免不一致的 POD =over =item 缩进

Answer 2

好的，到目前为止我发现的最好的解决方案是使用=item S< >*产生输出

HEAD
    a   A

     *  B

    c   C

不完全是我想要的（* 有点偏离）但无论如何