Update meta-data for upcoming 0.5.1 release

Data/Csv/Builder.hs

@@ -1,7 +1,7 @@
 {-# LANGUAGE ScopedTypeVariables #-}
 
 -- | Low-level bytestring builders. Most users want to use the more
--- type-safe 'Data.Csv.Incremental' module instead.
+-- type-safe "Data.Csv.Incremental" module instead.
 module Data.Csv.Builder
     (
     -- * Encoding single records and headers

README.md

@@ -2,8 +2,7 @@
 
 [![Hackage](https://img.shields.io/hackage/v/cassava.svg)](https://hackage.haskell.org/package/cassava) [![Build Status](https://travis-ci.org/hvr/cassava.svg)](https://travis-ci.org/hvr/cassava)
 
-A CSV parsing and encoding library optimized for ease of use and high
-performance.
+**See [package description](https://hackage.haskell.org/package/cassava#description).**
 
 ## Usage example
 

cassava.cabal

@@ -1,9 +1,33 @@
+cabal-version:       1.12
 Name:                cassava
 Version:             0.5.1.0
 Synopsis:            A CSV parsing and encoding library
-Description:
-  A CSV parsing and encoding library optimized for ease of use and high
-  performance.
+Description: {
+
+@cassava@ is a library for parsing and encoding [RFC 4180](https://tools.ietf.org/html/rfc4180)
+compliant [comma-separated values (CSV)](https://en.wikipedia.org/wiki/Comma-separated_values) data,
+which is a textual line-oriented format commonly used for exchanging tabular data.
+.
+@cassava@'s API includes support for
+.
+- Index-based record-conversion
+- Name-based record-conversion
+- Typeclass directed conversion of fields and records
+- Built-in field-conversion instances for standard types
+- Customizable record-conversion instance derivation via GHC generics
+- Low-level [bytestring](https://hackage.haskell.org/package/bytestring) builders (see "Data.Csv.Builder")
+- Incremental decoding and encoding API (see "Data.Csv.Incremental")
+- Streaming API for constant-space decoding (see "Data.Csv.Streaming")
+.
+Moreover, this library is designed to be easy to use; for instance, here's a
+very simple example of encoding CSV data:
+.
+>>> Data.Csv.encode [("John",27),("Jane",28)]
+"John,27\r\nJane,28\r\n"
+.
+Please refer to the documentation in "Data.Csv" and the included [README](#readme) for more usage examples.
+
+}
 Homepage:            https://github.com/hvr/cassava
 License:             BSD3
 License-file:        LICENSE
@@ -15,15 +39,19 @@ Author:              Johan Tibell
 Maintainer:          [email protected]
 Category:            Text, Web, CSV
 Build-type:          Simple
-Cabal-version:       >=1.10
 Extra-source-files:  examples/*.hs,
-                     CHANGES.md
+                     CHANGES.md,
+                     README.md
 Tested-with:         GHC ==8.2.1, GHC ==8.0.2, GHC ==8.0.1, GHC ==7.10.3, GHC ==7.8.4, GHC ==7.6.3, GHC ==7.4.2
 
 ----------------------------------------------------------------------------
 
-flag pre-bytestring-0-10-4
-  description: bytestring < 0.10.4
+source-repository head
+  type:     git
+  location: https://github.com/hvr/cassava
+
+flag bytestring--LT-0_10_4
+  description: [bytestring](https://hackage.haskell.org/haskell/package) < 0.10.4
 
 Library
   default-language: Haskell2010
@@ -77,7 +105,7 @@ Library
     vector >= 0.8 && < 0.13,
     Only >= 0.1 && < 0.1.1
 
-  if flag(pre-bytestring-0-10-4)
+  if flag(bytestring--LT-0_10_4)
     build-depends: bytestring <  0.10.4
                  , bytestring-builder >= 0.10.8 && < 0.11
   else