[AUCTeX-diffs] Changes to auctex/doc/auctex.texi,v

[Ralf Angeli]

CVSROOT:        /cvsroot/auctex
Module name:    auctex
Changes by:     Ralf Angeli <angeli>    09/10/25 18:24:47

Index: auctex.texi
===================================================================
RCS file: /cvsroot/auctex/auctex/doc/auctex.texi,v
retrieving revision 1.296
retrieving revision 1.297
diff -u -b -r1.296 -r1.297
--- auctex.texi 14 Jun 2009 15:45:14 -0000      1.296
+++ auctex.texi 25 Oct 2009 18:24:47 -0000      1.297
@@ -1851,10 +1851,19 @@
 @deffn Command TeX-fold-buffer
 @kindex C-c C-o C-b
 (@kbd{C-c C-o C-b}) Hide all foldable items in the current buffer
-according to the setting of @code{TeX-fold-type-list}.  This command can
-also be used to refresh the whole buffer and hide any new macros and
-environments which were inserted after the last invocation of the
-command.
+according to the setting of @code{TeX-fold-type-list}.
+
+If you want to have this done automatically every time you open a file,
+add it to a hook and make sure the function is called after font locking
+is set up for the buffer.  The following code should accomplish this:
+
address@hidden
+(add-hook 'find-file-hook 'TeX-fold-buffer t)
address@hidden lisp
+
+The command can be used any time to refresh the whole buffer and fold
+any new macros and environments which were inserted after the last
+invocation of the command.
 @end deffn
 
 @defopt TeX-fold-type-list
@@ -2468,9 +2477,76 @@
 viewer cannot display the contents correctly and a PostScript viewer
 will be invoked instead.
 
-The information about which file types and style options are
-associated with which viewers and options for them is stored in the
-variables @code{TeX-output-view-style} and @code{TeX-view-style}.
+The association between the tests for the conditions mentioned above and
+the viewers is made in the variable @code{TeX-view-program-selection}.
+Therefore this variable is the starting point for customization if you
+want to use other viewers than the ones suggested by default.
+
address@hidden TeX-view-program-selection
+This is a list of predicates and viewers which is evaluated from front
+to back in order to find out which viewer to call under the given
+conditions.  In the first element of each list item you can reference
+one or more predicates defined in @code{TeX-view-predicate-list} or
address@hidden  In the second element you can
+reference a viewer defined in @code{TeX-view-program-list} or
address@hidden  The viewer of the first item with
+a positively evaluated predicate is selected.
address@hidden defopt
+
+So @code{TeX-view-program-selection} only contains references to the
+actual implementations of predicates and viewer commands respectively
+which can be found elsewhere.  @AUCTeX{} comes with a set of
+preconfigured predicates and viewer commands which are stored in the
+variables @code{TeX-view-predicate-list-builtin} and
address@hidden respectively.  If you are not
+satisfied with those and want to overwrite one of them or add your own
+definitions, you can do so via the variables
address@hidden and @code{TeX-view-program-list}.
+
address@hidden TeX-view-predicate-list
+This is a list of predicates for viewer selection and invocation.  The
+first element of each list item is a symbol and the second element a
+Lisp form to be evaluated.  The form should return nil if the predicate
+is not fulfilled.
+
+A built-in predicate from @code{TeX-view-predicate-list-builtin} can be
+overwritten by defining a new predicate with the same symbol.
address@hidden defopt
+
address@hidden TeX-view-program-list
+This is a list of viewer specifications each consisting of a symbolic
+name and either a command line or a function to be invoked when the
+viewer is called.  If a command line is used, parts of it can be
+conditionalized by prefixing them with predicates from
address@hidden or
address@hidden  (See the doc string for the
+exact format to use.)  The command line can also contain placeholders as
+defined in @code{TeX-expand-list} which are expanded before the viewer
+is called.
+
+A built-in viewer spec from @code{TeX-view-program-list-builtin} can be
+overwritten by defining a new viewer spec with the same name.
address@hidden defopt
+
+Note that the viewer selection and invocation as described above will
+only work if certain default settings in @AUCTeX{} are intact.  For one,
+the whole viewer selection machinery will only be triggered if the
address@hidden expander in @code{TeX-expand-list} is unchanged.  So if you
+have trouble with the viewer invocation you might check if there is an
+older customization of the variable in place.  In addition, the use of a
+function in @code{TeX-view-program-list} only works if the View command
+in @code{TeX-command-list} makes use of the hook
address@hidden
+
+Note also that the implementation described above replaces an older one
+which was less flexible.  This old implementation works with the
+variables @code{TeX-output-view-style} and @code{TeX-view-style} which
+are used to associate file types and style options with viewers.  If
+desired you can reactivate it by using the placeholder @samp{%vv} for
+the View command in @code{TeX-command-list}.  Note however, that it is
+bound to be removed from @AUCTeX{} once the new implementation proved to
+be satisfactory.  For the time being, find a short description of the
+mentioned customization options below.
 
 @defopt TeX-output-view-style
 List of output file extensions, style options and view options.  Each