bug-automake
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: @direntry automake


From: Roumen Petrov
Subject: Re: @direntry automake
Date: Mon, 15 Jan 2007 23:24:13 +0200
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.0.7) Gecko/20060914 SeaMonkey/1.0.5

Stepan Kasal wrote:
Hello,
  according to my experience, people who run "info automake" expect
to get the whole Automake manual, not "automake Invocation".

I hear something like
  ``I tried "info automake", but it gave me an unusable man page''
And they feel trapped when I tell them to type "u" or "t" or start
with "info Automake" (capital `a') instead.

I'd like to make their experience with the info documentation better,
possibly by the patch below.

What do you think?

(I mailed an analogical bug report to bug-autoconf, see
http://lists.gnu.org/archive/html/bug-autoconf/2007-01/msg00039.html
but I want to here from both lists before we come to a decision.)

Stepan Kasal
------------------------------------------------------------------------

2007-01-15  Stepan Kasal  <address@hidden>

        * doc/automake.texi: Direntry for "automake Invocation" renamed.

Index: doc/automake.texi
===================================================================
RCS file: /cvs/automake/automake/doc/automake.texi,v
retrieving revision 1.162
diff -u -r1.162 automake.texi
--- doc/automake.texi   19 Dec 2006 23:52:55 -0000      1.162
+++ doc/automake.texi   15 Jan 2007 10:42:55 -0000
@@ -43,7 +43,7 @@
 @dircategory Individual utilities
 @direntry
 * aclocal: (automake)Invoking aclocal.          Generating aclocal.m4.
-* automake: (automake)Invoking Automake.        Generating Makefile.in.
+* automake-invocation: (automake)Invoking Automake.        Generating 
Makefile.in.
 @end direntry
@titlepage

About path: May be few lines before patched (category "Software development") entry with Automake should be changed to lower-case.


It seems to me new idea is "info automake" to show page with command line options and "info Automake" to open whole Automake manual. Why not ?


Roumen





reply via email to

[Prev in Thread] Current Thread [Next in Thread]