Problem 1280

Summary:	Build documentation is woefully incomplete
Product:	Documentation	Reporter:	Tom Roberts <tjrob>
Component:	Application Developers Guide	Assignee:	Ben Morgan <Ben.Morgan>
Status:	CLOSED FIXED
Severity:	enhancement
Priority:	P1
Version:	9.5
Hardware:	All
OS:	All

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.