Re: [docs] [PATCH 00/10] docs: highlight BitBake snippets with the bitbake language

["Antonin Godard" <antonin.godard@bootlin.com>]

Hi,

On Thu Aug 27, 2026 at 1:34 PM CEST, Trevor Woerner wrote:
> On Thu 2026-08-27 @ 10:38:58 AM, Antonin Godard wrote:
>> Hi,
>> 
>> On Wed Aug 26, 2026 at 3:34 AM CEST, Trevor Woerner via lists.yoctoproject.org wrote:
>> [...]
>> > Not included
>> > ------------
>> >
>> > Six blocks in ref-manual/ trip a defect in the released BitBake lexer,
>> > fixed upstream but not yet in a release. They are a separate patch, held
>> > until that release, so the rest is not blocked behind them.
>> 
>> Would it make sense to apply a patch to Pygments in OE-Core to fix these issues
>> until a new version of Pygments is released?
>
> It would be very easy for me to provide a patch that would fix these
> things locally until (if) upstream pygments picks up my updates:
>
> https://github.com/pygments/pygments/pull/3284
>
> I had wanted to add such a patch when I first developed the bitbake
> lexer for pygments but the last time I proposed adding a temporary,
> local pygments update it was decided we should wait for upstream.
> Therefore I stopped short of doing that here.

I think you misunderstood me :) What I meant is that we could patch
python3-pygments in *OE-Core* (*not* provide the lexer from yocto-docs)
temporarily, until your above pull request is merged, and we drop the
patches in OE-Core after an update.

> I would also like to add a lexer for some other smaller stuff such as
> SCC files. This lexer is very unlikely to be picked up by the upstream
> pygments project; their own documentation says so explicitly:
>
> https://pygments.org/docs/contributing/#language-support
>
> But I think it would be nice if we had a highlighting scheme for it.
> I'm more than happy to write it, but it is a plugin we would have to
> carry ourselves.

Sure, I am open to small additional lexers in the documentation (as long as
they're small and simple enough to be maintainable), especially if upstream
refuses additional small lexer like this one.

Thanks,
Antonin