GNU logs - #13624, boring messages


Message sent to bug-automake@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#13624: ACLOCAL_PATH documentation
Resent-From: taylanbayirli@HIDDEN (Taylan Ulrich B.)
Original-Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Resent-CC: bug-automake@HIDDEN
Resent-Date: Mon, 04 Feb 2013 00:16:02 +0000
Resent-Message-ID: <handler.13624.B.135993692931595 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: report 13624
X-GNU-PR-Package: automake
X-GNU-PR-Keywords: 
To: 13624 <at> debbugs.gnu.org
X-Debbugs-Original-To: bug-automake@HIDDEN
Received: via spool by submit <at> debbugs.gnu.org id=B.135993692931595
          (code B ref -1); Mon, 04 Feb 2013 00:16:02 +0000
Received: (at submit) by debbugs.gnu.org; 4 Feb 2013 00:15:29 +0000
Received: from localhost ([127.0.0.1]:34683 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1U29ia-0008DY-Sa
	for submit <at> debbugs.gnu.org; Sun, 03 Feb 2013 19:15:29 -0500
Received: from eggs.gnu.org ([208.118.235.92]:60861)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <taylanbayirli@HIDDEN>) id 1U29iZ-0008DR-AY
	for submit <at> debbugs.gnu.org; Sun, 03 Feb 2013 19:15:27 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <taylanbayirli@HIDDEN>) id 1U29hX-0004v4-2k
	for submit <at> debbugs.gnu.org; Sun, 03 Feb 2013 19:14:25 -0500
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,FREEMAIL_FROM,
	RCVD_IN_DNSWL_LOW,T_DKIM_INVALID autolearn=unavailable version=3.3.2
Received: from lists.gnu.org ([208.118.235.17]:49120)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <taylanbayirli@HIDDEN>) id 1U29hW-0004v0-Vo
	for submit <at> debbugs.gnu.org; Sun, 03 Feb 2013 19:14:23 -0500
Received: from eggs.gnu.org ([208.118.235.92]:43978)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <taylanbayirli@HIDDEN>) id 1U29hU-0005Q2-K9
	for bug-automake@HIDDEN; Sun, 03 Feb 2013 19:14:22 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <taylanbayirli@HIDDEN>) id 1U29hR-0004uO-30
	for bug-automake@HIDDEN; Sun, 03 Feb 2013 19:14:20 -0500
Received: from mail-ea0-f176.google.com ([209.85.215.176]:55305)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <taylanbayirli@HIDDEN>) id 1U29hQ-0004u3-T1
	for bug-automake@HIDDEN; Sun, 03 Feb 2013 19:14:17 -0500
Received: by mail-ea0-f176.google.com with SMTP id a13so2408960eaa.7
	for <bug-automake@HIDDEN>; Sun, 03 Feb 2013 16:14:15 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
	h=x-received:date:message-id:from:to:subject;
	bh=sG6AKwffl6Q1Ge2QUEpSJv0B96T9DfzTVOxcIbKZT2U=;
	b=ljoGuLMNqj5nUWp4Ke2rKtX4brsXXBCsrOQk/QYi7Ru1xHtbwo/+5NKEpF2D9liOqB
	d/enqiLpoXKLIfdd2VdSr9+jkJ7kIcZBO9MGyal+fKinbXvtuGFt+wvA9xfQf+lH6KTM
	LhQrRA+z5RJla20Fuf0h+muSGGwrTDOs0i3kMD615xP8Clzs246Q0aLxkt0P2J5P7Ae5
	G3bgwBfSHCqrMjeF0CEYVS5BzkxZLpjimnyT2DOx1g9Xcb+Ge70Eq4BQkzWfBuMwdTMn
	YT/pL6UCfxY1WmwNBPG9wB5jZnmxWs2MSoGMZrKBtqcZ+meTmh+vx770tkYqR361uv9E
	yEeA==
X-Received: by 10.14.213.131 with SMTP id a3mr32048547eep.24.1359936855649;
	Sun, 03 Feb 2013 16:14:15 -0800 (PST)
