Re: [boost] Re: 1.32 documentation issue

----- Mensaje original ----- De: Beman Dawes <bdawes@acm.org> Fecha: Martes, Noviembre 2, 2004 9:06 pm Asunto: Re: [boost] Re: 1.32 documentation issue
At 12:39 PM 11/2/2004, Robert Ramey wrote:
Actually after poking around in other pages - specifically the spirit >documentation I find that its not uncommon for links to point to www.boost.org rather than have a relative path that would keep the session in the same documentation tree. This would seem to conflict with the idea that boost should be usable as a CDROM distribution.
I don't know if there's time for this but the inspect should be enhanced to check for this and all the offending global links should be altered to relative ones.
We tried to do that at one time, but gave up because it is a bit tricky. Some absolute www.boost.org references are correct, such as to the LICENSE file, so it isn't as simple as just searching for "www.boost.org/" in .htm? files.
I've just taken a look (using grep) at the CVS RC (not the tarball) and it seems that while the problem does happen, particularly in spirit and graph libraries, it isn't really horrible.
I'd say we can wait until after the release ships, then see if we can come up with some logic that doesn't generate a lot of false positives.
Automatic detection aside, would it be possible to fix the offending links manually before release? Maybe it's not that straightforward, if those links are generated from BoostBook source. Joaquín M López Muñoz Telefónica, Investigación y Desarrollo

On 11/2/04 4:26 PM, "JOAQUIN LOPEZ MU?Z" <joaquin@tid.es> wrote:
At 12:39 PM 11/2/2004, Robert Ramey wrote:
Actually after poking around in other pages - specifically the spirit documentation I find that its not uncommon for links to point to www.boost.org rather than have a relative path that would keep the session in the same documentation tree. This would seem to conflict with the idea that boost should be usable as a CDROM distribution. [SNIP] Automatic detection aside, would it be possible to fix the offending links manually before release? Maybe it's not that straightforward, if those links are generated from BoostBook source.
Has anyone done these corrections yet? -- Daryle Walker Mac, Internet, and Video Game Junkie darylew AT hotmail DOT com

Daryle Walker writes:
On 11/2/04 4:26 PM, "JOAQUIN LOPEZ MU?Z" <joaquin@tid.es> wrote:
At 12:39 PM 11/2/2004, Robert Ramey wrote:
Actually after poking around in other pages - specifically the spirit documentation I find that its not uncommon for links to point to www.boost.org rather than have a relative path that would keep the session in the same documentation tree. This would seem to conflict with the idea that boost should be usable as a CDROM distribution. [SNIP] Automatic detection aside, would it be possible to fix the offending links manually before release? Maybe it's not that straightforward, if those links are generated from BoostBook source.
Has anyone done these corrections yet?
What needed to be fixed, and to the extent it was possible to fix it, yes. See http://article.gmane.org/gmane.comp.lib.boost.devel/112691. -- Aleksey Gurtovoy MetaCommunications Engineering
participants (3)
-
Aleksey Gurtovoy
-
Daryle Walker
-
JOAQUIN LOPEZ MU?Z