[gmx-developers] cmake gromacs manual

[Mark Abraham]

On 13/05/2011 12:05 AM, Szilárd Páll wrote:
> Hi,
>
>> I am trying to make the Gromacs manual, but I don't understand a cmake
>> error.
>> What does "built out of source" mean? Which source?
>> And I don't know what to set LATEX_OUTPUT_PATH to.
> Out of source normally means that the directory from where you issue
> cmake and where the build tree is generated is different from your
> source tree, for instance:
> source tree: ~/gromacs-4.5
> build tree:   ~/gromacs-4.5-build

A subdirectory of the source tree is sufficiently "out of tree" for 
CMake, and this makes organization much simpler. Now all your build 
trees are inside the source tree and don't need to be named to reflect 
the source version.

> I've never built the manual with CMake, so I'm not completely sure
> that this is the final solution.

I ported the manual to CMake a month or so back, and I updated the 
manual README to describe the necessary steps. Hopefully I did a good 
enough job. With a proper out-of-source build (which is always 
encouraged/required for CMake) you do not need to set LATEX_OUTPUT_PATH.

Mark

>> CMake Error at UseLATEX.cmake:389 (MESSAGE):
>>    LaTeX files must be built out of source or you must set LATEX_OUTPUT_PATH.
>>   Call Stack (most recent call first):
>>    CMakeLists.txt:5 (LATEX_GET_OUTPUT_PATH)
>>
>>
>>
>>   CMake Error at UseLATEX.cmake:389 (MESSAGE):
>>    LaTeX files must be built out of source or you must set LATEX_OUTPUT_PATH.
>>   Call Stack (most recent call first):
>>    UseLATEX.cmake:792 (LATEX_GET_OUTPUT_PATH)
>>    CMakeLists.txt:85 (ADD_LATEX_DOCUMENT)
>>
>>
>> --
>> gmx-developers mailing list
>> gmx-developers at gromacs.org
>> http://lists.gromacs.org/mailman/listinfo/gmx-developers
>> Please don't post (un)subscribe requests to the list. Use the www interface
>> or send it to gmx-developers-request at gromacs.org.
>>