[CMake] CMake terminology

[Craig Scott]

In documentation, blog articles, etc. I just call it the "cmake" step (or
sometimes the "project setup" step if talking in a more project-wide
sense). For many users, the separate configure and generate steps are
somewhat of an implementation detail, so it makes more sense to give it a
single term. I'm not aware of any generally accepted term, but the ones I
use seem to be fairly easy to understand, especially for those new to
CMake. YMMV.

On Saturday, 25 June 2016, Ruslan Baratov via CMake <cmake at cmake.org> wrote:

> On 24-Jun-16 23:49, Robert Maynard wrote:
>
>> Please run the configure and generate steps by
>>
> It's too long :)
>
> Also it doesn't express the fact that it's a single action, consider:
>   "To add variables on configure and generate steps use '-D'"
>   "Before running configure and generate steps note that old variables
> from cache can be used"
>   etc.
>
>
>
>> On Fri, Jun 24, 2016 at 4:40 PM, Ruslan Baratov
>> <ruslan_baratov at yahoo.com> wrote:
>>
>>> On 24-Jun-16 23:25, Robert Maynard wrote:
>>>
>>>> cmake from the command line is still running the two stages, it just
>>>> doesn't allow for feedback/input from the user between the two stages.
>>>>
>>> Yes, I understand that. Question is about the name of the step. I.e.
>>> when I
>>> do write manual what should I choose
>>>    Please run configure step by: cmake -H. -B_builds
>>> or
>>>    Please run generate step by: cmake -H. -B_builds
>>> ?
>>>
>>> May be both versions are correct? Or both incorrect?
>>>
>>> Ruslo
>>>
>>>
>>> On Fri, Jun 24, 2016 at 4:06 PM, Ruslan Baratov via CMake
>>>> <cmake at cmake.org> wrote:
>>>>
>>>>> Hi,
>>>>>
>>>>> I have a question about CMake terminology. When we are using CMake GUI
>>>>> there
>>>>> are two buttons "Configure" and "Generate", hence we have two stages:
>>>>>
>>>>> 1. Configure step, when we do configuring project, effectively creating
>>>>> file
>>>>> with cache variables (which we can modify) without really generating
>>>>> native
>>>>> tools files like Makefile/*.sln/etc.
>>>>>
>>>>> 2. Generate step, when we do generating project using file with cache
>>>>> variables, i.e. create those Makefile/*.sln/etc.
>>>>>
>>>>> The question is about command line version of CMake. Since we do
>>>>> creating
>>>>> file with cache and generate native tools files in one step what is the
>>>>> right term? Is it a configure step because we read user's '-D' and
>>>>> create
>>>>> cache file?  Is it a generate step because native tools files generated
>>>>> at
>>>>> the end? May be there is a third name to describe the fact that it's
>>>>> configure+generate step?
>>>>>
>>>>> Thanks, Ruslo
>>>>> --
>>>>>
>>>>> Powered by www.kitware.com
>>>>>
>>>>> Please keep messages on-topic and check the CMake FAQ at:
>>>>> http://www.cmake.org/Wiki/CMake_FAQ
>>>>>
>>>>> Kitware offers various services to support the CMake community. For
>>>>> more
>>>>> information on each offering, please visit:
>>>>>
>>>>> CMake Support: http://cmake.org/cmake/help/support.html
>>>>> CMake Consulting: http://cmake.org/cmake/help/consulting.html
>>>>> CMake Training Courses: http://cmake.org/cmake/help/training.html
>>>>>
>>>>> Visit other Kitware open-source projects at
>>>>> http://www.kitware.com/opensource/opensource.html
>>>>>
>>>>> Follow this link to subscribe/unsubscribe:
>>>>> http://public.kitware.com/mailman/listinfo/cmake
>>>>>
>>>>
>>>
>>>
> --
>
> Powered by www.kitware.com
>
> Please keep messages on-topic and check the CMake FAQ at:
> http://www.cmake.org/Wiki/CMake_FAQ
>
> Kitware offers various services to support the CMake community. For more
> information on each offering, please visit:
>
> CMake Support: http://cmake.org/cmake/help/support.html
> CMake Consulting: http://cmake.org/cmake/help/consulting.html
> CMake Training Courses: http://cmake.org/cmake/help/training.html
>
> Visit other Kitware open-source projects at
> http://www.kitware.com/opensource/opensource.html
>
> Follow this link to subscribe/unsubscribe:
> http://public.kitware.com/mailman/listinfo/cmake
>


-- 
Craig Scott
Melbourne, Australia
http://crascit.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://public.kitware.com/pipermail/cmake/attachments/20160625/51db37d8/attachment.html>