Plain Old Text Documentation in Perl Programming Last Updated : 01 Jun, 2020 Comments Improve Suggest changes Like Article Like Report POD is a markup language used for writing documentation for Perl, Perl programs, and Perl modules. It is simple to use. There are various translators available for converting Pod to different formats such as plain text, HTML, man pages, and more. Pod markup comprises of three kinds of paragraphs : Ordinary Paragraph: For bold, italic, code-style, hyperlinks, and more use formatting code in ordinary graphVerbatim Paragraph: Code block or other text which does not require any special parsing or formatting are implemented using, and these should not be wrapped too.Command Paragraph: A command paragraph is used for chunks of text, usually used as headings or parts of lists. Command paragraphs start with =, followed by an identifier and an arbitrary text To embed Pod (Plain Old Text) documentation in Perl modules and scripts , use embedded documentation in your Perl Code by using following rules: Start your documentation with an empty linePlace a '=head1' command at the beginning Place a '=cut' command at end Note : Perl will ignore the Pod (Plain Old Text) text you entered in the code Example: =head1 SYNOPSIS [GEEKSFORGEEKS]. =cut Following mentioned is a simple example of using embedded documentation inside your Perl code perl #!/usr/bin/perl print "Hello, World\n"; =head1 Hello, World Example This example demonstrate very basic syntax of Perl. =cut print "Hello, geeksforgeeks\n" Output: Hello, World Hello, geeksforgeeks If Pod is put at the end of the file, and you are using an __END__ or __DATA__ cut mark, then make sure that you put an empty line before the first Pod command, otherwise without an empty line before the =head1, many translators will not recognize the =head1 as starting a Pod block. Perl #!/usr/bin/perl print "Hello, World\n"; while(<DATA>) { print $_; } __END__ =head1 Hello, World Example This example demonstrate very basic syntax of Perl. print "Hello, geeksforgeeks\n"; Output: Hello, World =head1 Hello, World Example This example demonstrate very basic syntax of Perl. print "Hello, geeksforgeeks\n"; Comment More infoAdvertise with us Next Article Plain Old Text Documentation in Perl Programming K kaurbal1698 Follow Improve Article Tags : Perl Similar Reads Perl | Basic Syntax of a Perl Program Perl is a general purpose, high level interpreted and dynamic programming language. Perl was originally developed for the text processing like extracting the required information from a specified text file and for converting the text file into a different form. Perl supports both the procedural and 10 min read Object Oriented Programming (OOPs) in Perl Object-oriented programming: As the name suggests, Object-Oriented Programming or OOPs refers to languages that uses objects in programming. Object-oriented programming aims to implement real-world entities like inheritance, hiding, polymorphism, etc in programming. The main aim of OOP is to bind to 7 min read Perl | CGI Programming In Perl, CGI(Common Gateway Interface) is a protocol for executing scripts via web requests. It is a set of rules and standards that define how the information is exchanged between the web server and custom scripts. Earlier, scripting languages like Perl were used for writing the CGI applications. A 5 min read Perl - Attributes in Object Oriented Programming In Perl, Object Oriented concept is very much based on references and Arrays/Hashes. The few main terms of object-oriented programming with respect to Perl programming are object, class, and method. In Perl, an object is like a reference to a data type that knows about the class it belongs to. The o 6 min read Perl | Multi-line Strings | Here Document A string in Perl is a scalar variable and it can contain alphabets, numbers, special characters. The string can consist of a single word, a group of words or a multi-line paragraph. Multi-line string is required in a scenario where the user wants a complete paragraph or a group of paragraphs as a st 4 min read Function Signature in Perl A Perl function or subroutine is a group of statements that together perform a specific task. In every programming language user want to reuse the code. So the user puts the section of code in function or subroutine so that there will be no need to write code again and again. In Perl, the terms func 5 min read Use of print() and say() in Perl Perl uses statements and expressions to evaluate the input provided by the user or given as Hardcoded Input in the code. This evaluated expression will not be shown to the programmer as it's been evaluated in the compiler. To display this evaluated expression, Perl uses print() function and say() fu 3 min read Perl | String functions (length, lc, uc, index, rindex) String in Perl is a sequence of character enclosed within some kinds of quotation marks. Perl string can contain UNICODE, ASCII and escape sequence characters. Perl provides the various function to manipulate the string like any other programming language. Some string functions of Perl are as follow 4 min read Perl Programming Language Perl is a general purpose, high level interpreted and dynamic programming language. Perl supports both the procedural and Object-Oriented programming. Perl is a lot similar to C syntactically and is easy for the users who have knowledge of C, C++. Since Perl is a lot similar to other widely used lan 3 min read Hello World Program in Perl Perl programming language is exclusively designed for text processing purposes. Its abbreviation denotes Practical Extraction and Report Language. It is compatible on various platforms, such as Windows, Mac OS, and almost all versions of UNIX. Hello World! program in every programming language gives 3 min read Like