# Perl POD Documentation In Perl, you can embed POD (Plain Old Documentation) within modules or scripts. POD is a simple and easy-to-use markup language. POD documentation usage rules: > POD documentation starts with **=head1** and ends with **=cut**. Add an empty line before **=head1** and after **=cut**. Perl ignores the documentation within POD. Example: ## Example #!/usr/bin/perl print"Hello, Worldn"; =head1 Hello, World Example This is a simple Perl example. =cut print"Hello, Tutorialn"; Executing the above program, the output is: Hello, WorldHello, We can also use "__END__" or "__DATA__" to "comment out" everything after that line: ## Example #!/usr/bin/perl print"Hello, Worldn"; while(){print$_; } __END__ =head1 Hello, World Example This is a simple Perl example. print "Hello, Tutorialn"; Executing the above program, the output is: Hello, World=head1 Hello, World ExampleThis is a simple Perl example.print "Hello, Tutorialn"; The following example does not read the POD documentation: ## Example #!/usr/bin/perl print"Hello, Worldn"; __END__ =head1 Hello, World Example This is a simple Perl example. print "Hello, Tutorialn"; Executing the above program, the output is: Hello, World * * * ## What is POD? Pod (Plain Old Documentation) is a simple and easy-to-use markup language, commonly used for writing documentation within Perl programs and modules. Pod converters can transform Pod into many formats, such as text, html, man, etc. Pod markup language contains three basic types: Verbatim, Paragraph, and Command. * **Paragraphs**: You can use formatting codes within paragraphs, such as bold, italic, or code style, underline, etc. * **Verbatim Paragraphs**: Verbatim paragraphs are used for code blocks or other parts that do not require converter processing, and do not require paragraph reformatting. * **Command Paragraphs**: Command paragraphs apply to the entire document, typically used for setting headings or list markers. All command paragraphs (which are only one line long) start with "=", followed by an identifier. The subsequent text will be affected by this command. Currently widely used commands include: =pod (Start document)=head1 Heading Text=head2 Heading Text=head3 Heading Text=head4 Heading Text=over Indentation Spaces=item Prefix=back (End list)=begin Format=end End Format=for Format Text=encoding Encoding Type=cut (End document) In Perl, you can use pod2html **.pod >**.html to generate HTML format POD documentation. Consider the following POD example: ## Example =begin html =encoding utf-8 =head1 =cut When using pod2html, this code block will be copied verbatim. Use the pod2html command to execute, converting it to HTML code: $ pod2html test.pod > test.html Open test.html in a browser, the links section is an index, displayed as follows: !(#) The following example writes HTML directly into the POD documentation: =begin html =encoding utf-8

www.

=end html When using pod2html, this code block will be copied verbatim. Use the pod2html command to execute, converting it to HTML code: $ pod2html test.pod > test.html Open test.html in a browser, the links section is an index, displayed as follows: !(#)