summaryrefslogtreecommitdiff
path: root/dev-haskell/bits-atomic/metadata.xml
diff options
context:
space:
mode:
Diffstat (limited to 'dev-haskell/bits-atomic/metadata.xml')
-rw-r--r--dev-haskell/bits-atomic/metadata.xml38
1 files changed, 38 insertions, 0 deletions
diff --git a/dev-haskell/bits-atomic/metadata.xml b/dev-haskell/bits-atomic/metadata.xml
new file mode 100644
index 00000000000..0e02475e5f0
--- /dev/null
+++ b/dev-haskell/bits-atomic/metadata.xml
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
+<pkgmetadata>
+ <herd>haskell</herd>
+ <longdescription>
+ Atomic operations including CAS (compare-and-swap), fetch &amp; add and variants
+ suitable for low-level shared-memory synchronization.
+
+ The implementation is using GCC&#39;s builtin atomic operations (available in GCC &gt;=
+ 4) in C wrappers called through the FFI. See these links for background:
+
+ * GCC manual: &lt;http://gcc.gnu.org/onlinedocs/gcc/Atomic-Builtins.html&gt;
+
+ * GCC wiki: &lt;http://gcc.gnu.org/wiki/Atomic&gt;
+
+ /Portability/: This package is primarily developed on a Linux system, but
+ should work wherever GCC &gt;= 4 is available. It has been confirmed as working
+ on OSX. On Windows, it should work with Cygwin but currently fails for
+ vanilla Haskell-Platform 2010.1.0.0 as it still packages GCC 3.x. An
+ installer for updated versions of GCC is available at
+ &lt;http://www.mingw.org/&gt; and should make this package work in connection with
+ Haskell-Platform. Feedback on compatibility would be appreciated.
+
+ /Testing:/ The following commands can be used to compile and run the test suite:
+
+ &gt; cabal unpack bits-atomic &amp;&amp; cd bits-atomic-* # if not yet locally available
+ &gt; cabal configure -ftest
+ &gt; cabal build
+ &gt; cabal test
+
+ /Recent changes/:
+
+ * 0.1.3: Documentation updates, especially on portability. No functional
+ changes.
+
+ * 0.1.2: Avoid using System.FilePath in Setup.hs to fix build failure on hackage
+ </longdescription>
+</pkgmetadata>