MantisBT - CMake
View Issue Details
IDProjectCategoryView StatusDate SubmittedLast Update
0015403CMakeCMakepublic2015-02-11 21:032015-07-08 08:57
ReporterLaurent Demailly 
Assigned ToBrad King 
PrioritynormalSeveritytextReproducibilityalways
StatusclosedResolutionfixed 
PlatformOSOS Version
Product VersionCMake 3.1.2 
Target VersionCMake 3.2Fixed in VersionCMake 3.2 
Summary0015403: configure_file documentation could be more useful by specifing exactly where the files are generated
Descriptionconfigure_file doc's (
http://www.cmake.org/cmake/help/v3.1/command/configure_file.html [^]
)

would be more useful if we changed
"If <output> is a relative path it is evaluated with respect to the current binary directory."

to one of

"If <output> is a relative path it is evaluated with respect to the current binary directory (CMAKE_CURRENT_BINARY_DIR)"

or

"If <output> is a relative path it is evaluated with respect to the current binary directory (PROJECT_BINARY_DIR)"

or whichever _BINARY_DIR is the correct one (which is also not super clear in the doc of those)

Adding an example of which
include_directories
to use to use said generated file (which is often a .h) would be great
(a bit like http://www.cmake.org/cmake-tutorial/ [^] )


Steps To Reproduce
Additional Information
TagsNo tags attached.
Relationships
Attached Files
Issue History
Date ModifiedUsernameFieldChange
2015-02-11 21:03Laurent DemaillyNew Issue
2015-02-12 16:21Brad KingNote Added: 0037963
2015-02-12 16:21Brad KingAssigned To => Brad King
2015-02-12 16:21Brad KingStatusnew => resolved
2015-02-12 16:21Brad KingResolutionopen => fixed
2015-02-12 16:21Brad KingFixed in Version => CMake 3.3
2015-02-12 16:21Brad KingTarget Version => CMake 3.3
2015-02-12 23:39Laurent DemaillyNote Added: 0037964
2015-02-20 10:58Brad KingNote Added: 0038008
2015-02-20 10:58Brad KingFixed in VersionCMake 3.3 => CMake 3.2
2015-02-20 10:58Brad KingTarget VersionCMake 3.3 => CMake 3.2
2015-07-08 08:57Robert MaynardNote Added: 0039056
2015-07-08 08:57Robert MaynardStatusresolved => closed

Notes
(0037963)
Brad King   
2015-02-12 16:21   
Thanks for pointing this out. Documentation revised:

 Help: Revise configure_file documentation
 http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=029d38fa [^]
(0037964)
Laurent Demailly   
2015-02-12 23:39   
awesome ! I think that diff will help new users a lot ! thank you
(0038008)
Brad King   
2015-02-20 10:58   
I've merged this back to the 'release' branch for the next 3.2 release candidate.
(0039056)
Robert Maynard   
2015-07-08 08:57   
Closing resolved issues that have not been updated in more than 4 months.