Re: [PATCH -perfbook] appendix/questions: Address potential orphaned epigraph
"Paul E. McKenney" <[email protected]>
| Newsgroups | org.kernel.vger.perfbook |
|---|---|
| Message-ID | <d131b39d-8372-4ab8-9d64-6400b736d2a1@paulmck-laptop> |
On Mon, Jun 19, 2023 at 11:58:41PM +0900, Akira Yokosawa wrote:
> Commit 3566689d0c01 ("questions: Add section-level epigraphs")
> added an epigraph just above a figure environment.
> This makes cleverefcheck.pl complain:
>
> ./appendix/questions/time.tex:11:\begin{figure}
> ^^^ environment next to epigraph ^^^
>
> Move the figure environment bottom of the first paragraph in the
> section and prevent the epigraph from (potentially) ending up in
> the bottom of a column/page.
>
> Signed-off-by: Akira Yokosawa <[email protected]>
> ---
> Hi Paul,
>
> You might have wondered what cleverefcheck.pl complained about.
> At the moment, there is no epigraph actually orphaned, but
> let's just silence the complaint.
Now I know. ;-)
Queued and pushed, thank you!!!
Thanx, Paul
> Thanks, Akira
> --
> appendix/questions/time.tex | 14 +++++++-------
> 1 file changed, 7 insertions(+), 7 deletions(-)
>
> diff --git a/appendix/questions/time.tex b/appendix/questions/time.tex
> index a4ce11ed5bb0..49961966525a 100644
> --- a/appendix/questions/time.tex
> +++ b/appendix/questions/time.tex
> @@ -8,13 +8,6 @@
> \epigraph{Time is a game played beautifully by children.}
> {Heraclitus}
>
> -\begin{figure}
> -\centering
> -\resizebox{2.6in}{!}{\includegraphics{cartoons/r-2014-What-time-is-it}}
> -\caption{What Time Is It?}
> -\ContributedBy{Figure}{fig:app:questions:What Time Is It?}{Melissa Broussard}
> -\end{figure}
> -
> A key issue with timekeeping on multicore computer systems is illustrated
> by \cref{fig:app:questions:What Time Is It?}.
> One problem is that it takes time to read out the time.
> @@ -27,6 +20,13 @@ protocol (NTP) adjustments, and so on.
> So does the time eventually returned correspond to the beginning of
> the resulting time interval, the end, or somewhere in between?
>
> +\begin{figure}
> +\centering
> +\resizebox{2.6in}{!}{\includegraphics{cartoons/r-2014-What-time-is-it}}
> +\caption{What Time Is It?}
> +\ContributedBy{Figure}{fig:app:questions:What Time Is It?}{Melissa Broussard}
> +\end{figure}
> +
> Worse yet, the thread reading the time might be interrupted or preempted.
> Furthermore, there will likely be some computation between reading out
> the time and the actual use of the time that has been read out.
>
> base-commit: 3566689d0c01e93c1c0552ddff95b6d4b04ca2ed
> --
> 2.25.1
>