Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > linux.kernel > #1734185
| From | "Paul E. McKenney" <paulmck@linux.vnet.ibm.com> |
|---|---|
| Newsgroups | linux.kernel |
| Subject | Re: rcu kernel-doc issues (4.14-rc1) |
| Date | 2017-09-18 16:30 +0200 |
| Message-ID | <ur5dE-7ro-35@gated-at.bofh.it> (permalink) |
| References | (2 earlier) <uqLRD-2Eg-1@gated-at.bofh.it> <uqM1k-2Ht-11@gated-at.bofh.it> <uqNJL-3QI-3@gated-at.bofh.it> <uqUid-8iW-5@gated-at.bofh.it> <uqYOS-36l-27@gated-at.bofh.it> |
| Organization | linux.* mail to news gateway |
On Mon, Sep 18, 2017 at 09:30:01AM +0200, Markus Heiser wrote:
>
> > Am 18.09.2017 um 04:40 schrieb Paul E. McKenney <paulmck@linux.vnet.ibm.com>:
> [...]
> > And after some playing around, I did get rid of the error messages.
> > The code-block output looks a bit strange though, hints? I preceded
> > the code block with "::", again at Akira's suggestion. It looks fine
> > except for the :c:func: and backquotes on the first and last lines.
> >
> > Thanx, Paul
> >
> > ------------------------------------------------------------------------
> >
> > :c:func:`rcu_read_lock()`;
> > p = rcu_dereference(gp);
> > long_lived = is_long_lived(p);
> > if (long_lived) {
> > if (!atomic_inc_not_zero(p->refcnt))
> > long_lived = false;
> > else
> > p = rcu_pointer_handoff(p);
> > }
> > :c:func:`rcu_read_unlock()`;
>
> FYI:
>
> such replacements in code-blocks are comming from the "Highlights
> and cross-references" see:
>
> https://www.kernel.org/doc/html/latest/doc-guide/kernel-doc.html#highlights-and-cross-references
>
> and this is still a bug in the kernel-doc parser:
>
> https://www.mail-archive.com/linux-doc@vger.kernel.org/msg14409.html
Thank you for the pointer! I will try it out. Except that v4.14-rc1
apparently needs a later version of sphinx...
Thanx, Paul
Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread
rcu kernel-doc issues (4.14-rc1) Randy Dunlap <rdunlap@infradead.org> - 2017-09-17 03:30 +0200
Re: rcu kernel-doc issues (4.14-rc1) "Paul E. McKenney" <paulmck@linux.vnet.ibm.com> - 2017-09-17 06:50 +0200
Re: rcu kernel-doc issues (4.14-rc1) "Paul E. McKenney" <paulmck@linux.vnet.ibm.com> - 2017-09-17 19:50 +0200
Re: rcu kernel-doc issues (4.14-rc1) Randy Dunlap <rdunlap@infradead.org> - 2017-09-17 20:00 +0200
Re: rcu kernel-doc issues (4.14-rc1) "Paul E. McKenney" <paulmck@linux.vnet.ibm.com> - 2017-09-17 21:50 +0200
Re: rcu kernel-doc issues (4.14-rc1) "Paul E. McKenney" <paulmck@linux.vnet.ibm.com> - 2017-09-18 04:50 +0200
Re: rcu kernel-doc issues (4.14-rc1) Markus Heiser <markus.heiser@darmarit.de> - 2017-09-18 09:40 +0200
Re: rcu kernel-doc issues (4.14-rc1) "Paul E. McKenney" <paulmck@linux.vnet.ibm.com> - 2017-09-18 16:30 +0200
Re: rcu kernel-doc issues (4.14-rc1) Markus Heiser <markus.heiser@darmarit.de> - 2017-09-18 08:50 +0200
csiph-web