Skip to contentSkip to conversation

Reset footnote count of Glossary

PATCH In review Akira Yokosawa 2 participants 5 messages Nov 29, 2020 – Nov 30, 2020

lore
Share & tools
lore
#0 lore raw

PATCH 1/2 Reset footnote count of Glossary

From 8c33030941001780fb1a97c0028f04fab89470f2 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <[email protected]>
Date: Fri, 27 Nov 2020 20:03:14 +0900
Subject: [PATCH -perfbook 1/2] Reset footnote count of Glossary

Automatic reset of footnote count is disabled after \backmatter. Manually reset it in front of \include{glossary}.

---
 perfbook-lt.tex | 2 ++
 1 file changed, 2 insertions(+)
perfbook-lt.tex +2 -0
index 3a611add..bc32965d 100644
@@ -461,6 +461,8 @@
 \backmatter
 
 % Glossary
+%% Reset footnote count
+\setcounter{footnote}{0}
 \input{glossary.tex}
 
 % Bibliograpy
Signature · 1 line
2.17.1
#1 lore raw

PATCH 2/2 styleguide: Get rid of \VerbatimFootnotes macro

From b04aeebd8cb7d2ec0e5387c98011601cc4e0c270 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <[email protected]>
Date: Sun, 29 Nov 2020 17:01:24 +0900
Subject: [PATCH -perfbook 2/2] styleguide: Get rid of \VerbatimFootnotes macro

It turns out that this macro is not compatible with the "footnotebackref" package, which enables hyperlinks from footnotes to the corresponding footnote symbols in the text. Furthermore, it is wrong to use the macro in the middle of a book.
It is supposed to be used next to \begin{document}.

\VerbatimFootnote overrides the definition of \footnote{} based on the default code of standard LaTeX classes and breaks customization done by footnotebackref.

In perfbook, this affects footnotes in "Answers to Quick Quizzes" and Glossary as well as those in the latter part of Style Guide.

As it is not used anywhere else, remove the macro and update the footnote text accordingly.

---
 appendix/styleguide/styleguide.tex | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)
appendix/styleguide/styleguide.tex +7 -6
index b6b343e0..11802a85 100644
@@ -772,14 +772,15 @@ If they are escaped by a~\qco{\\},
 they appear in the end result with the escape character.
 The \qco{\\verb} command can be used in running text if you
 need to use monospace font for a string which contains
-many characters to escape.\VerbatimFootnotes\footnote{
-  The \verb|\verb| command is not almighty though.
+many characters to escape.\footnote{
+  The \co{\\verb} command is not almighty though.
   For example, you can't use it within a footnote.
   If you do so, you will see a fatal \LaTeX\ error.
-  The \qco{fancyvrb} package provides a workaround by
-  the name of \verb|\VerbatimFootnotes| macro.
-  This footnote is an example which contains a few \verb|\verb|
-  commands.}
+  A workaround would be a macro named \co{\\VerbatimFootnotes}
+  provided by the \co{fancyvrb} package.
+  Unfortunately, perfbook can't employ it due to the interference
+  with the \co{footnotebackref} package.
+  }
 
 \subsection{Cross-reference}
 \label{sec:app:styleguide:Cross-Reference}
Signature · 1 line
2.17.1
#2 lore raw

Re: [PATCH -perfbook 2/2] styleguide: Get rid of \VerbatimFootnotes macro

Quoted 16 lines · Akira Yokosawa
Quoted 1 line

From b04aeebd8cb7d2ec0e5387c98011601cc4e0c270 Mon Sep 17 00:00:00 2001

From: Akira Yokosawa <[email protected]>
Date: Sun, 29 Nov 2020 17:01:24 +0900
Subject: [PATCH -perfbook 2/2] styleguide: Get rid of \VerbatimFootnotes macro

It turns out that this macro is not compatible with the "footnotebackref" package, which enables hyperlinks from footnotes to the corresponding footnote symbols in the text. Furthermore, it is wrong to use the macro in the middle of a book.
It is supposed to be used next to \begin{document}.

\VerbatimFootnote overrides the definition of \footnote{} based on the default code of standard LaTeX classes and breaks customization done by footnotebackref.

Quoted 7 lines

In perfbook, this affects footnotes in "Answers to Quick Quizzes" and Glossary as well as those in the latter part of Style Guide.

As it is not used anywhere else, remove the macro and update the footnote text accordingly.

These are future-proofing, given no footnotes currently in the glossary and beyond, correct?

Either way, queued and pushed!

Thanx, Paul

Quoted 34 lines
---
 appendix/styleguide/styleguide.tex | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)
appendix/styleguide/styleguide.tex +7 -6
index b6b343e0..11802a85 100644
@@ -772,14 +772,15 @@ If they are escaped by a~\qco{\\},
 they appear in the end result with the escape character.
 The \qco{\\verb} command can be used in running text if you
 need to use monospace font for a string which contains
-many characters to escape.\VerbatimFootnotes\footnote{
-  The \verb|\verb| command is not almighty though.
+many characters to escape.\footnote{
+  The \co{\\verb} command is not almighty though.
   For example, you can't use it within a footnote.
   If you do so, you will see a fatal \LaTeX\ error.
-  The \qco{fancyvrb} package provides a workaround by
-  the name of \verb|\VerbatimFootnotes| macro.
-  This footnote is an example which contains a few \verb|\verb|
-  commands.}
+  A workaround would be a macro named \co{\\VerbatimFootnotes}
+  provided by the \co{fancyvrb} package.
+  Unfortunately, perfbook can't employ it due to the interference
+  with the \co{footnotebackref} package.
+  }
 
 \subsection{Cross-reference}
 \label{sec:app:styleguide:Cross-Reference}
Signature · 1 line
2.17.1
#3 lore raw

