From owner-dev-commits-doc-all@freebsd.org Fri Jan 29 03:15:32 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 8E1624FA343 for ; Fri, 29 Jan 2021 03:15:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4DRjC76rf3z3lQ8; Fri, 29 Jan 2021 03:15:31 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 9A2281B9BC; Fri, 29 Jan 2021 03:15:31 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 10T3FVuW015626; Fri, 29 Jan 2021 03:15:31 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 10T3FVm6015625; Fri, 29 Jan 2021 03:15:31 GMT (envelope-from git) Date: Fri, 29 Jan 2021 03:15:31 GMT Message-Id: <202101290315.10T3FVm6015625@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Kyle Evans Subject: git: 127d3f2965 - main - build: remove generate target, split run out MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: kevans X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 127d3f2965db2f4fad12bfabeeec9370f0972e92 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 29 Jan 2021 03:15:32 -0000 The branch main has been updated by kevans (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=127d3f2965db2f4fad12bfabeeec9370f0972e92 commit 127d3f2965db2f4fad12bfabeeec9370f0972e92 Author: Kyle Evans AuthorDate: 2021-01-28 04:22:48 +0000 Commit: Kyle Evans CommitDate: 2021-01-29 03:15:10 +0000 build: remove generate target, split run out This ensures that `make all` will never try to run the internal server. Instead, the user can run it manually if they need to. Reviewed-by: gjb, hrs Differential-Revision: https://reviews.freebsd.org/D28384 --- documentation/Makefile | 12 +++++++++--- website/Makefile | 12 +++++++++--- 2 files changed, 18 insertions(+), 6 deletions(-) diff --git a/documentation/Makefile b/documentation/Makefile index a09a995c11..c26485e6e1 100644 --- a/documentation/Makefile +++ b/documentation/Makefile @@ -6,7 +6,12 @@ # Targets intended for use on the command line # # all (default) - generate the books TOC and compile all the documentation -# generate - generate the books TOC and build all the documentation +# run - serves the built documentation site for local browsing +# +# The run target uses hugo's built-in webserver to make the documentation site +# available for local browsing. The documentation should have been built prior +# to attempting to use the `run` target. By default, hugo will start its +# webserver on port 1313. MAINTAINER=carlavilla@FreeBSD.org @@ -14,12 +19,13 @@ PYTHON_CMD = /usr/local/bin/python3.7 HUGO_CMD = /usr/local/bin/hugo LANGUAGES = en,es,pt-br,de,ja,zh-cn,zh-tw,ru,el,hu,it,mn,nl,pl,fr +.ORDER: all run + .ORDER: starting-message generate-books-toc .ORDER: starting-message build .ORDER: generate-books-toc build -all: starting-message generate-books-toc run -generate: starting-message generate-books-toc build .PHONY +all: starting-message generate-books-toc build starting-message: .PHONY @echo --------------------------------------------------------------- diff --git a/website/Makefile b/website/Makefile index 85b00f6df8..c6ea6d6cef 100644 --- a/website/Makefile +++ b/website/Makefile @@ -6,19 +6,25 @@ # Targets intended for use on the command line # # all (default) - generate the releases.toml and compile all the website -# generate - generate the releases.toml and build all the website +# run - serves the built website for local browsing +# +# The run target uses hugo's built-in webserver to make the built website +# available for local browsing. The website should have been built prior +# to attempting to use the `run` target. By default, hugo will start its +# webserver on port 1313. MAINTAINER=carlavilla@FreeBSD.org PYTHON_CMD = /usr/local/bin/python3.7 HUGO_CMD = /usr/local/bin/hugo +.ORDER: all run + .ORDER: starting-message generate-books-toc .ORDER: starting-message build .ORDER: generate-books-toc build -all: starting-message generate-releases run -generate: starting-message generate-releases build .PHONY +all: starting-message generate-releases build starting-message: .PHONY @echo ---------------------------------------------------------------