Re: Use make to only build new files in the documentation

From: Sergio Carlavilla <>
Date: Sun, 14 Nov 2021 18:46:50 UTC
On Sun, 14 Nov 2021 at 19:31, Rocky Hotas <> wrote:
> Hello!
> Chapter 5 of the ``FreeBSD Documentation Project Primer for New
> Contributors'' shows how to build documentation:
>  <>
> I tried several consecutive times to run `make' for the
> `documentation' (not the `website'), but each time it builds all
> the files, even if none of them has been modified. The same with
> `make build' (which populates `doc/documentation/public') and
> `make run'.
> My CPU is not that fast (it takes several minutes at each build). Is
> there a way to build only the modified files, and not all the files,
> each time?
> Thank you anyway,
> Rocky

Hi Rocky,

You have two options here.

First option is to build the documentation only with one language.
For example, to build only the english language use:

make run DOC_LANG="en"

In the second option you can go to the folder of the modified document and run:

asciidoctor _index.adoc

Let me know if this helps you.

PS: In my laptop, building all the documents in English took 1'5
minutes. I'm using a Thinkpad X200.