[perl #125933] Documentation tweak for perldebug POD

# New Ticket Created by  John SJ Anderson 
# Please include the string:  [perl #125933]
# in the subject line of all future correspondence about this issue. 
# <URL: https://rt.perl.org/Ticket/Display.html?id=125933 >



When looking something up in the perldebug POD, I noticed that it
still referring to using the '-w' switch. This patch updates that to
refer to 'use warnings' instead.

-----------------------------------------------------------------
---
Flags:
    category=docs
    severity=wishlist
    Type=Patch
    PatchStatus=HasPatch
---
Site configuration information for perl 5.22.0:

Configured by genehack at Mon Jul 20 12:50:39 PDT 2015.

Summary of my perl5 (revision 5 version 22 subversion 0) configuration:

  Platform:
    osname=darwin, osvers=14.4.0, archname=darwin-2level
    uname='darwin phineas.home.genehack.org 14.4.0 darwin kernel version 14.4.0: thu may 28 11:35:04 pdt 2015; root:xnu-2782.30.5~1release_x86_64 x86_64 i386 macbookair4,2 darwin '
    config_args='-Dprefix=/opt/plenv/versions/5.22.0 -de -Dusedevel -A'eval:scriptdir=/opt/plenv/versions/5.22.0/bin''
    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 ='-fno-common -DPERL_DARWIN -fno-strict-aliasing -pipe -fstack-protector-strong -I/opt/local/include',
    optimize='-O3',
    cppflags='-fno-common -DPERL_DARWIN -fno-strict-aliasing -pipe -fstack-protector-strong -I/opt/local/include'
    ccversion='', gccversion='4.2.1 Compatible Apple LLVM 6.1.0 (clang-602.0.53)', 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='env MACOSX_DEPLOYMENT_TARGET=10.3 cc', ldflags =' -fstack-protector-strong -L/usr/local/lib -L/opt/local/lib'
    libpth=/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/../lib/clang/6.1.0/lib /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib /usr/lib /usr/local/lib /opt/local/lib
    libs=-lpthread -ldbm -ldl -lm -lutil -lc
    perllibs=-lpthread -ldl -lm -lutil -lc
    libc=, so=dylib, useshrplib=false, libperl=libperl.a
    gnulibc_version=''
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=bundle, d_dlsymun=undef, ccdlflags=' '
    cccdlflags=' ', lddlflags=' -bundle -undefined dynamic_lookup -L/usr/local/lib -L/opt/local/lib -fstack-protector-strong'

Locally applied patches:
    Devel::PatchPerl 1.30

---
@INC for perl 5.22.0:
    /opt/plenv/versions/5.22.0/lib/perl5/site_perl/5.22.0/darwin-2level
    /opt/plenv/versions/5.22.0/lib/perl5/site_perl/5.22.0
    /opt/plenv/versions/5.22.0/lib/perl5/5.22.0/darwin-2level
    /opt/plenv/versions/5.22.0/lib/perl5/5.22.0
    .

---
Environment for perl 5.22.0:
    DYLD_LIBRARY_PATH (unset)
    HOME=/Users/genehack
    LANG=en_US.UTF-8
    LANGUAGE (unset)
    LC_ALL=en_US.UTF-8
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=/opt/plenv/versions/5.22.0/bin:/opt/plenv/libexec:/opt/plenv/plugins/perl-build/bin:/opt/plenv/shims:/opt/plenv/bin:/Users/genehack/bin:/opt/sbt/bin:/opt/scala/bin:/opt/play:/opt/go/bin:/opt/vim/bin:/opt/tmux/bin:/opt/sml/bin:/opt/ruby/bin:/opt/rust/bin:/opt/python/bin:/opt/node/bin:/opt/git/bin:/opt/emacs/b
in:/opt/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/usr/X11/bin:/Users/genehack/proj/go/bin
    PERL_BADLANG (unset)
    PERL_CPANM_OPT=--skip-installed --prompt
    SHELL=/bin/zsh


---
Attachment(s):
    0001-Replace-w-ref-in-SEE-ALSO-with-use-warnings.patch

>From 759289065c713b0b033d9786355c2f8f1764155f Mon Sep 17 00:00:00 2001
From: John SJ Anderson <gene...@genehack.org>
Date: Thu, 27 Aug 2015 18:17:06 -0700
Subject: [PATCH] Replace '-w' ref in SEE ALSO with 'use warnings'

---
 pod/perldebug.pod | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pod/perldebug.pod b/pod/perldebug.pod
index 8ad8349..d4d7af9 100644
--- a/pod/perldebug.pod
+++ b/pod/perldebug.pod
@@ -1197,7 +1197,7 @@ See L<perldebguts/"Debugging Perl Memory Usage"> for the details.
 
 =head1 SEE ALSO
 
-You did try the B<-w> switch, didn't you?
+You do have C<use warnings> enabled, don't you?
 
 L<perldebtut>,
 L<perldebguts>,
-- 
2.5.0