diff --git a/documentation/content/en/books/fdp-primer/doc-build/_index.adoc b/documentation/content/en/books/fdp-primer/doc-build/_index.adoc --- a/documentation/content/en/books/fdp-primer/doc-build/_index.adoc +++ b/documentation/content/en/books/fdp-primer/doc-build/_index.adoc @@ -51,6 +51,12 @@ ePub file format. |=== +[NOTE] +==== +On macOS and Linux, GNU Make doesn't work due to the syntax difference. +Users have to install bmake (Berkerly Make) manually. +==== + [[doc-build-rendering-html]] === Rendering to html @@ -123,6 +129,7 @@ These are the tools used to build and install the FDP documentation. * The primary build tool is man:make[1], specifically Berkeley Make. +** Therefore, bmake should be installed and used on macOS and Linux. * Python is used to generate the Table of Contents and other related Tables. * Hugo * AsciiDoctor diff --git a/documentation/content/en/books/fdp-primer/overview/_index.adoc b/documentation/content/en/books/fdp-primer/overview/_index.adoc --- a/documentation/content/en/books/fdp-primer/overview/_index.adoc +++ b/documentation/content/en/books/fdp-primer/overview/_index.adoc @@ -85,6 +85,8 @@ % make .... + +On macOS and Linux, install and use bmake because GNU Make doesn't work due to the differences of syntax. ++ . When changes are complete and tested, generate a "diff file": + [source,shell]