Re: [NOT YET PULL] Trial of labeling lines in code snippets

["Paul E. McKenney" <paulmck@linux.vnet.ibm.com>]

On Sat, Jul 21, 2018 at 09:19:53AM +0900, Akira Yokosawa wrote:
> Hi Paul,
> 
> So, an experimental branch to label particular lines in code
> snippets is ready for review.
> The branch is based on current master of yours.
> 
> I've converted 4 code snippets in Section 4.2. and updated
> corresponding code samples (sans forkjoin.c because it is
> quite simplified in Listing 4.1).
> 
> Does this approach look reasonable to you?

This does look promising, thank you!  Please give me some time to think
this over a bit.  My normal approach would end up with very long labels
in the code, which might be OK.  The argument against is that tying the
listing caption to the actual code might not be a great thing.

Again, looks promising, thank you!

							Thanx, Paul

>         Thanks, Akira
> 
> ---
> The following changes since commit e3191997557e0d33b862e267fb4d5971e879ca07:
> 
>   utilities: Provide scripts instead of broken symlinks (2018-07-18 11:40:57 -0700)
> 
> are available in the git repository at:
> 
>   https://github.com/akiyks/perfbook trial-fancyvrb
> 
> for you to fetch changes up to 2154a175e469e6238c89d4c494d204a9ddbaa20a:
> 
>   [EXP] Update hyphen2endash (2018-07-21 09:17:34 +0900)
> 
> ----------------------------------------------------------------
> Akira Yokosawa (3):
>       [EXP] toolsoftrade: Add labels in code samples as comments
>       [EXP] toolsoftrade: Reference line in code snippets by label
>       [EXP] Update hyphen2endash
> 
>  CodeSamples/api-pthreads/api-pthreads.h |  14 +-
>  CodeSamples/toolsoftrade/forkjoinvar.c  |  10 +-
>  CodeSamples/toolsoftrade/pcreate.c      |   5 +-
>  perfbook.tex                            |   6 +
>  toolsoftrade/toolsoftrade.tex           | 221 +++++++++++++++++---------------
>  utilities/hyphen2endash.sh              |   3 +
>  6 files changed, 141 insertions(+), 118 deletions(-)
>