Re: [boost] [lexical-cast] Help with documentation required

Subject: Re: [boost] [lexical-cast] Help with documentation required
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-07-20 09:37:21

> -----Original Message-----
> From: boost-bounces_at_[hidden] [mailto:boost-bounces_at_[hidden]] On Behalf Of Antony
> Polukhin
> Sent: Wednesday, July 20, 2011 1:05 PM
> To: boost_at_[hidden]
> Subject: [boost] [lexical-cast] Help with documentation required
> 
> I've added Qickbook documentation for lexical_cast to libs/conversion/doc/lexical_cast.qbk and a
> Jamfile.v2 file to build it. Meanwhile, there is an old HTML documentation for lexical_cast in
> libs/conversion/lexical_cast.htm and file libs/conversion/index.html references it.
> 
> The question is: How shall I update the lexical_cast.htm/index.html, doc/html/ folder?

I've built you improved docs OK 

Much more Boost look'n'feel :-)

(though I note that the link in synopsis

Library features defined in boost/lexical_cast.hpp:

is broken  (boost in wrong place).

Would the 'best' performance be shown using bold (or italic or underline)?

[table:my_table  Performance
  [[processor] [version 1] [version 2]]
  [[Intel]  [[_1.1]] [[*2.3]]] 
  [[AMD]  [[*2.2]] [['2.3]]] 
] [/table:my_table  Performance]

shows these font variants in action.

(Color would be even nicer ;-)  - how about it Joel and Eric and Daniel? )

I note it doesn't use Doxygen, nor produce pdf version, but that may be overkill.  I might be
willing to help sort this out, but not just now.

I suggest that you can leave it just where it is  (the right place according to Boost conventions),
but the main link to index.html in Boost docs, should point here rather than previous

boost-trunk/libs/conversion/lexical_cast.htm

HTH

Paul

PS Should this better be sent to boost-docs list (and copied to there)?

---
Paul A. Bristow,
Prizet Farmhouse, Kendal LA8 8AB  UK
[phone]  07714330204
pbristow_at_[hidden]