cleanups to user's guide
cleanups to user's guide

 * markup fixes
 * spelling
 * id's for some elements to avoid warnings
 * mention the use of Description field by setup haddock
 * clean up --hoogle description

thoughtpolice/cabal,triplepointfive/cabal,Peaker/cabal,kolmodin/cabal,trskop/cabal,typelead/epm,ghc-android/cabal,kosmikus/cabal,alphaHeavy/cabal,christiaanb/cabal,gridaphobe/cabal,edsko/cabal,fpco/cabal,enolan/cabal,martinvlk/cabal,ian-ross/cabal,typelead/epm,gbaz/cabal,lukexi/cabal,garetxe/cabal,kolmodin/cabal,plumlife/cabal,alphaHeavy/cabal,eric-stanley/cabal,mightybyte/cabal,plow-technologies/cabal,Heather/cabal,edsko/cabal,themoritz/cabal,lukexi/cabal,headprogrammingczar/cabal,Helkafen/cabal,garetxe/cabal,x-y-z/cabal,headprogrammingczar/cabal,mightybyte/cabal,themoritz/cabal,triplepointfive/cabal,sopvop/cabal,rimmington/cabal,anton-dessiatov/cabal,seereason/cabal,thoughtpolice/cabal,thomie/cabal,anton-dessiatov/cabal,ghc-android/cabal,eric-stanley/cabal,plumlife/cabal,fugyk/cabal,gbaz/cabal,bennofs/cabal,seereason/cabal,plow-technologies/cabal,valderman/cabal,Helkafen/cabal,sopvop/cabal,randen/cabal,mydaum/cabal,themoritz/cabal,trskop/cabal,valderman/cabal,bennofs/cabal,beni55/cabal,corngood/cabal,kosmikus/cabal,sopvop/cabal,mmakowski/cabal,thomie/cabal,fpco/cabal,ian-ross/cabal,randen/cabal,Heather/cabal,enolan/cabal,mmakowski/cabal,rimmington/cabal,christiaanb/cabal,martinvlk/cabal,mydaum/cabal,gridaphobe/cabal,x-y-z/cabal,corngood/cabal,Peaker/cabal,fugyk/cabal,beni55/cabal