[PATCH 1/2] defer: Use \twocolumnwidth in Figure 9.24

[PATCH 1/2] defer: Use \twocolumnwidth in Figure 9.24

[Akira Yokosawa]

Using \columnwidth results in a too large figure in 1c and eb
builds.

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
---
 defer/rcuusage.tex | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/defer/rcuusage.tex b/defer/rcuusage.tex
index 8d81a9d5..01342fda 100644
--- a/defer/rcuusage.tex
+++ b/defer/rcuusage.tex
@@ -416,7 +416,7 @@ was shown in the previous sections.
 
 \begin{figure}
 \centering
-\resizebox{\columnwidth}{!}{\includegraphics{defer/RCUphasedstatechange}}
+\resizebox{\twocolumnwidth}{!}{\includegraphics{defer/RCUphasedstatechange}}
 \caption{Phased State Change for Maintenance Operation}
 \label{fig:defer:Phased State Change for Maintenance Operation}
 \end{figure}

base-commit: b88e3be21e3695740422a41933bb32ae51522f01
-- 
2.17.1

[PATCH 2/2] defer/rcuusage: Move float objects away of section titles

[Akira Yokosawa]

Float objects are treated as page/column break candidates.
They can cause widowed section titles.

Move a pair of such objects in recently added contents.

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
---
 defer/rcuusage.tex | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/defer/rcuusage.tex b/defer/rcuusage.tex
index 01342fda..9f2a428e 100644
--- a/defer/rcuusage.tex
+++ b/defer/rcuusage.tex
@@ -6,6 +6,14 @@
 \label{sec:defer:RCU Usage}
 \OriginallyPublished{Section}{sec:defer:RCU Usage}{RCU Usage}{Linux Weekly News}{PaulEMcKenney2008WhatIsRCUUsage}
 
+This section answers the question ``What is RCU?'' from the viewpoint
+of the uses to which RCU can be put.
+Because RCU is most frequently used to replace some existing mechanism,
+we look at it primarily in terms of its relationship to such mechanisms,
+as listed in \cref{tab:defer:RCU Usage}.
+Following the sections listed in this table,
+\cref{sec:defer:RCU Usage Summary} provides a summary.
+
 \begin{table}
 \renewcommand*{\arraystretch}{1.2}
 \centering
@@ -40,14 +48,6 @@ Quasi multi-version concurrency control (MVCC) &
 \label{tab:defer:RCU Usage}
 \end{table}
 
-This section answers the question ``What is RCU?'' from the viewpoint
-of the uses to which RCU can be put.
-Because RCU is most frequently used to replace some existing mechanism,
-we look at it primarily in terms of its relationship to such mechanisms,
-as listed in \cref{tab:defer:RCU Usage}.
-Following the sections listed in this table,
-\cref{sec:defer:RCU Usage Summary} provides a summary.
-
 \subsubsection{RCU for Pre-BSD Routing}
 \label{sec:defer:RCU for Pre-BSD Routing}
 
@@ -414,13 +414,6 @@ was shown in the previous sections.
 \subsubsection{Phased State Change}
 \label{sec:defer:Phased State Change}
 
-\begin{figure}
-\centering
-\resizebox{\twocolumnwidth}{!}{\includegraphics{defer/RCUphasedstatechange}}
-\caption{Phased State Change for Maintenance Operation}
-\label{fig:defer:Phased State Change for Maintenance Operation}
-\end{figure}
-
 \Cref{fig:defer:Phased State Change for Maintenance Operation}
 shows a timeline for an example phased state change to efficiently
 handle maintenance operations.
@@ -431,6 +424,13 @@ operations must be undertaken carefully, taking into account added
 complexities due to their running concurrently with that maintenance
 operation.
 
+\begin{figure}
+\centering
+\resizebox{\twocolumnwidth}{!}{\includegraphics{defer/RCUphasedstatechange}}
+\caption{Phased State Change for Maintenance Operation}
+\label{fig:defer:Phased State Change for Maintenance Operation}
+\end{figure}
+
 In the figure, these apparently conflicting requirements are resolved by
 having a prepare phase prior to the maintenance operation and a cleanup
 phase after it, during which the common-case operations can proceed
