Modify

Ticket #2890 (new Bugs)

Opened 5 years ago

Last modified 3 years ago

Boost.Build PDF docs broken

Reported by: vladimir_prus Owned by: grafik
Milestone: Boost 1.39.0 Component: Documentation
Version: Boost 1.38.0 Severity: Problem
Keywords: Cc: daniel_james@…

Description

Edward Diener has reported that the link to PDF documentation on http://www.boost.org/doc/libs/1_38_0/tools/build/v2/index.html does not work. This is relative link presently, and it works fine on  http://boost.org/boost-build2. I see two ways of fixing it in the complete Boost docs:

  • Copy userman.pdf into
  • Change the document to use absolute link to PDF file

I'd appreciate guidance as to which option is best. If first option is best, then naturally it should be done by somebody with access to the site.

Attachments

Change History

comment:1 Changed 5 years ago by danieljames

  • Cc daniel_james@… added
  • Owner changed from danieljames to grafik

I'm reassigning this to Rene as I'd like his feedback below and I can't see any way to cc him. I'm not expecting to fix this.

The link is broken in the main release as well (you can see it in the inspect report). Older versions of boost seem to be fine, so you might want to do whatever you used to do.

As you're already changing links in your release script, you could use an absolute link in the main boost release and then change to it a relative link for the build release.

At the moment, we can't copy userman.pdf to the location on the site (I assume that's what you meant) as the documentation is served from the release zip file. It's possible to change htaccess to check for files before running php to get the page. Rene, does that sound okay to you? It's not very nice to have special cases, but that seems to be the least problematic way to me.

Incidentally, you should have as much access to the site as I have. Everything I do is through subversion.

comment:2 Changed 3 years ago by anonymous

Is this still an issue? Apparently John has been able to build the PDF docs lately (from memory, I read something from the developers mailing list about his progress). Should we host the pdf files somewhere and just get the absolute link added to the documentation?

comment:3 Changed 3 years ago by danieljames

This is still an issue. You can see it in the latest version. This is something that needs to be fixed in boost build, as the broken link is present in the boost distribution.

Building the pdf docs is a different issue, it's still broken on the release branch due to moving the jam directory, but it's okay on trunk. I think it just needs [64189] to be merged.

View

Add a comment

Modify Ticket

Change Properties
<Author field>
Action
as new
Author


E-mail address and user name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.