Difference between revisions of "User talk:Gjanssens"

Revision as of 20:34, 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.

I added a note at the beginning of the page.

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.

Perhaps I had copied that from Translation.

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.

That is, what you published on the page.

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)

If the page is OK for you, you can remove this whole section.