reactos/CMake
1
0
Fork 0
mirror of https://github.com/reactos/CMake.git synced 2024-12-15 07:41:15 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
b779b8e85f
CMake/Tests
History
Brad King b779b8e85f Merge topic 'cmp0040-wording' 
a1b1f1a2 CMP0040: Clarify policy warning to match documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !1415
2017-10-27 09:42:37 -04:00
..
AliasTarget HP-UX: Drop support for building CMake on HP-UX 2017-08-07 09:16:09 -04:00
Architecture Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
ArgumentExpansion
Assembler Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
BuildDepends Drop Visual Studio 7 .NET 2003 generator 2017-04-19 15:28:05 -04:00
BundleGeneratorTest Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
BundleTest Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
BundleUtilities Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CFBundleTest Xcode: Properly handle BUNDLE_EXTENSION 2016-06-18 23:23:32 +02:00
CheckCompilerRelatedVariables
CMakeCommands CompileFeatures: Makes tests work with meta-feature only 2017-05-29 13:51:45 -04:00
CMakeLib Enable clang-tidy modernize-loop-convert lint 2017-09-19 09:32:25 -04:00
CMakeOnly Merge topic 'fix-test-all-find-modules' 2017-04-24 09:34:03 -04:00
CMakeServerLib server: test buffer parsing 2017-08-31 15:35:04 -04:00
CMakeTestAllGenerators Tests: Drop machine-specific logic from CMakeTestAllGenerators 2017-04-18 15:12:22 -04:00
CMakeTestMultipleConfigures
CMakeTests gitattributes: prefer eol=lf to crlf=input 2017-08-23 13:30:00 -04:00
CoberturaCoverage
CommandLineTest
CompatibleInterface Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CompileCommandOutput Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CompileDefinitions Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CompileFeatures clang-format: format all code as Cpp11 2017-08-30 11:07:05 -04:00
CompileOptions Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Complex HP-UX: Drop support for building CMake on HP-UX 2017-08-07 09:16:09 -04:00
ComplexOneConfig HP-UX: Drop support for building CMake on HP-UX 2017-08-07 09:16:09 -04:00
ConfigSources
COnly Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Contracts Replace http://www.cmake.org URLs with https://cmake.org 2015-09-25 15:47:39 -04:00
CPackComponents Tests: Fix CPackComponents NSIS install root 2017-03-09 10:20:35 -05:00
CPackComponentsDEB CPack RPM and DEB: improved package version handling 2017-09-21 19:54:17 +02:00
CPackComponentsForAll CPack RPM and DEB: improved package version handling 2017-09-21 19:54:17 +02:00
CPackComponentsPrefix CPack: Enable DEB and RPM tests more reliably 2015-05-12 08:56:34 -04:00
CPackTestAllGenerators
CPackWiXGenerator Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CrossCompile
CSharpLinkToCxx VS: Do not reference output assemblies if not possible for CSharp target 2017-09-05 09:41:40 -04:00
CSharpOnly VS: added support for C# (for Visual Studio 2010, 2012, 2013, 2015) 2017-01-13 09:28:13 +01:00
CTestBuildCommandProjectInSubdir
CTestConfig Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestCoverageCollectGCOV Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestLimitDashJ issues: update references to the CMake issue tracker 2016-08-15 09:34:06 -04:00
CTestScriptMode
CTestTest Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTest2 Tests: In CTestTest2 skip the kwsys.testProcess-10 test that leaks 2015-07-31 09:27:08 -04:00
CTestTestBadExe
CTestTestBadGenerator
CTestTestChecksum Tests: Fix spurious CTestTestParallel failures 2017-03-31 13:46:08 -04:00
CTestTestCostSerial Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTestCrash Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTestCycle
CTestTestDepends
CTestTestEmptyBinaryDirectory
CTestTestFailure Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTestFdSetSize Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTestLabelRegExp
CTestTestLaunchers Tests: Add additional launcher tests 2017-01-10 13:48:59 -05:00
CTestTestMissingDependsExe
CTestTestParallel Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTestResourceLock Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTestRunScript
CTestTestScheduler Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTestSerialInDepends
CTestTestSerialOrder
CTestTestSkipReturnCode
CTestTestStopTime Tests: make tests pass with SOURCE_DATE_EPOCH set 2017-01-30 09:25:44 -05:00
CTestTestSubdir
CTestTestTimeout Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTestUpload Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CTestTestVerboseOutput CTest: Output test-specific env vars in verbose mode (#15446) 2015-03-17 10:11:33 -04:00
CTestTestZeroTimeout Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Cuda clang-format: format all code as Cpp11 2017-08-30 11:07:05 -04:00
CudaOnly Tests: Fix CudaOnly.WithDefs test on CUDA 9 2017-09-29 09:55:11 -04:00
CustComDepend Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CustomCommand add_custom_{command,target}: Add COMMAND_EXPAND_LISTS option 2017-01-13 20:02:16 -06:00
CustomCommandByproducts Tests: Fix CustomCommandByproducts regex for phony rules 2017-05-31 11:48:02 -04:00
CustomCommandWorkingDirectory Tests: use BYPRODUCTS in the CustomCommandWorkingDirectory test 2017-04-21 08:57:40 -04:00
CxxDialect
CxxOnly Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
CxxSubdirC Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
DelphiCoverage Tests: Fix DelphiCoverage test file selection 2015-10-20 11:13:25 -04:00
Dependency Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
DoubleProject
EmptyDepends
EmptyLibrary
EmptyProperty Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Environment Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
ExportImport Tests: Make function name not match SONAME 2017-05-18 10:26:09 -04:00
ExternalOBJ
ExternalProject ExternalProject: only append COMMAND if actually adding a command 2017-02-27 11:33:31 -05:00
ExternalProjectLocal ExternalProject: Fix UPDATE_DISCONNECTED with empty update steps 2016-11-15 08:45:04 -05:00
ExternalProjectSourceSubdir ExternalProject: Add SOURCE_SUBDIR option 2016-08-16 13:18:18 -04:00
ExternalProjectSubdir Drop Visual Studio 6 generator 2016-03-09 09:42:18 -05:00
ExternalProjectUpdate ExternalProject: Always run update step with non-empty UPDATE_COMMAND 2016-05-18 14:54:25 -04:00
FindBoost Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
FindBZip2 Tests: Add FindBZip2 unit tests 2016-09-09 11:42:35 -04:00
FindDoxygen Improve Doxygen support 2017-05-24 10:15:45 +07:00
FindEXPAT FindEXPAT: Add unit test of target and variables 2017-09-01 16:02:57 +01:00
FindFreetype FindFreetype: Add imported target, docs, and test 2017-09-07 17:52:33 +01:00
FindGSL Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
FindGTest FindGTest: Improve test to catch link error 2017-09-18 10:01:15 -04:00
FindGTK2 Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
FindICU Tests: Run clang-format on FindICU test code 2016-07-13 10:01:02 -04:00
FindJsonCpp FindJsonCpp: Drop new module due to upstream jsoncpp providing package 2015-02-20 08:22:02 -05:00
FindLibRHash FindLibRHash: Add module to find the librhash package 2016-11-10 08:29:38 -05:00
FindLibUV FindLibUV: Add module to find libuv package 2016-08-31 09:05:14 -04:00
FindLTTngUST Format include directive blocks and ordering with clang-format 2016-04-29 13:58:54 -04:00
FindMatlab FindMatlab: adding handling of component "MAT" 2016-08-30 14:50:20 +02:00
FindModulesExecuteAll Tests: Fix FindModulesExecuteAll when KDE4 is installed 2017-04-21 10:11:10 -04:00
FindMPI FindMPI: Support components for various languages 2017-09-15 14:55:08 +02:00
FindOpenCL Tests/FindOpenCL: Run clang-format to fix style 2016-06-07 08:41:06 -04:00
FindOpenGL FindOpenGL: Add support for GLVND on Linux 2017-09-25 09:22:29 -04:00
FindOpenMP TestFindOpenMP,MPI: Disable default languages 2017-05-08 21:43:01 +02:00
FindOpenSSL Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
FindPackageModeMakefileTest cmake: Fix --find-package mode with imported targets 2017-08-29 15:30:07 -04:00
FindPackageTest find_package: Optionally sort globbed directories in a meaningful order 2016-09-15 13:35:25 -04:00
FindPatch FindPatch: Add module to find 'patch' command-line tool 2017-09-01 11:46:28 -04:00
FindPNG Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
FindProtobuf FindProtobuf: add flag to allow descriptor files to be generated 2017-10-02 08:08:24 -04:00
FindThreads FindThreads: officially announce it works with only C++ enabled 2015-09-25 10:08:35 -04:00
FindTIFF Tests: Remove unnecessary setting of CMAKE_MODULE_PATH 2017-05-16 08:05:32 +10:00
FindVulkan Tests/FindVulkan: Run clang-format 2016-06-08 12:56:50 -04:00
FindXalanC Tests: Remove unnecessary setting of CMAKE_MODULE_PATH 2017-05-16 08:05:32 +10:00
FindXercesC Tests: Remove unnecessary setting of CMAKE_MODULE_PATH 2017-05-16 08:05:32 +10:00
ForceInclude Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Fortran Tests: Split Fortran module testing into separate FortranModules test 2016-09-22 14:52:01 -04:00
FortranC Tests: Fix CMAKE_MAKE_PROGRAM selection in FortranC.Flags test 2015-08-11 10:18:05 -04:00
FortranModules Ninja: Add source location as include directory for preprocessed files 2016-09-27 08:11:08 -04:00
FortranOnly CheckFortranCompilerFlag: Add test case 2015-02-05 11:18:13 -05:00
Framework Apple: Add support for static frameworks 2017-01-31 08:59:15 -05:00
FunctionTest
GeneratorExpression VS,Xcode: Fix TARGET_PROPERTY genex in source COMPILE_FLAGS property 2017-10-03 08:03:33 -04:00
GhsMulti Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
GhsMultiDuplicateSourceFilenames GHS: Use shorter object file names on collision 2016-05-18 09:27:19 -04:00
GoogleTest GoogleTest: Add support for disabled tests 2017-06-05 10:11:08 -04:00
IncludeDirectories Xcode: Properly mark SYSTEM includes as such 2016-12-27 22:18:30 +01:00
InterfaceLibrary Do not initialize NO_SYSTEM_FROM_IMPORTED on INTERFACE libraries 2017-10-13 14:32:14 -04:00
InterfaceLinkLibraries Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
iOSNavApp Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
IPO
JacocoCoverage CTest: Fix Jacoco Coverage 2015-03-06 11:18:19 -05:00
Java UseJava: OUTPUT_DIR must exists in all cases. 2017-10-10 10:00:23 +02:00
JavaExportImport Tests: Test namespaces with exported JARs 2017-04-21 10:51:09 -04:00
JavaJavah Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
JavascriptCoverage
JCTest Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Jump Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
LibName Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
LinkDirectory Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
LinkFlags Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
LinkLanguage Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
LinkLine Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
LinkLineOrder Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
LinkStatic
LoadCommand Tests: Remove ancient workaround in LoadCommand tests 2017-10-04 09:42:52 -04:00
LoadCommandOneConfig Tests: Remove ancient workaround in LoadCommand tests 2017-10-04 09:42:52 -04:00
MacroTest
MacRuntimePath Add a BUILD_RPATH target property specifying build-tree RPATH entries 2016-10-03 13:42:27 -04:00
MakeClean Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
MathTest math(EXPR): Add support for unary + and - expressions 2016-10-14 15:35:15 -04:00
MFC Avoid CRLF newlines in Git repo blobs 2017-08-30 08:29:43 -04:00
MissingInstall Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
MissingSourceFile
Module Merge topic 'modernize-git-whitespace-attributes' 2017-08-25 11:04:05 -04:00
ModuleDefinition Support WINDOWS_EXPORT_ALL_SYMBOLS with .def files 2017-03-21 10:02:34 -04:00
MSManifest Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
MumpsCoverage Avoid CRLF newlines in Git repo blobs 2017-08-30 08:29:43 -04:00
NewlineArgs Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
ObjC++
ObjectLibrary Drop Visual Studio 7 .NET 2003 generator 2017-04-19 15:28:05 -04:00
OutDir Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
OutOfBinary Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
OutOfSource Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
PDBDirectoryAndName Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
PerConfig Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Plugin HP-UX: Drop support for building CMake on HP-UX 2017-08-07 09:16:09 -04:00
Policy0002
PolicyScope
PositionIndependentTargets clang-format.bash: Use Git attributes to mark files for formatting 2017-02-22 16:59:26 -05:00
PrecompiledHeader Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
PreOrder Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Preprocess Drop Visual Studio 7 .NET 2003 generator 2017-04-19 15:28:05 -04:00
Properties Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
PythonCoverage
Qt4And5Automoc
Qt4Deploy Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Qt4Targets Autogen: Tests: Disable some tests on non ASCII build paths 2017-06-13 16:51:33 +02:00
QtAutogen Autogen: Tests: Update AUTOMOC_MACRO_NAMES test 2017-09-28 09:21:44 +02:00
QtAutogenRerun Autogen: Tests: Add a change-not test to the mocRerun test 2017-09-21 09:58:24 +02:00
QtAutomocNoQt
QtAutoUicInterface Autogen: Enable per-config support 2017-08-05 14:37:03 +02:00
ReturnTest
RunCMake Merge topic 'cmp0040-wording' 2017-10-27 09:42:37 -04:00
RuntimePath Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
SBCS Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Server Tests: Teach Server test to print server return code 2017-08-30 14:20:44 -04:00
SetLang Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Simple Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
SimpleCOnly Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
SimpleInstall gitattributes: prefer eol=crlf to -crlf 2017-08-23 13:31:41 -04:00
SimpleInstallS2 gitattributes: prefer eol=crlf to -crlf 2017-08-23 13:31:41 -04:00
SourceFileProperty
SourceGroups source_group: Restore TREE support for relative paths 2017-05-17 09:04:02 -04:00
SourcesProperty
StagingPrefix Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
StringFileTest Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
SubDir Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
SubDirSpaces Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
SubProject Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
SwiftMix Swift: Simplify mixed test case to make it version agnostic 2017-03-29 15:36:05 +02:00
SwiftOnly Xcode: Add option to set Swift language version 2016-09-26 08:46:23 -04:00
SwigTest SwigTest: Update for swig_add_library and add lua example 2016-11-11 08:14:10 +01:00
SystemInformation Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
TargetName Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
TestDriver Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Testing Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
TestsWorkingDirectory Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
TryCompile Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
Tutorial Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Unset
VariableUnusedViaSet
VariableUnusedViaUnset
VariableUsage
Visibility Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
VSExcludeFromDefaultBuild VS: Add option to put INSTALL target in .sln default build 2015-05-06 10:31:39 -04:00
VSExternalInclude VS15: Add Visual Studio 15 generator 2016-09-07 15:49:08 -04:00
VSGNUFortran Tests: Fix CMake syntax warning in VSGNUFortran test 2017-09-15 10:49:42 -04:00
VSMASM Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
VSMidl Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
VSNASM VS: Add support for ASM_NASM language 2017-02-07 13:20:52 -05:00
VSNsightTegra Tests: Fix VSNsightTegra test on Android NDK r12b 2016-10-18 13:32:50 -04:00
VSProjectInSubdir
VSResource Ninja: Fix quoting of RC language depfile in cmcldeps call 2017-09-25 10:07:48 -04:00
VSResourceNinjaForceRSP ninja, rc: ignore CMAKE_NINJA_FORCE_RESPONSE_FILE for RC files 2016-06-27 14:34:06 -04:00
VSWindowsFormsResx Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
VSWinStorePhone VS: Add VS_SHADER_OUTPUT_HEADER_FILE and VS_SHADER_VARIABLE_NAME properties. 2017-09-27 07:56:09 -04:00
VSXaml Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
WarnUnusedCliUnused Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
Wrapping Tests: Ensure Solaris linker never sees empty contents 2017-05-18 10:32:03 +10:00
X11 Revise C++ coding style using clang-format 2016-05-16 16:05:19 -04:00
XCTest XCTest: Speed up test by only enabling C language 2017-06-28 22:00:36 +02:00
.NoDartCoverage
bootstrap.bat.in
BootstrapTest.cmake BootstrapTest: Use --parallel=... argument. 2016-10-21 18:22:44 +02:00
CheckFortran.cmake Tests: Pass generator platform and toolset into check for Fortran 2017-03-08 09:12:09 -05:00
CMakeBuildTest.cmake.in
CMakeCopyright.cmake
CMakeInstall.cmake
CMakeLists.txt UseJava: OUTPUT_DIR must exists in all cases. 2017-10-10 10:00:23 +02:00
CTestUpdateBZR.cmake.in Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
CTestUpdateCommon.cmake Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
CTestUpdateCVS.cmake.in Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
CTestUpdateGIT.cmake.in Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
CTestUpdateGIT.sh.in
CTestUpdateHG.cmake.in Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
CTestUpdateP4.cmake.in Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
CTestUpdateSVN.cmake.in Use string(APPEND) in Tests 2016-07-28 00:43:04 +02:00
EnforceConfig.cmake.in
README.rst Tests: Document test directory layout in a README.rst 2017-06-14 15:04:19 -04:00
test_clean.cmake.in

README.rst 

CMake Tests Directory
*********************

This directory contains the CMake test suite.
See also the `CMake Source Code Guide`_.

.. _`CMake Source Code Guide`: ../Help/dev/source.rst

Many tests exist as immediate subdirectories, but some tests
are organized as follows.

* ``CMakeLib/``:
  Source code, used for tests, that links to the ``CMakeLib`` library
  defined over in ``Source/``.

* ``CMakeOnly/``:
  Deprecated.  Tests that run CMake to generate a project but not build it.
  Superseded by ``Tests/RunCMake/``.

* ``Find*/``:
  Tests for specific find modules that can only be run on machines with
  the corresponding packages installed.  They are enabled in
  ``CMakeLists.txt`` by undocumented options used on CI builds.

* ``Module/``:
  Tests for specific CMake modules.

* ``RunCMake/``:
  Tests that run CMake and/or other tools while precisely checking
  their return code and stdout/stderr content.  Useful for testing
  error cases and diagnostic output.