Re: [O] [RFC] [PATCH] ox-latex: support :float no with caption for minted listings

[Nicolas Goaziou]

Hello,

Aaron Ecay <address@hidden> writes:

> Why is the compatibility=false option needed?  I can’t figure this
> out.

This is in my local copy of the minted manual, in "7 Known issues". It
may be outdated, though.

> “Pretty” source code export in all cases requires adding certain packages
> to the default, as explained in the docstring of ‘org-latex-listings’.
> The patch adds discussion of the caption requirement there, so there is
> no “if” about the documentation.
>
> I don’t understand what you’re saying about introducing “support” for
> the caption package.  The patch uses one specific feature of the caption
> package in one specific place to accomplish one specific goal.  There
> are no other changes needed anywhere else in the codebase than these
> couple of lines in one function (plus the documentation).

With your patch latex back-end can produce "\captionof" macros. This is
what I call (partial) "support" from Org: knowing the macro.

Again, using this macro is an error in the default configuration.
Besides not doing using it at all, there are usually two ways to solve
the problem:

  1. Add the package in the default package list, so the combination
     still works out of the box for anyone. E.g., `rotating' package.
     Use with care, more packages is a higher risk of incompatibilites
     between them. The lighter counterpart of `caption' package may be
     safe though.

     OTOH, once the package is in the default package list, it can be
     used everywhere in the back-end. This can be an advantage if there
     are several places that could use \captionof.

  2. Suggest, through docstring or manual, to the user to require
     a specific package if he wants to benefit from the feature. E.g.,
     `booktabs'.

     Usually, the situation makes it obvious that such a package is
     required (e.g. ":environment longtabu" or ":booktabs t").
     Unfortunately, this is not the case here. Under some
     circumstances, :float nil needs `caption' (or its lighter
     counterpart). I find it a bit too magical.

     Note there is also :caption attribute which is used in tables and
     special blocks, but not in source blocks, which may come handy
     here.


WDYT?


Regards,

-- 
Nicolas Goaziou