Received: from taylan.dyndns.org (p4FD91F6D.dip.t-dialin.net. [79.217.31.109])
	by mx.google.com with ESMTPS id
	o3sm24565008eem.15.2013.02.03.16.14.14
	(version=TLSv1.2 cipher=RC4-SHA bits=128/128);
	Sun, 03 Feb 2013 16:14:15 -0800 (PST)
Date: Mon, 04 Feb 2013 01:14:13 +0100
Message-Id: <871ucxj5pm.fsf@HIDDEN>
From: taylanbayirli@HIDDEN (Taylan Ulrich B.)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 208.118.235.17
X-Spam-Score: -3.4 (---)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
X-Spam-Score: -4.2 (----)

Good day,

The ACLOCAL_PATH environment-variable might benefit from better
documentation.  A mention in the short man-page would probably be
best, since setting it is needed to get aclocal to work at all after
installing it in a non-standard path like ~/usr.

Also, should --print-ac-dir respect it?  Currently it doesn't.

Regards,
Taylan




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: taylanbayirli@HIDDEN (Taylan Ulrich B.)
Subject: bug#13624: Acknowledgement (ACLOCAL_PATH documentation)
Message-ID: <handler.13624.B.135993692931595.ack <at> debbugs.gnu.org>
References: <871ucxj5pm.fsf@HIDDEN>
X-Gnu-PR-Message: ack 13624
X-Gnu-PR-Package: automake
Reply-To: 13624 <at> debbugs.gnu.org
Date: Mon, 04 Feb 2013 00:16:02 +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 13624 <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
13624: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D13624
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems


Message sent to bug-automake@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#13624: ACLOCAL_PATH documentation
Resent-From: Stefano Lattarini <stefano.lattarini@HIDDEN>
Original-Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Resent-CC: bug-automake@HIDDEN
Resent-Date: Mon, 04 Feb 2013 12:59:01 +0000
Resent-Message-ID: <handler.13624.B13624.135998273215244 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 13624
X-GNU-PR-Package: automake
X-GNU-PR-Keywords: 
To: "Taylan Ulrich B." <taylanbayirli@HIDDEN>
Cc: 13624 <at> debbugs.gnu.org
Received: via spool by 13624-submit <at> debbugs.gnu.org id=B13624.135998273215244
          (code B ref 13624); Mon, 04 Feb 2013 12:59:01 +0000
Received: (at 13624) by debbugs.gnu.org; 4 Feb 2013 12:58:52 +0000
Received: from localhost ([127.0.0.1]:35367 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1U2LdL-0003xn-UI
	for submit <at> debbugs.gnu.org; Mon, 04 Feb 2013 07:58:52 -0500
Received: from mail-ea0-f182.google.com ([209.85.215.182]:37614)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <stefano.lattarini@HIDDEN>)
	id 1U2LdI-0003xa-VX; Mon, 04 Feb 2013 07:58:49 -0500
Received: by mail-ea0-f182.google.com with SMTP id a12so2767227eaa.27
	for <multiple recipients>; Mon, 04 Feb 2013 04:57:43 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
	h=x-received:message-id:date:from:mime-version:to:cc:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	bh=nP0JXHsOh4HGHcY/6ZulVw0TVffaNulyTCyRx4oqFw8=;
	b=NFKDy0/Ede0GfplTNp/0YhiLHpP2iHKhNIOGiiz/zUeXik5lc1VedIc/wgEHgHwv6O
	QbSD7DdTLCH6xZqlhbK9fh+46YNy019nTjo+VYk9/evx5Pac/CS16v7CqWXzpnweu5TI
	KKg1IYCBfZAyegm0PSj2JSKzht8QIbv2BR5Or4VVhCX136SOpNguh16LqxEN/3ldfg/R
	y6QLWEGhqmfblPQ6dOUgjuv6s3+RLIYSpqrvvx/UI2m6QM6b/MknKJOt9EYNjVdEkR8u
	Oet1VN5ERj1M3a18Y7AUtqcd5MLaaxSXoR1Uyy28tyQiwa3UFptHFGpz6cE+A1j/956D
	hhcg==
