Add 'docs' and 'doxygen' targets to top-level Makefile.

git-svn-id: svn://svn.berlios.de/openocd/trunk@1858 b42882b7-edfa-0310-969c-e2dbd0fdcd60
This commit is contained in:
zwelch 2009-05-20 20:52:14 +00:00
parent 8686a33807
commit e666807a6f
2 changed files with 42 additions and 0 deletions

View File

@ -13,6 +13,14 @@ SUBDIRS = src doc
EXTRA_DIST = Doxyfile EXTRA_DIST = Doxyfile
docs: pdf html doxygen
doxygen::
doxygen Doxyfile 2>&1 | perl tools/logger.pl > doxygen.log
doxygen-clean:
rm -f -r doxygen doxygen.log
MAINTAINERCLEANFILES = \ MAINTAINERCLEANFILES = \
configure \ configure \
Makefile.in \ Makefile.in \

34
tools/logger.pl Normal file
View File

@ -0,0 +1,34 @@
#!/usr/bin/perl
# logger.pl: masks long meaningless output with pretty lines of dots
# Details: 1) reads lines from STDIN and echos them on STDOUT,
# 2) print a '.' to STDERR every $N lines.
# 3) print a newline after a sequence of $C dots
use strict;
use warnings;
# make sure all output gets displayed immediately
$| = 1;
# TODO: add -n and -c options w/ zero checks)
# line and column limits
my $N = 10;
my $C = 72;
# current line and column counters
my $n = 0;
my $c = 0;
# read all lines from STDIN
while (<STDIN>)
{
# echo line to output
print STDOUT $_;
# only display progress every Nth step
next unless ++$n % $N;
print STDERR ".";
# wrap at column C to provide fixed-width rows of dots
print STDERR "\n" unless ++$c % $C;
}
print STDERR "\n"