Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

documentation to ref function, missing type VSTRING #9492

Closed
p5pRT opened this issue Sep 24, 2008 · 6 comments
Closed

documentation to ref function, missing type VSTRING #9492

p5pRT opened this issue Sep 24, 2008 · 6 comments
Labels
distro-mswin32 documentation

Comments

@p5pRT
Copy link

p5pRT commented Sep 24, 2008

Migrated from rt.perl.org#59264 (status was 'resolved')

Searchable as RT59264$
@p5pRT
Copy link
Author

p5pRT commented Sep 24, 2008

From hans.ginzel@generali.com

Created by hans@matfyz.cz

Builtin type VSTRING is missing in perldoc -f ref
in the list of builtin types.
It is only mentioned in later paragraph.

Perl Info 

Flags:
    category=docs
    severity=low

Site configuration information for perl v5.8.8:

Configured by SYSTEM at Tue Jul 31 19:34:29 2007.

Summary of my perl5 (revision 5 version 8 subversion 8) configuration:
  Platform:
    osname=MSWin32, osvers=5.00, archname=MSWin32-x86-multi-thread
    uname=''
    config_args='undef'
    hint=recommended, useposix=true, d_sigaction=undef
    usethreads=define use5005threads=undef useithreads=define
usemultiplicity=define
    useperlio=define d_sfio=undef uselargefiles=define usesocks=undef
    use64bitint=undef use64bitall=undef uselongdouble=undef
    usemymalloc=n, bincompat5005=undef
  Compiler:
    cc='cl', ccflags ='-nologo -GF -W3 -MD -Zi -DNDEBUG -O1 -DWIN32
-D_CONSOLE -DNO_STRICT -DHAVE_DES_FCRYPT -DNO_HASH_SEED
-DUSE_SITECUSTOMIZE -DPRIVLIB_LAST_IN_INC -DPERL_IMPLICIT_CONTEXT
-DPERL_IMPLICIT_SYS -DUSE_PERLIO -DPERL_MSVCRT_READFIX',
    optimize='-MD -Zi -DNDEBUG -O1',
    cppflags='-DWIN32'
    ccversion='12.00.8804', gccversion='', gccosandvers=''
    intsize=4, longsize=4, ptrsize=4, doublesize=8, byteorder=1234
    d_longlong=undef, longlongsize=8, d_longdbl=define, longdblsize=8
    ivtype='long', ivsize=4, nvtype='double', nvsize=8, Off_t='__int64',
lseeksize=8
    alignbytes=8, prototype=define
  Linker and Libraries:
    ld='link', ldflags ='-nologo -nodefaultlib -debug -opt:ref,icf 
-libpath:"C:\Tools\Perl\lib\CORE"  -machine:x86'
    libpth=\lib
    libs=  oldnames.lib kernel32.lib user32.lib gdi32.lib winspool.lib 
comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib 
netapi32.lib uuid.lib ws2_32.lib mpr.lib winmm.lib  version.lib
odbc32.lib odbccp32.lib msvcrt.lib
    perllibs=  oldnames.lib kernel32.lib user32.lib gdi32.lib winspool.lib
 comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib 
netapi32.lib uuid.lib ws2_32.lib mpr.lib winmm.lib  version.lib
odbc32.lib odbccp32.lib msvcrt.lib
    libc=msvcrt.lib, so=dll, useshrplib=true, libperl=perl58.lib
    gnulibc_version=''
  Dynamic Linking:
    dlsrc=dl_win32.xs, dlext=dll, d_dlsymun=undef, ccdlflags=' '
    cccdlflags=' ', lddlflags='-dll -nologo -nodefaultlib -debug
-opt:ref,icf  -libpath:"C:\Tools\Perl\lib\CORE"  -machine:x86'

