Check that the necessary symlinks exist for mconfig and mlint

Merge remote-tracking branch 'remotes/origin/jkeenan/clarify-readme-1'

Merge remote-tracking branch 'origin/ntyni/ls-diff-flags'

parenthesize NV_OVERFLOWS_INTEGERS_AT value

It's a macro that expands to an expression. Parenthesize it for safety.

Provide links to 'dist' documentation.

Fix typo in comment about Configure modification

Make diff flags configurable in ls-diff.pl

My own itch for this is getting unified diffs (now achieved with -D-u).
The default is still just '-w'.

Clarify policy on updates to Configure

Correct one typo and one incorrect command.

Remove U/mksample

The glossary part of this has been removed, and the script has been
moved to Porting/

Additional clarification.

Clarify side-by-side checkouts.

Merge branch 'generalize_paths'

Fix upstream source comment

Update header info for Configure

Update documentation

And thank you Dom for making the tools more usable for all of us

ignore perl symlink

use low-precedence or to sep expressions and actions

Compatibility fixes following review

fix memrchr description

Fix missing 'my' in previous change where use strict was in use

Remove hard-coded paths to /pro/3gl/CPAN

Replace /pro/bin/perl with /usr/bin/perl

Remove obsolete scripts

Add probe for memrchr

Ignore emacs lock files

Correct one spelling error.

don't track vim .swp files

add probes for openat, unlinkat, renameat, linkat and fchmodat

backport of d226c0a2bfaa78c245a5573af5c0f2681f925c8c

check for GCC 6 and 7

backport of b9486474d36974b83d0b00fdcbfd1530299a0f7c

fixed couple of compilation failures with g++ (JHI)

take Rafael's fixes for mlint

Make mconfig more verbose on fail

If a unit erroneously has

?MAKE:  -pick $@ $@

instead of

?MAKE:  -pick $@ %<

it passes with just one make target, but with two make targets, mconfig
fails with

Can't open .

which isn't very helpful

