in reply to help for naming a module that aims latin utf8 coded corpus statistical analysis

I don't know about your choice of module name, but you do need to tidy up your pod. You must have blank lines before and after command paragraphs (lines starting with =). Even a single space on an otherwise blank line breaks some POD parsers.

Blocks of text without intervening blank lines will get reflowed by POD parsers so that your numbered list and the text preceding it become a single blob of text. Similar nastiness happens to your code sample.

For the full story see perlpod and actually test your pod with several different renderers.

Immediate fixes are to indent each line by several spaces for your list, ensure paragraphs are separated from each other by a blank line and make sure that blank lines don't contain white space. Consider:

=head1 NAME Text::CStatiBR - performs corpora statistical analyses =head1 SYNOPSIS use CText::CStatiBR; &Text::CStatiBR::CSTATIBR(); =head1 DESCRIPTION C<Text::CStatiBR> creates a seven column CSV file output with one line + each token per text given as input a corpus that files names follows ' 1 (1). txt', '1 (2). txt', ..., '1 (n).txt' or 1 \(([1-9]|[1-9][0-9]+)\)\.txt Columns stores statistical information: (1) number of word forms in document d; (2) number of tokens in d; (3) Id number of d, ie., n; (4) frequency of term t in d; (5) corpus frequency of t ; (6) document frequency of t (number of documents where t occurs at + least once); (7) t, UTF8 latin coded token-string delimited by /[ -@]|[\[-`]|[{ +-¿]|[&#592;-&#745;]|[&#884;-&#65533;]/ Main output file name is '1 (n + 5).txt' and it is stored in the same +directory as the corpus, together with residual files on each input file with .txu +and .txv ad hoc extensions. This code was written under CAPES BEX-09323-5 =head2 Methods Example: #!/usr/bin/perl use strict; use Text::CStatiBR; &Text::CStatiBR::CSTATIBR("5"); #5 files are analised. #Main output #file created is #1 (10).txt =cut

renders using pod2html (and copying as plain text) as:

* NAME * SYNOPSIS * DESCRIPTION o Methods NAME Text::CStatiBR - performs corpora statistical analyses SYNOPSIS use CText::CStatiBR; &Text::CStatiBR::CSTATIBR(); DESCRIPTION Text::CStatiBR creates a seven column CSV file output with one line ea +ch token per text given as input a corpus that files names follows ' 1 (1). txt', '1 (2). txt', ..., '1 (n).txt' or 1 \(([1-9]|[1-9][0-9]+)\)\.txt Columns stores statistical information: (1) number of word forms in document d; (2) number of tokens in d; (3) Id number of d, ie., n; (4) frequency of term t in d; (5) corpus frequency of t ; (6) document frequency of t (number of documents where t occurs at + least once); (7) t, UTF8 latin coded token-string delimited by C<< /[ -@]|[\[-` +]|[{-¿]|[&#592;-&#745;]|[&#884;-&#65533;]/ >> Main output file name is '1 (n + 5).txt' and it is stored in the s +ame directory as the corpus, together with residual files on each input file with . +txu and .txv ad hoc extensions. This code was written under CAPES BEX-09323-5 Methods Example: #!/usr/bin/perl use strict; use Text::CStatiBR; &Text::CStatiBR::CSTATIBR("5"); #5 files are analised. #Main output #file created is #1 (10).txt

DWIM is Perl's answer to Gödel