Re: [Boost-docs] Quickbook document author Unicode a accent R&#xE5 isnot converted.

Subject: Re: [Boost-docs] Quickbook document author Unicode a accent R&#xE5 isnot converted.
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2010-09-03 08:11:31

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-
> bounces_at_[hidden]] On Behalf Of Daniel James
> Sent: Sunday, August 29, 2010 10:15 PM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] Quickbook document author Unicode a accent
> R&#xE5 isnot converted.
> 
> On 26 August 2010 12:06, Paul A. Bristow <pbristow_at_[hidden]> wrote:
> >
> > I have no strong views on this - apart from an opinion that docs that
> > are still using 1.3 are almost certainly in need of revision, and
> > while revision/update is being done, it isn't a big chore to ensure that
'meta'
> > info like this is up to date, and that the latest version is being used.
> > Maintenance is pretty poor if this doesn't happen.
> 
> After thinking about it, I've reverted it to 1.43 behaviour (i.e. not
encoding
> characters, just outputting them as is), so this is considered a bug in
1.44. There
> are some edge cases where the parser is different, but they're unlikely to
happen
> naturally.

If you are next working on Quickbook, you might help those who easily get
muddled by including the version of Quickbook used to generate the document
somewhere (perhaps on the "Last edited..." line.).  It would be useful to
have point versions too - 1.6.2 say.
Shall I post a Trac item for this and ISBN...?

The docs line
"quickbook 1.5 declares the version of quickbook the document is written
for. In its absence, version 1.1 is assumed." could usefully make even
clearer that this affects what features can/must be used, and link to the
helpful changelog page. 

And I note in passing that the copyright dates are way out of date, and the
authors list might be updated too ;-).

Thanks

Paul

PS I am now revising/extending the Boost.Math docs.  That should give it a
bit of an workout!