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

Uwe Bonnes bon at elektron.ikp.physik.tu-darmstadt.de
Wed Feb 14 16:47:36 CET 2018

>>>>> "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).


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.

Uwe Bonnes                bon at elektron.ikp.physik.tu-darmstadt.de

Institut fuer Kernphysik  Schlossgartenstrasse 9  64289 Darmstadt
--------- Tel. 06151 1623569 ------- Fax. 06151 1623305 ---------

More information about the En-Nut-Discussion mailing list