X-Received: by 10.14.173.196 with SMTP id v44mr70996487eel.29.1359982663410;
	Mon, 04 Feb 2013 04:57:43 -0800 (PST)
Received: from [192.168.178.21]
	(host137-94-dynamic.4-87-r.retail.telecomitalia.it. [87.4.94.137])
	by mx.google.com with ESMTPS id q5sm27136245eeo.17.2013.02.04.04.57.41
	(version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128);
	Mon, 04 Feb 2013 04:57:42 -0800 (PST)
Message-ID: <510FB03E.80301@HIDDEN>
Date: Mon, 04 Feb 2013 13:57:34 +0100
From: Stefano Lattarini <stefano.lattarini@HIDDEN>
MIME-Version: 1.0
References: <871ucxj5pm.fsf@HIDDEN>
In-Reply-To: <871ucxj5pm.fsf@HIDDEN>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-Spam-Score: 0.1 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
X-Spam-Score: 0.1 (/)

severity 13624 minor
tags 13624 + moreinfo
thanks

On 02/04/2013 01:14 AM, Taylan Ulrich B. wrote:
> Good day,
> 
> The ACLOCAL_PATH environment-variable might benefit from better
> documentation.
>
This is a little vague.  What do you mean by "better documentation"?
Do you find specific passages unclear?  Is the documentation too short,
or too long-winded?

In any case, the best way towards a fix would probably be for you
to offer a patch with your proposed improvements.  I've found out
that active users of a feature are often better at documenting or
explaining it than developers of the same features are (and both
are usually better than I am :-)

> A mention in the short man-page would probably be best,
>
Consider that the man pages for aclocal and automake are just slightly
tweaked versions of the respective '--help' output of those programs,
and as such they should remain very short.

But if you want to attempt a patch to enhance the help screen to also
tell about ACLOCAL_PATH, and do so keeping it short ans sweet, you
might easily sway my decision ;-)

> since setting it is needed to get aclocal to work at all after
> installing it in a non-standard path like ~/usr.
>
This is not true; the only issue is that *third-party* m4 files
(those not provided by Automake itself) that are installed in the
aclocal directory of another aclocal installation (say, in
'/usr/share/aclocal') are not available by default to the new
aclocal installation.

> Also, should --print-ac-dir respect it?
>
No, because it just prints the *hard-coded* default directory where
aclocal looks for third-party macros:

<http://www.gnu.org/software/automake/manual/automake.html#index-g_t_002d_002dprint_002dac_002ddir-273>

> Currently it doesn't.
> 
And this is by design.  Do you have a real use-case for wanting
'--print-ac-dir' to print all the directories that would be searched
by aclocal?  If yes, we might think of a new option for that (it
should pretty easy to implement).

Thanks,
  Stefano




Message received at control <at> debbugs.gnu.org:


Received: (at control) by debbugs.gnu.org; 4 Feb 2013 12:58:53 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Feb 04 07:58:53 2013
Received: from localhost ([127.0.0.1]:35369 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1U2LdM-0003xq-Qi
	for submit <at> debbugs.gnu.org; Mon, 04 Feb 2013 07:58:53 -0500
Received: from mail-ea0-f182.google.com ([209.85.215.182]:37614)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <stefano.lattarini@HIDDEN>)
	id 1U2LdI-0003xa-VX; Mon, 04 Feb 2013 07:58:49 -0500
Received: by mail-ea0-f182.google.com with SMTP id a12so2767227eaa.27
	for <multiple recipients>; Mon, 04 Feb 2013 04:57:43 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
	h=x-received:message-id:date:from:mime-version:to:cc:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	bh=nP0JXHsOh4HGHcY/6ZulVw0TVffaNulyTCyRx4oqFw8=;
	b=NFKDy0/Ede0GfplTNp/0YhiLHpP2iHKhNIOGiiz/zUeXik5lc1VedIc/wgEHgHwv6O
	QbSD7DdTLCH6xZqlhbK9fh+46YNy019nTjo+VYk9/evx5Pac/CS16v7CqWXzpnweu5TI
	KKg1IYCBfZAyegm0PSj2JSKzht8QIbv2BR5Or4VVhCX136SOpNguh16LqxEN/3ldfg/R
	y6QLWEGhqmfblPQ6dOUgjuv6s3+RLIYSpqrvvx/UI2m6QM6b/MknKJOt9EYNjVdEkR8u
	Oet1VN5ERj1M3a18Y7AUtqcd5MLaaxSXoR1Uyy28tyQiwa3UFptHFGpz6cE+A1j/956D
	hhcg==
