Re: [PATCH v6 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags

2020-10-15 Thread Jonathan Corbet
On Thu, 15 Oct 2020 07:32:07 +0200 Mauro Carvalho Chehab wrote: > > That will apply to most (maybe all) of the structures mentioned in this > > file. > > I expected that if the documentation system now automatically recognizes > > 'struct foo', then it would render it in code font even when

Re: [PATCH v6 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags

2020-10-15 Thread Mauro Carvalho Chehab
Em Thu, 15 Oct 2020 09:36:05 -0700 Eric Biggers escreveu: > On Thu, Oct 15, 2020 at 07:32:07AM +0200, Mauro Carvalho Chehab wrote: > > On the other hand, if one finds a valid "struct foo" using normal > > fonts, this would mean that either the doc is outdated, mentioning > > an struct that were

Re: [PATCH v6 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags

2020-10-15 Thread Eric Biggers
On Thu, Oct 15, 2020 at 07:32:07AM +0200, Mauro Carvalho Chehab wrote: > On the other hand, if one finds a valid "struct foo" using normal > fonts, this would mean that either the doc is outdated, mentioning > an struct that were removed/renamed or that there's a missing > kernel-doc markup. > >

Re: [PATCH v6 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags

2020-10-14 Thread Mauro Carvalho Chehab
Em Wed, 14 Oct 2020 14:59:54 -0700 Eric Biggers escreveu: > On Wed, Oct 14, 2020 at 08:59:07AM +0200, Mauro Carvalho Chehab wrote: > > [PATCH v6.1 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags > > > > The :c:type: tag has problems with Sphinx 3.x, as structs > > there should be

Re: [PATCH v6 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags

2020-10-14 Thread Eric Biggers
On Wed, Oct 14, 2020 at 08:59:07AM +0200, Mauro Carvalho Chehab wrote: > [PATCH v6.1 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags > > The :c:type: tag has problems with Sphinx 3.x, as structs > there should be declared with c:struct. > > So, remove them, relying at automarkup.py

Re: [PATCH v6 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags

2020-10-14 Thread Mauro Carvalho Chehab
Em Tue, 13 Oct 2020 10:25:12 -0700 Eric Biggers escreveu: > On Tue, Oct 13, 2020 at 01:53:50PM +0200, Mauro Carvalho Chehab wrote: > > The :c:type: tag has problems with Sphinx 3.x, as structs > > there should be declared with c:struct. > > > > So, remove them, relying at automarkup.py

Re: [PATCH v6 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags

2020-10-13 Thread Eric Biggers
On Tue, Oct 13, 2020 at 01:53:50PM +0200, Mauro Carvalho Chehab wrote: > The :c:type: tag has problems with Sphinx 3.x, as structs > there should be declared with c:struct. > > So, remove them, relying at automarkup.py extension to > convert them into cross-references. > > Signed-off-by: Mauro

[PATCH v6 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags

2020-10-13 Thread Mauro Carvalho Chehab
The :c:type: tag has problems with Sphinx 3.x, as structs there should be declared with c:struct. So, remove them, relying at automarkup.py extension to convert them into cross-references. Signed-off-by: Mauro Carvalho Chehab --- Documentation/filesystems/fscrypt.rst | 51