summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'dev-haskell/inspection-testing/metadata.xml')
-rw-r--r--dev-haskell/inspection-testing/metadata.xml33
1 files changed, 33 insertions, 0 deletions
diff --git a/dev-haskell/inspection-testing/metadata.xml b/dev-haskell/inspection-testing/metadata.xml
new file mode 100644
index 000000000000..f4d3257dab77
--- /dev/null
+++ b/dev-haskell/inspection-testing/metadata.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
+<pkgmetadata>
+ <maintainer type="project">
+ <email>haskell@gentoo.org</email>
+ <name>Gentoo Haskell</name>
+ </maintainer>
+ <longdescription>
+ Some carefully crafted libraries make promises to their
+ users beyond functionality and performance.
+
+ Examples are: Fusion libraries promise intermediate data
+ structures to be eliminated. Generic programming libraries promise
+ that the generic implementation is identical to the
+ hand-written one. Some libraries may promise allocation-free
+ or branch-free code.
+
+ Conventionally, the modus operandi in all these cases is
+ that the library author manually inspects the (intermediate or
+ final) code produced by the compiler. This is not only
+ tedious, but makes it very likely that some change, either
+ in the library itself or the surrounding eco-system,
+ breaks the library's promised without anyone noticing.
+
+ This package provides a disciplined way of specifying such
+ properties, and have them checked by the compiler. This way,
+ this checking can be part of the ususal development cycle
+ and regressions caught early.
+
+ See the documentation in &quot;Test.Inspection&quot; or the project
+ webpage for more examples and more information.
+ </longdescription>
+</pkgmetadata>