Commits

Bryan O'Sullivan committed 465f482

Update docs.

Comments (0)

Files changed (3)

Data/Double/Conversion/ByteString.hs

 --
 -- Fast, efficient support for converting between double precision
 -- floating point values and text.
+--
+-- Although about 15 times faster than plain 'show', these functions
+-- are /slower/ than their 'Text' counterparts, at roughly half the
+-- speed.  (This seems to be due to the cost of allocating
+-- 'ByteString' values via @malloc@.)
 
 module Data.Double.Conversion.ByteString
     (

Data/Double/Conversion/Text.hs

 --
 -- Fast, efficient support for converting between double precision
 -- floating point values and text.
+--
+-- These functions are about 30 times faster than the default 'show'
+-- implementation for the 'Double' type.
 
 module Data.Double.Conversion.Text
     (

double-conversion.cabal

 cabal-version:  >= 1.8
 build-type:     Simple
 description:
-    A library that performs fast conversion between double precision
-    floating point and text, implemented as bindings to the C++
-    double-conversion library written by Florian Loitsch at Google.
+    A library that performs fast, accurate conversion between double
+    precision floating point and text.
+    .
+    This library is implemented as bindings to the C++
+    @double-conversion@ library written by Florian Loitsch at Google:
+    <http://code.google.com/p/double-conversion/>.
+    .
+    The 'Text' versions of these functions are about 30 times faster
+    than the default 'show' implementation for the 'Double' type.
+    .
+    The 'ByteString' versions are /slower/ than the 'Text' versions;
+    roughly half the speed.  (This seems to be due to the cost of
+    allocating 'ByteString' values via @malloc@.)
+    .
+    As a final note, be aware that the @bytestring-show@ package is
+    about 50% slower than simply using 'show'.
 
 extra-source-files:
     README.markdown
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.