Re: [cmake-developers] Please restore --help-full cmake option for version 3
On 2014-04-24 04:38-0700 Alan W. Irwin wrote: So in sum, please restore the --help-full CMake 2 functionality (or an approximation to it where you simply dump out all documentation classes to stdout) for CMake-3. I also just discovered that --help-man and --help-html were gone as well for those who preferred man or html formatting of the full documentation as opposed to the ascii form delivered by --help-full. The latter is the most important to me and is presumably the easiest to implement, but I am sure others prefer the man page or html formats instead so I hope CMake developers will deal with those cases as well. And to adapt the polite but extremely useful just my opinion phrase from David Cole that I just admired ( :-) ) This suggested restoration of --help-full and the rest is just an expression of my (strong) opinion that cmake 3 should continue to be as convenient to run and use as cmake 2. Alan __ Alan W. Irwin Astronomical research affiliation with Department of Physics and Astronomy, University of Victoria (astrowww.phys.uvic.ca). Programming affiliations with the FreeEOS equation-of-state implementation for stellar interiors (freeeos.sf.net); the Time Ephemerides project (timeephem.sf.net); PLplot scientific plotting software package (plplot.sf.net); the libLASi project (unifont.org/lasi); the Loads of Linux Links project (loll.sf.net); and the Linux Brochure Project (lbproject.sf.net). __ Linux-powered Science __ -- 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/cgi-bin/mailman/listinfo/cmake-developers
Re: [cmake-developers] Please restore --help-full cmake option for version 3
On 04/24/2014 02:17 PM, Alan W. Irwin wrote: I also just discovered that --help-man and --help-html were gone as well for those who preferred man or html formatting of the full documentation as opposed to the ascii form delivered by --help-full. The latter is the most important to me and is presumably the easiest to implement, but I am sure others prefer the man page or html formats instead so I hope CMake developers will deal with those cases as well. The documentation is now generated by Sphinx (http://sphinx-doc.org/) rather than CMake itself. The man and html documentation (also plain text but not single file and not installed) can be generated when building CMake itself. The current html version of CMake git master e.g. looks like this: http://www.cmake.org/cmake/help/git-master/ So even though the cmake binary can no longer generate the html and manpage documentation itself it is still available. Nils -- 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/cgi-bin/mailman/listinfo/cmake-developers
Re: [cmake-developers] Please restore --help-full cmake option for version 3
So even though the cmake binary can no longer generate the html and manpage documentation itself it is still available. To search the 3.0 rc4 help for find package, you can: http://www.cmake.org/cmake/help/v3.0/search.html?q=find+package And if you don't trust the web based search, you can install the pre-built binaries for CMake, and grep down in the doc/cmake-3.0/html directory of the installation. Just my opinion always makes people smile or cringe. There's rarely a non-reaction... Glad you admired it and smiled this morning... ;-) HTH, David C. -- 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/cgi-bin/mailman/listinfo/cmake-developers
Re: [cmake-developers] Please restore --help-full cmake option for version 3
On 2014-04-24 08:35, Nils Gladitz wrote: On 04/24/2014 02:17 PM, Alan W. Irwin wrote: I also just discovered that --help-man and --help-html were gone as well for those who preferred man or html formatting of the full documentation as opposed to the ascii form delivered by --help-full. The latter is the most important to me and is presumably the easiest to implement, but I am sure others prefer the man page or html formats instead so I hope CMake developers will deal with those cases as well. The documentation is now generated by Sphinx (http://sphinx-doc.org/) rather than CMake itself. The man and html documentation (also plain text but not single file and not installed) can be generated when building CMake itself. The current html version of CMake git master e.g. looks like this: http://www.cmake.org/cmake/help/git-master/ So even though the cmake binary can no longer generate the html and manpage documentation itself it is still available. Is there a reason CMake cannot know where to find these pages in order to display them on request? (--help-man doesn't seem necessary except to generate the man pages; if they're being generated by some other means, I'd think 'man cmake' is sufficient to display them.) -- Matthew -- 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/cgi-bin/mailman/listinfo/cmake-developers
Re: [cmake-developers] Please restore --help-full cmake option for version 3
On 24.04.2014 17:23, Matthew Woehlke wrote: Is there a reason CMake cannot know where to find these pages in order to display them on request? You mean have --help-man / --help-html output the distributed files? The new documentation (as distributed) is no longer single page so that would not map properly. (--help-man doesn't seem necessary except to generate the man pages; if they're being generated by some other means, I'd think 'man cmake' is sufficient to display them.) I think the same is true for the html documentation. The documented use case for both --help-man and --help-html is generating the documentation for the build rather than displaying it for the user. There may be undocumented valid use cases for regular users as well but I can't think of any. Nils -- 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/cgi-bin/mailman/listinfo/cmake-developers
[cmake-developers] [CMake 0014897]: Wrong reference of ZERO_CHECK.vcxproj if project is included with INCLUDE_EXTERNAL_MSPROJECT(...)
The following issue has been SUBMITTED. == http://www.cmake.org/Bug/view.php?id=14897 == Reported By:jwo Assigned To: == Project:CMake Issue ID: 14897 Category: CMake Reproducibility:always Severity: minor Priority: normal Status: new == Date Submitted: 2014-04-24 12:04 EDT Last Modified: 2014-04-24 12:04 EDT == Summary:Wrong reference of ZERO_CHECK.vcxproj if project is included with INCLUDE_EXTERNAL_MSPROJECT(...) Description: When including a project into another project with INCLUDE_EXTERNAL_MSPROJECT(...), the resulting solution cannot be built due to a reference to a non-existing project. Error-Message: The project file ' ' has been renamed or is no longer part of the solution This only happens if the two projects (the included and the including) have been configured via CMake. It does occur if using the generator for Visual Studio 2012, but not when generating for Visual Studio 2008. The reason for the problem is the following. Both project in the solution (the included and the including) refer to the project ZERO_CHECK (You can right-click the project, go to properties, then to Framework and References to see it). Unformtunately, the project IDs (called Identity in this view) ZERO_CHECK of differ between these two project. Project2 refers to the existing ZERO_CHECK, but Project1 refers to a non-existing. Steps to Reproduce: 1. Unzip the appended archive ReproduceBug.zip 2. call cmake_all_projects.bat to cmake the two projects 3. Open the second soultion (Sln2/project2.sln) 4. Build the solution -- Error: The project file ' ' has been renamed or is no longer part of the solution 5. Right-click project1 and project2, go to properties, then to Framework and References and find the different references to ZERO_CHECK. Additional Information: This bug is related but not a duplicate of bug 0014378 (http://www.cmake.org/Bug/view.php?id=0014378) Anyway, setting CMAKE_SUPPRESS_REGENERATION to TRUE suppresses the error by deactivating its cause. But for many users may not be a good workarround as the automatic regerneration of the projects is blocked. Due to several reasons it is not possible to include the two projects in the same CMakeLists.txt or configure them in one call of CMake. == Issue History Date ModifiedUsername FieldChange == 2014-04-24 12:04 jwoNew Issue 2014-04-24 12:04 jwoFile Added: ReproduceBug.zip == -- 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/cgi-bin/mailman/listinfo/cmake-developers
Re: [cmake-developers] Please restore --help-full cmake option for version 3
On 2014-04-24 08:56-0400 David Cole wrote: So even though the cmake binary can no longer generate the html and manpage documentation itself it is still available. To search the 3.0 rc4 help for find package, you can: http://www.cmake.org/cmake/help/v3.0/search.html?q=find+package That search (or typing both find and package in the search box) finds all instances of pages with both find and package (apparently), but you have to visit all those pages to see whether --find-package appears or not so I didn't bother since I was looking for a convenient method, and this search tool appears to not be that. So I tried using the search tool with various variants of --find (in quotes or not and with those -- characters escaped with \ and uniform results were produced in all cases, i.e., zero hits. So it appears the -- characters completely confuse this search engine and there is no apparent way to escape them. Not good! And if you don't trust the web based search (or if it gives an extremely inconvenient and sometimes unreliable result like above if -- characters are involved) you can install the pre-built binaries for CMake, and grep down in the doc/cmake-3.0/html directory of the installation. That (or doing the equivalent with the man pages) is certainly possible, but it is obviously not particularly convenient either. I now do get it that the new CMake 3 documentation software produces html and man pages that can be installed so there is really no reason to make those accessible from the cmake command line. So that leaves the ascii documentation case that _is_ currently made accessible from the command line for the various manuals. So my remaining question (without all the html and man distractions) boils down to a request to implement --help-full as the concatanation (following the same order as the present CMake 2 results) of those individual manual results. It appears that many of the CMake 3 manuals are equivalent to prior CMake 2 results. For example, wine@raven ~software/cmake/install-3.0.0-rc3/bin/cmake \ --help-manual cmake-commands |less or the exactly equivalent wine@raven ~software/cmake/install-3.0.0-rc3/bin/cmake \ --help-commands |less gives mostly equivalent results to ~software/cmake/install-2.8.12.2/bin/cmake \ --help-commands |less and so forth for commands, modules, policies, properties, and variables. Of course, there are additional manuals for cmake 3 beyond those five most important ones. But establishing the appropriate order of all the concatanated manuals (obviously prepending just one of the command-line command manuals such as cmake, ccmake, etc.) to give a largely equivalent result to the cmake version 2 --help-full results for each CMake-related command-line command should be quite doable. In sum, access to concatanated ascii documentation with --help-full for CMake-2 for each different cmake-related command-line command allows knowledgable users superb and quick access to all documentation on the command line with regex search tools like less without fumbling around with unreliable html searches (see above) or a slew of different man pages. So having --help-full implemented for CMake-3 command-line commands in a similar way would be equally useful. Alan __ Alan W. Irwin Astronomical research affiliation with Department of Physics and Astronomy, University of Victoria (astrowww.phys.uvic.ca). Programming affiliations with the FreeEOS equation-of-state implementation for stellar interiors (freeeos.sf.net); the Time Ephemerides project (timeephem.sf.net); PLplot scientific plotting software package (plplot.sf.net); the libLASi project (unifont.org/lasi); the Loads of Linux Links project (loll.sf.net); and the Linux Brochure Project (lbproject.sf.net). __ Linux-powered Science __ -- 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/cgi-bin/mailman/listinfo/cmake-developers
Re: [cmake-developers] Please restore --help-full cmake option for version 3
On 2014-04-24 14:42, Alan W. Irwin wrote: So my remaining question (without all the html and man distractions) boils down to a request to implement --help-full as the concatanation (following the same order as the present CMake 2 results) of those individual manual results. Come to think of it, it's pretty common to have a monolithic form of otherwise categorized documentation. Single web pages are (as noted) much easier to search, likewise for man pages and plain text. And of course if you want the documentation in PDF form... If there isn't currently a .rst file somewhere to concatenate all the various documentation together with appropriate headings and table of contents, this would probably be a good thing to add. (And then it could be leveraged for --help-full.) -- Matthew -- 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/cgi-bin/mailman/listinfo/cmake-developers
Re: [cmake-developers] Please restore --help-full cmake option for version 3
On 04/24/2014 03:01 PM, Matthew Woehlke wrote: If there isn't currently a .rst file somewhere to concatenate all the various documentation together with appropriate headings and table of contents, this would probably be a good thing to add. (And then it could be leveraged for --help-full.) Help/index.rst is exactly this. It's what generates the top-level help page for html. Our cmRST class we use to process .rst files for the --help options is capable of starting there and traversing the entire toctree. Also the Sphinx 'singlehtml' builder can be used to produce all documents in a single html file. I had a work-in-progress topic left from back when I did the documentation conversion to restore --help-full with index.rst and add the Sphinx singlehtml option, but forgot about it. I'm reviving it now. -Brad -- 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/cgi-bin/mailman/listinfo/cmake-developers
Re: [cmake-developers] Please restore --help-full cmake option for version 3
On 04/24/2014 03:15 PM, Brad King wrote: I had a work-in-progress topic left from back when I did the documentation conversion to restore --help-full with index.rst and add the Sphinx singlehtml option, but forgot about it. I'm reviving it now. Restore --help-full option to output all help manuals http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=64f05923 Utilities/Sphinx: Add option to build 'singlehtml' format http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=faf291a9 -Brad -- 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/cgi-bin/mailman/listinfo/cmake-developers
Re: [cmake-developers] cmake --find-package
On Wednesday, April 23, 2014 14:45:45 Alan W. Irwin wrote: On 2014-04-23 22:40+0200 Alexander Neundorf wrote: On Wednesday, April 23, 2014 13:21:39 Alan W. Irwin wrote: On 2014-04-23 13:21-0400 Bill Hoffman wrote: On 4/23/2014 12:22 PM, Alan W. Irwin wrote: However, if you discover the problem is a general one for --find-package and Qt5, then it appears that Qt5 might be a good illustrative example to use for your renewed effort at developing a reliable --find-package capability. I recently ran into a project using --find-package and found a limitation that could be very problematic. If a find module in CMake uses a try-compile, or tries to figure out anything to do with the compiler, this command will fail.I am not sure there is a good way around this. Certainly try-compile is not actively discouraged in the CMake Modules, so this can be added to any module at any time, breaking --find-package in the future. Hi Bill: You cannot use --find-package unless you specify the language. So I assume that --find-package enables the specified language, and, in general, you would think that try-compile would work properly under those circumstances. No. It doesn't really enable a language, it only loads a bunch of files to set the most urgently required variables. Most of it is implemented in CMakeFindPackageMode.cmake It is basically wrapping a find_package() call, setting up just enough to make it succeed usually. try_compile() will fail. My plan was to limit this mode to Config.cmake files only, but as I said, due to the changes in CMake this has become too much work, so I won't work on that in the forseeable future. Hi Alex: The question that remains is will --find-package be maintained indefinitely for CMake-3.x? I can't guarantee. Since modern Config.cmake files don't follow the old convention of setting a _LIBRARIES and a _INCLUDE_DIRS variable anymore, which is the basic assumption the --find-package feature was based on, I don't really feel motivated to fix this. As I said, --find-package is the only way I know how to obtain required compile and link flags for Qt5 at the present time (assuming the patch for the library name screwup is accepted for the CMake support files in Qt5, but that is a separate Qt5 issue compared to whether or not you decide to maintain --find-package for CMake-3.x). Until I discovered this thread, I had assumed that the --find-package option would be maintained indefinitely for CMake so I haven't looked further at other alternatives yet. Assuming you or someone else decides to remove the --find-package capability now or sometime during CMake-3.x (which from my point of view makes sense if you are not going to maintain it), I wouldn't object. This is actually the first time I get serious feedback for that feature, I had the impression nobody uses it or considers it useful. Alex -- 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/cgi-bin/mailman/listinfo/cmake-developers
