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

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

 



Hi Paul,

This is v2 of the trial of fancyvrb scheme.

---
The following changes since commit 3b62f67a76e15f8d8f8190a4252362d4ac0cdf23:

  Regenerating the atomic counter graph on a more modern CPU (2018-07-23 13:47:51 -0700)

are available in the git repository at:

  https://github.com/akiyks/perfbook.git trial-fancyvrb-20180730a

for you to fetch changes up to 3361b7331cf0f08a75bf6a9f69b7ea2f126e3b75:

  [EXP] Automate sub makefile update (2018-07-31 00:31:56 +0900)

----------------------------------------------------------------
Akira Yokosawa (6):
      [EXP] toolsoftrade: Add labels in code samples as comments
      [EXP] Add script to extract code snippet from code sample
      [EXP] toolsoftrade: Reference line in code snippets by label
      [EXP] Update hyphen2endash
      [EXP] Add *.fcv to .gitignore
      [EXP] Automate sub makefile update

 .gitignore                              |   2 +
 CodeSamples/api-pthreads/api-pthreads.h |  18 ++--
 CodeSamples/toolsoftrade/forkjoinvar.c  |  12 ++-
 CodeSamples/toolsoftrade/pcreate.c      |   7 +-
 Makefile                                |  14 ++-
 perfbook.tex                            |  12 +++
 toolsoftrade/toolsoftrade.tex           | 174 ++++++++++----------------------
 utilities/fcvextract.pl                 | 166 ++++++++++++++++++++++++++++++
 utilities/gen_snippet_mk.pl             |  55 ++++++++++
 utilities/hyphen2endash.sh              |   3 +
 10 files changed, 322 insertions(+), 141 deletions(-)
 create mode 100755 utilities/fcvextract.pl
 create mode 100755 utilities/gen_snippet_mk.pl

---

There are quite a few changes since v1:

    o Rebased to current master.
    o Use line label format of "ln:directory:filename:function:linelabel"
    o To avoid repetitive use of long labels in reference, introduce
      \lnlblbase and \lnrefbase macros. By this change, now \lnlbl{} and
      \lnref{} can have simple line labels.
    o Add a script to extract VerbatimL sources from code samples.
    o Add a script to generate sub makefile for snippet extraction.
    o Update Makefile accordingly.

The scheme looks like to work for 90% of code snippets.

TODO list for me to improve:

    o Support of code snippets other than "C".
    o Support option to meta command \begin{snippet} other than labelbase and
      commandchars.
    o Support of commandchars option with no escape charactor required

If this looks ready for you to merge, I'll amend commit logs and
add header comment to gen_snippets_mk.pl and send a proper pull request.
Please try this branch and let me know what you think.

        Thanks, Akika

--
To unsubscribe from this list: send the line "unsubscribe perfbook" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[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