[perl #52334] man page contains "Blah blah blah"

# New Ticket Created by  David Gatwood 
# Please include the string:  [perl #52334]
# in the subject line of all future correspondence about this issue. 
# <URL: http://rt.perl.org/rt3/Ticket/Display.html?id=52334 >



This is a bug report for perl from dgatwood@mac.com,
generated with the help of perlbug 1.35 running under perl v5.8.8.


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

The manual page for "Cyrus::SIEVE::managesieve" is pretty bad.
It doesn't say much at all about the functionality, and adds
"blah blah blah" as filler.  That's pretty embarrassing.  From
the man page:

NAME
        Cyrus::SIEVE::managesieve - Perl extension for blah blah
        blah

SYNOPSIS
          use Cyrus::SIEVE::managesieve;
          blah blah blah

DESCRIPTION
        Call sieve_get_handle to get a handle for further calls.
        sieve_get_error will return a string representing the last
        error, if any.

        Blah blah blah.



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

Configured by root at Sun Sep 23 19:05:56 PDT 2007.

Summary of my perl5 (revision 5 version 8 subversion 8) configuration:
   Platform:
     osname=darwin, osvers=9.0, archname=darwin-thread-multi-2level
     uname='darwin omen.apple.com 9.0 darwin kernel version 9.0.0b5:  
mon sep 10 17:17:11 pdt 2007; root:xnu-1166.6~1release_ppc power  
macintosh '
     config_args='-ds -e -Dprefix=/usr -Dccflags=-g  -pipe  -Dldflags=- 
Dman3ext=3pm -Duseithreads -Duseshrplib'
     hint=recommended, useposix=true, d_sigaction=define
     usethreads=define use5005threads=undef useithreads=define  
usemultiplicity=define
     useperlio=define d_sfio=undef uselargefiles=define usesocks=undef
     use64bitint=define use64bitall=define uselongdouble=undef
     usemymalloc=n, bincompat5005=undef
   Compiler:
     cc='cc', ccflags ='-arch i386 -arch ppc -g -pipe -fno-common - 
DPERL_DARWIN -no-cpp-precomp -fno-strict-aliasing -Wdeclaration-after- 
statement -I/usr/local/include',
     optimize='-O3',
     cppflags='-no-cpp-precomp -g -pipe -fno-common -DPERL_DARWIN -no- 
cpp-precomp -fno-strict-aliasing -Wdeclaration-after-statement -I/usr/ 
local/include'
     ccversion='', gccversion='4.0.1 (Apple Inc. build 5465)',  
gccosandvers=''
     intsize=4, longsize=4, ptrsize=4, doublesize=8, byteorder=4321
     d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=16
     ivtype='long', ivsize=4, nvtype='double', nvsize=8,  
Off_t='off_t', lseeksize=8
     alignbytes=8, prototype=define
   Linker and Libraries:
     ld='cc -mmacosx-version-min=10.5', ldflags ='-arch i386 -arch ppc  
-L/usr/local/lib'
     libpth=/usr/local/lib /usr/lib
     libs=-ldbm -ldl -lm -lutil -lc
     perllibs=-ldl -lm -lutil -lc
     libc=/usr/lib/libc.dylib, so=dylib, useshrplib=true,  
libperl=libperl.dylib
     gnulibc_version=''
   Dynamic Linking:
     dlsrc=dl_dlopen.xs, dlext=bundle, d_dlsymun=undef, ccdlflags=' '
     cccdlflags=' ', lddlflags='-arch i386 -arch ppc -bundle - 
undefined dynamic_lookup -L/usr/local/lib'

Locally applied patches:


---
@INC for perl v5.8.8:
     /System/Library/Perl/5.8.8/darwin-thread-multi-2level
     /System/Library/Perl/5.8.8
     /Library/Perl/5.8.8/darwin-thread-multi-2level
     /Library/Perl/5.8.8
     /Library/Perl
     /Network/Library/Perl/5.8.8/darwin-thread-multi-2level
     /Network/Library/Perl/5.8.8
     /Network/Library/Perl
     /System/Library/Perl/Extras/5.8.8/darwin-thread-multi-2level
     /System/Library/Perl/Extras/5.8.8
     /Library/Perl/5.8.6
     /Library/Perl/5.8.1
     .

---
Environment for perl v5.8.8:
     DYLD_LIBRARY_PATH (unset)
     HOME=/Users/dg
     LANG=en_US.UTF-8
     LANGUAGE (unset)
     LD_LIBRARY_PATH (unset)
     LOGDIR (unset)
     PATH=/opt/local/bin:/opt/local/sbin:/usr/local/php5/bin:/System/ 
Library/Frameworks/Python.framework/Versions/2.3/bin:/usr/bin:/bin:/ 
usr/sbin:/sbin:/usr/local/bin:/usr/X11/bin:/usr/local/bin:/sw/bin
     PERL_BADLANG (unset)
     SHELL=/bin/bash

• [perl #52334] man page contains "Blah blah blah" by David Landgren via RT
• [perl #52334] man page contains "Blah blah blah" by David Gatwood
• Re: [perl #52334] man page contains "Blah blah blah" by H.Merijn Brand