Re: Intro

[Tassilo Horn]

Jan Braun <Jan.Braun@klein-gallien.org> writes:

Hi Jan,

>>> the background color does not extent to the right hand side of the
>>> window pane, as it does in your example screenshot.
>> 
>> Ah, that's a recent emacs change.  If you want the background extend
>> to the end of the line, customize
>> `font-latex-doctex-documentation-face' and give it an Extend value of
>> On.
>
>  [x] solved 
>
> Merci vielmals!

Great.  I wonder if we should make that the default.  Any opinions?

>> When you do
>> 
>>  M-: (TeX-load-style "doc") RET
>>  M-: (TeX-run-style-hooks "doc") RET
>> 
>> all the environments and formatting (no % in the macrocode body) are
>> there.  
>
> Yes, indeed, thank you.
>
> I tried `C-c C-e macro' :-)  It asked for the name of the macros, 
> and inserted the text accordingly.  I wondered, if the missing 
> percent sign between \begin{macro} and \end{macro} is 
> intentional?  IMHO a macrocode-environment is needed for that?
>
> I tried to insert the variable environment: it misses the 
> mandatory argument for the variable name, but on the other hand, 
> it inserts the percent sign between \begin and \end.
>
> The Macros \TestFiles and \TestMissing are still unknown.

Indeed, they don't seem to be defined anywhere in auctex.

Hm, the last docTeX mentions in the changes docs are for 11.50:

   * Limited support for 'doc.sty' and 'ltxdoc.cls' ('dtx' files) was
     added.  The new docTeX mode provides functionality for editing
     documentation parts.  This includes formatting (indenting and
     filling), adding and completion of macros and environments while
     staying in comments as well as syntax highlighting.  (Please note
     that the mode is not finished yet.  For example syntax highlighting
     does not work yet in XEmacs.)

   * For macro completion in docTeX mode the AUCTeX style files
     'doc.el', 'ltxdoc.el' and 'ltx-base.el' were included.  The latter
     provides general support for low-level LaTeX macros and may be used
     with LaTeX class and style files as well.  It is currently not
     loaded automatically for those files.

Can it really be that those have never be enabled automatically?  If so,
what's the reason?

Well, it seems our dtx support is a bit lacking behind.  Unfortunately,
I don't really have any experience with docTeX so I'm not sure what
would be the right thing.  Maybe enabling the "doc" (or "ltxdoc"?) style
in docTeX-mode would at least be the first step.

Bye,
Tassilo