Re: [Bug-AUCTeX] Re: 2005-06-10; `TeX-ispell-document' for multifile doc in different directories

[Ralf Angeli]

* Franz Haeuslschmid (2005-06-12) writes:

> Ralf Angeli writes:
>
>> I fixed the case where the master file would not be found when
>> `TeX-ispell-document' was executed from a slave file.  Note that for
>> `TeX-ispell-document' to work from a master file, the slave files have
>> to be opened as well.  AUCTeX currently does not open these files
>> automatically.
>
> Thank you very much for your efforts and the information.  As it
> is not obvious (at least for me), that included files have to be
> included, would you mind to insert that information into the info
> docs for multi-file documents of for that function?

I included it in the doc strings.  The functionality related to spell
checking is practically undocumented in the manual.  After deciding
about the interface (it could e.g. make sense to let the command open
the related files when given a prefix argument) this should be
changed.  As an excuse the manual is labeled as preliminary. (c;

> Use this scenario and do something like `touch figure.eps' or
> `mkdir figures && touch figure.eps' or even both.  Now open
> `slave-file.tex' and try to insert one of the figures by
> evaluating `C-c RET includegraphics'.  AUCTeX offers me then a
> completion list (BTW how can I configure this list of possible
> completions?):

What would you like to configure?

> There is no offering for `figure'.

Probably because it is not in TeX's search path.  You can either adapt
the search path or customize `LaTeX-includegraphics-read-file':

,----[ C-h v LaTeX-includegraphics-read-file RET ]
| LaTeX-includegraphics-read-file's value is 
| LaTeX-includegraphics-read-file-TeX
| 
| Function for reading \includegraphics files.
| 
| `LaTeX-includegraphics-read-file-TeX' lists all graphic files
| found in the TeX search path.
| 
| `LaTeX-includegraphics-read-file-relative' lists all graphic files
| in the master directory and its subdirectories and inserts the
| relative file name.  This option doesn't works with Emacs 21.3 or
| XEmacs.
| 
| The custom option `simple' works as
| `LaTeX-includegraphics-read-file-relative' but it lists all kind of
| files.
| 
| Inserting the subdirectory in the filename (as
| `LaTeX-includegraphics-read-file-relative') is discouraged by
| `epslatex.ps'.
| 
| You can customize this variable.
| 
| Defined in `tex-style'.
`----

This should be documented better as well. \c:

-- 
Ralf