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.

Sign up for GitHub

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

perl 5.24.0 missing core doc - perl5240delta.pod #15621

Closed
p5pRT opened this issue Sep 21, 2016 · 6 comments
Closed

perl 5.24.0 missing core doc - perl5240delta.pod #15621

p5pRT opened this issue Sep 21, 2016 · 6 comments
Labels
distro-All documentation Not a Bug

Comments

@p5pRT
Copy link

p5pRT commented Sep 21, 2016

Migrated from rt.perl.org#129328 (status was 'rejected')

Searchable as RT129328$
@p5pRT
Copy link
Author

p5pRT commented Sep 21, 2016

From perl-diddler@tlinx.org

Created by perl-diddler@tlinx.org

I tried to post this bug via https://rt.perl.org/index.html so as not
to have the worthless version info after this, but clicking on
login simply went back to the same screen.

Anyway -- a fundamental piece of documentation is missing
with 5.24​: perl5240delta.pod.

Without a delta, how can one be expected to know what the changes
are? Not sure how perl 5.24.0 got approved for release without,
IMO, something so basic, but I do remember a discussion with
the release agent regarding not pre-announcing an important change
in the perlXdelta.doc, some time ago, and them saying that no one
ever reads those things.

**Ahem**... If they aren't included, that would make sure no one
read them. Naw... no self-fulfilling prophecies here... *snort*.
;-)

Perl Info 

Flags:
    category=docs
    severity=high

Site configuration information for perl 5.16.3:

Configured by law at Wed Jan 22 12:58:58 PST 2014.

Summary of my perl5 (revision 5 version 16 subversion 3) configuration:
   
  Platform:
    osname=linux, osvers=3.12.0-isht-van, archname=x86_64-linux-thread-multi-ld
    uname='linux ishtar 3.12.0-isht-van #1 smp preempt wed nov 13 16:50:51 pst 2013 x86_64 x86_64 x86_64 gnulinux '
    config_args=''
    hint=previous, useposix=true, d_sigaction=define
    useithreads=define, usemultiplicity=define
    useperlio=define, d_sfio=undef, uselargefiles=define, usesocks=undef
    use64bitint=define, use64bitall=define, uselongdouble=define
    usemymalloc=n, bincompat5005=undef
  Compiler:
    cc='gcc', ccflags ='-D_REENTRANT -D_GNU_SOURCE -fno-strict-aliasing -pipe -fstack-protector -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64',
    optimize='-g -O2',
    cppflags='-D_REENTRANT -D_GNU_SOURCE -fno-strict-aliasing -pipe -fstack-protector -D_REENTRANT -D_GNU_SOURCE -fno-strict-aliasing -pipe -fstack-protector -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_REENTRANT -D_GNU_SOURCE -fno-strict-aliasing -pipe -fstack-protector -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64'
    ccversion='', gccversion='4.8.1 20130909 [gcc-4_8-branch revision 202388]', 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='long double', nvsize=16, Off_t='off_t', lseeksize=8
    alignbytes=16, prototype=define
  Linker and Libraries:
    ld='gcc', ldflags ='-g -fstack-protector -fPIC'
    libpth=/usr/lib64 /lib64
    libs=-lnsl -lndbm -lgdbm -ldb -ldl -lm -lcrypt -lutil -lpthread -lc -lgdbm_compat
    perllibs=-lnsl -ldl -lm -lcrypt -lutil -lpthread -lc
    libc=/lib/libc-2.18.so, so=so, useshrplib=true, libperl=libperl-5.16.3.so
    gnulibc_version='2.18'
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags='-Wl,-E -Wl,-rpath,/home/perl/perl-5.16.3/lib/x86_64-linux-thread-multi-ld/CORE'
    cccdlflags='-fPIC', lddlflags='-shared -g -O2 -fstack-protector -fPIC'

Locally applied patches:
    


@INC for perl 5.16.3:
    /home/law/bin/lib
    /home/perl/perl-5.16.3/lib/site/x86_64-linux-thread-multi-ld
    /home/perl/perl-5.16.3/lib/site
    /home/perl/perl-5.16.3/lib/x86_64-linux-thread-multi-ld
    /home/perl/perl-5.16.3/lib
    .


Environment for perl 5.16.3:
    HOME=/home/law
    LANG=en_US.utf8
    LANGUAGE (unset)
    LC_COLLATE=C
    LC_CTYPE=en_US.UTF-8
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=/sbin:.::/home/law/bin:/usr/local/bin:/usr/bin:/bin:/usr/games:/opt/kde3/bin:/usr/lib/mit/bin:/usr/lib/mit/sbin:/usr/sbin:/etc/local/func_lib:/home/law/lib:/home/law/bin/lib
    PERL5OPT=-Mutf8 -CSA -I/home/law/bin/lib
    PERL_BADLANG (unset)
    SHELL=/bin/bash

@p5pRT
Copy link
Author

p5pRT commented Sep 21, 2016

From @dcollinsn

On Wed Sep 21 12​:13​:29 2016, LAWalsh wrote​:

Anyway -- a fundamental piece of documentation is missing
with 5.24​: perl5240delta.pod.

As with - I think all? - maint releases, the current perldelta is installed as perldelta.pod. In perl-5.24.0.tar.gz, this is at pod/perldelta.pod, which starts with the line​:

  perldelta - what is new for perl v5.24.0

In Git at​: http​://perl5.git.perl.org/perl.git/blob/be2c0c650b028f54e427f2469a59942edfdff8a9​:/pod/perldelta.pod

--
Respectfully,
Dan Collins

@p5pRT
Copy link
Author

p5pRT commented Sep 21, 2016

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

@p5pRT
Copy link
Author

p5pRT commented Sep 21, 2016

@dcollinsn - Status changed from 'open' to 'rejected'

@p5pRT p5pRT closed this as completed Sep 21, 2016
@p5pRT
Copy link
Author

p5pRT commented Sep 21, 2016

From zefram@fysh.org

Linda Walsh wrote​:

Anyway -- a fundamental piece of documentation is missing
with 5.24​: perl5240delta.pod.

"perldoc perl5240delta" works for me. It's not named perl5240delta.pod in
the tarball​: it's pod/perldelta.pod, and gets installed under both names.

-zefram

@p5pRT
Copy link
Author

p5pRT commented Sep 21, 2016

From perl-diddler@tlinx.org

On Wed Sep 21 12​:19​:32 2016, dcollinsn@​gmail.com wrote​:

On Wed Sep 21 12​:13​:29 2016, LAWalsh wrote​:

Anyway -- a fundamental piece of documentation is missing
with 5.24​: perl5240delta.pod.

As with - I think all? - maint releases, the current perldelta is
installed as perldelta.pod.

Yes noticed that after the fact...
Sorry for the bother. Though NOTE -- some do read such things... ;-)

@Astara Astara mentioned this issue Feb 7, 2021
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
distro-All documentation Not a Bug
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@p5pRT