X-Received: by 10.14.173.196 with SMTP id v44mr70996487eel.29.1359982663410;
	Mon, 04 Feb 2013 04:57:43 -0800 (PST)
Received: from [192.168.178.21]
	(host137-94-dynamic.4-87-r.retail.telecomitalia.it. [87.4.94.137])
	by mx.google.com with ESMTPS id q5sm27136245eeo.17.2013.02.04.04.57.41
	(version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128);
	Mon, 04 Feb 2013 04:57:42 -0800 (PST)
Message-ID: <510FB03E.80301@HIDDEN>
Date: Mon, 04 Feb 2013 13:57:34 +0100
From: Stefano Lattarini <stefano.lattarini@HIDDEN>
MIME-Version: 1.0
To: "Taylan Ulrich B." <taylanbayirli@HIDDEN>
Subject: Re: bug#13624: ACLOCAL_PATH documentation
References: <871ucxj5pm.fsf@HIDDEN>
In-Reply-To: <871ucxj5pm.fsf@HIDDEN>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-Spam-Score: 0.1 (/)
X-Debbugs-Envelope-To: control
Cc: 13624 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
X-Spam-Score: -2.6 (--)

severity 13624 minor
tags 13624 + moreinfo
thanks

On 02/04/2013 01:14 AM, Taylan Ulrich B. wrote:
> Good day,
> 
> The ACLOCAL_PATH environment-variable might benefit from better
> documentation.
>
This is a little vague.  What do you mean by "better documentation"?
Do you find specific passages unclear?  Is the documentation too short,
or too long-winded?

In any case, the best way towards a fix would probably be for you
to offer a patch with your proposed improvements.  I've found out
that active users of a feature are often better at documenting or
explaining it than developers of the same features are (and both
are usually better than I am :-)

> A mention in the short man-page would probably be best,
>
Consider that the man pages for aclocal and automake are just slightly
tweaked versions of the respective '--help' output of those programs,
and as such they should remain very short.

But if you want to attempt a patch to enhance the help screen to also
tell about ACLOCAL_PATH, and do so keeping it short ans sweet, you
might easily sway my decision ;-)

> since setting it is needed to get aclocal to work at all after
> installing it in a non-standard path like ~/usr.
>
This is not true; the only issue is that *third-party* m4 files
(those not provided by Automake itself) that are installed in the
aclocal directory of another aclocal installation (say, in
'/usr/share/aclocal') are not available by default to the new
aclocal installation.

> Also, should --print-ac-dir respect it?
>
No, because it just prints the *hard-coded* default directory where
aclocal looks for third-party macros:

<http://www.gnu.org/software/automake/manual/automake.html#index-g_t_002d_002dprint_002dac_002ddir-273>

> Currently it doesn't.
> 
And this is by design.  Do you have a real use-case for wanting
'--print-ac-dir' to print all the directories that would be searched
by aclocal?  If yes, we might think of a new option for that (it
should pretty easy to implement).

Thanks,
  Stefano




Message received at control <at> debbugs.gnu.org:


Received: (at control) by debbugs.gnu.org; 4 Feb 2013 12:58:53 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Feb 04 07:58:53 2013
Received: from localhost ([127.0.0.1]:35369 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1U2LdM-0003xq-Qi
	for submit <at> debbugs.gnu.org; Mon, 04 Feb 2013 07:58:53 -0500
Received: from mail-ea0-f182.google.com ([209.85.215.182]:37614)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <stefano.lattarini@HIDDEN>)
	id 1U2LdI-0003xa-VX; Mon, 04 Feb 2013 07:58:49 -0500
