perldoc/POD - 不要在段落中添加额外的行
perldoc/POD - don't add extra line in paragraph
我正在尝试编写一些 POD 文档并使用 perldoc 来显示它。我的目标是让格式看起来像这样:
REQUIRED ARGUMENTS
argument1
Description of the first argument.
argmuent2
Description of the second argument.
其中 "REQUIRED ARGUMENTS" 为粗体 header 而 "argument1" 和 "argument2" 为斜体。
但我不知道如何获得特定的缩进。
我试过这个:
=head1 REQUIRED ARGUMENTS
I<argument1>
Description of the first argument.
I<argument2>
Description of the second argument.
生成以下内容(粗体 header 和斜体正确显示,但不需要描述的 run-on):
REQUIRED ARGUMENTS
argument1 Description of the first argument.
argument2 Description of the second argument.
我试过了:
=head1 REQUIRED ARGUMENTS
I<argument1>
Description of the first argument.
I<argument2>
Description of the second argument.
产生以下内容(同样,粗体和斜体都很好,但现在参数和描述之间多了一行):
REQUIRED ARGUMENTS
argument1
Description of the first argument.
argument2
Description of the second argument.
在其他也没有成功的事情中,我试过这个:
=head1 REQUIRED ARGUMENTS
I<argument1>
=over 4
Description of the first argument.
=back
结果如下:
REQUIRED ARGUMENTS
argument1
Description of the first argument.
使用项目作为参数:
=head1 REQUIRED ARGUMENTS
=over 4
=item I<argument1>
Description of the first argument.
=item I<argument2>
Description of the second argument.
=back
=cut
我正在尝试编写一些 POD 文档并使用 perldoc 来显示它。我的目标是让格式看起来像这样:
REQUIRED ARGUMENTS
argument1
Description of the first argument.
argmuent2
Description of the second argument.
其中 "REQUIRED ARGUMENTS" 为粗体 header 而 "argument1" 和 "argument2" 为斜体。
但我不知道如何获得特定的缩进。
我试过这个:
=head1 REQUIRED ARGUMENTS
I<argument1>
Description of the first argument.
I<argument2>
Description of the second argument.
生成以下内容(粗体 header 和斜体正确显示,但不需要描述的 run-on):
REQUIRED ARGUMENTS
argument1 Description of the first argument.
argument2 Description of the second argument.
我试过了:
=head1 REQUIRED ARGUMENTS
I<argument1>
Description of the first argument.
I<argument2>
Description of the second argument.
产生以下内容(同样,粗体和斜体都很好,但现在参数和描述之间多了一行):
REQUIRED ARGUMENTS
argument1
Description of the first argument.
argument2
Description of the second argument.
在其他也没有成功的事情中,我试过这个:
=head1 REQUIRED ARGUMENTS
I<argument1>
=over 4
Description of the first argument.
=back
结果如下:
REQUIRED ARGUMENTS
argument1
Description of the first argument.
使用项目作为参数:
=head1 REQUIRED ARGUMENTS
=over 4
=item I<argument1>
Description of the first argument.
=item I<argument2>
Description of the second argument.
=back
=cut