1.1 --- a/docs/yatexe.tex	Sun Jan 22 14:20:46 1995 +0000
     1.2 +++ b/docs/yatexe.tex	Thu Feb 02 17:18:29 1995 +0000
     1.3 @@ -36,10 +36,11 @@
     1.4  * Cursor jump::                 Jumping to related position
     1.5  * Changing and Deleting::       Changing/deleting certain unit of text
     1.6  * Filling::                     Filling an item or paragraph
     1.7 -* Updation of @code{\includeonly}::  Maintaining @code{\includeonly}
     1.8 -* What column?::                Column position guide in tabular
     1.9 +* Updation of includeonly::     Free from maintaining includeonly
    1.10 +* What column?::                Guidance to tabular column
    1.11  * Intelligent newline::         Guess requisites of new line
    1.12  * Online help::                 On-line documentation of LaTeX
    1.13 +* Browsing file hierarchy::     Walking through file hierarchy
    1.14  * Cooperation with other packages::  Work well with gmhist, min-out
    1.15  * Customizations::              How to breed `Wild Bird'
    1.16  * Etcetera::                    YaTeX is acquisitive.
    1.17 @@ -138,6 +139,7 @@
    1.18          (@kbd{C-c a}, @kbd{;}, @kbd{:})
    1.19  @item Online help for the popular La@TeX{} commands
    1.20        (@kbd{C-c ?}, @kbd{C-c /})(English help is not yet supported)
    1.21 +@item Document files hierarchy browser (@kbd{C-c d})
    1.22  @end itemize
    1.23  
    1.24  @node Installation, Typesetting, Main features, Top
    1.25 @@ -1180,7 +1182,7 @@
    1.26  character on a line changes the fill-prefix temporarily to the depth of
    1.27  the line.
    1.28  
    1.29 -@node Updation of @code{\includeonly}, What column?, Filling, Top
    1.30 +@node Updation of includeonly, What column?, Filling, Top
    1.31  @comment  node-name,  next,  previous,  up
    1.32  @chapter Updation of @code{\includeonly}
    1.33  @cindex includeonly
    1.34 @@ -1299,7 +1301,7 @@
    1.35  useful.  See the definition of the function
    1.36  @code{YaTeX-intelligent-newline-itemize} as an example.
    1.37  
    1.38 -@node Online help, Cooperation with other packages, Intelligent newline, Top
    1.39 +@node Online help, Browsing file hierarchy, Intelligent newline, Top
    1.40  @comment  node-name,  next,  previous,  up
    1.41  @chapter Online help
    1.42  @cindex online help
    1.43 @@ -1349,7 +1351,73 @@
    1.44  standard commands.   I might  want    to include it  in   the next
    1.45  distribution.
    1.46  
    1.47 -@node Cooperation with other packages, Customizations, Online help, Top
    1.48 +@node Browsing file hierarchy, Cooperation with other packages, Online help, Top
    1.49 +@comment  node-name,  next,  previous,  up
    1.50 +@chapter Browsing file hierarchy
    1.51 +@cindex hierarchy
    1.52 +@cindex browsing
    1.53 +
    1.54 +  When you are editing multi-file source, typing
    1.55 +
    1.56 +@table @kbd
    1.57 +@item [prefix] d
    1.58 +        @dots{} browse file hierarchy
    1.59 +@end table
    1.60 +
    1.61 +@noindent
    1.62 +asks you the parent-most file (which may be defaulted) and displays the
    1.63 +documentation hierarchy in the next window.  In this buffer, the following
    1.64 +commands are available.
    1.65 +
    1.66 +@table @kbd
    1.67 +@item n
    1.68 +        @dots{} move to the next line and show its contents
    1.69 +@item p
    1.70 +        @dots{} move to the previous line and show its contents
    1.71 +@item N
    1.72 +        @dots{} move to the next file in the same inclusion level
    1.73 +@item P
    1.74 +        @dots{} move to the previous file in the same inclusion level
    1.75 +@item j
    1.76 +        @dots{} move to the next line
    1.77 +@item k
    1.78 +        @dots{} move to the previous line
    1.79 +@item u
    1.80 +        @dots{} move to the parent file
    1.81 +@item .
    1.82 +        @dots{} show the current files contents in the next window
    1.83 +@item SPC
    1.84 +        @dots{} scroll up the current file window
    1.85 +@item DEL, b
    1.86 +        @dots{} scroll down the current file window
    1.87 +@item <
    1.88 +        @dots{} show the beginning of the current file
    1.89 +@item >
    1.90 +        @dots{} show the end of the current file
    1.91 +@item >
    1.92 +        @dots{} return to the previous postion after @kbd{<} or @kbd{>}
    1.93 +@item RET, g
    1.94 +        @dots{} open the current file in the next window
    1.95 +@item mouse-2
    1.96 +        @dots{} same as RET(available only with window system)
    1.97 +@item o
    1.98 +        @dots{} other window
    1.99 +@item 1
   1.100 +        @dots{} delete other windows
   1.101 +@item -
   1.102 +        @dots{} shrink hierarchy buffer window
   1.103 +@item +
   1.104 +        @dots{} enlarge hierarchy buffer window
   1.105 +@item ?
   1.106 +        @dots{} describe mode
   1.107 +@item q
   1.108 +        @dots{} quit
   1.109 +@end table
   1.110 +
   1.111 +  Note that operations on the file contents in the next window do not work 
   1.112 +correctly when you close the corresponding file.
   1.113 +
   1.114 +@node Cooperation with other packages, Customizations, Browsing file hierarchy, Top
   1.115  @comment  node-name,  next,  previous,  up
   1.116  @chapter Cooperation with other packages
   1.117  
   1.118 @@ -1583,6 +1651,14 @@
   1.119  Alist of LaTeX's sectioning command vs its height.
   1.120  @end defvar
   1.121  
   1.122 +@defvar YaTeX-hierarchy-ignore-heading-regexp
   1.123 +@code{YaTeX-display-hierarchy} searches for sectioning command first, and
   1.124 +comment line secondary as a file headings.  In latter case, ignore lines
   1.125 +that match with regular expression of this variable.  Default value of
   1.126 +this variable is RCS header expressions and mode specifying line `-*- xxxx 
   1.127 +-*'.
   1.128 +@end defvar
   1.129 +
   1.130  @node Sample definitions, Hook variables, All customizable variables, Lisp variables
   1.131  @comment  node-name,  next,  previous,  up
   1.132  @subsection Sample definitions