-- 
2.17.1

Re: [PATCH 2/2] defer/rcuusage: Move float objects away of section titles

[Akira Yokosawa]

On Mon, 6 Dec 2021 12:03:00 +0900, Akira Yokosawa wrote:
> Float objects are treated as page/column break candidates.
> They can cause widowed section titles.

Paul,

I see there remain quite a lot of similar patterns in LaTeX code
of perfbook.

So I'm thinking of adding patterns in cleverefcheck.pl to find
float objects next to headings (\section, \subsection, etc.).

Does this sound reasonable to you?

        Thanks, Akira

> 
> Move a pair of such objects in recently added contents.
> 
> Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
> ---
>  defer/rcuusage.tex | 30 +++++++++++++++---------------
>  1 file changed, 15 insertions(+), 15 deletions(-)
> 
> diff --git a/defer/rcuusage.tex b/defer/rcuusage.tex
> index 01342fda..9f2a428e 100644
> --- a/defer/rcuusage.tex
> +++ b/defer/rcuusage.tex
> @@ -6,6 +6,14 @@
>  \label{sec:defer:RCU Usage}
>  \OriginallyPublished{Section}{sec:defer:RCU Usage}{RCU Usage}{Linux Weekly News}{PaulEMcKenney2008WhatIsRCUUsage}
>  
> +This section answers the question ``What is RCU?'' from the viewpoint
> +of the uses to which RCU can be put.
> +Because RCU is most frequently used to replace some existing mechanism,
> +we look at it primarily in terms of its relationship to such mechanisms,
> +as listed in \cref{tab:defer:RCU Usage}.
> +Following the sections listed in this table,
> +\cref{sec:defer:RCU Usage Summary} provides a summary.
> +
>  \begin{table}
>  \renewcommand*{\arraystretch}{1.2}
>  \centering
> @@ -40,14 +48,6 @@ Quasi multi-version concurrency control (MVCC) &
>  \label{tab:defer:RCU Usage}
>  \end{table}
>  
> -This section answers the question ``What is RCU?'' from the viewpoint
> -of the uses to which RCU can be put.
> -Because RCU is most frequently used to replace some existing mechanism,
> -we look at it primarily in terms of its relationship to such mechanisms,
> -as listed in \cref{tab:defer:RCU Usage}.
> -Following the sections listed in this table,
> -\cref{sec:defer:RCU Usage Summary} provides a summary.
> -
>  \subsubsection{RCU for Pre-BSD Routing}
>  \label{sec:defer:RCU for Pre-BSD Routing}
>  
> @@ -414,13 +414,6 @@ was shown in the previous sections.
>  \subsubsection{Phased State Change}
>  \label{sec:defer:Phased State Change}
>  
> -\begin{figure}
> -\centering
> -\resizebox{\twocolumnwidth}{!}{\includegraphics{defer/RCUphasedstatechange}}
> -\caption{Phased State Change for Maintenance Operation}
> -\label{fig:defer:Phased State Change for Maintenance Operation}
> -\end{figure}
> -
>  \Cref{fig:defer:Phased State Change for Maintenance Operation}
>  shows a timeline for an example phased state change to efficiently
>  handle maintenance operations.
> @@ -431,6 +424,13 @@ operations must be undertaken carefully, taking into account added
>  complexities due to their running concurrently with that maintenance
>  operation.
>  
> +\begin{figure}
> +\centering
> +\resizebox{\twocolumnwidth}{!}{\includegraphics{defer/RCUphasedstatechange}}
> +\caption{Phased State Change for Maintenance Operation}
> +\label{fig:defer:Phased State Change for Maintenance Operation}
> +\end{figure}
> +
>  In the figure, these apparently conflicting requirements are resolved by
>  having a prepare phase prior to the maintenance operation and a cleanup
>  phase after it, during which the common-case operations can proceed
> 

Re: [PATCH 2/2] defer/rcuusage: Move float objects away of section titles

[Paul E. McKenney]

