[cmake-developers] [CMake 0015403]: configure_file documentation could be more useful by specifing exactly where the files are generated

[Mantis Bug Tracker]

The following issue has been SUBMITTED. 
====================================================================== 
http://www.cmake.org/Bug/view.php?id=15403 
====================================================================== 
Reported By:                Laurent Demailly
Assigned To:                
====================================================================== 
Project:                    CMake
Issue ID:                   15403
Category:                   CMake
Reproducibility:            always
Severity:                   text
Priority:                   normal
Status:                     new
====================================================================== 
Date Submitted:             2015-02-11 18:03 PST
Last Modified:              2015-02-11 18:03 PST
====================================================================== 
Summary:                    configure_file documentation could be more useful by
specifing exactly where the files are generated
Description: 
configure_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/ )



====================================================================== 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2015-02-11 18:03 Laurent DemaillyNew Issue                                    
======================================================================