This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: tests for --help
- From: Rafael Espindola <espindola at google dot com>
- To: janis187 at us dot ibm dot com
- Cc: Ralf Wildenhues <Ralf dot Wildenhues at gmx dot de>, Ben Elliston <bje at au1 dot ibm dot com>, gcc-patches at gcc dot gnu dot org, Diego Novillo <dnovillo at google dot com>
- Date: Thu, 9 Apr 2009 09:44:02 +0100
- Subject: Re: tests for --help
- References: <20090301071014.GA6143@ins.uni-bonn.de> <1235944327.7891.63.camel@helios> <20090305212022.GF14854@ins.uni-bonn.de> <1236298485.1310.3.camel@helios> <20090306190019.GC16791@ins.uni-bonn.de> <20090401203554.GD20432@gmx.de> <38a0d8450904080537l105f94a4m891b59462292a65e@mail.gmail.com> <1239229492.6731.17.camel@janis-laptop>
> Usually a .exp file is infrastructure for tests from other files, so
> help.exp deserves a comment at the start that it is a set of tests.
Done.
> Some of the comments are not full sentences, some don't start with a
> capitalized word, and some don't end with a period. ÂSome are missing
> (meaning it would be helpful to have additional comments as well).
I fixed the capitalized words and missing periods. Ralf, can you take
a look at the missing comments?
> In help.exp, it would be easier to read the calls to check_for_options
> if the arguments were passed as strings instead of within braces; I'm
> pretty sure that would work.
It does except for strings with newlines or +. I changed all other strings.
> It shouldn't be necessary to use "\{" for puts; in other files "{"
> comes through just fine.
Done.
> In proc check_for_options it's confusing to have an argument called
> xfail when the proc calls a procedure of that name; please rename the
> argument to lessen the chances for confusion.
Done.
> Why is there an unconditional "pass $test" at the end of options.exp?
No idea. Ralf?
> Janis
>
>
Thanks,
--
Rafael Avila de Espindola
Google | Gordon House | Barrow Street | Dublin 4 | Ireland
Registered in Dublin, Ireland | Registration Number: 368047
diff --git a/gcc/testsuite/gcc.misc-tests/help.exp b/gcc/testsuite/gcc.misc-tests/help.exp
new file mode 100644
index 0000000..f9c395c
--- /dev/null
+++ b/gcc/testsuite/gcc.misc-tests/help.exp
@@ -0,0 +1,77 @@
+# Copyright (C) 2005, 2007, 2009 Free Software Foundation, Inc.
+
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GCC; see the file COPYING3. If not see
+# <http://www.gnu.org/licenses/>.
+
+# This file contains a set of test that check that gcc options are
+# documented in --help.
+
+load_lib options.exp
+
+# Document --version. No undocumented switches in --help.
+check_for_options c "--help" "--version" "This switch lacks documentation" ""
+
+# No intermingled output; pick up help strings from duplicate option flags.
+check_for_options c "-v --help" "" {
+[^\n]The following options
+-Wconversion[^\n]*lacks documentation
+" -g "
+} ""
+
+# There are still undocumented switches in -v --help.
+check_for_options c "-v --help" "" "This switch lacks documentation" "xfail"
+
+# Multiline conversion in optc-gen.
+check_for_options c "-v --help" "" {are likely to\n -std} ""
+
+# --help= classes and qualifiers.
+check_for_options c "--help=optimizers" "-O" " -g " ""
+check_for_options c "--help=params" "maximum number of" "-Wunsafe-loop-optimizations" ""
+check_for_options c "--help=C" "-ansi" "-gnatO" ""
+check_for_options c {--help=C++} {-std=c\+\+} "-gnatO" ""
+check_for_options c "--help=common" "-dumpbase" "-gnatO" ""
+check_for_options c "--help=undocumented" "This switch lacks documentation" "" ""
+
+# Undocumented flags are not yet consistently marked as such.
+check_for_options c "--help=^undocumented" "-Wall" "This switch lacks documentation" "xfail"
+
+# Examples from the manual.
+check_for_options c "--help=target,undocumented" "" "" ""
+check_for_options c "--help=target,optimizers" "" "" ""
+check_for_options c "--help=warnings,^joined,^undocumented" "" "" ""
+check_for_options c "-Q -O2 --help=optimizers" {
+-O
+-ftree-vectorize[^\n]*disabled
+} " -g " ""
+check_for_options c "-Q -O3 --help=optimizers" {
+-O
+-ftree-vectorize[^\n]*enabled
+} " -g " ""
+# Repeated --help=.
+check_for_options c "--help=params --help=optimizers" {
+maximum number of
+-O
+} "" ""
+
+# PR 37805.
+check_for_options c "--help=joined" "Wformat=" "-fstrict-prototype" ""
+check_for_options c "--help=separate" "-MF" "-fstrict-prototype" ""
+check_for_options c "--help=warnings,joined" "Wformat=" "Wtrigraphs" ""
+check_for_options c "--help=warnings,^joined" "Wtrigraphs" "Wformat=" ""
+check_for_options c "--help=joined,separate" "-I" "" ""
+check_for_options c "--help=^joined,separate" "--param " "" ""
+check_for_options c "--help=joined,^separate" "--help=" "" ""
+check_for_options c "--help=joined,undocumented" "" "" ""
+# Listing only excludes gives empty results.
+check_for_options c "--help=^joined,^separate" "" "" ""
diff --git a/gcc/testsuite/lib/options.exp b/gcc/testsuite/lib/options.exp
new file mode 100644
index 0000000..9178c98
--- /dev/null
+++ b/gcc/testsuite/lib/options.exp
@@ -0,0 +1,70 @@
+# Copyright (C) 2009 Free Software Foundation, Inc.
+
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GCC; see the file COPYING3. If not see
+# <http://www.gnu.org/licenses/>.
+
+# We set LC_ALL and LANG to C so that we get the same error messages as expected.
+setenv LC_ALL C
+setenv LANG C
+
+# Run the LANGUAGE compiler with GCC_OPTIONS and inspect the compiler
+# output to make sure that they match the newline-separated patterns
+# in COMPILER_PATTERNS but not the patterns in COMPILER_NON_PATTERNS.
+# In case of failure, xfail if XFAIL is nonempty.
+
+proc check_for_options {language gcc_options compiler_patterns compiler_non_patterns expected_failure} {
+ set filename test-[pid]
+ set fd [open $filename.c w]
+ puts $fd "int main (void) { return 0; }"
+ close $fd
+ remote_download host $filename.c
+
+ set test "compiler driver $gcc_options option(s):"
+ set gcc_options "\{additional_flags=$gcc_options\}"
+
+ switch "$language" {
+ "c" { set compiler cc1 }
+ default { error "unknown language" }
+ }
+ set gcc_output [gcc_target_compile $filename.c $filename.x executable $gcc_options]
+ remote_file build delete $filename.c $filename.x $filename.gcno
+
+ foreach pattern [split $compiler_patterns "\n"] {
+ if {$pattern ne ""} {
+ if {[regexp -- "$pattern" $gcc_output]} {
+ pass "$test $pattern"
+ } else {
+ if {$expected_failure ne ""} {
+ xfail "$test $pattern"
+ } else {
+ fail "$test $pattern"
+ }
+ }
+ }
+ }
+ foreach pattern [split $compiler_non_patterns "\n"] {
+ if {$pattern ne ""} {
+ if {![regexp -- "$pattern" $gcc_output]} {
+ pass "$test $pattern"
+ } else {
+ if {$expected_failure ne ""} {
+ xfail "$test $pattern"
+ } else {
+ fail "$test $pattern"
+ }
+ }
+ }
+ }
+ pass $test
+}