Commit 8b57d808 authored by Eddie Kohler's avatar Eddie Kohler

To 1.7.0rc1.

parent 40f164d6
THE CLICK MODULAR ROUTER RELEASE 1.6.0
THE CLICK MODULAR ROUTER RELEASE 1.7.0
======================================
This is the README file for the source release for the Click modular
......
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
# Generated by GNU Autoconf 2.61 for click 1.6.9.
# Generated by GNU Autoconf 2.61 for click 1.7.0rc1.
#
# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
# 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
......@@ -572,8 +572,8 @@ SHELL=${CONFIG_SHELL-/bin/sh}
# Identity of this package.
PACKAGE_NAME='click'
PACKAGE_TARNAME='click'
PACKAGE_VERSION='1.6.9'
PACKAGE_STRING='click 1.6.9'
PACKAGE_VERSION='1.7.0rc1'
PACKAGE_STRING='click 1.7.0rc1'
PACKAGE_BUGREPORT=''
# Factoring default headers for most tests.
......@@ -1261,7 +1261,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
\`configure' configures click 1.6.9 to adapt to many kinds of systems.
\`configure' configures click 1.7.0rc1 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
......@@ -1327,7 +1327,7 @@ fi
if test -n "$ac_init_help"; then
case $ac_init_help in
short | recursive ) echo "Configuration of click 1.6.9:";;
short | recursive ) echo "Configuration of click 1.7.0rc1:";;
esac
cat <<\_ACEOF
......@@ -1462,7 +1462,7 @@ fi
test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
click configure 1.6.9
click configure 1.7.0rc1
generated by GNU Autoconf 2.61
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
......@@ -1476,7 +1476,7 @@ cat >config.log <<_ACEOF
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
It was created by click $as_me 1.6.9, which was
It was created by click $as_me 1.7.0rc1, which was
generated by GNU Autoconf 2.61. Invocation command line was
$ $0 $@
......@@ -18683,7 +18683,7 @@ exec 6>&1
# report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
This file was extended by click $as_me 1.6.9, which was
This file was extended by click $as_me 1.7.0rc1, which was
generated by GNU Autoconf 2.61. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
......@@ -18736,7 +18736,7 @@ Report bugs to <bug-autoconf@gnu.org>."
_ACEOF
cat >>$CONFIG_STATUS <<_ACEOF
ac_cs_version="\\
click config.status 1.6.9
click config.status 1.7.0rc1
configured by $0, generated by GNU Autoconf 2.61,
with options \\"`echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`\\"
......
......@@ -11,7 +11,7 @@ dnl The Software is provided WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED. This
dnl notice is a summary of the Click LICENSE file; the license in that file is
dnl legally binding.
AC_INIT([click], [1.6.9])
AC_INIT([click], [1.7.0rc1])
AC_PREREQ(2.60)
AC_CONFIG_HEADER(include/click/config.h:config.h.in include/click/pathvars.h:pathvars.h.in include/click/config-bsdmodule.h:config-bsdmodule.h.in include/click/config-linuxmodule.h:config-linuxmodule.h.in include/click/config-ns.h:config-ns.h.in include/click/config-userlevel.h:config-userlevel.h.in)
......
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
.\"
.\" Standard preamble:
.\" ========================================================================
......@@ -48,22 +48,25 @@
. ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.ie \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
.\"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.el \{\
. de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
......@@ -129,7 +132,11 @@
.\" ========================================================================
.\"
.IX Title "TESTIE 1"
.TH TESTIE 1 "" "perl v5.8.8" ""
.TH TESTIE 1 "2009-03-05" "perl v5.10.0" ""
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
testie \- simple test harness
.SH "SYNOPSIS"
......@@ -168,6 +175,9 @@ unsuccessful tests.
.IX Item "-VV, --superverbose"
Like \-\-verbose, but use a slightly different format, and additionally print
every test's \f(CW%desc\fR section before the test results.
.IP "\-q, \-\-quiet" 8
.IX Item "-q, --quiet"
Don't print information to the terminal while running multiple tests.
.IP "\-v, \-\-version" 8
.IX Item "-v, --version"
Print version number information and exit.
......@@ -205,7 +215,8 @@ starting with %. There must be, at least, a \f(CW%script\fR section.
The \f(CW%file\fR and \f(CW%expect\fR* sections define input and/or output files by
name. Testie runs its script in a private directory in \fI/tmp\fR; any files
mentioned in \f(CW%file\fR or \f(CW%expect\fR* are placed in that directory.
.IP "%script" 8
.ie n .IP "%script" 8
.el .IP "\f(CW%script\fR" 8
.IX Item "%script"
The shell script (in sh syntax) that controls the test. Testie will run
each command in sequence. Every command in the script must succeed, with
......@@ -217,7 +228,8 @@ The \f(CW%script\fR section can contain multiple subtests. To start a new subtes
execute a command like \*(L"testie_subtest \s-1SECTIONNAME\s0\*(R". Testie will report the
offending \s-1SECTIONNAME\s0 when standard output or error doesn't match an
expected value.
.IP "%require [\-q]" 8
.ie n .IP "%require [\-q]" 8
.el .IP "\f(CW%require\fR [\-q]" 8
.IX Item "%require [-q]"
A shell script (in sh syntax) defining prerequisites that must be satisfied
before the test can run. Every command in the script must succeed, with
......@@ -227,18 +239,22 @@ if a requirement fails.
.Sp
Testie runs the requirement script before creating any other test files.
For example, contents of \f(CW%file\fR sections are not available.
.IP "%desc" 8
.ie n .IP "%desc" 8
.el .IP "\f(CW%desc\fR" 8
.IX Item "%desc"
A short description of the test. In \-\-superverbose mode, its contents are
printed before the test results.
.IP "%info" 8
.ie n .IP "%info" 8
.el .IP "\f(CW%info\fR" 8
.IX Item "%info"
This section is ignored. It is intended for information about the test.
.IP "%cut" 8
.ie n .IP "%cut" 8
.el .IP "\f(CW%cut\fR" 8
.IX Item "%cut"
This section is ignored. It is intended to comment out obsolete parts of
the test.
.IP "%file [\-d] [+LENGTH] \s-1FILENAME\s0..." 8
.ie n .IP "%file [\-d] [+LENGTH] \s-1FILENAME\s0..." 8
.el .IP "\f(CW%file\fR [\-d] [+LENGTH] \s-1FILENAME\s0..." 8
.IX Item "%file [-d] [+LENGTH] FILENAME..."
Create an input file for the script. \s-1FILENAME\s0 can be 'stdin', which sets
the script's standard input. If \s-1LENGTH\s0 is provided, the file data consists
......@@ -246,8 +262,9 @@ of the \s-1LENGTH\s0 bytes following this line. Otherwise, it consists of the da
up to the next section. The \f(CW\*(C`\-d\*(C'\fR flag tells testie to delete the
first character of each line in the section; this makes it possible to
include files that have lines that start with %.
.IP "%expectv [\-a] [\-d] [+LENGTH] \s-1FILENAME\s0..." 8
.IX Item "%expectv [-a] [-d] [+LENGTH] FILENAME..."
.ie n .IP "%expectv [\-ad] [+LENGTH] \s-1FILENAME\s0..." 8
.el .IP "\f(CW%expectv\fR [\-ad] [+LENGTH] \s-1FILENAME\s0..." 8
.IX Item "%expectv [-ad] [+LENGTH] FILENAME..."
An expected output file for the script. \s-1FILENAME\s0 can be 'stdout', for
standard output. If \s-1LENGTH\s0 is provided, the file data consists of the
\&\s-1LENGTH\s0 bytes following this line; otherwise, it consists of the data up to
......@@ -260,24 +277,23 @@ The \f(CW\*(C`\-a\*(C'\fR flag marks this expected output as an alternate. Testi
compare the script's output file with each provided alternate; the test
succeeds if any of the alternates match. The \f(CW\*(C`\-d\*(C'\fR flag behaves as in
\&\f(CW%file\fR.
.IP "%expect [\-a] [\-d] [\-i] [+LENGTH] \s-1FILENAME\s0..." 8
.IX Item "%expect [-a] [-d] [-i] [+LENGTH] FILENAME..."
.ie n .IP "%expect [\-adiw] [+LENGTH] \s-1FILENAME\s0..." 8
.el .IP "\f(CW%expect\fR [\-adiw] [+LENGTH] \s-1FILENAME\s0..." 8
.IX Item "%expect [-adiw] [+LENGTH] FILENAME..."
An expected output file for the script. Arguments are as for \f(CW%expectv\fR.
.Sp
Testie will run the script, then compare the file generated by script
with the provided data. The files are compared line\-by\-line. Testie
ignores trailing whitespace on each line and in the files at large. It also
with the provided data. The files are compared line-by-line. Testie
ignores blank lines and trailing whitespace on each line. It also
ignores lines in the script output that match \f(CW%ignore\fR patterns (see below).
Blank lines in the \f(CW%expect\fR data match one or more blank lines in the
output. \f(CW%expect\fR lines can contain Perl regular expressions, enclosed by two
\&\f(CW%expect\fR lines can contain Perl regular expressions, enclosed by two
sets of braces; so the \f(CW%expect\fR line
.Sp
.Vb 1
\& foo{{(bar)?}}
.Ve
.Sp
matches either 'foo' or 'foobar'. The \f(CW\*(C`\-i\*(C'\fR flag makes any regular
expressions case\-insensitive.
matches either 'foo' or 'foobar'.
.Sp
Document an \f(CW%expect\fR line with \*(L"{{?comment}}\*(R" blocks. For example:
.Sp
......@@ -288,42 +304,55 @@ Document an \f(CW%expect\fR line with \*(L"{{?comment}}\*(R" blocks. For exampl
Testie ignores whitespace before and after the \*(L"{{?comment}}\*(R" block, and if
the actual output differs from this expected line, it prints the comment in
addition to the line differences.
.IP "%expectx [\-a] [\-d] [\-i] [+LENGTH] \s-1FILENAME\s0..." 8
.IX Item "%expectx [-a] [-d] [-i] [+LENGTH] FILENAME..."
%expectx is just like \f(CW%expect\fR, except that every line is treated as a
.Sp
The \f(CW\*(C`\-a\*(C'\fR and \f(CW\*(C`\-d\*(C'\fR flags may also be used for \f(CW%expect\fR sections. Also, the
\&\f(CW\*(C`\-i\*(C'\fR flag makes any regular expressions case-insensitive (text outside of
regular expressions must match case), and the \f(CW\*(C`\-w\*(C'\fR flag ignores any
differences in amount of whitespace within a line.
.ie n .IP "%expectx [\-adiw] [+LENGTH] \s-1FILENAME\s0..." 8
.el .IP "\f(CW%expectx\fR [\-adiw] [+LENGTH] \s-1FILENAME\s0..." 8
.IX Item "%expectx [-adiw] [+LENGTH] FILENAME..."
\&\f(CW%expectx\fR is just like \f(CW%expect\fR, except that every line is treated as a
regular expression. The input is parsed for \*(L"{{?comment}}\*(R" blocks, but
other brace pairs are treated according to the normal regular expression
rules.
.IP "%stdin [+LENGTH]" 8
.ie n .IP "%stdin [+LENGTH]" 8
.el .IP "\f(CW%stdin\fR [+LENGTH]" 8
.IX Item "%stdin [+LENGTH]"
Same as '%file stdin [\s-1ARGS\s0]'.
.IP "%stdout [\-a] [\-d] [\-i] [+LENGTH]" 8
.IX Item "%stdout [-a] [-d] [-i] [+LENGTH]"
.ie n .IP "%stdout [\-adiw] [+LENGTH]" 8
.el .IP "\f(CW%stdout\fR [\-adiw] [+LENGTH]" 8
.IX Item "%stdout [-adiw] [+LENGTH]"
Same as '%expect stdout'.
.IP "%stderr [\-a] [\-d] [\-i] [+LENGTH]" 8
.IX Item "%stderr [-a] [-d] [-i] [+LENGTH]"
.ie n .IP "%stderr [\-adiw] [+LENGTH]" 8
.el .IP "\f(CW%stderr\fR [\-adiw] [+LENGTH]" 8
.IX Item "%stderr [-adiw] [+LENGTH]"
Same as '%expect stderr'.
.IP "%ignorex [\-d] [\-i] [+LENGTH] [\s-1FILENAME\s0]" 8
.IX Item "%ignorex [-d] [-i] [+LENGTH] [FILENAME]"
.ie n .IP "%ignorex [\-di] [+LENGTH] [\s-1FILENAME\s0]" 8
.el .IP "\f(CW%ignorex\fR [\-di] [+LENGTH] [\s-1FILENAME\s0]" 8
.IX Item "%ignorex [-di] [+LENGTH] [FILENAME]"
Each line in the \f(CW%ignorex\fR section is a Perl regular expression. Lines in
the supplied \s-1FILENAME\s0 that match any of those regular expressions will not
be considered when comparing files with \f(CW%expect\fR data. The regular
expression must match the whole line. \s-1FILENAME\s0 may be 'all', in which case
the regular expressions will apply to all \f(CW%expect\fR files. \*(L"{{?comment}}\*(R"
blocks are ignored.
.ie n .IP "%ignore, %ignorev" 8
.el .IP "%ignore, \f(CW%ignorev\fR" 8
.ie n .IP "%ignore\fR, \f(CW%ignorev" 8
.el .IP "\f(CW%ignore\fR, \f(CW%ignorev\fR" 8
.IX Item "%ignore, %ignorev"
Like '%ignorex', but '%ignore' parses regular expressions only inside
double braces (\*(L"{{ }}\*(R"), and '%ignorev' lines must match exactly.
.IP "%include \s-1FILENAME\s0" 8
.ie n .IP "%include \s-1FILENAME\s0" 8
.el .IP "\f(CW%include\fR \s-1FILENAME\s0" 8
.IX Item "%include FILENAME"
Interpolate the contents of another testie file.
.IP "%eot" 8
.ie n .IP "%eot" 8
.el .IP "\f(CW%eot\fR" 8
.IX Item "%eot"
Marks the end of the current test. The rest of the file will be parsed for
additional tests.
.IP "%eof" 8
.ie n .IP "%eof" 8
.el .IP "\f(CW%eof\fR" 8
.IX Item "%eof"
The rest of the file is ignored.
.SH "EXAMPLE"
......
......@@ -11,7 +11,7 @@ dnl The Software is provided WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED. This
dnl notice is a summary of the Click LICENSE file; the license in that file is
dnl legally binding.
AC_INIT([libclick], [1.6.9])
AC_INIT([libclick], [1.7.0])
AC_PREREQ(2.50)
AC_CONFIG_HEADER(include/click/config.h:config.h.in include/click/pathvars.h:pathvars.h.in include/click/config-userlevel.h:config-userlevel.h.in)
......
......@@ -16,7 +16,7 @@ dnl
dnl the usual 'configure.ac' boilerplate
dnl
AC_INIT(click-samplepackage, 1.6.0)
AC_INIT(click-samplepackage, 1.7.0)
AC_SUBST(ac_configure_args)
CLICKPACKAGENAME=sample
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment