Re: [cmake-developers] Make it easier for beginners

[Clément Gregoire]

Sorry, while I am motivated I had quite a busy month and let this thread
quietly slumber, which was not my intent.
I was hoping for a concrete answer to my questions but I suppose it
requires some sort of merge request (for the documentation/tutorials part),
as it would be more effective to get answers and feedback. I just didn't
want to have work being rejected just because "we don't put tutorials in
the documentation".
However I still think what I said for the wiki, if we can't put an
automated banner on CMake pages, then I guess I will have to edit those
myself.
@Bill sending you an email for the account.
If anybody has any resources or would like to help me for the tutorials,
please tell me. While I think I already have most of the resources and
knowledge for most of it, it never hurts.

Cheers,
- Lectem



2017-10-26 10:46 GMT+02:00 Nicholas Devenish :

> On Thu, Oct 26, 2017 at 12:49 AM, Wesley Smith 
> wrote:
>
>> I still don't understand the scoped syntax in Daniel Pfeifer's talk (e.g.
>> boost::boost)
>>
>
> Easy: It doesn't mean anything special, it's almost entirely just a name
> (think of :: as any other character).
>
> The advantage is,
> a) bookkeeping e.g. cleanly namespacing stuff (which admittedly could be
> done with _/prefixes)
> and more importantly
> b) If you give an undefined name e.g. "boost_notalib" (or something
> mis-spelled) to target_link_libraries it'll just add "-lboost_notalib" to
> the link command - because it doesn't know if it's a custom library that it
> doesn't know about,  or an undefined target. A name like "Boost::NotALib"
> can never be a library name, so if it's not a defined target you'll get an
> error at configuration time rather than build time.
>
> (Caveat: I am not an expert so could be completely wrong in incomplete or
> subtle ways, but this is definitely one way it makes a difference)
>
> Nick
>
> --
>
> 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-developers
>
-- 

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-developers

Re: [cmake-developers] Make it easier for beginners

[Nicholas Devenish]

On Thu, Oct 26, 2017 at 12:49 AM, Wesley Smith 
wrote:

> I still don't understand the scoped syntax in Daniel Pfeifer's talk (e.g.
> boost::boost)
>

Easy: It doesn't mean anything special, it's almost entirely just a name
(think of :: as any other character).

The advantage is,
a) bookkeeping e.g. cleanly namespacing stuff (which admittedly could be
done with _/prefixes)
and more importantly
b) If you give an undefined name e.g. "boost_notalib" (or something
mis-spelled) to target_link_libraries it'll just add "-lboost_notalib" to
the link command - because it doesn't know if it's a custom library that it
doesn't know about,  or an undefined target. A name like "Boost::NotALib"
can never be a library name, so if it's not a defined target you'll get an
error at configuration time rather than build time.

(Caveat: I am not an expert so could be completely wrong in incomplete or
subtle ways, but this is definitely one way it makes a difference)

Nick
-- 

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-developers

Re: [cmake-developers] Make it easier for beginners

[Wesley Smith]

I agree that if you do a search for how to setup a project with cmake, it's
hard to know what's best practice.  As cmake has evolved, the best practice
has changed and many old style techniques still return toward the top of
search results.  For me, the best resources have been:

http://preshing.com/20170522/learn-cmakes-scripting-language-in-15-minutes/
https://www.youtube.com/watch?v=bsXLMQ6WgIk

I still don't understand the scoped syntax in Daniel Pfeifer's talk (e.g.
boost::boost).  And CPack was really opaque to me until I bought the cmake
book.  I wish there were better tutorials on CPack and on how to write
cmake scripts that play well as dependencies on other projects using cmake.

wes


On Sun, Oct 22, 2017 at 12:08 PM, Bill Hoffman 
wrote:

> On 10/21/2017 10:56 AM, Lectem wrote:
>
>> _Question :_ Would it possible to delete the wiki, or reset/reopen it ?
>>
>> _Reason:_ The wiki is full of old stuff, but we can't register to edit
>> stuff. Still, people willing to learn will end up visiting it, thinking it
>> gives good advice. "How could it not ? It's the official wiki". At the very
>> least I wish we could add a big red message stating it is outdated and not
>> updated anymore.
>>
>> The wiki is still open.  If people want to edit they have to send an
> email and let us know what they want to do.  It was too hard to keep the
> spam off of it otherwise.  So, send me an email off list and I can get you
> setup with a wiki account.
>
> -Bill
> --
>
> 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/opensou
> rce/opensource.html
>
> Follow this link to subscribe/unsubscribe:
> http://public.kitware.com/mailman/listinfo/cmake-developers
>
-- 

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-developers

Re: [cmake-developers] Make it easier for beginners

[Bill Hoffman]

On 10/21/2017 10:56 AM, Lectem wrote:

_Question :_ Would it possible to delete the wiki, or reset/reopen it ?

_Reason:_ The wiki is full of old stuff, but we can't register to edit 
stuff. Still, people willing to learn will end up visiting it, thinking 
it gives good advice. "How could it not ? It's the official wiki". At 
the very least I wish we could add a big red message stating it is 
outdated and not updated anymore.


The wiki is still open.  If people want to edit they have to send an 
email and let us know what they want to do.  It was too hard to keep the 
spam off of it otherwise.  So, send me an email off list and I can get 
you setup with a wiki account.


-Bill
--

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-developers