[cmake-developers] [CMake 0015319]: Documentation clarification

[Mantis Bug Tracker]

The following issue has been SUBMITTED. 
====================================================================== 
http://public.kitware.com/Bug/view.php?id=15319 
====================================================================== 
Reported By:                Craig Hicks
Assigned To:                
====================================================================== 
Project:                    CMake
Issue ID:                   15319
Category:                   CMake
Reproducibility:            always
Severity:                   minor
Priority:                   normal
Status:                     new
====================================================================== 
Date Submitted:             2014-12-18 15:57 EST
Last Modified:              2014-12-18 15:57 EST
====================================================================== 
Summary:                    Documentation clarification
Description: 
The manual entry -G "MinGW Makefiles" on 
http://www.cmake.org/cmake/help/v2.8.12/cmake.html#gen%3aMinGWMakefiles
is ambiguous:

MinGW Makefiles: Generates a make file for use with mingw32-make.
The makefiles generated use cmd.exe as the shell. They do not require msys or a
unix shell.

Should be changed to :

MinGW Makefiles: Generates a make file for use with mingw32-make.
The makefiles generated use cmd.exe as the shell. They are not compatible msys
or a unix shell.  "cmake" should not be invoked from msys or unix shells when
"MinGW Makefiles" is specified as the generator.

Steps to Reproduce: 
Invoking (cmake -G "MinGW Makefiles" ...) from msys shell always fails in many
ways.

Additional Information: 
Obvious only once you know it.  The wording "does not require msys or a unix
shell" could be interpreted as implying that ", however they can be used".

As background, mingw32-make did not come with the minwg 64 bit gcc 4.8.2
downloaded from sourceforge.  It seemed correct that cmake would require "MinGW
Makefiles" for the mingw compiler.

However, cmake could not find a make program, but since I had make sitting
around under msys, I just specified that.

If the manual had been more explicit, it would have saved your novice user a lot
of time.  Trolling the web for advice, it seems there are many folks who have
encountered the same problem.


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

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2014-12-18 15:57 Craig Hicks    New Issue                                    
======================================================================