develooper Front page | perl.perl5.porters | Postings from July 2016

[perl #128607] POD: sysseek

Thread Previous | Thread Next
From:
perlbug-followup
Date:
July 12, 2016 19:28
Subject:
[perl #128607] POD: sysseek
Message ID:
rt-4.0.18-26201-1468317365-1529.128607-75-0@perl.org
# New Ticket Created by   
# Please include the string:  [perl #128607]
# in the subject line of all future correspondence about this issue. 
# <URL: https://rt.perl.org/Ticket/Display.html?id=128607 >



This is a bug report for perl from niczero@wow.com,
generated with the help of perlbug 1.40 running under perl 5.24.0.


-----------------------------------------------------------------
The POD for sysseek [perldoc -f sysseek] appears to me to have an
error.  In the second stanza it says

  Note the in bytes: even if the filehandle has been set to operate
  on characters (for example by using the ":encoding(utf8)" I/O
  layer), "tell" will return byte offsets, not character offsets
  (because implementing that would render "sysseek" unacceptably
  slow).

Where it says "tell" I think it should say "sysseek".  I suspect
it shouldn't mention 'tell' at all, other than in the following
stanza.
-----------------------------------------------------------------
---
Flags:
    category=docs
    severity=low
---
Site configuration information for perl 5.24.0:

Configured by root at Mon May 16 22:00:30 BST 2016.

Summary of my perl5 (revision 5 version 24 subversion 0) configuration:
   
  Platform:
    osname=linux, osvers=3.16.0-4-amd64, archname=x86_64-linux
    uname='linux dbdev 3.16.0-4-amd64 #1 smp debian 3.16.7-ckt20-1+deb8u4 (2016-02-29) x86_64 gnulinux '
    config_args='-des'
    hint=recommended, useposix=true, d_sigaction=define
    useithreads=undef, usemultiplicity=undef
    use64bitint=define, use64bitall=define, uselongdouble=undef
    usemymalloc=n, bincompat5005=undef
  Compiler:
    cc='cc', ccflags ='-fwrapv -fno-strict-aliasing -pipe -fstack-protector-strong -I/usr/local/include -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_FORTIFY_SOURCE=2',
    optimize='-O2',
    cppflags='-fwrapv -fno-strict-aliasing -pipe -fstack-protector-strong -I/usr/local/include'
    ccversion='', gccversion='4.9.2', gccosandvers=''
    intsize=4, longsize=8, ptrsize=8, doublesize=8, byteorder=12345678, doublekind=3
    d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=16, longdblkind=3
    ivtype='long', ivsize=8, nvtype='double', nvsize=8, Off_t='off_t', lseeksize=8
    alignbytes=8, prototype=define
  Linker and Libraries:
    ld='cc', ldflags =' -fstack-protector-strong -L/usr/local/lib'
    libpth=/usr/local/lib /usr/lib/gcc/x86_64-linux-gnu/4.9/include-fixed /usr/include/x86_64-linux-gnu /usr/lib /lib/x86_64-linux-gnu /lib/../lib /usr/lib/x86_64-linux-gnu /usr/lib/../lib /lib
    libs=-lpthread -lnsl -ldl -lm -lcrypt -lutil -lc
    perllibs=-lpthread -lnsl -ldl -lm -lcrypt -lutil -lc
    libc=libc-2.19.so, so=so, useshrplib=false, libperl=libperl.a
    gnulibc_version='2.19'
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags='-Wl,-E'
    cccdlflags='-fPIC', lddlflags='-shared -O2 -L/usr/local/lib -fstack-protector-strong'


---
@INC for perl 5.24.0:
    /usr/local/lib/site_perl/x86_64-linux
    /usr/local/lib/site_perl
    /opt/perl/5.24.0/lib/x86_64-linux
    /opt/perl/5.24.0/lib
    .

---
Environment for perl 5.24.0:
    HOME=/home/nsandfield
    LANG=en_GB.UTF-8
    LANGUAGE=en_GB:en
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=/usr/local/bin:/opt/perl/5.24.0/bin:/usr/bin:/bin
    PERL_BADLANG (unset)
    PERL_MB_OPT=--install_base /opt/perl/5.24.0
    PERL_MM_OPT=INSTALL_BASE=/opt/perl/5.24.0
    SHELL=/bin/bash


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