Re: Merging ox-texinfo+ into ox-texinfo

[Nicolas Goaziou]

Hello,

Jonas Bernoulli <jonas@bernoul.li> writes:

> I recently talked to Bastien about this and he encouraged to bring up
> the possibility of merging ox-texinfo+.el into ox-texinfo.el.
>
> ox-texinfo+ (https://github.com/tarsius/ox-texinfo-plus) has several
> features but the one I would like to talk about now is the following.

[...]
>
>    Create `@deffn` and similar definition items by writing list
>    items in Org that look similar to what they will look like in
>    Info.  To enable this, add:
>
>    #+TEXINFO_DEFFN: t
>
>    to your Org file.  After doing that, you can create definition
>    items like so:
>
>    - Command: magit-section-show
>
>      Show the body of the current section.
>
>    - Function: magit-git-exit-code &rest args
>    - Macro: magit-insert-section &rest args
>    - Variable: magit-display-buffer-noselect
>    - User Option: magit-display-buffer-function
>    - Key: q, magit-mode-bury-buffer
>
> I propose that we add this as an optional feature to ox-texinfo.el
> itself.

I like the idea, thank you for suggesting it.

The chosen UI is rather odd however. I cannot think of another use of
controlling export thhough "#+keyword: boolean" syntax. Usually, we
extend the "options" keyword. It could become, for example:

  #+options: texinfo+:t

Could it be possible to use that syntax instead?

> It is possible to mix the two styles; you can use the ox-texinfo+.el
> style for most or all definitions but use the additional flexibility of
> ox-texinfo.el, when that is needed.

How is it possible? Keywords are global. How do you change value
locally?

Regards,
-- 
Nicolas Goaziou