[Boost-bugs] [Boost C++ Libraries] #6358: Documentation

Subject: [Boost-bugs] [Boost C++ Libraries] #6358: Documentation
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2012-01-04 20:40:28

#6358: Documentation
------------------------------+---------------------------------------------
 Reporter:  ramey             |       Owner:  fcacciola
     Type:  Bugs              |      Status:  new      
Milestone:  To Be Determined  |   Component:  numeric  
  Version:  Boost 1.48.0      |    Severity:  Problem  
 Keywords:                    |  
------------------------------+---------------------------------------------
 I want to use boost numeric conversion.

 I NEED to use boost numeric conversion.

 But I can't really figure out how to use it.

 a) the interface with policies which contain function options which
 contain...
 is just too hard to follow.  I  think this is a design problem.

 b) the documentation of all this isn't complete - and it reflects the
 interface.  trying to figure it out is like pulling teeth.

 It "looks like" it depends upon numeric_limits for minimums, maximums,
 etc.  I would hope this means that if I create my own numeric type and
 specialize numeric_limits for it, the convert<...> will "just work" and
 I'll get an overflow/under flow exception when I need it.  But trying to
 verify that this works like this by looking at the documentation is like
 pulling teeth.  I believe the library works and/or can be made to work for
 what I want to do, but the documentation is presenting a real obstacle so
 I have to look at the code itself - which I shouldn't have to do.

 Robert Ramey

-- 
Ticket URL: <https://svn.boost.org/trac/boost/ticket/6358>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.