(perl #130108) check if dtrace accepts -xnolibs and use it if available

Backport of f2a60c1f79f4336895ffcbe81f18e49b0228ea44

dtrace without -xnolibs fails in a FreeBSD jail, so we need to supply
it on FreeBSD.

Unfortunately systemtap's dtrace emulation doesn't support -xnolibs so
we need to test if it's available.

And fixed a serious typo in the make-rules

Turn on removal of dot in @INC by default

Backport of 4634f4819b15eb189f3502773a and 12e837793e279bd6e705e920b9

That's it. Dot no longer in @INC.

Zero out high bytes of 80-bit ldnan

1. Backport of dd6885360b15e763e0706dc28555eea328de432d

   fix garbage filtering with 80-bit long doubles

   The test had several problems that resulted in the excess
   bytes not getting zeroed out. This caused random contents in
   $Config{longdblinfbytes}, observed on Debian with GCC 6.2.0 (but not
   5.4.1).

   Bug-Debian: https://bugs.debian.org/844752

2. Backport of 6b2c7479d6d33249c2385d8a36d8ee9e61e1a519

   also zero out high bytes of 80-bit ldnan

   These are currently zero anyway, but things are probably not guaranteed
   to stay so.

Extra note that there is NO need to install dist/meta from github

Assume dist-git will merge our PR's

Cleanups on files being worked on to be PR'd by dist-git

Exclude diffs the will never be resolved

Indicate clean state

In this case we'd just have to wait for upstream to accept the PR

promote dist-git rm_try changes to dist/

No changes left to keep

Allow a pattern for diff matching

ls-diff.pl           => 161 files
ls-diff.pl -p rm_try => 40 files

Missing from previous backport

Exclude DOT from @INC - as agreed on for now

Configure: add defs summarizing doublekind/longdblkind

Backport of 4cb05021f1602b1c29295f791d76ba4b38426f2a

For windows/netware It seems that many of the recent fp definitions
have not been yet copied over there [1] [2], so went mostly by dead
reckoning [3].

[1] Note that many of them are not absolutely necessary for building.
[2] The proper updating involves doing stuff in win32, which I do not have.
[3] As far as I can tell, Windows CE does not really not have long double.

Add option to exclude '.' from @INC

Add scan for IBM and Cray mainframe fp formats.

Backport of 6e6b38aecfbcb229c8568366e3566d7fe7c8bbc5
For completeness: it's quite unlikely Perl would build in those environments.

Though with Cray it's less impossible: Perl used to build in C90
UNICOS, in 5.8-ish timeframe.

With IBM, highly unlikely, because there probably never was a UNIXy
enough environment where the IBM Floating Point Architecture was used.

signbit scan assuming too much

Backport of b76dad153351f50f46ba283bb0da075b93e89838
It was assuming a negative zero, which is an IEEE-754 only concept.

There is no need to assume the negative zero for the correct
functioning of the signbit, however.

Add probe for gai_strerror

Configure: clarify "version-specific"

Backport of commit 6baaafe34b15a5bbc05abd45b1b00f684654bb25
Author: Dan Collins <dcollinsn@gmail.com>
Date:   Mon Jul 4 15:21:05 2016 -0400

    Configure: clarify "version-specific"

    This has long been a confusing configure question. It sounds like
    it saves time by installing /less/, but really it just installs
    binaries with a version number suffix.

VAX Float format H

Backport of commits

Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Wed Jul 27 07:04:02 2016 -0400

    Configure: note that the infnan tests may crash.

    (And in VAX, that is exactly what happens with the infinities.)

commit 86ea01eb2de6e15e79ff54031d7fabfb5f628d4e
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Tue Jul 26 22:10:42 2016 -0400

    Configure: VAX format H

commit a0cc6aaf62d581814737e0f0869cd9ee9d8f88ef
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Mon Jul 25 21:50:32 2016 -0400

    VAX: catch vax floats beyond VMS or Ultrix

commit e90f85309441678b2b41bb1acd37873f9443bb67
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Mon Jul 25 18:57:41 2016 -0400

    VAX: document also formats S/T/X, and hidden bits

    Though S, T, and X are not really pure VAX formats per se.

VAX: Configure changes for VAX floats

Backport of c183cd86045c09fcbba056a606ae50f11c9c5b5a

Detect the VAX floating point formats D and G.

And the F float, but that is float (duh), never likely to be
the double, but do it for consistency (we detect IEEE single
precision floats, too).

The T float and X float are the IEEE 64-bit and 128-bit,
but those were available only on the Alpha.

Tested on vax-netbsd.

[perl #128538] [PATCH] Fix copy/paste error in Configure

New probe for strerror_l()

Requested by Karl Williamson for Perl.

This function is specified by POSIX.1-2008 (and therefore by Single Unix):

http://pubs.opengroup.org/onlinepubs/9699919799/functions/strerror_l.html

New probe for querylocale()

Requested by Karl Williamson for Perl.

This function is known to exist on FreeBSD and Mac OS, for example:

https://www.freebsd.org/cgi/man.cgi?query=querylocale
https://developer.apple.com/library/ios/documentation/System/Conceptual/ManPages_iPhoneOS/man3/querylocale.3.html

dist/meta merge after acceptance upstream

Three down, 161 to go

Finish.U isn't modified anymore

All changes accepted by upstream. One down, 164 to go

Spelling in dist installation

this change has been put as a PR to dist

Remove trailing whitespace on meta-lines in unit files

This change has also been proposed as PR to dist upstream

Confused? You won't be after the next version of pigs in space

I had to think about what the letters meant on every command, so they
were not logical enough. Now with comments in --help

Merged changes to Finish.U

Tweak Csym.U probe to handle GCC 6 -flto

In GCC 6, link-time optimization is smarter at removing references to
functions that never actually get used, so all symbols were being detected
as available. This change constitutes our latest move in this arms race.

Backport of this perl5 commit:

commit adec5bbf0b66ee5ebc2ba80eda2389bb68e23d86
Author:     Lukas Mai <l.mai@web.de>
AuthorDate: Wed May 11 22:15:34 2016 +0200
Commit:     Aaron Crane <arc@cpan.org>
CommitDate: Sat May 14 16:21:36 2016 +0100

    fix symbol detection with gcc 6 link-time optimization (RT #128131)

Don't croak when usecrosscompile but no targethost

Backport of this perl5 commit, for Perl RT#127234:

commit 23695c073f41fdac9d20d873827ba8b2a3dda710
Author:     Niko Tyni <ntyni@debian.org>
AuthorDate: Sun Jan 10 22:35:53 2016 +0200
Commit:     Tony Cook <tony@develop-help.com>
CommitDate: Tue May 10 10:46:13 2016 +1000

    Fix the Configure escape with usecrosscompile but no targethost

    Commit 97076f2 added a graceful exit to Configure when targethost is
    not defined but usecrosscompile is. However, this is not reached because
    there is a similar check a bit earlier that makes Configure bail out.

    Make the earlier check warn instead of croaking.

    The use case for this combination is supplying an external config.sh
    suitable for the target platform, avoiding the need for configuration
    probes.

Bring more dist in line with dist-git

All of these still have been overruled units, so it'll change nothing
in functionality but should ease finding diffs that do matter

[UTIL] Perl system does not default to $_

This doesn't actually affect anything, because no units have a ?MAKE rule
with any actions other than the "pick" pseudo-command. But it seems worth
fixing nonetheless.

[UTIL] mconfig: don't rely on directory order

Update README for FS type and mconfig

removed but saved old dist folder

One down, too many to go

Mass update of *headers* in dist/U from git

This is to simplify identifying upcoming changes

unused leftover

git => dist

These are the simple copies with no changes but the RCS headers

Update dist/U from dist-git/mcon/U

First step.

perl ls-diff.pl will show

  #     Git             Dist              Perl    Diff Unit
=== ========= ====== ========= ====== ========= ====== ======================
  1  3974/135   1113  4014/135   4732  3804/138   4687 Checkcc.U
  2  2327/ 63    696  2372/ 63   2221  2182/ 61   2176 Compile.U
  3  4076/114   2496  4161/114   2463  4153/111   3289 Config_h.U
:
:

size of the unit/number of lines in the unit size of the diff
compared to the next column. Last diff is the size of the diff
between dist-git and modified.

Next steps will include updating dist/U from dist-git/mcon/U
followed by the same updates from dist/U into U (our modified
versions). That last step should either remove our modified
version or result in feedback to Rafael in order to explain
what we changed and why, hoping it'll find its way upstream so
we can remove yet another modified unit not to maintain :)

Expect a flurry of commits to dist/U where only comments and
typoes are fixed.

Remove a module that has no changes to the original from dist

The changes are merely in the RCS headers and these do not conflict
Replace the dist unit with the one from dist-git

[UTIL] New metagrep -F option

Does fixed-string matching, like grep -F.

Probe for and expose the 'fd' field for SA_SIGINFO

Backport of this commit, which is currently on the ilmari/siginfo-fd branch
in perl5.git:

commit 95288b852f4f3a4e7b82ecd37ae330943af64340
Author: Dagfinn Ilmari Mannsåker <ilmari@ilmari.org>
Date:   Wed Feb 3 16:35:15 2016 +0000

    Probe for and expose the 'fd' field for SA_SIGINFO

    This Linux-specific field indicates which FD a SIGIO/SIGPOLL signal
    pertains to.

add d_duplocale and i_locale Configure probes to d_newlocale.U

Backport of this commit, which is currently on the smoke-me/khw-new_locale
branch in perl5.git:

commit 954392da8720867ead32088bd3483655b6623428
Author: Tony Cook <tony@develop-help.com>
Date:   Mon Mar 21 12:12:58 2016 +1100

    add d_duplocale and i_locale Configure probes

cosmetic doc change

Fix wording for glossary of lrint() and related functions

This corrects infelicities in the following:

commit bc580dd327b37b38d4f66d5c335b3e9fc12eaac8
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Mon Feb 2 17:26:16 2015 -0500

    Configure: lrintl, lroundl, llrintl, llroundl

Delete Configure probe for d_modfl_pow32_bug in d_modfl.U

Perl commit 94a2587fdd5c930411410a33daa1209d3ef941ea removed the glossary
entries and the like, but left the Configure probe in place.

Add missing ?H: lines for d_longdbl.U

This should have been part of 9c52d4117799c8de73f4871a148d3bb88fe5214d

Fix 683e3b31e8b72cce

Was committed in perl5 as a1da3d4009387b6065a5116ba3a6cccd85e70168
Author: H.Merijn Brand <h.m.brand@xs4all.nl>
Date:   Sat Oct 10 15:27:09 2015 +0200

    Found when backporting. JHI's reply:

    Oops.

    It should be define:define:define.

    I was trying to stop the test that uses alarm() not to compiled in a
    system where alarm() does not exist.

These two are not required in perl, but got included anyway

We can alway get them from diat-git if we would need them later

Don't add -shared when the compiler is clang++

Backport of f8fbb01c4686d7e4393ba90b2e1326e9536d9107
Author: Chris 'BinGOs' Williams <chris@bingosnet.co.uk>
Date:   Thu Aug 27 15:30:10 2015 +0100

    Don't add -shared when the compiler is clang++

[UTIL] New simplifydiff tool

Pipe a diff into it, and it removes any diff hunk in which every insertion
was deleted by some other part of the diff, and every deletion was inserted
by some other part.

Various updates to float-format probes

Backported from the following:

commit b5897239a0c3c2f5ec699690086b30e7db4305d4
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Tue Dec 8 08:40:38 2015 -0500

    Configure: cannot trust the bytes after the 80-bit fp

    They can be zero, they can be garbage.

commit 3118d7d684b56cbeb702af874f4326683c45f045
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Tue Dec 8 08:48:40 2015 -0500

    Configure: mixed-endian double-doubles

    The ppc64el is the first seen little-endian double-double (and also
    the first little-endian ppc), but it turns out its little-endianness
    is mixed: the doubles are still in big-endian order.  Configure was
    expecting wrongly a fully byte-reversed double-double.

    Therefore extend the long double format detection to cover all the
    (double-double) permutations, though the formats of five and eight
    are rather unlikely (based on current platforms using double-double).

commit 74c6ce8743ba719b8416ce00933e19104484b949
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Thu Dec 10 18:59:53 2015 -0500

    Configure: infnan for mixed-endian double-double

commit 157a0ac7a2e2f56bd291b87c343712def4a1acfb
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Wed Dec 16 21:57:31 2015 -0500

    Configure: notes on the m68881 extended precision format

amigaos4: Configure: syslog extension not feasible

Backport of 57bce8812ba4e6da4ddb13a5a2340d3329ac6cd5
Author: Andy Broad <andy@broad.ology.org.uk>
Date:   Mon Sep 14 10:37:45 2015 -0400

    amigaos4: Configure: syslog extension not feasible

dead symlink

Get rid of the hasfield_t global variable

Try to avoid doubling the cppflags if rerun without removing config.sh

Backport of 76e6b6c7dc4c93d421dfe6c24866c3cd4560b57a
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Fri Oct 16 08:10:40 2015 -0400

    Try to avoid doubling the cppflags if rerun without removing config.sh

    This bug has been here since 2001, introduced by yours truly
    in 58e77565.  Hasn't been too harmful, obviously.  It doubles
    the cppflags only once, thankfully, unlimited doubling would
    probably have been noticed earlier.

    The avoidance maneuver is far from fool-proof.  To be more
    fooler-proofer, some sort of order-preserving deduping would
    be needed.

Another small cleanup

Remove old cruft. It still is in git

compile error after re-running Configure since AmigaOS merge

Backport of b44694539e922b1078113e05f80651c9eedd5d37
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Thu Oct 15 08:39:42 2015 -0400

    rt.perl.org 126152 compile error after re-running Configure since AmigaOS merge

    Configure /proc issues, honor d_procselfexe and procselfexe hints.

Stuff missed in previous commits

Make -O behavior the default

Backport of 41d73075f0801c26794dadb1ff690f305d7e53a7
Author: Ivan Pozdeev <vano@mail.mipt.ru>
Date:   Wed Aug 12 20:33:12 2015 +0300

and the later update

commit 7a4fcb3f64df51eacf89f69a4bf76386aea1e8e3
Author: Aaron Crane <arc@cpan.org>
Date:   Wed Dec 2 00:06:42 2015 +0000

    Configure: unbreak -S option now that -O is the default

    As far as I can tell, using the -S and -O options together has always
    yielded an error of this form:

        Configure: 2042: .: Can't open ./optdef.sh

    That's because, even though optdef.sh is created in the UU directory, and
    most of Configure is run in that directory, part of the -S implementation is
    run in the root directory, and was therefore trying to read ./optdef.sh
    instead of ./UU/optdef.sh.

    As of 41d73075f0801c26794dadb1ff690f305d7e53a7, the -O mode is always
    enabled, so the -S option has been broken since then. This fixes that.

probe in Configure whether dtrace builds an object

backport of:

commit c2538af7458bf317cdc7bc684f65831744010d80
Author: Tony Cook <tony@develop-help.com>
Date:   Wed Mar 9 11:54:13 2016 +1100

    [perl #122287] probe in Configure whether dtrace builds an object

    When building the object file, newer versions of dtrace (on Illumos
    based systems at least) require an input object file that uses
    at least one of the probes defined in the .d file.

    The test in Makefile.SH didn't provide that definition so the test
    would fail, and not build an object file, and fail to link later on,
    on systems that *do* need the object file.

    Moved the probe to Configure (where it probably belongs) and supplied
    an object file that uses a probe.

    Tested successfully on OmniOS (with the new dtrace), Solaris 11,
    and darwin.

commit 5fa8e144165a5c086facccf35630b9c4a781c4ad
Author: David Mitchell <davem@iabyn.com>
Date:   Fri Mar 18 23:29:44 2016 +0000

    Configure: silence 'dtrace -G' probe

    When built with -Dusedtrace, Configure checks to see whether 'dtrace -G'
    is supported, by running it. If it fails, it may spew error messages
    to stderr, so use >/dev/null 2>&1.

[UTIL] Scan each file max once

It does not work in SysV (solaris) or old BSD greps.

Even though -q is POSIX, that does not guarantee succes

Backport of e244340e4067bb332773529bbff797bd14f103de
Author: Jarkko Hietaniemi <jhi@iki.fi>
Date:   Wed Dec 16 20:19:03 2015 -0500

    Configure: grep -q is not portable

    It does not work in SysV (solaris) or old BSD greps.