View Issue Details [ Jump to Notes ]

[ Print ]

Project

Category

View Status

Date Submitted

Last Update

0011166

CMake

public

2010-08-24 14:22

2016-06-10 14:31

Reporter

David Cole

Assigned To

Kitware Robot

Priority

normal

Severity

minor

Reproducibility

have not tried

Status

closed

Resolution

moved

Platform

OS Version

Product Version

CMake-2-8

Target Version

Fixed in Version

Summary

0011166: Please improve error messages and documentation related to "cmake --build"

Description

From a posting by David Abrahams on the ryppl-dev@googlegroups.com mailing list:

    1. The documentation I can find for --build is at best quite sparse.
    Since I was starting with someone else's code, it wasn't there because
    I knew I needed it and added it myself; it was already present.
    Trying to figure out what it did was difficult for me in part because
    of...

    2. The term "Project binary directory" used in those docs does not
    sound to me like it means what it is, so I misinterpreted what was
    supposed to come next. For me, the term "(configured) CMake build
    directory" would be better.

    3. cmake --help says:

    Usage

     cmake [options] <path-to-source>
     cmake [options] <path-to-existing-build>

    Options
     ...
     --build <dir> = Build a CMake-generated project binary tree.

    which doesn't make it at all clear that when you use --build <dir>
    there's no additional <path-to-xxx> required on the command line

    4. "Could not load cache" is a terrible alias for "I looked in the
    argument to --build (`.') and it doesn't appear to be a configured
    build directory"

And David Cole's response:

I agree.

On all 4 points.

I've filed a bug that will hopefully become an action item to make things better. :-)

Tags

No tags attached.

Attached Files

Relationships

Notes
(0041740) Kitware Robot (administrator) 2016-06-10 14:28	Resolving issue as `moved`. This issue tracker is no longer used. Further discussion of this issue may take place in the current CMake Issues page linked in the banner at the top of this page.

Issue History
Date Modified	Username	Field	Change
2010-08-24 14:22	David Cole	New Issue
2011-01-17 16:24	David Cole	Assigned To	=> David Cole
2011-01-17 16:24	David Cole	Status	new => assigned
2011-10-25 22:16	David Cole	Assigned To	David Cole =>
2011-10-25 22:16	David Cole	Status	assigned => backlog
2016-06-10 14:28	Kitware Robot	Note Added: 0041740
2016-06-10 14:28	Kitware Robot	Status	backlog => resolved
2016-06-10 14:28	Kitware Robot	Resolution	open => moved
2016-06-10 14:28	Kitware Robot	Assigned To	=> Kitware Robot
2016-06-10 14:31	Kitware Robot	Status	resolved => closed