Received: by mail-ea0-f182.google.com with SMTP id a12so2767227eaa.27
	for <multiple recipients>; Mon, 04 Feb 2013 04:57:43 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
	h=x-received:message-id:date:from:mime-version:to:cc:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	bh=nP0JXHsOh4HGHcY/6ZulVw0TVffaNulyTCyRx4oqFw8=;
	b=NFKDy0/Ede0GfplTNp/0YhiLHpP2iHKhNIOGiiz/zUeXik5lc1VedIc/wgEHgHwv6O
	QbSD7DdTLCH6xZqlhbK9fh+46YNy019nTjo+VYk9/evx5Pac/CS16v7CqWXzpnweu5TI
	KKg1IYCBfZAyegm0PSj2JSKzht8QIbv2BR5Or4VVhCX136SOpNguh16LqxEN/3ldfg/R
	y6QLWEGhqmfblPQ6dOUgjuv6s3+RLIYSpqrvvx/UI2m6QM6b/MknKJOt9EYNjVdEkR8u
	Oet1VN5ERj1M3a18Y7AUtqcd5MLaaxSXoR1Uyy28tyQiwa3UFptHFGpz6cE+A1j/956D
	hhcg==
X-Received: by 10.14.173.196 with SMTP id v44mr70996487eel.29.1359982663410;
	Mon, 04 Feb 2013 04:57:43 -0800 (PST)
Received: from [192.168.178.21]
	(host137-94-dynamic.4-87-r.retail.telecomitalia.it. [87.4.94.137])
	by mx.google.com with ESMTPS id q5sm27136245eeo.17.2013.02.04.04.57.41
	(version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128);
	Mon, 04 Feb 2013 04:57:42 -0800 (PST)
Message-ID: <510FB03E.80301@HIDDEN>
Date: Mon, 04 Feb 2013 13:57:34 +0100
From: Stefano Lattarini <stefano.lattarini@HIDDEN>
MIME-Version: 1.0
To: "Taylan Ulrich B." <taylanbayirli@HIDDEN>
Subject: Re: bug#13624: ACLOCAL_PATH documentation
References: <871ucxj5pm.fsf@HIDDEN>
In-Reply-To: <871ucxj5pm.fsf@HIDDEN>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-Spam-Score: 0.1 (/)
X-Debbugs-Envelope-To: control
Cc: 13624 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
X-Spam-Score: -2.6 (--)

severity 13624 minor
tags 13624 + moreinfo
thanks

On 02/04/2013 01:14 AM, Taylan Ulrich B. wrote:
> Good day,
> 
> The ACLOCAL_PATH environment-variable might benefit from better
> documentation.
>
This is a little vague.  What do you mean by "better documentation"?
Do you find specific passages unclear?  Is the documentation too short,
or too long-winded?

In any case, the best way towards a fix would probably be for you
to offer a patch with your proposed improvements.  I've found out
that active users of a feature are often better at documenting or
explaining it than developers of the same features are (and both
are usually better than I am :-)

> A mention in the short man-page would probably be best,
>
Consider that the man pages for aclocal and automake are just slightly
tweaked versions of the respective '--help' output of those programs,
and as such they should remain very short.

But if you want to attempt a patch to enhance the help screen to also
tell about ACLOCAL_PATH, and do so keeping it short ans sweet, you
might easily sway my decision ;-)

> since setting it is needed to get aclocal to work at all after
> installing it in a non-standard path like ~/usr.
>
This is not true; the only issue is that *third-party* m4 files
(those not provided by Automake itself) that are installed in the
aclocal directory of another aclocal installation (say, in
'/usr/share/aclocal') are not available by default to the new
aclocal installation.

> Also, should --print-ac-dir respect it?
>
No, because it just prints the *hard-coded* default directory where
aclocal looks for third-party macros:

<http://www.gnu.org/software/automake/manual/automake.html#index-g_t_002d_002dprint_002dac_002ddir-273>

> Currently it doesn't.
> 
And this is by design.  Do you have a real use-case for wanting
'--print-ac-dir' to print all the directories that would be searched
by aclocal?  If yes, we might think of a new option for that (it
should pretty easy to implement).

Thanks,
  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.