[En-Nut-Discussion] Building docs needs an insane amount of RAM

Philipp Burch phip at hb9etc.ch
Sat Feb 17 20:51:47 CET 2018

On 14.02.2018 16:47, Uwe Bonnes wrote:
>>>>>> "Philipp" == Philipp Burch <phip at hb9etc.ch> writes:
>     Philipp> Hi everyone, I just wanted to rebuild the Ethernut source
>     Philipp> documentation to check some functions. But even with the 8GiB
>     Philipp> RAM plus 12GiB of swap space, it still runs out of memory. I
>     Philipp> suppose this is due to the large amount of vendor headers,
>     Philipp> especially for the STM32. Is there an easy way to exclude
>     Philipp> certain folders from the documentation generation process?
>     Philipp> Maybe this should be done for all vendor headers in general, as
>     Philipp> these probably do not offer much useful documentation when used
>     Philipp> in conjunction with Nut/OS anyway (which should hide the
>     Philipp> hardware details).
> Philipp,
> nut/doc/gen/nut_en.cfg contains some "EXCLUDE" statements. Perhaps adding
> something like */arch/*/vendor/* or */vendor/* to "EXCLUDE_PATTERNS" will do
> the job.
> Bye

Hi Uwe,

thanks for the hint! That solved it and also brought down the whole
folder size down from several Gigabytes to approx. 500MiB by excluding
the graphs as well.


More information about the En-Nut-Discussion mailing list