bug#44744: 12.2.4; Incomplete documentation for TeX-view-program-list

2020-11-20 Thread Arash Esbati
Hi James,

James Cook  writes:

> I wanted to add mupdf TeX-view-program-list, but the documentation
> (appearing in customize-variable for example) was missing one crucial
> piece of information: how I should actually format the command.

Admittedly, there are no examples in the docstring, but ...

,[ C-h v TeX-view-program-list RET ]
| TeX-view-program-list is a variable defined in ‘tex.el’.
| Its value is nil
| 
|   You can customize this variable.
| 
| Documentation:
| List of viewer specifications.
| This variable can be used to specify how a viewer is to be
| invoked and thereby add new viewers on top of the built-in list
| of viewers defined in ‘TeX-view-program-list-builtin’ or override
| entries in the latter.

This is a link where you can find examples for built-in viewers.

> I eventually figured out it needs to be "mupdf %o". Either %o should
> be documented right there, or there should be a link to a place where
> it and other substitutions are documented. (I'm sure they are
> somewhere; I just have no idea where to start looking.)

| Note that the command line can contain placeholders as defined in
| ‘TeX-expand-list’ which are expanded before the viewer is called.

The placeholders (%o and such) are again linked to `TeX-expand-list'
which then redirects you to `TeX-expand-list-builtin'.

What would you suggest in order to make the docstring more clear?

Best, Arash



___
bug-auctex mailing list
bug-auctex@gnu.org
https://lists.gnu.org/mailman/listinfo/bug-auctex


bug#44609: 12.3.1; auctex.el does not (provide 'auctex), which breaks use-package

2020-11-20 Thread Arash Esbati
Hi Mosè,

Mosè Giordano  writes:

> did you read the README.md of `use-package'?  It actually has an
> example about AUCTeX:
> https://github.com/jwiegley/use-package/blob/caa92f1d64fc25480551757d854b4b49981dfa6b/README.md#package-installation
>
>> If you need to install a different package from the one named by 
>> use-package, you can specify it like this:
>
> (use-package tex
>   :ensure auctex)

should we add this to AUCTeX manual?  Is this snippet also necessary
when AUCTeX is installed via ELPA?  I don't do use-package, so I can't
tell.

Best, Arash



___
bug-auctex mailing list
bug-auctex@gnu.org
https://lists.gnu.org/mailman/listinfo/bug-auctex