Initial import.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@3 6f19259b-4bc3-4df7-8a09-765794883524

Tools/Source/Cpptasks/net/sf/antcontrib/cpptasks/compiler/PrecompilingCompiler.java

@@ -0,0 +1,49 @@
+/*
+ * 
+ * Copyright 2002-2004 The Ant-Contrib project
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+package net.sf.antcontrib.cpptasks.compiler;
+import java.io.File;
+/**
+ * A compiler that can utilize precompilation of header files
+ * 
+ * @author Curt Arnold
+ */
+public interface PrecompilingCompiler {
+    /**
+     * 
+     * This method may be used to get two distinct compiler configurations, one
+     * for compiling the specified file and producing a precompiled header
+     * file, and a second for compiling other files using the precompiled
+     * header file.
+     * 
+     * The last (preferrably only) include directive in the prototype file will
+     * be used to mark the boundary between pre-compiled and normally compiled
+     * headers.
+     * 
+     * @param config
+     *            base configuration
+     * @param prototype
+     *            A source file (for example, stdafx.cpp) that is used to build
+     *            the precompiled header file. @returns null if precompiled
+     *            headers are not supported or a two element array containing
+     *            the precompiled header generation configuration and the
+     *            consuming configuration
+     *  
+     */
+    CompilerConfiguration[] createPrecompileConfigurations(
+            CompilerConfiguration config, File prototype,
+            String[] nonPrecompiledFiles);
+}