[DOC] cmake build dir

[AndreiCherniaev]

[DOC] cmake build dir

[vapier]

i don't see much point to suggesting more complicated options. if people want to look at the full cmake option set, they're free to. the docs are meant to be a quick start.

[AndreiCherniaev]

i don't see much point to suggesting more complicated options. if people want to look at the full cmake option set, they're free to. the docs are meant to be a quick start.

I suggest quick start. In docs I see more hard way.

1. " sub directory of the top level". Dummy people create new directory and in this directory do your mkdir bld
2. people thinking that
   <options> ..
   is one thing. So if someone doesn't need any options, someone will try just
   cmake -DBUILD_TEST=1

I suggest more user-friendly way!

[vapier]

passing -S & -B options is more complicated than simply using ...

if you want to suggest wording improvements to the text for clarity, feel free. i imagine using ../ would make it clear it's a dir. or we invert the order and suggest cmake .. -DBUILD_TEST=1 <options>.

[AndreiCherniaev]

passing -S & -B options is more complicated than simply using ...

yes, passing -S & -B options is more complicated.

but your

$ mkdir bld
$ cd bld

Is very-very more complicated. Because user must well understand in which folder he working... Isn't it?