Re: Setting up user defined texinfo headlines using outline-heading-alist

[Christopher Dimech <dimech@gmx.com>]

I would be grateful for some explanation of variables "outline-regexp" and
"outline-heading-alist".  

texinfo.el sets both "outline-heading-alist" and "outline-regexp", the latter from the
other using the same variable "texinfo-section-list".

Do we really need to have both outline-heading-alist and texinfo-section-list, because
as far as I can see we are using the same definition of headings and levels with the
variable "texinfo-section-list". 


> Sent: Friday, May 14, 2021 at 7:13 AM
> From: "Yuri Khan" <yuri.v.khan@gmail.com>
> To: "Christopher Dimech" <dimech@gmx.com>
> Cc: "Help Gnu Emacs" <help-gnu-emacs@gnu.org>
> Subject: Re: Setting up user defined texinfo headlines using outline-heading-alist
>
> On Fri, 14 May 2021 at 01:35, Christopher Dimech <dimech@gmx.com> wrote:
> 
> > It is then very easy to tell a user to learn more elisp, rather than convince a
> > developer to be consistent and write in ways that assist in the reuse of their
> > code.
> 
> Yeah, much of the code in and around Emacs assumes the user can read,
> and often also write, Elisp.
> 
> If you find outline-regexp in a docstring and you want to know where
> it’s defined and how it’s used, your best bet is to invoke
> xref-find-references on it and skim through the code.
> 
> If you want to know how to have headings fontified, M-x find-library
> RET outline RET, then search for “face”, eventually find a variable
> ‘outline-font-lock-keywords’ and its use in ‘outline-mode’ but not in
> outline-minor-mode (probably because with outline-minor-mode you
> already have some fontification by the major mode). Maybe find a way
> to add ‘outline-font-lock-keywords’ to the major mode’s
> ‘font-lock-defaults’, but that definitely requires some programming.
> 
>