Re: Changes to emacs/info/dir,v

Re: Changes to emacs/info/dir,v

[Glenn Morris]

You seem to have alphabetized info/dir. Previously, the entries were
in some kind of order of importance (eg emacs, efaq, eintr, elisp at
the start) and thematic grouping (eg news and mail packages together).

Jason Rumney wrote:

> RCS file: /sources/emacs/emacs/info/dir,v
> retrieving revision 1.37
> retrieving revision 1.38
> diff -u -b -r1.37 -r1.38
> --- dir	6 May 2006 13:15:07 -0000	1.37
> +++ dir	6 Feb 2008 22:57:25 -0000	1.38
> @@ -1,80 +1,78 @@
> --*- Text -*-
> -This is the file .../info/dir, which contains the topmost node of the
> -Info hierarchy.  The first time you invoke Info you start off
> -looking at that node, which is (dir)Top.
> +This is the file .../info/dir, which contains the
> +topmost node of the Info hierarchy, called (dir)Top.
> +The first time you invoke Info you start off looking at this node.
[...]

Re: Changes to emacs/info/dir,v

[Jason Rumney]

Glenn Morris wrote:
> You seem to have alphabetized info/dir. Previously, the entries were
> in some kind of order of importance (eg emacs, efaq, eintr, elisp at
> the start) and thematic grouping (eg news and mail packages together).
>   
This was the order install-info put them in. If someone wants to 
maintain it by hand, they are welcome to, but given that it hasn't been 
updated since 2006 while a number of manuals have been added to CVS, I 
can't see that happening.

Re: Changes to emacs/info/dir,v

[Glenn Morris]

Jason Rumney wrote:

> This was the order install-info put them in. If someone wants to 
> maintain it by hand, they are welcome to, but given that it hasn't been 
> updated since 2006 while a number of manuals have been added to CVS, I 
> can't see that happening.

I think that's overly pessimistic. I don't mind adding entries by
hand; I'd simply forgotten, or never knew, that it had to be done. I
would hope the same is true for others.

It also ought to be simple to write something to warn about missing
dir entries. Then it's a question of remembering to run it. :)

Re: Changes to emacs/info/dir,v

[Glenn Morris]

Glenn Morris wrote:

> It also ought to be simple to write something to warn about missing
> dir entries.

Eg `make check-info-dir':

*** Makefile.in	16 Jan 2008 04:09:42 -0000	1.338
--- Makefile.in	7 Feb 2008 23:10:34 -0000
***************
*** 779,784 ****
--- 779,802 ----
  	-(cd doc/misc; $(MAKE) $(MFLAGS) info)
  	-(cd doc/lispref; $(MAKE) $(MFLAGS) info)
  	-(cd doc/lispintro; $(MAKE) $(MFLAGS) info)
+ 
+ # The info/dir file must be updated by hand when new manuals are added.
+ check-info-dir: info
+ 	cd info ; \
+ 	missing= ; \
+ 	for file in *; do \
+ 	  test -f "$${file}" || continue ; \
+ 	  case $${file} in \
+ 	    *-[0-9]*|COPYING|dir) continue ;; \
+ 	  esac ; \
+ 	  grep -q -F ": ($${file})." dir || missing="$${missing} $${file}" ; \
+ 	done ; \
+ 	if test -n "$${missing}"; then \
+ 	  echo "Missing info/dir entries: $${missing}" ; \
+ 	  exit 1 ; \
+ 	fi ; \
+ 	echo "info/dir is OK"
+ 
  dvi:
  	(cd doc/emacs; $(MAKE) $(MFLAGS) dvi)
  	(cd doc/misc; $(MAKE) $(MFLAGS) dvi)

Re: Changes to emacs/info/dir,v

[Richard Stallman]

    You seem to have alphabetized info/dir. Previously, the entries were
    in some kind of order of importance (eg emacs, efaq, eintr, elisp at
    the start) and thematic grouping (eg news and mail packages together).

That change was not good.  Could you revert it?