Bug 464726

Summary: Formatting in perldoc is horible and makes it almost unreadable
Product: [openSUSE] openSUSE 11.1 Reporter: Adam Jimerson <vendion>
Component: OtherAssignee: Michael Schröder <mls>
Status: RESOLVED DUPLICATE QA Contact: E-mail List <qa-bugs>
Severity: Minor    
Priority: P5 - None    
Version: Final   
Target Milestone: ---   
Hardware: x86-64   
OS: openSUSE 11.1   
Whiteboard:
Found By: --- Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---

Description Adam Jimerson 2009-01-09 02:59:00 UTC
In perldoc formatting of the documentation is riddled with formatting problems, here is the output of perldoc perlsec:

"Perl automatically enables a set of special security checks, called
ESC[4mtaintESC[24
m ESC[4mmodeESC[24m,
when it detects its program running with differing real and effective
user or
group IDs. The setuid bit in Unix permissions is mode 04000, the
setgid bit mode
02000; either or both may be set. You can also enable taint mode
explicitly by
using the ESC[1m-T ESC[22mcommand line flag. This flag is
ESC[4mstronglyESC[24m sugge
sted for server"

Even worse here is the output from perldoc perldoc:

"ESC[1mNAMEESC[0m
       perldoc - Look up Perl documentation in Pod format.

ESC[1mSYNOPSISESC[0m
       ESC[1mperldoc ESC[22m[ESC[1m-hESC[22m] [ESC[1m-vESC[22m] [ESC[1m-tESC[22m] [ESC[1m-u
ESC[22m] [ESC[1m-mESC[22m] [ESC[1m-lESC[22m] [ESC[1m-FESC[22m] [ESC[1m-iESC[22m] [ESC[1m-V
ESC[22m] [ESC[1m-TESC[22m] [ESC[1m-rESC[22m]
       [ESC[1m-dESC[4mdestination_fileESC[24mESC[22m] [ESC[1m-oESC[4mformatnameESC[24mESC[22
m] [ESC[1m-MESC[4mFormatterClassNameESC[24mESC[22m]
       [ESC[1m-wESC[4mformatteroption:valueESC[24mESC[22m] [ESC[1m-nESC[4mESC[22mnroff-repla
cementESC[24m] [ESC[1m-XESC[22m] [ESC[1m-L ESC[4mESC[22mlanguage_codeESC[24m]
       PageName|ModuleName|ProgramName

       ESC[1mperldoc -f ESC[22mBuiltinFunction

       ESC[1mperldoc -L ESC[22mit ESC[1m-f ESC[22mBuiltinFunction

       ESC[1mperldoc -q ESC[22mFAQ Keyword

       ESC[1mperldoc -L ESC[22mfr ESC[1m-q ESC[22mFAQ Keyword

       See below for more description of the switches."

In order to clean it up so that it is readable the user has to give perldoc the -t argument, but doesn't fully fix the formatting issue.
Comment 1 Michael Schröder 2009-01-14 15:02:07 UTC
Duplicate.

*** This bug has been marked as a duplicate of bug 463444 ***