From nobody Fri Jul 14 14:38:07 2023 X-Original-To: dev-commits-doc-all@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 4R2YxC58jSz4mf93 for ; Fri, 14 Jul 2023 14:38:07 +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 4R2YxC4kbbz3DWs; Fri, 14 Jul 2023 14:38:07 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1689345487; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=7N9Uqe3kr9qJLxEU3cfJAh6d37gcXJ6+L28Eb+WtFHw=; b=kRBdsjjqOzvG+WiAxptslS9poDjCLVQFHJ4hw+cd1nAJh1JX3aNcOHSJauFC3lmV8Zpw5P SvaTIFHc6UjrqXs9mUCFiv6LyrgKlh7PFlJoEB9IwJRF5FlLqgvh7KV2X1L3Wm6vHUsdQJ XjDPJ+n0G2TKPCooFau/rmlkan55o5ncNPkkBc66JDQEqSixMO25Mix+VD2uoH45MS0GlR Frwi0fKNnjfLSEXBjxV2cBXb2GrMIERymp2SwcZxypD8myWMv+CERq0HeOqmSb4J7/Qxb5 //4DXqPTVXG+phTGl1HU9Qt6uJct8VC0v5zumbTDD8ViQpUlA8B6SSIpJHIKkA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1689345487; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=7N9Uqe3kr9qJLxEU3cfJAh6d37gcXJ6+L28Eb+WtFHw=; b=WXFXo99amPXg8fRVjgSeywQNNE/X3lLWbFW97+fwRnzzU/rJ6yYcHgj3sECq1TIB/gYLwX 6+GEnEYusMPjn2ID6DRFIfTb2kpUuUstnIwl7HFIgxEazUx1EvnqtT9sPuj3Si6znCyG+j +DyRgtNKNRRHkjFChhx6S+VQvRWP9xB/4KpJUWb5hI7l+MKmCn84k5mIv7A3t4Hoa3IvwH +Sl1vM979Gqa0Uckc0YQKBTCz6fsAwchvq6pLNyXdqdOyAVVq8unUiw4MGunx8XIc5+Pmq /x8+v1m158gVLwgwlaXprU+THJNAyIeKB6TuY9Dco70NBiAzWOMQb1LyHwMTLw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1689345487; a=rsa-sha256; cv=none; b=c6hWDQ0mZTH0GMTHiVsQTzYfht+X7Yynobt5iMCCkaciXvc+GvbjOYDhh95SY4E2CuPvhk Y4fe7K+kW8dfeWZF8pJHfBz68xG46tpWOGNJk41PAwetKN0sCzB28m7mJXpuFugfqLjynA 2T8XNSFw/GHpHxymBtgc1dCQfFXzHX4jIDeqZjOQPrUb0415WAYxeEqTZlbMBHHHBuT0iF 5bZa54CaR4Ue6SRqeQ2jyckOOk5WZxp5TG3tD5Bbx/LnTNgPtwJsiqYL2mZAinHJhFxrFP KZatrGCtBmQBgeeIhn+ixdR86EdSMxT8TNxBJ6+NPULEzAClHKvxcPB5/HS/Jg== 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 4R2YxC3nv4zLsF; Fri, 14 Jul 2023 14:38:07 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 36EEc79e012255; Fri, 14 Jul 2023 14:38:07 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 36EEc7K7012254; Fri, 14 Jul 2023 14:38:07 GMT (envelope-from git) Date: Fri, 14 Jul 2023 14:38:07 GMT Message-Id: <202307141438.36EEc7K7012254@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: bf81c5046f - main - FDP: Upgrade MacOS build instructions List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bf81c5046f6d55d7985f28a5994b0a5488ad9587 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=bf81c5046f6d55d7985f28a5994b0a5488ad9587 commit bf81c5046f6d55d7985f28a5994b0a5488ad9587 Author: Minsoo Choo AuthorDate: 2023-07-14 14:36:01 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-07-14 14:36:01 +0000 FDP: Upgrade MacOS build instructions - Upgrade MacOS build instructions - Remove tip about use Hugo 0.90 or higher Differential Revision: https://reviews.freebsd.org/D41036 --- documentation/Makefile | 2 +- .../content/en/books/fdp-primer/overview/_index.adoc | 13 ++++++++----- 2 files changed, 9 insertions(+), 6 deletions(-) diff --git a/documentation/Makefile b/documentation/Makefile index 825c235269..1ed2666850 100644 --- a/documentation/Makefile +++ b/documentation/Makefile @@ -41,7 +41,7 @@ GEMBASE?= ${GEM_PATH} GEMBASE?= ${LOCALBASE} .endif -RUBY_CMD = ${GEMBASE}/bin/ruby +RUBY_CMD ?= ${LOCALBASE}/bin/ruby HUGO_CMD = ${LOCALBASE}/bin/hugo HUGO_ARGS?= --minify HUGO_OFFLINE_ARGS?= --environment offline --verbose --minify diff --git a/documentation/content/en/books/fdp-primer/overview/_index.adoc b/documentation/content/en/books/fdp-primer/overview/_index.adoc index d0f8f19972..b17d7ba66a 100644 --- a/documentation/content/en/books/fdp-primer/overview/_index.adoc +++ b/documentation/content/en/books/fdp-primer/overview/_index.adoc @@ -253,10 +253,6 @@ Finally, use the btn:[Submit Bug] button to submit your diff to the problem repo [.procedure] ==== -[TIP] -====== -Hugo version 0.90 or higher must be used -====== . Install these packages using link:https://brew.sh/[Homebrew] and link:https://rubygems.org/[RubyGem]. + @@ -274,6 +270,13 @@ $ echo 'export PATH="$(brew --prefix ruby)/bin:$PATH"' >> ~/.zshrc $ source ~/.zshrc .... + +. Add git alias to Homebrew git since `git format-patch` from Apple-provided git won't work with Phabricator. ++ +[source,shell] +.... +$ echo 'alias git=/usr/local/bin/git' >> ~/.zshrc +$ source ~/.zshrc +.... . Install the rouge package using RubyGem. + [source,shell] @@ -297,7 +300,7 @@ Repeat until all of the errors are resolved. + [source,shell] .... -$ bmake run LOCALBASE=/opt/homebrew USE_RUBYGEMS=YES +$ bmake run USE_RUBYGEMS=YES RUBY_CMD=$(brew --prefix ruby)/bin/ruby .... . Add all the files with `git add .`, then review the diff with `git diff`. For example: +