Perl, by default, does not have any specific tokens to specify multiline comments. Nevertheless, there are several workarounds to accomplish this.
The easiest solution is to use the POD system, enclosing the comments between 2 lines: the first line should begin with '=comment' and the last line should begin with '=cut'.
- INVOKING THE DEBUGGER
perl -d script.pl
- QUITTING THE DEBUGGER
NOTE: All the commands below are executed from within the debugger.
- LISTING THE SOURCE CODE
- List next window of lines
- List a specific line
- List first window of lines from a specific subroutine
- View some lines of code around the current line
- Set a breakpoint in the current line:
perldoc -f function
-- READ MODULE DOCUMENTATION
There are 2 ways to get the information:
Example: perldoc CGI
Example: man Mail::Send
-- READ SOURCE CODE
If you want to have a look at both the documentation and source code of a module, run the following:
perldoc -m module
Example: perldoc -m IO::Dir
-- SHOW THE PATH WHERE A MODULE IS INSTALLED
perldoc -l module
Example: perldoc -l Catalyst