[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index][Thread Index][Top&Search][Original]

[perl #59746] Documentation issues with 5.8.8/Math/BigInt.pm



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



This is a bug report for perl from olafs@twoquid.cs.ru.nl,
generated with the help of perlbug 1.35 running under perl v5.8.8.

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

Idly browsing through perldoc Math::BigInt, after reading
http://thedailywtf.com/Articles/Out-of-All-the-Possible-Answers.aspx, I
noticed the following.

The documentation states the following things:

         # lowest common multiplicator (no OO style)
         my $lcm = Math::BigInt::blcm(@values);
...
       blcm

               blcm(@values);          # lowest common multiplicator (no OO styl

I assume (hope!) that what is meant here is the Lowest Common Multiple,
not "multiplicator". A multiplicator is something that multiplies, a
multiple is the result of a multiplication. That is quite something
else. The same incorrect word is used several times in the file.

       bacmp

               $x->bacmp($y);

       Compares $x with $y while ignoring their. Returns -1, 0, 1 or undef.

Ignoring their *what*?


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

Configured by olafs at Tue Feb  5 11:52:36 CET 2008.

Summary of my perl5 (revision 5 version 8 subversion 8) configuration:
  Platform:
    osname=freebsd, osvers=6.1-release, archname=amd64-freebsd
    uname='freebsd twoquid.cs.ru.nl 6.1-release freebsd 6.1-release #2: mon mar 19 15:05:26 cet 2007 root@twoquid.cs.ru.nl:usrsrcsysamd64compiletwoquid amd64 '
    config_args='-sde -Dprefix=/usr/local -Darchlib=/usr/local/lib/perl5/5.8.8/mach -Dprivlib=/usr/local/lib/perl5/5.8.8 -Dman3dir=/usr/local/lib/perl5/5.8.8/perl/man/man3 -Dman1dir=/usr/local/man/man1 -Dsitearch=/usr/local/lib/perl5/site_perl/5.8.8/mach -Dsitelib=/usr/local/lib/perl5/site_perl/5.8.8 -Dscriptdir=/usr/local/bin -Dsiteman3dir=/usr/local/lib/perl5/5.8.8/man/man3 -Dsiteman1dir=/usr/local/man/man1 -Ui_malloc -Ui_iconv -Uinstallusrbinperl -Dcc=cc -Duseshrplib -Dccflags=-DAPPLLIB_EXP="/usr/local/lib/perl5/5.8.8/BSDPAN" -Doptimize=-O2 -fno-strict-aliasing -pipe  -Ud_dosuid -Ui_gdbm -Dusethreads=n -Dusemymalloc=y -Duse64bitint'
    hint=recommended, useposix=true, d_sigaction=define
    usethreads=undef use5005threads=undef useithreads=undef usemultiplicity=undef
    useperlio=define d_sfio=undef uselargefiles=define usesocks=undef
    use64bitint=define use64bitall=define uselongdouble=undef
    usemymalloc=y, bincompat5005=undef
  Compiler:
    cc='cc', ccflags ='-DAPPLLIB_EXP="/usr/local/lib/perl5/5.8.8/BSDPAN" -DHAS_FPSETMASK -DHAS_FLOATINGPOINT_H -fno-strict-aliasing -pipe -Wdeclaration-after-statement -I/usr/local/include',
    optimize='-O2 -fno-strict-aliasing -pipe ',
    cppflags='-DAPPLLIB_EXP="/usr/local/lib/perl5/5.8.8/BSDPAN" -DHAS_FPSETMASK -DHAS_FLOATINGPOINT_H -fno-strict-aliasing -pipe -Wdeclaration-after-statement -I/usr/local/include'
    ccversion='', gccversion='3.4.4 [FreeBSD] 20050518', gccosandvers=''
    intsize=4, longsize=8, ptrsize=8, doublesize=8, byteorder=12345678
    d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=16
    ivtype='long', ivsize=8, nvtype='double', nvsize=8, Off_t='off_t', lseeksize=8
    alignbytes=8, prototype=define
  Linker and Libraries:
    ld='cc', ldflags =' -Wl,-E -L/usr/local/lib'
    libpth=/usr/lib /usr/local/lib
    libs=-lgdbm -lm -lcrypt -lutil
    perllibs=-lm -lcrypt -lutil
    libc=, so=so, useshrplib=true, libperl=libperl.so
    gnulibc_version=''
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags='  -Wl,-R/usr/local/lib/perl5/5.8.8/mach/CORE'
    cccdlflags='-DPIC -fPIC', lddlflags='-shared  -L/usr/local/lib'

Locally applied patches:
    defined-or

---
@INC for perl v5.8.8:
    /usr/local/lib/perl5/5.8.8/BSDPAN
    /usr/local/lib/perl5/site_perl/5.8.8/mach
    /usr/local/lib/perl5/site_perl/5.8.8
    /usr/local/lib/perl5/site_perl
    /usr/local/lib/perl5/5.8.8/mach
    /usr/local/lib/perl5/5.8.8
    .

---
Environment for perl v5.8.8:
    HOME=/home/vb/olafs
    LANG (unset)
    LANGUAGE (unset)
    LC_CTYPE=nl_NL.ISO8859-1
    LD_LIBRARY_PATH=/home/vb/olafs/lib:
    LOGDIR (unset)
    PATH=/usr/X11R6/bin:/home/vb/olafs/bin.FreeBSD:/home/vb/olafs/bin:/usr/local/kun/bin:/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/ucb:/bin:/etc:/usr/etc:/sbin:/usr/sbin:/usr/games:.
    PERL_BADLANG (unset)
    SHELL=/usr/local/bin/bash


[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index][Thread Index][Top&Search][Original]