Skip to content

Conversation

1-1sam
Copy link

@1-1sam 1-1sam commented Aug 2, 2025

Currently, Pod::Usage will completely lowercase all words in a heading if they contain three or less characters when using -verbose 99. This behavior can provide undesirable results for some headings. For example, a heading named SEE ALSO will be formatted as see Also.

=head1 SEE ALSO
...
see Also
    ...

This PR adds some additional formatting logic that ensures the first word of a heading has its first character uppercased regardless of length. This means that the above SEE ALSO example will now be formatted as See Also. I believe this behavior will provide more desirable output for most users.

@1-1sam 1-1sam changed the title Do not completely lowecase the first word in a heading Do not completely lowercase the first word in a heading Aug 2, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant