Re: [Boost-docs] Doc build stylesheet version?

Subject: Re: [Boost-docs] Doc build stylesheet version?
From: Daniel James (dnljms_at_[hidden])
Date: 2010-01-21 18:51:08

2010/1/21 Beman Dawes <bdawes_at_[hidden]>:
>
> Notice the freshly generated file says "DocBook XSL Stylesheets
> V1.69.1" while the trunk version says "DocBook XSL Stylesheets
> V1.74.0". There are a lot of diffs in the document relating to HTML
> markup.
>
> Is this a problem?

Probably not. I think the newer stylesheets mostly just generate
slightly better HTML.

> Is http://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted#Cygwin
> out of date? It says to use docbook-xml42. Or have I done something
> wrong?

No, not at all. It looks cygwin haven't updated their docbook-xsl
package for years.

> Also, I'm getting warnings that [br] tags I added are deprecated. What
> should I replace them with?

I think the idea was that you should be using paragraphs. But the best
thing might be to undeprecate line breaks as no one pays the slightest
attention to the warnings so they're mostly just noise.

Daniel