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

On Sun, 14 Nov 2021 at 19:31, Rocky Hotas <rockyhotas@firemail.cc> wrote:
>
> Hello!
> Chapter 5 of the ``FreeBSD Documentation Project Primer for New
> Contributors'' shows how to build documentation:
>
>  <https://docs.freebsd.org/en/books/fdp-primer/doc-build/>
>
> 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.