Problem 1280 - Build documentation is woefully incomplete
Summary: Build documentation is woefully incomplete
Status: CLOSED FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Application Developers Guide (show other problems)
Version: 9.5
Hardware: All All
: P1 enhancement
Assignee: Ben Morgan
URL:
Depends on:
Blocks:
 
Reported: 2012-01-22 18:18 CET by Tom Roberts
Modified: 2018-05-08 14:47 CEST (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this problem.
Description Tom Roberts 2012-01-22 18:18:09 CET
The new Cmake build system is great! But users now need more documentation to build their programs.

This is particularly true for visualization drivers. "geant4-config --libs" does not include the external libraries, so users have to guess what is needed. The old system handled this for users, but I had to just keep adding X11 libraries until the link succeeded. 

Even so, library ordering has thorns: the clue I needed to resolve a subtle failure in Open Inventor (non-widget child "dsm") was in a History file for a different viewer (!), and turned out to be an ordering issue between the Motif and X11 libraries (something I would never have guessed, since the link succeeded with the incorrect order I happened to generate).
Comment 1 Ben Morgan 2012-01-25 02:57:19 CET
Which platform/OS are you running on, and does your application use X11/Inventor etc (by which I mean your application has extra X11/Inventor code in addition to that in Geant4)? I only ask because I don't see this problem with shared libraries on Linux, building the basic examples at least. If you're doing a static build then this is related to Bugs #1203 and #1204.

The intention is to add output of the required libraries for static builds at least, as per Bug #1203, plus Makefile examples as per Bug #1204. If more than that is required, let us know.
Comment 2 Ben Morgan 2012-09-14 09:11:16 CEST
Marking as high priority for 9.6 release
Comment 3 Ben Morgan 2012-11-21 12:55:10 CET
I'm tentatively marking this as fixed - the documentation has been updated for 9.6 with more information, though your point of view may be different!

Looking back at the original report, this may be more an issue with geant4-config itself than documentation. If you continue to see issues, please submit a new bug on that.