Locally applied patches:
    ACTIVEPERL_LOCAL_PATCHES_ENTRY
    Iin_load_module moved for compatibility with build 806
    Avoid signal flag SA_RESTART for older versions of HP-UX
    PerlEx support in CGI::Carp
    Less verbose ExtUtils::Install and Pod::Find
    Patch for CAN-2005-0448 from Debian with modifications
    Rearrange @INC so that 'site' is searched before 'perl'
    Partly reverted 24733 to preserve binary compatibility
    MAINT31223 plus additional changes
    31490 Problem bootstraping Win32CORE
    31324 Fix DynaLoader::dl_findfile() to locate .so files again
    31214 Win32::GetLastError fails when first called
    31211 Restore Windows NT support
    31188 Problem killing a pseudo-forked child on Win32
    29732 ANSIfy the PATH environment variable on Windows
    27527,29868 win32_async_check() can loop indefinitely
    26970 Make Passive mode the default for Net::FTP
    26379 Fix alarm() for Windows 2003
    24699 ICMP_UNREACHABLE handling in Net::Ping


@INC for perl v5.8.8:
    C:\!home\perl\lib
    C:/Tools/Perl/site/lib
    C:/Tools/Perl/lib
    .


Environment for perl v5.8.8:
    HOME (unset)
    LANG (unset)
    LANGUAGE (unset)
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=C:\!home\bin;C:\bin;C:\Tools\Perl\site\bin;C:\Tools\Perl\bin;C:\Tools\Perl\bin;c:\tools\imagemagick-6.3.8-q16;C:\!home\bin;C:\bin;C:\Tools\MiKTeX
2.7\miktex\bin;C:\Oracle\Ora10g\bin;C:\WINDOWS\system32;C:\MySQL\MySQL
Server 5.1\bin
    PERLLIB=C:\!home\perl\lib
    PERL_BADLANG (unset)
    SHELL (unset)

@p5pRT
Copy link
Author

p5pRT commented Sep 24, 2008

From renee.baecker@smart-websolutions.de

Hello Hans,

thanks for your report.

The ref function in Perl 5.8.8 doesn't return VSTRING at all​:
Y​:\>perl -e "print ref \0.2.58"
SCALAR
Y​:\>perl -v

This is perl, v5.8.8 built for MSWin32-x86-multi-thread
(with 18 registered patches, see perl -V for more detail)

But in Perl 5.8.9 it will and Perl 5.10.0 it already does​:

C​:\Perl\bin>.\perl -e "print ref \0.2.58"
VSTRING
C​:\Perl\bin>.\perl -v

This is perl, v5.10.0 built for MSWin32-x86-multi-thread
(with 5 registered patches, see perl -V for more detail)

Attached is a small patch for maint-5.8 that adds "VSTRING" in the docs.
This patch is only for maint-5.8 as it is already documented in 5.10.

Cheers,
Renée

@p5pRT
Copy link
Author

p5pRT commented Sep 24, 2008

From renee.baecker@smart-websolutions.de

perlfunc.patch 
--- perlfunc.pod.orig	2008-09-24 11:01:32.000000000 +0200
+++ perlfunc.pod	2008-09-24 11:02:47.000000000 +0200
@@ -4327,6 +4327,7 @@
     LVALUE
     FORMAT
     IO
+    VSTRING
     Regexp
 
 If the referenced object has been blessed into a package, then that package

@p5pRT
Copy link
Author

p5pRT commented Sep 24, 2008

The RT System itself - Status changed from 'new' to 'open'

@p5pRT
Copy link
Author

p5pRT commented Oct 5, 2008

From @nwc10

On Wed, Sep 24, 2008 at 12​:50​:22AM -0700, Hans Ginzel wrote​:

Builtin type VSTRING is missing in perldoc -f ref
in the list of builtin types.
It is only mentioned in later paragraph.

Thanks for spotting this inconsistency. VSTRING shouldn't have been mentioned
at all, as it's not a built-in until 5.10.0. The error happened because
accidentally merged across a documentation update from the 5.10 branch without
spotting this little stowaway. Fixed by change 34462.

Nicholas Clark

@p5pRT p5pRT closed this as completed Oct 6, 2008
@p5pRT
Copy link
Author

p5pRT commented Oct 6, 2008

module@renee-baecker.de - Status changed from 'open' to 'resolved'

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
distro-mswin32 documentation
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@p5pRT