develooper Front page | perl.perl5.porters | Postings from March 2000

[ID 20000322.006] incorrect pod2man output from long =item paragraphs

Thread Previous | Thread Next
From:
Robin Barker
Date:
March 22, 2000 06:06
Subject:
[ID 20000322.006] incorrect pod2man output from long =item paragraphs
Message ID:
200003221405.OAA11103@tempest.npl.co.uk

This is a bug report for perl from rmb1@cise.npl.co.uk,
generated with the help of perlbug 1.28 running under perl v5.6.0.


-----------------------------------------------------------------
[Please enter your report here]

pod2man -lax ~/appl/lib/perl5/5.6.0/pod/perlport.pod | nroff -man

produces 

nroff: Macro argument too long; line 752, file <standard input>

{ I found this from C<perldoc perlport> which gives up and 
  produces raw text }



A number of other pod pages produce strange output because the
text following =item is too long.  For example C<perldoc perl>
produces

DBM implementations)
     o roll-your-
         own magic variables (including multiple simultaneous
         Described in the perltie manpage and the AnyDBM_File
         manpage.

instead of (something like)

     o roll-your-own magic variables (including multiple simultaneous 
     DBM implementations)
         Described in the perltie manpage and the AnyDBM_File
         manpage.


This may be a limitation in nroff, in which case Pod::Man should
trap this an do something sensible with the extra text.  
Otherwise we could rewrite the pods which have these long =item's.

Robin

[Please do not change anything below this line]
-----------------------------------------------------------------
---
Flags:
    category=utilities
    severity=low
---
Site configuration information for perl v5.6.0:

Configured by rmb1 at Tue Mar 21 15:21:17 GMT 2000.

Summary of my perl5 (revision 5.0 version 6 subversion 0) configuration:
  Platform:
    osname=solaris, osvers=2.7, archname=sun4-solaris-64int
    uname='sunos tempest 5.7 generic_106541-04 sun4u sparc sunw,ultra-5_10 '
    config_args='-des -Dcc=gcc -Dprefix=~/appl -Dman1dir=none -Dman3dir=none -Doptimize=-O -g -Dcf_email=rmb1@cise.npl.co.uk -Dcy_by=Robin Barker -Duseperlio -Uinstallusrbinperl -Duselargefiles -Duse64bitint'
    hint=recommended, useposix=true, d_sigaction=define
    usethreads=undef use5005threads=undef useithreads=undef usemultiplicity=undef
    useperlio=define d_sfio=undef uselargefiles=define 
    use64bitint=define use64bitall=undef uselongdouble=undef usesocks=undef
  Compiler:
    cc='gcc', optimize='-O -g', gccversion=2.95.1 19990816 (release)
    cppflags='-DDEBUGGING -fno-strict-aliasing -I/usr/local/include'
    ccflags ='-DDEBUGGING -fno-strict-aliasing -I/usr/local/include -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64'
    stdchar='char', d_stdstdio=define, usevfork=false
    intsize=4, longsize=4, ptrsize=4, doublesize=8
    d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=16
    ivtype='long long', ivsize=8, nvtype='double', nvsize=8, Off_t='off_t', lseeksize=8
    alignbytes=8, usemymalloc=y, prototype=define
  Linker and Libraries:
    ld='gcc', ldflags =' -L/usr/local/lib '
    libpth=/usr/local/lib /lib /usr/lib /usr/ccs/lib
    libs=-lsocket -lnsl -ldl -lm -lc -lcrypt -lsec
    libc=/lib/libc.so, so=so, useshrplib=false, libperl=libperl.a
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags=' '
    cccdlflags='-fPIC', lddlflags='-G -L/usr/local/lib'

Locally applied patches:
    v5.6.0-RC3

---
@INC for perl v5.6.0:
    /home/rmb1/appl/lib/perl5/site_perl/5.005
    /home/rmb1/appl/lib/perl5/5.6.0/sun4-solaris-64int
    /home/rmb1/appl/lib/perl5/5.6.0
    /home/rmb1/appl/lib/perl5/site_perl/5.6.0/sun4-solaris-64int
    /home/rmb1/appl/lib/perl5/site_perl/5.6.0
    /home/rmb1/appl/lib/perl5/site_perl
    .

---
Environment for perl v5.6.0:
    HOME=/home/rmb1
    LANG=C
    LANGUAGE (unset)
    LD_LIBRARY_PATH=/usr/lib
    LOGDIR (unset)
    PATH=/home/rmb1/appl/script:/usr/tempest/bin:/usr/local/bin:/usr/local/Admigration/exec:/usr/local/hotjava/bin:/usr/openwin/bin:/usr/dt/bin:/usr/ccs/bin:/usr/bin
    PERL5LIB=/home/rmb1/appl/lib/perl5/site_perl/5.005
    PERL_BADLANG (unset)
    SHELL=/bin/csh

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About