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
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
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
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
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
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.