[ID 19991001.002] $^W documentation

This is a bug report for perl from root@brutos.mchh3.oen.siemens.de,
generated with the help of perlbug 1.26 running under perl 5.00503.


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

This is more a hint than a bug, and possibly it's already known
- sorry then. The report concerns the documentation of $^W.
Currently, it implies that $^W=0 disables -w, in other words,
that $^W and -w are synonyms. But this is not completely true
because of the two phases precompilation and runtime - a $^W
assignment outside BEGIN scopes does NOT affect warnings produced
by the compiler, e.g. "Variable used only once."

So I propose to simply add a more detailed explanation where
$^W influences which warnings.

Greetings

	J. Stenzel

[Please do not change anything below this line]
-----------------------------------------------------------------

---
Site configuration information for perl 5.00503:

Configured by root at Wed Apr  7 18:28:49 MET DST 1999.

Summary of my perl5 (5.0 patchlevel 5 subversion 3) configuration:
  Platform:
    osname=solaris, osvers=2.6, archname=sun4-solaris-thread
    uname='sunos brutos 5.6 generic_105181-12 sun4u sparc sunw,ultra-5_10 '
    hint=recommended, useposix=true, d_sigaction=define
    usethreads=define useperlio=undef d_sfio=undef
  Compiler:
    cc='gcc -B/usr/ccs/bin/', optimize='-O', gccversion=2.8.1
    cppflags='-D_REENTRANT -I/usr/local/include -I/opt/gnu/include'
    ccflags ='-D_REENTRANT -I/usr/local/include -I/opt/gnu/include'
    stdchar='unsigned char', d_stdstdio=define, usevfork=false
    intsize=4, longsize=4, ptrsize=4, doublesize=8
    d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=16
    alignbytes=8, usemymalloc=y, prototype=define
  Linker and Libraries:
    ld='gcc -B/usr/ccs/bin/', ldflags =' -L/usr/local/lib -L/opt/gnu/lib'
    libpth=/usr/local/lib /opt/gnu/lib /lib /usr/lib /usr/ccs/lib
    libs=-lsocket -lnsl -lgdbm -ldl -lm -lposix4 -lpthread -lc -lcrypt
    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 -L/opt/gnu/lib'

Locally applied patches:
    

---
@INC for perl 5.00503:
    /usr/local/perl5.005/lib/5.00503/sun4-solaris-thread
    /usr/local/perl5.005/lib/5.00503
    /usr/local/perl5.005/lib/site_perl/5.005/sun4-solaris-thread
    /usr/local/perl5.005/lib/site_perl/5.005
    .

---
Environment for perl 5.00503:
    HOME=/user/ets
    LANG (unset)
    LANGUAGE (unset)
    LD_LIBRARY_PATH=/data/staroffice_sun5/solaris-sparc/lib:/data/staroffice_sun5/solaris-sparc/lib:/data/staroffice_sun5/solaris-sparc/lib:/data/SPARCworks_SunOS5_sho51_3.1/lib:/usr/dt/lib:/usr/openwin/lib:/usr/lib:/usr/ucblib
    LOGDIR (unset)
    PATH=/data/staroffice_sun5/solaris-sparc/bin:/data/staroffice_sun5/solaris-sparc/bin:/data/staroffice_sun5/solaris-sparc/bin:/data/SPARCworks_SunOS5_sho51_3.1/bin:/data/SPARCworks_SunOS5_sho51_3.1/SC4.0/bin:/user/ets/5bin:/usr/dt/bin:/usr/openwin/bin:/usr/bin:/usr/sbin:/sbin:/usr/ccs/bin:/usr/local/bin:/usr/ucb:/data/cs_132.29/system/tools:/data/ars_SunOS5/bin:.:/user/ets/bin:/etc:/pro/radix/bin:/pro/radix/master/ghosts:/pro/radix/master/master_tools:/pro/radix/master/help_tools:/opt/SUNWwabi/bin:/usr/atria/bin:/user/ets/perl/sdf/bin:/tool/alocal/kde/bin:/usr/atria/bin:/user/ets/perl/sdf/bin:/tool/alocal/kde/bin:/usr/atria/bin:/user/ets/perl/sdf/bin:/tool/alocal/kde/bin
    PERL_BADLANG (unset)
    SHELL=/bin/csh

• [ID 19991001.002] $^W documentation by jochen.stenzel.gp
• Re: [ID 19991001.002] $^W documentation by Tom Phoenix