Opened 9 years ago

Closed 3 years ago

#2890 closed Bugs (invalid)

Boost.Build PDF docs broken

Reported by: Vladimir Prus Owned by: René Rivera
Milestone: Boost 1.39.0 Component: Documentation
Version: Boost 1.38.0 Severity: Problem
Keywords: Cc: daniel_james@…


Edward Diener has reported that the link to PDF documentation on does not work. This is relative link presently, and it works fine on 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 (0)

Change History (4)

comment:1 Changed 9 years ago by Daniel James

Cc: daniel_james@… added
Owner: changed from Daniel James to René Rivera

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 7 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 7 years ago by Daniel James

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.

comment:4 Changed 3 years ago by René Rivera

Resolution: invalid
Status: newclosed

Assuming this is now either not a problem any more, or a different problem now that we are in github.

Modify Ticket

Change Properties
Set your email in Preferences
as closed The owner will remain René Rivera.
The resolution will be deleted.

Add Comment

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

Note: See TracTickets for help on using tickets.