Re: [PATCH -perfbook v4] howto: make ref to git archive explicit

On Wed, 27 Dec 2023 17:34:25 +0800, [email protected] wrote:
> From: Zhouyi Zhou <[email protected]>
> 
> Make "git archive" in answer to Quick Quiz 1.3 more explicit, so that reader can easily know where
> "git archive" is.

Now that this patch adds just a footnote mentioning Section 1.5,
commit log can use some adjustments.

How about:

    Make "git archive" in answer to Quick Quiz 1.3 more explicit by
    adding a footnote, so that a first-time reader, who have never
    read Section 1.5, can easily know how to clone the Git repo and
    build PDFs.

That said, I'm beginning to wonder how many of first-time readers
would bother trying -nq builds without having got annoyed by those
lots of QQz's in perfbook. ;-)

> 
> Suggested-by: Akira Yokosawa <[email protected]>
> Signed-off-by: Zhouyi Zhou<[email protected]>

Reviewed-by: Akira Yokosawa <[email protected]>

    Thanks, Akira

> ---
> Hi Akira
> 
> Thank you for your valuable suggestions and guidances, I learned a lot
> during this process ;-)
> 
> And I invoke make -j 20 in my ubuntu 22.04, everything works great!
> 
> Our editor Yunjing Li is still too modest to provide her email, sorry.
> 
> Thanks for your patient and hard work.
> 
> Thanks
> Zhouyi
> --
>  howto/howto.tex | 4 +++-
>  1 file changed, 3 insertions(+), 1 deletion(-)
> 
> diff --git a/howto/howto.tex b/howto/howto.tex
> index 55270cba..8d678644 100644
> --- a/howto/howto.tex
> +++ b/howto/howto.tex
> @@ -226,7 +226,9 @@ Here are a few possible strategies:
>  	only a blank sheet of paper.
>  \item	If you find the Quick Quizzes distracting but impossible
>  	to ignore, you can always clone the \LaTeX{} source for
> -	this book from the git archive.
> +	this book from the git archive.\footnote{
> +		See \cref{sec:howto:Whose Book Is This?}
> +		for instructions to do this.}
>  	You can then run the command \co{make nq}, which will
>  	produce a \co{perfbook-nq.pdf}.
>  	This PDF contains unobtrusive boxed tags where the Quick Quizzes