On Mon, Dec 06, 2021 at 12:57:06PM +0900, Akira Yokosawa wrote:
> On Mon, 6 Dec 2021 12:03:00 +0900, Akira Yokosawa wrote:
> > Float objects are treated as page/column break candidates.
> > They can cause widowed section titles.

I queued and pushed both, thank you!

> Paul,
> 
> I see there remain quite a lot of similar patterns in LaTeX code
> of perfbook.
> 
> So I'm thinking of adding patterns in cleverefcheck.pl to find
> float objects next to headings (\section, \subsection, etc.).
> 
> Does this sound reasonable to you?

That sounds most excellent!  Especially given that I apparently am having
some trouble keeping all of the usage rules in my head.  ;-)

							Thanx, Paul

>         Thanks, Akira
> 
> > 
> > Move a pair of such objects in recently added contents.
> > 
> > Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
> > ---
> >  defer/rcuusage.tex | 30 +++++++++++++++---------------
> >  1 file changed, 15 insertions(+), 15 deletions(-)
> > 
> > diff --git a/defer/rcuusage.tex b/defer/rcuusage.tex
> > index 01342fda..9f2a428e 100644
> > --- a/defer/rcuusage.tex
> > +++ b/defer/rcuusage.tex
> > @@ -6,6 +6,14 @@
> >  \label{sec:defer:RCU Usage}
> >  \OriginallyPublished{Section}{sec:defer:RCU Usage}{RCU Usage}{Linux Weekly News}{PaulEMcKenney2008WhatIsRCUUsage}
> >  
> > +This section answers the question ``What is RCU?'' from the viewpoint
> > +of the uses to which RCU can be put.
> > +Because RCU is most frequently used to replace some existing mechanism,
> > +we look at it primarily in terms of its relationship to such mechanisms,
> > +as listed in \cref{tab:defer:RCU Usage}.
> > +Following the sections listed in this table,
> > +\cref{sec:defer:RCU Usage Summary} provides a summary.
> > +
> >  \begin{table}
> >  \renewcommand*{\arraystretch}{1.2}
> >  \centering
> > @@ -40,14 +48,6 @@ Quasi multi-version concurrency control (MVCC) &
> >  \label{tab:defer:RCU Usage}
> >  \end{table}
> >  
> > -This section answers the question ``What is RCU?'' from the viewpoint
> > -of the uses to which RCU can be put.
> > -Because RCU is most frequently used to replace some existing mechanism,
> > -we look at it primarily in terms of its relationship to such mechanisms,
> > -as listed in \cref{tab:defer:RCU Usage}.
> > -Following the sections listed in this table,
> > -\cref{sec:defer:RCU Usage Summary} provides a summary.
> > -
> >  \subsubsection{RCU for Pre-BSD Routing}
> >  \label{sec:defer:RCU for Pre-BSD Routing}
> >  
> > @@ -414,13 +414,6 @@ was shown in the previous sections.
> >  \subsubsection{Phased State Change}
> >  \label{sec:defer:Phased State Change}
> >  
> > -\begin{figure}
> > -\centering
> > -\resizebox{\twocolumnwidth}{!}{\includegraphics{defer/RCUphasedstatechange}}
> > -\caption{Phased State Change for Maintenance Operation}
> > -\label{fig:defer:Phased State Change for Maintenance Operation}
> > -\end{figure}
> > -
> >  \Cref{fig:defer:Phased State Change for Maintenance Operation}
> >  shows a timeline for an example phased state change to efficiently
> >  handle maintenance operations.
> > @@ -431,6 +424,13 @@ operations must be undertaken carefully, taking into account added
> >  complexities due to their running concurrently with that maintenance
> >  operation.
> >  
> > +\begin{figure}
> > +\centering
> > +\resizebox{\twocolumnwidth}{!}{\includegraphics{defer/RCUphasedstatechange}}
> > +\caption{Phased State Change for Maintenance Operation}
> > +\label{fig:defer:Phased State Change for Maintenance Operation}
> > +\end{figure}
> > +
> >  In the figure, these apparently conflicting requirements are resolved by
> >  having a prepare phase prior to the maintenance operation and a cleanup
> >  phase after it, during which the common-case operations can proceed
> >