Re: [Boost-docs] 'Update to latest Boost version' option does not get to the right link

Subject: Re: [Boost-docs] 'Update to latest Boost version' option does not get to the right link
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2015-05-27 14:11:59

Very useful to know!

Done.

https://en.wikipedia.org/wiki/Unit_in_the_last_place#Language_support

Thanks

Paul

PS I have dbelatedly read

https://en.wikipedia.org/wiki/Help:Referencing_for_beginners

The entry now reads:

The [[Boost C++ Libraries]] offer <tt>boost::math::float_next</tt>,
<tt>boost::math::float_prior</tt>, <tt>boost::math::nextafter</tt> and
<tt>boost::math::float_advance</tt> functions to obtain nearby (and distant) floating-point values,
and <tt>boost::math::float_distance(a, b)</tt> to calculate the floating-point distance between two
doubles.

<ref name="Boost float_distance">{{cite book |
url=http://www.boost.org/doc/libs/release/libs/math/doc/html/math_toolkit/next_float/float_distance.
html | title=Boost float_distance}}</ref>

> -----Original Message-----
> From: Boost-docs [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of John Maddock
> Sent: 27 May 2015 13:36
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] 'Update to latest Boost version' option does not get to the right link
> 
> 
> Just replace the version number in the URL with "release" and you get a version agnostic URL, eg
>
http://www.boost.org/doc/libs/release/libs/math/doc/html/math_toolkit/next_float/float_distance.html
> 
> HTH, John.
> 
> On 27/05/2015 12:59, Paul A. Bristow wrote:
> > I've been ticked off by a Wikipedia editor for not providing he
> > approved citation  (links to Wikipedia itself are not regarded as
> > reliable - no self-referencing )  and I'm OK with that (one must reference www.boost.org rather
than
> Wikipedia article boost Libraries).
> >
> > But I'm not sure if/how to provide a link to the function in question
> > (in this case for example float_next).
> >
> > The user would like to just click on to the link float_next and get to the docs for that.
> >
> > Or we can let a Well-Known Search Engine help us out, say searching for "boost.org float_next"
> >
> > That works up to a point - it get to
> >
> >
> > http://www.boost.org/doc/libs/1_52_0/libs/math/doc/sf_and_dist/html/ma
> > th_toolkit/utils/next_float/fl
> > oat_next.html
> >
> > but that isn't the most recent version.
> >
> > There is a box acknowledging "This is an old version" and kindly
> > offering to get the most recent version (of the home page).
> >
> >
> > http://www.boost.org/doc/libs/1_58_0/libs/math/doc/html/math_toolkit/n
> > ext_float/float_distance.html
> >
> > but that just gets to http://www.boost.org/doc/libs/ which isn't
> > really what the hapless wants :-(
> >
> > Using the local search box does get you to the most recent, so that's just about OK, but not
ideal.
> >
> > However, I am left with the question of what to provide for the link to float_next for
Wikipedia.
> >
> > So far I have
> >
> >
> > https://en.wikipedia.org/wiki/Unit_in_the_last_place#Language_support
> >
> > (See ref 5)
> >
> > Of course, the float_next link above will soon be out of date when version 1.59 hits the
streets.
> > It would be nice to have a way of getting a link to the most recent
> > version.  GIT might provide a mechanism http://boostorg.github.io ?  but I am wary of that.
> >
> > Any suggestions on doing better?
> >
> > Paul
> >
> >
> > ---
> > Paul A. Bristow
> > Prizet Farmhouse
> > Kendal UK LA8 8AB
> > [phone]
> >
> >
> >
> > _______________________________________________
> > Boost-docs mailing list
> > Boost-docs_at_[hidden]
> > http://lists.boost.org/mailman/listinfo.cgi/boost-docs
> >
> 
> _______________________________________________
> Boost-docs mailing list
> Boost-docs_at_[hidden]
> http://lists.boost.org/mailman/listinfo.cgi/boost-docs