Re: Missing l3doc.el

[Jan Braun]

Oc Captain, my captain!


> Am 08.03.2022 um 10:13 schrieb Arash Esbati <arash@gnu.org>:

> Thanks for your comments.  I admit I'm not that much into l3
> programming.  So I suggest we try to get the basic l3doc.el running and
> then look after improvements.

Sounds good to me.  You’re the expert in Lisp, maybe I can help in 
LaTeX3?

> 
>> But when inserting a document environment into a DTX buffer/
>> file, it should at least read like this:
>> 
>> ——8<—— 
>> %<*driver>
>> \documentclass{l3doc}
>> 
>> \begin{document}
>> \DocInput{<buffername>.dtx}
>> \end{document}
>> %</driver>
>> ——8<—— 
> 
> To be honest, I'm not fond of smart tools trying to do smart things
> without asking me.

In that case, how about a variable: `LaTeX-doctex-insert-driver’, which 
defaults to nil and only when the user defined non-nil, it will insert 
the additional code?

>  You can easily write a function which does the job
> for you -- this may disturb other users.

Again someone else did: I am using auto-insert-tkld, from Kevin 
Donaldson, which does the magic.

> 
>> One of the first things of a DTX file is the command \CheckSum{}.  
> [...]
> 
> That ship has sailed: from doc.pdf v3.0 
> […]

Aye Aye Captain.  Haven’t read that.  Away with it.

>> [TeX commands]
>> to change this manually.  It would of course be fine, if AUCTeX 
>> would switch to this behaviour automatically, when in docTeX mode. 
> 
> Thanks for the hint.  We should consider this in a later step.

No problem!

>> [Inserting section commmands …]
> 
> I haven't checked the code, but I think you're right about the sections
> being invisible.

Thank you so much!

Ahoy

  Jan