From nobody Sun Nov 14 18:46:50 2021
X-Original-To: freebsd-doc@mlmmj.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
	by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id C80F01832C3A
	for <freebsd-doc@mlmmj.nyi.freebsd.org>; Sun, 14 Nov 2021 18:47:02 +0000 (UTC)
	(envelope-from carlavilla@freebsd.org)
Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256
	 client-signature RSA-PSS (4096 bits) client-digest SHA256)
	(Client CN "smtp.freebsd.org", Issuer "R3" (verified OK))
	by mx1.freebsd.org (Postfix) with ESMTPS id 4HshBZ4FK8z4fgj
	for <freebsd-doc@freebsd.org>; Sun, 14 Nov 2021 18:47:02 +0000 (UTC)
	(envelope-from carlavilla@freebsd.org)
Received: from mail-ua1-f47.google.com (mail-ua1-f47.google.com [209.85.222.47])
	(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
	(Client CN "smtp.gmail.com", Issuer "GTS CA 1D4" (verified OK))
	(Authenticated sender: carlavilla)
	by smtp.freebsd.org (Postfix) with ESMTPSA id 6C1DEB80C
	for <freebsd-doc@freebsd.org>; Sun, 14 Nov 2021 18:47:02 +0000 (UTC)
	(envelope-from carlavilla@freebsd.org)
Received: by mail-ua1-f47.google.com with SMTP id r15so2960081uao.3
        for <freebsd-doc@freebsd.org>; Sun, 14 Nov 2021 10:47:02 -0800 (PST)
X-Gm-Message-State: AOAM531ri5QEUq08oVAk87pRwqMxyTXeNZ3lDYzrz3gip8tTl985fzte
	7YBaFPahz7LL5z/oD9GNt8aiIHBjMxI0RvmpkwE=
X-Google-Smtp-Source: ABdhPJw6lB22AtdVSYFSY/V80T6BuuFqbIei3zGQ4PMCbyCfLp9EUB123HSrWEyMof0YBVNYDOpQE9dpeThbsLjJ/R8=
X-Received: by 2002:a05:6102:4192:: with SMTP id cd18mr35157037vsb.35.1636915621885;
 Sun, 14 Nov 2021 10:47:01 -0800 (PST)
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Archive: https://lists.freebsd.org/archives/freebsd-doc
List-Help: <mailto:freebsd-doc+help@freebsd.org>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Subscribe: <mailto:freebsd-doc+subscribe@freebsd.org>
List-Unsubscribe: <mailto:freebsd-doc+unsubscribe@freebsd.org>
Sender: owner-freebsd-doc@freebsd.org
MIME-Version: 1.0
References: <20211114183114.g6zw5zcampk2zx2s@delpotro>
In-Reply-To: <20211114183114.g6zw5zcampk2zx2s@delpotro>
From: Sergio Carlavilla <carlavilla@freebsd.org>
Date: Sun, 14 Nov 2021 19:46:50 +0100
X-Gmail-Original-Message-ID: <CAFwocyNNPk3fCRLDrnSka8AxfQ--6ozqvwSD=ADaXKUvRJx-PQ@mail.gmail.com>
Message-ID: <CAFwocyNNPk3fCRLDrnSka8AxfQ--6ozqvwSD=ADaXKUvRJx-PQ@mail.gmail.com>
Subject: Re: Use make to only build new files in the documentation
To: Rocky Hotas <rockyhotas@firemail.cc>
Cc: "freebsd-doc@FreeBSD.org" <freebsd-doc@freebsd.org>
Content-Type: text/plain; charset="UTF-8"
X-ThisMailContainsUnwantedMimeParts: N

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.