Rewrite the introductory text for clarity.

Put the `info' topic above the "Emacs" subcategory line.

diff --git a/info/dir b/info/dir
index 9131bc48b78c42c368c23fa664737b80dfd15fde..49ba651009ec59f393b3ad8cfabcf8344c31b86e 100644 (file)
--- a/info/dir
+++ b/info/dir
@@ -4,18 +4,24 @@ Info hierarchy.  The first time you invoke Info you start off
 looking at that node, which is (dir)Top.
 \1f
 File: dir      Node: Top       This is the top of the INFO tree
-  This (the Directory node) gives a menu of major topics. 
-  Typing "d" returns here, "q" exits, "?" lists all INFO commands, "h" 
-  gives a primer for first-timers, "mEmacs<Return>" visits the Emacs topic,
-  etc.
-  In Emacs, you can click mouse button 2 on a menu item or cross reference
-  to select it.
-  --- PLEASE ADD DOCUMENTATION TO THIS TREE. (See INFO topic first.) ---
 
-* Menu: The list of major topics begins on the next line.
+The Info Directory
+******************
+
+  The Info Directory is the top-level menu of major Info topics. 
+  Type "d" in Info to return to the Info Directory.  Type "q" to exit Info.
+  Type "?" for a list of Info commands, or "h" to visit an Info tutorial.
+  Type "m" to choose a menu item--for instance, 
+    "mEmacs<Return>" visits the Emacs manual.
+  In Emacs Info, you can click mouse button 2 on a menu item or cross reference
+  to follow it to its target.
+
+* Menu: Each line that starts with a * is a topic you can select with "m".
+  Every third topic has a red *.
 
-Emacs
 * Info: (info).                How to use the documentation browsing system.
+
+Emacs
 * Emacs: (emacs).      The extensible self-documenting text editor.
 * Emacs FAQ: (efaq).   Frequently Asked Questions about Emacs.
 * Emacs Lisp Introduction: (eintr).