GNU bug report logs - #13624
ACLOCAL_PATH documentation

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: automake; Severity: minor; Reported by: taylanbayirli@HIDDEN (Taylan Ulrich B.); Keywords: moreinfo; dated Mon, 4 Feb 2013 00:16:02 UTC; Maintainer for automake is bug-automake@HIDDEN.
Added tag(s) moreinfo. Request was from Stefano Lattarini <stefano.lattarini@HIDDEN> to control <at> debbugs.gnu.org. Full text available.
Severity set to 'minor' from 'normal' Request was from Stefano Lattarini <stefano.lattarini@HIDDEN> to control <at> debbugs.gnu.org. Full text available.

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


Received: (at 13624) by debbugs.gnu.org; 4 Feb 2013 12:58:52 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Feb 04 07:58:52 2013
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
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: 13624
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: 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




Information forwarded to bug-automake@HIDDEN:
bug#13624; Package automake. Full text available.

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


Received: (at submit) by debbugs.gnu.org; 4 Feb 2013 00:15:29 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Feb 03 19:15:29 2013
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.)
To: bug-automake@HIDDEN
Subject: ACLOCAL_PATH documentation
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-Debbugs-Envelope-To: submit
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




Acknowledgement sent to taylanbayirli@HIDDEN (Taylan Ulrich B.):
New bug report received and forwarded. Copy sent to bug-automake@HIDDEN. Full text available.
Report forwarded to bug-automake@HIDDEN:
bug#13624; Package automake. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Fri, 31 Oct 2014 17:00:04 UTC

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