Re^2: Max line length convention in POD?

Maybe they use perltidy of similar tool before committing?

Apparently so and it sets --maximum-line-length=79 so there is an enforcement present. Whether that is run on pure-pod files such as the one nysus is working with is a different matter because the maximum line-length in Tutorial.pod is indeed 83 (plus the EOL).

Update: but only 3 out of the 661 lines in Tutorial.pod are over the 79-character limit so perhaps it should be enforced here. Maybe ask the Dancer devs on IRC for clarification?

Comment on Re^2: Max line length convention in POD? Download Code

Replies are listed 'Best First'.
Re^3: Max line length convention in POD? (pure text) by LanX (Saint) on Dec 06, 2017 at 15:32 UTC
> it sets `--maximum-line-length=79` I'd even reduce line length on pure PODs. A little googling shows that normal print publications tend to limit pure text lines between 45 and 65 characters. This makes sense, since readability depends on easy eye movement and minimized hassle to find the continuing line. Extending this to 70-80 for code is also sensible since indentation adding whitespace to the left and low density of statements per line still allow to move the eye fluently without loosing the line. Consequently dense paragraphs in POD should be limited to 65 at most. Couldn't find a setting for that in Perl::Tidy , but it should be possible in emacs. PS: I have to admit that "hanging" comments on the right make this calculation more complicated. Cheers Rolf _{(addicted to the Perl Programming Language and ☆☆☆☆ :) Wikisyntax for the Monastery}	[reply] [d/l]

Replies are listed 'Best First'.

Re^3: Max line length convention in POD? (pure text)
by LanX (Saint) on Dec 06, 2017 at 15:32 UTC

> it sets --maximum-line-length=79

I'd even reduce line length on pure PODs.

A little googling shows that normal print publications tend to limit pure text lines between 45 and 65 characters.

This makes sense, since readability depends on easy eye movement and minimized hassle to find the continuing line.

Extending this to 70-80 for code is also sensible since

indentation adding whitespace to the left and
low density of statements per line

Consequently dense paragraphs in POD should be limited to 65 at most.

Couldn't find a setting for that in Perl::Tidy , but it should be possible in emacs.

PS: I have to admit that "hanging" comments on the right make this calculation more complicated.

Cheers Rolf
_{(addicted to the Perl Programming Language and ☆☆☆☆ :)

Wikisyntax for the Monastery}

[reply]
[d/l]