When I open the manuals index in Adobe Reader on Linux, the links to the manuals don't work. What's the problem?

This is due to a bug in Adobe Reader on Linux, which was apparently introduced when Unicode support was added to Adobe products a few years ago. The problem is that links between PDF documents either do not work at all, or work intermittently. Links within a document do work. The bug is confined to the Linux platform, and is not present on Windows or Mac platforms.

This bug affects the Suite 2012 Update 2 documentation, because the documentation is now generated with recent Adobe software, released since the changes described above. Links between PDF files generated with earlier versions of Adobe software work, which is why there were no problems with the PDF documentation prior to Suite 2012 Update 2.

There are several workarounds to this problem.

• Open the manuals in Adobe Reader on Windows or a Mac.
• Use a different PDF reader, such as KPDF or Evince. Both of these readers support links between PDF documents. If you use Evince, you should make sure you are using version 2.0 or later: many Linux distributions include a very old version of Evince (0.6), and this version does not work. Ubuntu includes a recent version of Evince in the distribution.
• Use the HTML documentation index ($SCHRODINGER/docs/Documentation_Index.html) with Adobe Reader. You will be able to open the manuals from this index, but not follow links between the manuals.
• Open the manuals directly from Adobe Reader. The manuals are stored in subdirectories of $SCHRODINGER/docs. Again, links to other manuals might not work.

If you use Maestro to open the PDF documentation index, you will notice that it opens KPDF by default when you choose Help → Manuals Index, or if you do not have KPDF, it tries Evince.

If you search the manuals from Maestro, Adobe Reader is used because the search index requires it. The search is not affected by the bug, and you can open PDF documents from the search results (but again, you cannot follow links to other documents reliably).

Related Articles:

#1735: Why does Maestro open the manuals index in KPDF rather than Adobe Reader?

Back to Search Results