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

[Franz Haeuslschmid]

Ralf Angeli writes:

> * 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,
Ouch, I must be confused today...

>>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?

The list of offered completions.  However, you already explained
it below in your answer.

>> 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 ]

[... Documentation for variable ...]

> `----
>
> This should be documented better as well. \c:

The documentation for that variable would have answered everything
I wanted to know.  I also encourage you to insert a pointer from
AUCTeX's info documentation to the set of functions and variables
that are closely related to built-in styles.  I would have
expected such a reference in the info node for (info
"(auctex)Completion") or (info "(auctex)Multifile").  You may
want to extend (info "(auctex)Style Files") to comprise the
description of built-in styles.  Anyway, this reflects only my
opinion, I only want to suggest some amendment on where
references and documentation could go (after is has been
written:^).

Thank you again,
Franz.