[math][constants] mathematical constants page deserves to be more visible in the documentation
I believe the Boost.math toolkit mathematical constants are an extremely useful feature, yet it is extremely difficult to find. Every time I try to browse to it I try searching boost.org/libs, then try the math library page and cannot find the links at either of those locations. In fact, I'm not exactly sure how to browse to it and instead use saved bookmarks. I it would be worthwhile if there was some direct link or mention of it on boost.org/libs/math at minimum, and possibly even directly on boost.org/libs . Here is the mathematical constants page I am referring to: http://www.boost.org/doc/libs/release/libs/math/doc/sf_and_dist/html/math_to... Any thoughts on this idea? Cheers! Andrew Hundt
-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Andrew Hundt Sent: Thursday, May 02, 2013 4:11 PM To: boost@lists.boost.org Subject: [boost] [math][constants] mathematical constants page deserves to be more visible in the documentation
I believe the Boost.math toolkit mathematical constants are an extremely useful feature, yet it is extremely difficult to find. Every time I try to browse to it I try searching boost.org/libs, then try the math library page and cannot find the links at either of those locations. In fact, I'm not exactly sure how to browse to it and instead use saved bookmarks. I it would be worthwhile if there was some direct link or mention of it on boost.org/libs/math at minimum, and possibly even directly on boost.org/libs .
Here is the mathematical constants page I am referring to: http://www.boost.org/doc/libs/release/libs/math/doc/sf_and_dist/html/math_to...
Any thoughts on this idea?
OK - I've had trouble too ;-) Googling "boost math constants" gets you to an obsolete version of Boost with only a handful of constants, and the handy link to the latest version doesn't really help much getting there direct. using the boost.org site you get to the fearsome looking source code :-( http://www.boost.org/doc/libs/1_51_0/boost/math/constants/constants.hpp The third item gets you closer - to http://www.boost.org/doc/libs/1_50_0/libs/math/doc/sf_and_dist/html/math_too... .html but even that isn't latest version :-( I'll discuss with John Maddock how we can do better - I'm sure we can. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
I'll discuss with John Maddock how we can do better - I'm sure we can.
+1. I've spotted the issue too, but haven't got around to doing anything :-( In fact the "big index page" we have has considerably outgrown it's original self and is no longer terrible useful (too much on one page). Plus the "old" Math lib stuff (from before Paul and I got involved) should really be integrated into one seemless whole with the new stuff. So I guess we have some experimenting to do! Thanks for the nudge, John.
Googling "boost math constants" gets you to an obsolete version of Boost with only a handful of constants, and the handy link to the latest version doesn't really help much getting there direct.
I tried it and it takes me to the homepage of library, when it should take me to the constants page in the actual library. How can this be enforced? How about having an option at the top to select the same page in many of the different versions of Boost That way we can directly compare the changes too, version to version. -- View this message in context: http://boost.2283326.n4.nabble.com/math-constants-mathematical-constants-pag... Sent from the Boost - Dev mailing list archive at Nabble.com.
In message
I believe the Boost.math toolkit mathematical constants are an extremely useful feature, yet it is extremely difficult to find. Every time I try to browse to it I try searching boost.org/libs, then try the math library page and cannot find the links at either of those locations. In fact, I'm not exactly sure how to browse to it and instead use saved bookmarks. I it would be worthwhile if there was some direct link or mention of it on boost.org/libs/math at minimum, and possibly even directly on boost.org/libs .
Here is the mathematical constants page I am referring to: http://www.boost.org/doc/libs/release/libs/math/doc/sf_and_dist/html/mat h_toolkit/constants.html
Any thoughts on this idea?
Cheers! Andrew Hundt
+1 ISTM that the content is v. and quite frequently useful. And, of course, many thanks to the contributors here. On http://www.boost.org/doc/libs/1_53_0/libs/math/doc/sf_and_dist/html/math_ toolkit/constants/constants.html , the text of the Uses and Rationale entries for two_thirds_pi and four_thirds_pi, seem to be incorrect to me. No? Alec -- Alec Ross
-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Alec Ross Sent: Friday, May 03, 2013 8:17 AM To: boost@lists.boost.org Subject: Re: [boost] [math][constants] mathematical constants page deserves to be more visible in
the
documentation
In message
, Andrew Hundt writes I believe the Boost.math toolkit mathematical constants are an extremely useful feature, yet it is extremely difficult to find. Every time I try to browse to it I try searching boost.org/libs, then try the math library page and cannot find the links at either of those locations. In fact, I'm not exactly sure how to browse to it and instead use saved bookmarks. I it would be worthwhile if there was some direct link or mention of it on boost.org/libs/math at minimum, and possibly even directly on boost.org/libs .
Here is the mathematical constants page I am referring to: http://www.boost.org/doc/libs/release/libs/math/doc/sf_and_dist/html/ma t h_toolkit/constants.html
Any thoughts on this idea?
Cheers! Andrew Hundt
+1
ISTM that the content is v. and quite frequently useful. And, of course, many thanks to the contributors here.
On http://www.boost.org/doc/libs/1_53_0/libs/math/doc/sf_and_dist/html/math_ toolkit/constants/constants.html , the text of the Uses and Rationale entries for two_thirds_pi and four_thirds_pi, seem to be incorrect to me. No?
Copy and paste is wonderful - but all too easily abused :-( Mea culpa :-(( Will correct. Thanks Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Alec Ross Sent: Friday, May 03, 2013 8:17 AM To: boost@lists.boost.org Subject: Re: [boost] [math][constants] mathematical constants page deserves to be more visible in
the
documentation On http://www.boost.org/doc/libs/1_53_0/libs/math/doc/sf_and_dist/html/math_ toolkit/constants/constants.html , the text of the Uses and Rationale entries for two_thirds_pi and four_thirds_pi, seem to be incorrect to me. No?
Yes :-( constants.qbk Corrected in trunk. At revision: 84123 Will appear in 1.54 docs. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Alec Ross Sent: Friday, May 03, 2013 8:17 AM To: boost@lists.boost.org Subject: Re: [boost] [math][constants] mathematical constants page deserves to be more visible in the documentation
In message Andrew Hundt
writes I believe the Boost.math toolkit mathematical constants are an extremely useful feature, yet it is extremely difficult to find. Every time I try to browse to it I try searching boost.org/libs, then try the math library page and cannot find the links at either of those locations.
Thanks to these helpful comments, John Maddock has reorganized the structure of all the Math documentation. A reorganised version draft is at https://svn.boost.org/svn/boost/sandbox/math/libs/math/doc/html/index.html Table of Contents 1. Overview 2. Statistical Distributions and Functions 3. Special Functions 4. Floating Point Utilities 5. TR1 and C99 external "C" Functions 6. Mathematical Constants <<<<<<<<<<<<<<<<< Constants now get a Page One billing! 7. Complex Number Functions 8. Quaternions 9. Octonions 10. Integer Utilities (Greatest Common Divisor and Least Common Multiple) 11. Internals (Series, Rationals and Continued Fractions, Root Finding, Function Minimization, Testing and Development Tools) <<<<<<<<<<<<<<<<<<<<<< useful Root-Finding tools exposed to public view too 12. Use with User-Defined Floating-Point Types 13. Policies: Controlling Precision, Error Handling etc 14. Performance 15. Backgrounders 16. Library Status 17. Indexes Any feedback on this? (while we are crossing Is and dotting Ts ;-) Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
participants (5)
-
Alec Ross
-
Andrew Hundt
-
Anurag Kalia
-
John Maddock
-
Paul A. Bristow