Long script names and POD

Anonymous Monk has asked for the wisdom of the Perl Monks concerning the following question:

When I use perldoc on script names that are somewhat long the header seems to mess up.

Following is the contents of my POD file

=head1 NAME

   SomewhatLongName.pod - This is a test

=head1 SYNOPSIS

    This is the synopsis

=cut
[download]

I run the following

perldoc  SomewhatLongName.pod
[download]

I see the following:

SOMEWHATLONGNAMUser Contributed Perl DocumentaSOMEWHATLONGNAME(1)



NAME
          SomewhatLongName.pod - This is a test

SYNOPSIS
           This is the synopsis



perl v5.8.0                 2013-07-08        SOMEWHATLONGNAME(1)
[download]

The first line is messed up. Also, perldoc converts script name to all upper case. What am I doing wrong here?

Comment on Long script names and POD Select or Download Code

Replies are listed 'Best First'.
Re: Long script names and POD by toolic (Bishop) on Jul 08, 2013 at 19:19 UTC
The first line is not corrupted for me: `SOMEWHATLONGNAME(1) User Contributed Perl Documentation SOMEWHATLON +GNAME(1) NAME SomewhatLongName.pod - This is a test SYNOPSIS This is the synopsis perl v5.12.2 2013-07-08 SOMEWHATLON +GNAME(1)` [download] You are using an old version of Perl. Perhaps the bug you are seeing has been fixed since. perldoc converts the script name to all caps for me, too. I can't remember it ever behaving differently. On linux, even built-in commands, like ls show up in caps. Perl is consistent with that: `man ls LS(1) User Commands + LS(1) NAME ls - list directory contents SYNOPSIS ls [OPTION]... [FILE]... DESCRIPTION List information about the FILEs (the current directory by d +efault). Sort entries alphabetically if none of -cftuvSUX nor --sort.` [download]	[reply] [d/l] [select]
Re^2: Long script names and POD by Anonymous Monk on Jul 08, 2013 at 20:25 UTC
Seems like I have 5.8.0 which is not that old. May be the bug was there with that version? When I do a `perl -v` [download] I get the following `This is perl, v5.8.0 built for i586-linux-thread-multi (with 1 registered patch, see perl -V for more detail) ....` [download]	[reply] [d/l] [select]
Re^3: Long script names and POD by toolic (Bishop) on Jul 08, 2013 at 20:29 UTC
Seems like I have 5.8.0 which is not that old perlhist lists 5.8.0 as 11 years old. There have been 5 major releases since (5.10, 5.12, ... 5.18). Your version is old.	[reply]
Re^4: Long script names and POD by Anonymous Monk on Jul 08, 2013 at 20:49 UTC
Re: Long script names and POD ( cpan Pod::Perldoc ) by Anonymous Monk on Jul 09, 2013 at 02:34 UTC
upgrade Pod::Perldoc `cpan Pod::Perldoc`, the latest runs on 5.8	[reply] [d/l]