From 59850d0874429601812bc13408cb1f776649027c Mon Sep 17 00:00:00 2001
From: Roman Divacky
Date: Wed, 14 Oct 2009 17:57:32 +0000
Subject: Update llvm to r84119.
---
docs/CommandGuide/FileCheck.pod | 65 +++++++++++
docs/CommandGuide/Makefile | 10 +-
docs/CommandGuide/index.html | 4 +-
docs/CommandGuide/lit.pod | 222 +++++++++++++++++++++++++++++++++++++
docs/CommandGuide/llc.pod | 22 ++--
docs/CommandGuide/llvm-as.pod | 6 +-
docs/CommandGuide/llvm-dis.pod | 6 +-
docs/CommandGuide/llvm-extract.pod | 10 +-
docs/CommandGuide/llvm-ld.pod | 6 +
docs/CommandGuide/llvm-link.pod | 9 +-
docs/CommandGuide/llvmc.pod | 6 +
docs/CommandGuide/opt.pod | 29 +++--
12 files changed, 356 insertions(+), 39 deletions(-)
create mode 100644 docs/CommandGuide/FileCheck.pod
create mode 100644 docs/CommandGuide/lit.pod
(limited to 'docs/CommandGuide')
diff --git a/docs/CommandGuide/FileCheck.pod b/docs/CommandGuide/FileCheck.pod
new file mode 100644
index 000000000000..539f66fea545
--- /dev/null
+++ b/docs/CommandGuide/FileCheck.pod
@@ -0,0 +1,65 @@
+
+=pod
+
+=head1 NAME
+
+FileCheck - Flexible pattern matching file verifier
+
+=head1 SYNOPSIS
+
+B I [I<--check-prefix=XXX>] [I<--strict-whitespace>]
+
+=head1 DESCRIPTION
+
+B reads two files (one from standard input, and one specified on the
+command line) and uses one to verify the other. This behavior is particularly
+useful for the testsuite, which wants to verify that the output of some tool
+(e.g. llc) contains the expected information (for example, a movsd from esp or
+whatever is interesting). This is similar to using grep, but it is optimized
+for matching multiple different inputs in one file in a specific order.
+
+The I file specifies the file that contains the patterns to
+match. The file to verify is always read from standard input.
+
+The input and output of B is beyond the scope of this short
+introduction. Please see the I page in the LLVM documentation.
+
+=head1 OPTIONS
+
+=over
+
+=item B<--help>
+
+Print a summary of command line options.
+
+=item B<--check-prefix> I
+
+FileCheck searches the contents of I for patterns to match. By
+default, these patterns are prefixed with "CHECK:". If you'd like to use a
+different prefix (e.g. because the same input file is checking multiple
+different tool or options), the B<--check-prefix> argument allows you to specify
+a specific prefix to match.
+
+=item B<--strict-whitespace>
+
+By default, FileCheck canonicalizes input horizontal whitespace (spaces and
+tabs) which causes it to ignore these differences (a space will match a tab).
+The --strict-whitespace argument disables this behavior.
+
+=item B<-version>
+
+Show the version number of this program.
+
+=back
+
+=head1 EXIT STATUS
+
+If B verifies that the file matches the expected contents, it exits
+with 0. Otherwise, if not, or if an error occurs, it will exit with a non-zero
+value.
+
+=head1 AUTHORS
+
+Maintained by The LLVM Team (L).
+
+=cut
diff --git a/docs/CommandGuide/Makefile b/docs/CommandGuide/Makefile
index cf77e6a33db0..3b6518310726 100644
--- a/docs/CommandGuide/Makefile
+++ b/docs/CommandGuide/Makefile
@@ -48,6 +48,12 @@ HTML := $(patsubst $(SRC_DOC_DIR)%.pod, $(DST_HTML_DIR)%.html, $(POD))
MAN := $(patsubst $(SRC_DOC_DIR)%.pod, $(DST_MAN_DIR)%.1, $(POD))
PS := $(patsubst $(SRC_DOC_DIR)%.pod, $(DST_PS_DIR)%.ps, $(POD))
+# The set of man pages we will not install
+NO_INSTALL_MANS = $(DST_MAN_DIR)FileCheck.1
+
+# The set of man pages that we will install
+INSTALL_MANS = $(filter-out $(NO_INSTALL_MANS), $(MAN))
+
.SUFFIXES:
.SUFFIXES: .html .pod .1 .ps
@@ -75,7 +81,7 @@ HTML_DIR := $(PROJ_docsdir)/html/CommandGuide
MAN_DIR := $(PROJ_mandir)/man1
PS_DIR := $(PROJ_docsdir)/ps
-install-local:: $(HTML) $(MAN) $(PS)
+install-local:: $(HTML) $(INSTALL_MANS) $(PS)
$(Echo) Installing HTML CommandGuide Documentation
$(Verb) $(MKDIR) $(HTML_DIR)
$(Verb) $(DataInstall) $(HTML) $(HTML_DIR)
@@ -83,7 +89,7 @@ install-local:: $(HTML) $(MAN) $(PS)
$(Verb) $(DataInstall) $(PROJ_SRC_DIR)/manpage.css $(HTML_DIR)
$(Echo) Installing MAN CommandGuide Documentation
$(Verb) $(MKDIR) $(MAN_DIR)
- $(Verb) $(DataInstall) $(MAN) $(MAN_DIR)
+ $(Verb) $(DataInstall) $(INSTALL_MANS) $(MAN_DIR)
$(Echo) Installing PS CommandGuide Documentation
$(Verb) $(MKDIR) $(PS_DIR)
$(Verb) $(DataInstall) $(PS) $(PS_DIR)
diff --git a/docs/CommandGuide/index.html b/docs/CommandGuide/index.html
index f05260bfebb3..f1046fac4480 100644
--- a/docs/CommandGuide/index.html
+++ b/docs/CommandGuide/index.html
@@ -128,6 +128,8 @@ options) arguments to the tool you are interested in.
+- FileCheck -
+ Flexible file verifier used extensively by the testing harness
- tblgen -
target description reader and generator
@@ -144,7 +146,7 @@ options) arguments to the tool you are interested in.
src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01">
LLVM Compiler Infrastructure
- Last modified: $Date: 2008-12-11 18:12:52 +0100 (Thu, 11 Dec 2008) $
+ Last modified: $Date: 2009-08-15 17:38:11 +0200 (Sat, 15 Aug 2009) $