Changeset 522906 in git


Ignore:
Timestamp:
Mar 3, 2012, 10:21:04 AM (11 years ago)
Author:
Bernhard R. Link <brlink@…>
Branches:
(u'jengelh-datetime', 'ceac47cbc86fe4a15902392bdbb9bd2ae0ea02c6')(u'spielwiese', 'ad2543eab51733612ba7d118afc77edca719600e')
Children:
ede7a69d54c25b9d0c8b81afc4a499d622183a15
Parents:
5bcfa8f36743c68cb02d72f74780d253c35537a3
git-author:
Bernhard R. Link <brlink@debian.org>2012-03-03 10:21:04+01:00
git-committer:
Hans Schoenemann <hannes@mathematik.uni-kl.de>2013-03-13 15:28:57+01:00
Message:
tag more examples

Add a way to tag all examples from a .lib file included.

Use this new feature to tag some libs needed external programs,
special features or significant memory usage in order to be able
to build documentation on more machines.

Make DOC2TEX_EXAMPLE_EXCLUSIONS a make variable, so that this
setting can also be overridden at make invocation time.
Location:
doc
Files:
5 edited

Legend:

Unmodified
Added
Removed
  • doc/Makefile.in

    r5bcfa8 r522906  
    6767EX_SUBDIR       = ./examples
    6868CHKSUM_DB       = ${DOC_SUBDIR}/chksum
     69DOC2TEX_EXAMPLE_EXCLUSIONS = @DOC2TEX_EXAMPLE_EXCLUSIONS@
    6970DOC2TEX         = ${PERL} ./doc2tex.pl -docdir ${DOC_SUBDIR} \
    7071                  -Singular ${SINGULAR} -verbose ${VERBOSE} -make ${MAKE} \
    71                   -exdir ${EX_SUBDIR} @DOC2TEX_EXAMPLE_EXCLUSIONS@
    72 PL2DOC          = ${PERL} ./pl2doc.pl -db ${CHKSUM_DB}
     72                  -exdir ${EX_SUBDIR} ${DOC2TEX_EXAMPLE_EXCLUSIONS}
     73TAG             =
     74PL2DOC          = ${PERL} ./pl2doc.pl ${TAG} -db ${CHKSUM_DB}
    7375
    7476# t2h stuff
  • doc/doc2tex.pl

    r5bcfa8 r522906  
    539539sub HandleLib
    540540{
    541   my($lib, $proc, $n_fun, $n_ex, $section, $tex_file);
     541  my($lib, $proc, $n_fun, $n_ex, $section, $tex_file, $tag);
    542542
    543543  if (/^\@c\s*lib\s+([^\.]+)\.lib(.*)/)
     
    551551    print TEX $_;
    552552    return;
     553  }
     554  if (/tag:(\w+)/)
     555  {
     556    $tag = "TAG='-tag ".$1."'";
     557  }
     558  else
     559  {
     560    $tag = '';
    553561  }
    554562
     
    574582  {
    575583    print "<lib $lib " if ($verbose);
    576     System("$make $make_opts VERBOSE=$verbose $tex_file");
     584    System("$make $make_opts $tag VERBOSE=$verbose $tex_file");
    577585  }
    578586 
  • doc/pl2doc.pl

    r5bcfa8 r522906  
    2020  if (/^-o$/)    { $out_file = shift(@ARGV); next;}
    2121  if (/^-db$/) { $db_file = shift(@ARGV); next;}
     22  if (/^-tag$/) { $tag = $tag . " tag:" . shift(@ARGV); next;}
    2223  if (/^-no_fun$/)    { $no_fun = 1;next;}
    2324  if (/^-doc$/)       { $doc = 1; next;}
     
    120121    {
    121122      print LDOC "\@strong{Example:}\n";
    122       print LDOC "\@smallexample\n\@c example\n";
     123      print LDOC "\@smallexample\n\@c example$tag\n";
    123124      print LDOC $ex;
    124125      print LDOC "\n\@c example\n\@end smallexample\n";
Note: See TracChangeset for help on using the changeset viewer.