Improve installation instructions

[schuhschuh]

From email correspondence:

Dear Andreas,

I am attempting to install BASIS on top of Ubuntu 16.04.

I have difficulties, and would like to suggest to fix them in the install hints,
both on the web-site and the package help. (probably the description is outdated)

The BUILD_PROJECT_TOOL does not exist
The option 'g' in ccmake does not exist, and not understood by ccmake

I could, however, make the configuration and generation CMake's graphic surface.

After that,
make
was OK, but
make install
results in message 
-- Install configuration: "Release"
CMake error at cmake_install.cmake:36 (file):
 file cannot create directory: /opt/cmake-basis/doc. Maybe need
 administrative privileges.


The hellobasis should be HelloBasis

Regards

Janos

Hi Janos,

Thanks for letting me know. Indeed some instructions are outdated. There has been a pull
request already to remove the BUILD_PROJECT_TOOL option and update the quickstart page.

The 'g' option must still exist in the Curses based CMake GUI for the command line, 'ccmake'.
It is however only available when the configure step, 'c', was successful. Otherwise CMake
cannot generate the build tool specific configuration files.

The installation step must usually be run as root, i.e., when the CMAKE_INSTALL_PREFIX
was set to a directory outside your HOME directory. It must be run with 'sudo' on Ubuntu.

    sudo make install

I will see to improve the installation steps before the next release.

Thanks,
Andreas

Hi Andreas,

The 'g' option must still exist in the Curses based CMake GUI for the
command line, 'ccmake'. It is however only available when the configure
step, 'c', was successful. Otherwise CMake cannot generate the build tool
specific configuration files.

The instruction like 'keep pressing 'c'' at least warnts that I shall press
'c' not onece. How about writing something like
Press 'c' repeatedly until 'g' appears

Janos

[schuhschuh]

Hi Andreas,

as you told you are working on it, I say that

1./ After
"Install the libraries"
I think you should devote a few lines of building those simple things together,
something like

target_link_libraries(helloc++ foo bar)

and editing the source. With some practice, it can concluded, but you may loose
beginners at this point.

2./
I experience difficulties when using 'cp' instructions, saying that the owner 
cannot be changed. Maybe it is a feature of Ubuntu.

Janos