Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 14 Nov 2021 19:46:50 +0100
From:      Sergio Carlavilla <carlavilla@freebsd.org>
To:        Rocky Hotas <rockyhotas@firemail.cc>
Cc:        "freebsd-doc@FreeBSD.org" <freebsd-doc@freebsd.org>
Subject:   Re: Use make to only build new files in the documentation
Message-ID:  <CAFwocyNNPk3fCRLDrnSka8AxfQ--6ozqvwSD=ADaXKUvRJx-PQ@mail.gmail.com>
In-Reply-To: <20211114183114.g6zw5zcampk2zx2s@delpotro>
References:  <20211114183114.g6zw5zcampk2zx2s@delpotro>

next in thread | previous in thread | raw e-mail | index | archive | help
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.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAFwocyNNPk3fCRLDrnSka8AxfQ--6ozqvwSD=ADaXKUvRJx-PQ>