Re: [PATCH v2 4/4] debugging/debugging: s/remainder of a section/following sections/

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Sat, 11 Feb 2023 09:10:08 -0800, SeongJae Park wrote:
> A sectence in 'Microbenchmarking' section is mentioning the remainder of
> the section will look at ways for dealing with conflicts in measurement
> error advices.  Because we don't distinguish section and subsection on
> text, this makes it a little confused, whether it means remainder of the
> subsection, or the following subsections of the section.  Make it a bit
> more clear.
> 
> Suggedsted-by: Paul E. McKenney <paulmck@xxxxxxxxxx>
> Signed-off-by: SeongJae Park <sj38.park@xxxxxxxxx>
> ---
>  debugging/debugging.tex | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> diff --git a/debugging/debugging.tex b/debugging/debugging.tex
> index b7538620..170bf273 100644
> --- a/debugging/debugging.tex
> +++ b/debugging/debugging.tex
> @@ -641,8 +641,8 @@ sure to take full advantage of any existing test suites available to
>  you.
>  Important as test development is, we must leave further discussion of it
>  to books dedicated to that topic.
> -The following sections therefore discuss locating bugs in your code given that
> -you already have a good test suite.
> +The remainder of this section (\cref{sec:debugging:Performance Estimation})
> +looks at ways of resolving this conflict.

I think this hunk is misplaced. Existing text around here doesn't
have any ambiguity. In other words, "The following sections" means
Sections 11.2 through 11.7 (11.8 is a summary). 

>  
>  \section{Tracing}
>  \label{sec:debugging:Tracing}
> @@ -2302,7 +2302,7 @@ to creep in, including:
>  
>  The first and fourth sources of interference provide conflicting advice,
>  which is one sign that we are living in the real world.
> -The remainder of this section looks at ways of resolving this conflict.
> +The following sections look at ways of resolving this conflict.

To my eyes, this sentence now looks redundant as there already is an
introduction to the following subsections below QQz 11.23.

>  
>  \QuickQuiz{
>  	But what about other sources of error, for example, due to



[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Linux NFS]     [Linux NILFS]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux