Difference between revisions of "User talk:Gjanssens"

From GnuCash
Jump to: navigation, search
(Initializing_Documentation_Build_Environment&curid=3983: new section)
 
Line 2: Line 2:
  
 
;-G: other generators possible?
 
;-G: other generators possible?
 +
:All generators supported by cmake are possible. I have chosen to set "Unix Makefiles" to limit the changes in following commands. They can all use "make <xyz>" then instead of "make <xyz> or ninja(-build) <xyz>". In fact we can probably omit the generator as "Unix Makefiles" is the default on linux.
 +
 
;builddir:subdir vs. out of tree?
 
;builddir:subdir vs. out of tree?
 +
:Personally I prefer to build out of tree. But the documentation was written with a hidden build dir instead. I have not changed that. A non-hidden build dir in-tree apparently causes issues for potfile generation (in code) and may have other side effects so that should be avoided.
 +
 
;WITH_CHM:Why is the only unavailable format on my system the only defaulting "ON"?
 
;WITH_CHM:Why is the only unavailable format on my system the only defaulting "ON"?
 +
:No it will be unavailable on linux. You're looking at the conditions for a Windows environment. On linux all but the CHM will be available (well, pedantically MOBI will be disabled by default as well). Note that chm doesn't work on linux at all, regardless of the build system. For Autotools it's simply not there. For CMake I tried to make it work using a compat library but that fails. I have not investigated further as it's really only a Windows format. Nothing other than Windows will ever use it.
 +
 
:;My current process:
 
:;My current process:
 
::#sudo make install;
 
::#sudo make install;

Revision as of 10:24, 29 April 2020

Initializing_Documentation_Build_Environment&curid=3983

-G
other generators possible?
All generators supported by cmake are possible. I have chosen to set "Unix Makefiles" to limit the changes in following commands. They can all use "make <xyz>" then instead of "make <xyz> or ninja(-build) <xyz>". In fact we can probably omit the generator as "Unix Makefiles" is the default on linux.
builddir
subdir vs. out of tree?
Personally I prefer to build out of tree. But the documentation was written with a hidden build dir instead. I have not changed that. A non-hidden build dir in-tree apparently causes issues for potfile generation (in code) and may have other side effects so that should be avoided.
WITH_CHM
Why is the only unavailable format on my system the only defaulting "ON"?
No it will be unavailable on linux. You're looking at the conditions for a Windows environment. On linux all but the CHM will be available (well, pedantically MOBI will be disabled by default as well). Note that chm doesn't work on linux at all, regardless of the build system. For Autotools it's simply not there. For CMake I tried to make it work using a compat library but that fails. I have not investigated further as it's really only a Windows format. Nothing other than Windows will ever use it.
My current process
  1. sudo make install;
  2. parallel:
    • make html
    • yelp
  3. firefox with HTML output
  4. Final phase: remaining formts on demand

--Fell (talk) 20:11, 28 April 2020 (UTC)