Re: [PATCH -perfbook 2/2] styleguide: Get rid of \VerbatimFootnotes macro

Quoted 20 lines · Paul E. McKenney
Quoted 19 lines · Akira Yokosawa
Quoted 1 line

From b04aeebd8cb7d2ec0e5387c98011601cc4e0c270 Mon Sep 17 00:00:00 2001

From: Akira Yokosawa <[email protected]>
Date: Sun, 29 Nov 2020 17:01:24 +0900
Subject: [PATCH -perfbook 2/2] styleguide: Get rid of \VerbatimFootnotes macro

It turns out that this macro is not compatible with the "footnotebackref" package, which enables hyperlinks from footnotes to the corresponding footnote symbols in the text. Furthermore, it is wrong to use the macro in the middle of a book.
It is supposed to be used next to \begin{document}.

\VerbatimFootnote overrides the definition of \footnote{} based on the default code of standard LaTeX classes and breaks customization done by footnotebackref.

In perfbook, this affects footnotes in "Answers to Quick Quizzes" and Glossary as well as those in the latter part of Style Guide.

Quoted 7 lines
Quoted 4 lines

As it is not used anywhere else, remove the macro and update the footnote text accordingly.

These are future-proofing, given no footnotes currently in the glossary and beyond, correct?

There is a footnote in the description of "Cache Miss". Otherwise, I wouldn't have noticed the wrong count.

Looks like back matters are not supposed to have sections or footnotes.

Thanks, Akira

Quoted 39 lines

Either way, queued and pushed!

Thanx, Paul

Quoted 34 lines
---
 appendix/styleguide/styleguide.tex | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)
appendix/styleguide/styleguide.tex +7 -6
index b6b343e0..11802a85 100644
@@ -772,14 +772,15 @@ If they are escaped by a~\qco{\\},
 they appear in the end result with the escape character.
 The \qco{\\verb} command can be used in running text if you
 need to use monospace font for a string which contains
-many characters to escape.\VerbatimFootnotes\footnote{
-  The \verb|\verb| command is not almighty though.
+many characters to escape.\footnote{
+  The \co{\\verb} command is not almighty though.
   For example, you can't use it within a footnote.
   If you do so, you will see a fatal \LaTeX\ error.
-  The \qco{fancyvrb} package provides a workaround by
-  the name of \verb|\VerbatimFootnotes| macro.
-  This footnote is an example which contains a few \verb|\verb|
-  commands.}
+  A workaround would be a macro named \co{\\VerbatimFootnotes}
+  provided by the \co{fancyvrb} package.
+  Unfortunately, perfbook can't employ it due to the interference
+  with the \co{footnotebackref} package.
+  }
 
 \subsection{Cross-reference}
 \label{sec:app:styleguide:Cross-Reference}
Signature · 1 line
2.17.1
#4 lore raw

Re: [PATCH -perfbook 2/2] styleguide: Get rid of \VerbatimFootnotes macro

Quoted 26 lines · Akira Yokosawa
Quoted 25 lines · Paul E. McKenney
Quoted 23 lines · Akira Yokosawa
Quoted 1 line

From b04aeebd8cb7d2ec0e5387c98011601cc4e0c270 Mon Sep 17 00:00:00 2001

From: Akira Yokosawa <[email protected]>
Date: Sun, 29 Nov 2020 17:01:24 +0900
Subject: [PATCH -perfbook 2/2] styleguide: Get rid of \VerbatimFootnotes macro

It turns out that this macro is not compatible with the "footnotebackref" package, which enables hyperlinks from footnotes to the corresponding footnote symbols in the text. Furthermore, it is wrong to use the macro in the middle of a book.
It is supposed to be used next to \begin{document}.

\VerbatimFootnote overrides the definition of \footnote{} based on the default code of standard LaTeX classes and breaks customization done by footnotebackref.

In perfbook, this affects footnotes in "Answers to Quick Quizzes" and Glossary as well as those in the latter part of Style Guide.

As it is not used anywhere else, remove the macro and update the footnote text accordingly.

Quoted 7 lines
Quoted 2 lines

These are future-proofing, given no footnotes currently in the glossary and beyond, correct?

There is a footnote in the description of "Cache Miss". Otherwise, I wouldn't have noticed the wrong count.

Looks like back matters are not supposed to have sections or footnotes.

Right you are! Never mind!!! ;-)

Thanx, Paul

Quoted 41 lines

Thanks, Akira

Quoted 39 lines

Either way, queued and pushed!

Thanx, Paul

Quoted 34 lines
---
 appendix/styleguide/styleguide.tex | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)
appendix/styleguide/styleguide.tex +7 -6
index b6b343e0..11802a85 100644
@@ -772,14 +772,15 @@ If they are escaped by a~\qco{\\},
 they appear in the end result with the escape character.
 The \qco{\\verb} command can be used in running text if you
 need to use monospace font for a string which contains
-many characters to escape.\VerbatimFootnotes\footnote{
-  The \verb|\verb| command is not almighty though.
+many characters to escape.\footnote{
+  The \co{\\verb} command is not almighty though.
   For example, you can't use it within a footnote.
   If you do so, you will see a fatal \LaTeX\ error.
-  The \qco{fancyvrb} package provides a workaround by
-  the name of \verb|\VerbatimFootnotes| macro.
-  This footnote is an example which contains a few \verb|\verb|
-  commands.}
+  A workaround would be a macro named \co{\\VerbatimFootnotes}
+  provided by the \co{fancyvrb} package.
+  Unfortunately, perfbook can't employ it due to the interference
+  with the \co{footnotebackref} package.
+  }
 
 \subsection{Cross-reference}
 \label{sec:app:styleguide:Cross-Reference}
Signature · 1 line
2.17.1