GNU logs - #13355, boring messages

Message sent to bug-automake@HIDDEN:

Subject: bug#13355: Deprecating and removing the 'mkinstalldir' script
Resent-From: Stefano Lattarini <stefano.lattarini@HIDDEN>
Original-Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Resent-CC: bug-automake@HIDDEN
Resent-Date: Fri, 04 Jan 2013 10:16:01 +0000
Resent-Message-ID: <handler.13355.B.13572945546889 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 13355 <at> debbugs.gnu.org
Message-ID: <50E6ABC1.5080701@HIDDEN>
Date: Fri, 04 Jan 2013 11:15:29 +0100
From: Stefano Lattarini <stefano.lattarini@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Precedence: list
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org

Severity: wishlist

The 'mksintalldirs' script has been by long superseded by "install-sh -d",
has  already deprecated in the documentation, and already removed in
AUtomake-NG.  I'd like to remove it in future Automake versions.

However, we must first find a viable way to non-fatally deprecate it
with some form of runtime warning.  I haven't yet thought in any detail
about how that; I'm just opening this report to ensure the question
won't slip through the cracks.

Regards,
  Stefano

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.428 (Entity 5.428)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Stefano Lattarini <stefano.lattarini@HIDDEN>
Subject: bug#13355: Acknowledgement (Deprecating and removing the
 'mkinstalldir' script)
Message-ID: <handler.13355.B.13572945546889.ack <at> debbugs.gnu.org>
References: <50E6ABC1.5080701@HIDDEN>
X-Gnu-PR-Message: ack 13355
X-Gnu-PR-Package: automake
Reply-To: 13355 <at> debbugs.gnu.org
Date: Fri, 04 Jan 2013 10:16:01 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-automake@HIDDEN

If you wish to submit further information on this problem, please
send it to 13355 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
13355: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D13355
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-automake@HIDDEN:

Subject: bug#13355: Deprecating and removing the 'mkinstalldir' script
Resent-From: Stefano Lattarini <stefano.lattarini@HIDDEN>
Original-Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Resent-CC: bug-automake@HIDDEN
Resent-Date: Sat, 12 Jan 2013 20:37:01 +0000
Resent-Message-ID: <handler.13355.B.13580229762704 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 13355 <at> debbugs.gnu.org
Message-ID: <50F1C912.5080508@HIDDEN>
Date: Sat, 12 Jan 2013 21:35:30 +0100
From: Stefano Lattarini <stefano.lattarini@HIDDEN>
MIME-Version: 1.0
References: <50E6ABC1.5080701@HIDDEN>
In-Reply-To: <50E6ABC1.5080701@HIDDEN>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Precedence: list
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org

On 01/04/2013 11:15 AM, Stefano Lattarini wrote:
> Severity: wishlist
> 
> The 'mksintalldirs' script has been by long superseded by "install-sh -d",
> has  already deprecated in the documentation, and already removed in
> Automake-NG.  I'd like to remove it in future Automake versions.
> 
> However, we must first find a viable way to non-fatally deprecate it
> with some form of runtime warning.
>
Here is a tentative roadmap:

For Automake 1.13.x:

  - edit 'mkinstalldirs' print a non-fatal warning when invoked (keeping
    its behaviour unchanged in every other aspect); this warning should
    reference the use of "install-sh -d".

  - have automake print a warning in the 'obsolete' category when it
    decides to distribute the 'mkinstalldirs' script only because it
    is found in the AC_CONFIG_AUX_DIR directory (but *not* if the user
    distributes it explicitly, by listing it in EXTRA_DIST).

For Automake 1.14, or even 1.15:

  - turn both the warnings above into fatal errors.

For the next major version after that:

  - remove the mkinstalldir script from our Git repository altogether,
    and drop any special handling of it from the automake script.

This will allow anyone using older Automake versions to still be compatible
with 1.13.2, 1.14 and 1.15 by simply:

  - committing a copy of 'mkinstalldirs' in his repository;
  - explicitly distributing it by having it listed in EXTRA_DIST.

This is quite low priority, so it might be some time before any actual
patches materializes.

Regards,
  Stefano

Message sent to bug-automake@HIDDEN:

Subject: bug#13355: Deprecating and removing the 'mkinstalldir' script
Resent-From: Stefano Lattarini <stefano.lattarini@HIDDEN>
Original-Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Resent-CC: bug-automake@HIDDEN
Resent-Date: Sun, 13 Jan 2013 20:53:02 +0000
Resent-Message-ID: <handler.13355.B13355.135811033211266 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 13355 <at> debbugs.gnu.org
Message-ID: <50F31E5B.6020403@HIDDEN>
Date: Sun, 13 Jan 2013 21:51:39 +0100
From: Stefano Lattarini <stefano.lattarini@HIDDEN>
MIME-Version: 1.0
References: <50E6ABC1.5080701@HIDDEN> <50F1C912.5080508@HIDDEN>
In-Reply-To: <50F1C912.5080508@HIDDEN>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Precedence: list
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org

On 01/12/2013 09:35 PM, Stefano Lattarini wrote:
> On 01/04/2013 11:15 AM, Stefano Lattarini wrote:
>> Severity: wishlist
>>
>> The 'mksintalldirs' script has been by long superseded by "install-sh -d",
>> has  already deprecated in the documentation, and already removed in
>> Automake-NG.  I'd like to remove it in future Automake versions.
>>
>> However, we must first find a viable way to non-fatally deprecate it
>> with some form of runtime warning.
>>
> Here is a tentative roadmap:
> 
> For Automake 1.13.x:
> 
>   - edit 'mkinstalldirs' print a non-fatal warning when invoked (keeping
>     its behaviour unchanged in every other aspect); this warning should
>     reference the use of "install-sh -d".
>
Actually, I'm no longer sure there is a point in mangling a working script
with warnings of dubious usefulness.  A warning at Automake runtime should
be good enough.  Speaking of which ...

>   - have automake print a warning in the 'obsolete' category when it
>     decides to distribute the 'mkinstalldirs' script only because it
>     is found in the AC_CONFIG_AUX_DIR directory (but *not* if the user
>     distributes it explicitly, by listing it in EXTRA_DIST).
>
... this is isn't the truly correct path to deprecation.  A better and
simpler one would be to warn only if 'mkinstalldirs' is *not* listen in
an explicit AC_REQUIRE_AUX_FILE call (which is *the* correct and documented
interface to require auxiliary scripts in Autotools-based projects).

I'll try to cook up a patch along that line (it should be really easy and
minimal at this point).

> For Automake 1.14, or even 1.15:
> 
>   - turn both the warnings above into fatal errors.
>
Now, s/both the warnings/the warning/ of course.

> For the next major version after that:
> 
>   - remove the mkinstalldir script from our Git repository altogether,
>     and drop any special handling of it from the automake script.
>
This stands.

> This will allow anyone using older Automake versions to still be compatible
> with 1.13.2, 1.14 and 1.15 by simply:
> 
>   - committing a copy of 'mkinstalldirs' in his repository;
>
This stands too.

>   - explicitly distributing it by having it listed in EXTRA_DIST.
>
Rather, 'mkinstalldirs' should just be given in a AC_REQUIRE_AUX_FILE
invocation.  This sounds more natural, and is the correct use of APIs.

Regards,
  Stefano

Last modified: Mon, 25 Nov 2019 12:00:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.