Em Mon, 17 Jun 2019 07:56:08 -0600 Jonathan Corbet <corbet@xxxxxxx> escreveu: > On Mon, 17 Jun 2019 06:16:59 -0300 > Mauro Carvalho Chehab <mchehab+samsung@xxxxxxxxxx> wrote: > > > > No need to change, the emacs notation is also OK, see your link > > > > > > """or (using formats recognized by popular editors):""" > > > > > > https://www.python.org/dev/peps/pep-0263/#defining-the-encoding > > > > > > I prefer emacs notation, this is also evaluated by many other editors / tools. > > > > The usage of emacs notation is something that we don't like at the > > Linux Kernel. With ~4K developers per release, if we add tags to > > every single editor people use, it would be really messy, as one > > developer would be adding a tag and the next one replacing it by its > > some other favorite editor's tag. > > So "we" like a language-specific notation instead? That seems a little > strange to me. Lots of things understand the Emacs notation, it doesn't > seem like something that needs to be actively avoided here. >From my side, I don't have any strong preference. Just saying that people usually complain when e-macs or vim specific tags appear at the Kernel. That's why I would prefer an editor-agnostic macro. It won't make any difference for me, anyway, as the editors I use don't recognize it. Whatever you want is OK to me, provided that we use the same notation on all Sphinx extensions... right now there's a mix of notations. Thanks, Mauro