datastruct: Employ new scheme for code snippet

Hi Paul,

This patch set consists of enhancement of fcvextract.pl, update of snippets in datastruct, and some minor tweaks.

fcvextract.pl now suppresses comment blocks in C source and supports alternative code for snippets in #ifndef blocks, which won't be affected by the suppression of comment blocks.

Also, labeling of the form /* \lnlbl{label} */ is now supported in C snippets.

Patch #1 adds comment block handling to fcvextract.pl, without changing the default behavior.

Patch #2 adds a couple of explicit options to snippets which have comments to be displayed. It also converts alternative code fragments using "#ifndef FCV_EXCLUDE" so that they survive comment block suppression.

Patch #3 changes the default to "keepcomment=no". This removes a couple of comments in Listings 4.8 and 9.5.

Patch #4 removes now redundant "\fcvexclude" around comment blocks. It also uses "#ifndef FCV_SNIPPET" to reduce \fcvexclude uses.

Patch #5 adds support of "/* \lnlbl{label} */" labeling.

Patch #6 updates snippets of hash_bkt.c. "struct hashtab" now has the "ht_cmp" field and I updated the text to mention it. You might want to do some rewording.

Patch #7 adds the "ht_cmp" field in the hashdiagram figure (still in .fig).

Patch #8 updates the rest of snippets in datastruct. It also fixes typo in cross references of Listing 10.13. By this change, an smp_mb() appears in ht_get_bucket() (Listing 10.10).

My guess is that the counterpart barrier is the first synchronize_rcu() in hashtab_resize(). It might deserve some explanation or a Quick Quiz. Also, Answer to Quick Quiz 10.13 might need some expansion, since it looks as though hash_reorder.c used something more than the pure RCU protection. But I might be completely misreading here...

Patches #9 and #10 are minor tweaks in appearance of Listing 10.13. As you can see, tab-space width can be adjusted per snippet.

Patch #11 permits more chances of hyphenation.

I'm thinking of globally widening tab space of snippets for 1C layout. Let me do some experiment.

Thanks, Akira
--
Akira Yokosawa (11):
fcvextract.pl: Enhance comment block handling of C source
CodeSamples: Add explicit 'keepcomment=yes' options fcvextract.pl: Make 'keepcomment=no' as default
CodeSamples: Remove redundant \fcvexclude fcvextract.pl: Support '/* \lnlbl{...} */' style label in C source
datastruct: Employ new scheme for snippets of hash_bkt.c
datastruct: Update hashdiagram figure
datastruct: Employ new scheme for snippets of hash_bkt_rcu and
hash_resize
Make sure lmtt font is used in 'VerbatimL' and 'Verbatim' env Use wider tabsize for snippet in 'listing*'
datastruct: Tweak hyphenation

 CodeSamples/SMPdesign/lockhdeq.c           |  11 +-
 CodeSamples/SMPdesign/smpalloc.c           |   8 +-
 CodeSamples/count/count_end.c              |   8 +-
 CodeSamples/count/count_lim.c              |   8 +-
 CodeSamples/count/count_tstat.c            |  10 +-
 CodeSamples/datastruct/hash/hash_bkt.c     |  96 ++--
 CodeSamples/datastruct/hash/hash_bkt_rcu.c |  33 +-
 CodeSamples/datastruct/hash/hash_resize.c  | 232 +++++-----
 CodeSamples/defer/route_hazptr.c           |  20 +-
 CodeSamples/defer/route_rcu.c              |  36 +-
 CodeSamples/defer/route_refcnt.c           |  16 +-
 CodeSamples/defer/route_seq.c              |  18 +-
 CodeSamples/defer/route_seqlock.c          |  14 +-
 CodeSamples/defer/seqlock.h                |  12 +-
 CodeSamples/locking/locked_list.c          |   6 +-
 CodeSamples/toolsoftrade/forkjoinvar.c     |   2 +-
 CodeSamples/toolsoftrade/pcreate.c         |   2 +-
 datastruct/datastruct.tex                  | 687 ++++++++---------------------
 datastruct/hashdiagram.fig                 | 103 ++---
 perfbook.tex                               |   2 +
 pfhyphex.tex                               |   1 +
 utilities/fcvextract.pl                    |  87 +++-
 22 files changed, 627 insertions(+), 785 deletions(-)

2.7.4