[perl #125261]

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


To: perlbug@perl.org
Subject: Documentation of wait has 'no sentence'
From: ambs@cpan.org
Reply-To: ambs@cpan.org
Message-Id: <5.20.1_88794_1432756917@stravinski.home>


This is a bug report for perl from ambs@cpan.org,
generated with the help of perlbug 1.40 running under perl 5.20.1.


-----------------------------------------------------------------
[Please describe your issue here]

line 8118 of cpan/Pod-Perldoc/corpus/perlfunc.pod

    If you use wait in your handler for $SIG{CHLD} it may accidentally
    for the child created by qx() or system(). See perlipc for
    details.

It may accidentally do what to the poor child?
Unfortunately my knowledge is limited to know how to fix it.


[Please do not change anything below this line]
-----------------------------------------------------------------
---
Flags:
    category=docs
    severity=low
---
Site configuration information for perl 5.20.1:

Configured by ambs at Wed Sep 17 21:49:58 WEST 2014.

Summary of my perl5 (revision 5 version 20 subversion 1) configuration:
   
  Platform:
    osname=darwin, osvers=13.3.0, archname=darwin-thread-multi-2level
    uname='darwin stravinski.local 13.3.0 darwin kernel version 13.3.0: tue jun 3 21:27:35 pdt 2014; root:xnu-2422.110.17~1release_x86_64 x86_64 '
    config_args=''
    hint=recommended, useposix=true, d_sigaction=define
    useithreads=define, usemultiplicity=define
    use64bitint=define, use64bitall=define, uselongdouble=undef
    usemymalloc=n, bincompat5005=undef
  Compiler:
    cc='cc', ccflags ='-fno-common -DPERL_DARWIN -fno-strict-aliasing -pipe -fstack-protector -I/usr/local/include',
    optimize='-O3',
    cppflags='-fno-common -DPERL_DARWIN -fno-strict-aliasing -pipe -fstack-protector -I/usr/local/include'
    ccversion='', gccversion='4.2.1 Compatible Apple LLVM 5.1 (clang-503.0.40)', 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='env MACOSX_DEPLOYMENT_TARGET=10.3 cc', ldflags =' -fstack-protector -L/usr/local/lib'
    libpth=/usr/local/lib /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/../lib/clang/5.1/lib /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib /usr/lib
    libs=-lgdbm -ldbm -ldb -ldl -lm -lutil -lc
    perllibs=-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 -fstack-protector'


---
@INC for perl 5.20.1:
    /opt/perl/lib/site_perl/5.20.1/darwin-thread-multi-2level
    /opt/perl/lib/site_perl/5.20.1
    /opt/perl//lib/5.20.1/darwin-thread-multi-2level
    /opt/perl//lib/5.20.1
    .

---
Environment for perl 5.20.1:
    DYLD_LIBRARY_PATH=:/usr/local/mysql/lib/
    HOME=/Users/ambs
    LANG=en_US.UTF-8
    LANGUAGE (unset)
    LC_COLLATE=pt_PT.UTF-8
    LC_CTYPE=pt_PT.UTF-8
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=/opt/cwb-3.0/bin:.:/Users/ambs/bin:/opt/perl/bin:/usr/local/bin/:/usr/texbin:/opt/ccache:/Users/ambs/Library/Haskell/bin/:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/X11/bin:/usr/texbin
    PERL_AUTOINSTALL_PREFER_CPAN=1
    PERL_BADLANG (unset)
    PERL_CPANM_OPT=-S
    SHELL=/bin/bash

• [perl #125261] by Alberto Manuel Brandao Simoes
• Re: [perl #125261] by Leon Timmermans