Subject: bug#72814: 31.0.50; Add a variable controlling doxygen support in C/C++/Java?

From: Eli Zaretskii <[email-masked]>
Date: Tue, 27 Aug 2024 15:22:16 +0300

> From: Yuan Fu <[email-masked]>
> Date: Mon, 26 Aug 2024 20:13:52 -0700
> Cc: [email-masked],
>  [email-masked]
> 
> 
> Yuan Fu <[email-masked]> writes:
> 
> > X-Debbugs-CC: [email-masked] <mailto:[email-masked]>,
> > [email-masked]
> >
> > Should we add a custom option that controls whether to enable doxygen
> > support in c-ts-mode/c++-ts-mode/java-ts-mode?
> >
> > Technically this isn’t a problem, since the doxygen support is only
> > enabled if there’s doxygen grammar on the system. But many people
> > (me) might install a grammar bundle that includes dozens of
> > grammars for convenience. Then the doxygen support would turn on when
> > the user doesn’t really intend to use it.
> >
> > I propose we add custom options like c-ts-mode-enable-doxygen and set it
> > to t by default, so the default behavior is still to enable doxygen
> > support when the grammar for it exists, but people who don’t want to pay
> > for it can turn it off by setting the option to nil.
> >
> > Yuan
> 
> Eli, WDYT?

I'm okay with such an option, but it should be careful to check
whether the corresponding grammar library is available, and offer a
user-friendly diagnostic if not.