Bug 269540
| Summary: | `make run` is invalid in top level of doc | ||||||
|---|---|---|---|---|---|---|---|
| Product: | Documentation | Reporter: | Andrey Portnoy <aportnoy> | ||||
| Component: | Books & Articles | Assignee: | Sergio Carlavilla Delgado <carlavilla> | ||||
| Status: | Closed FIXED | ||||||
| Severity: | Affects Many People | CC: | carlavilla, gbe | ||||
| Priority: | --- | ||||||
| Version: | Latest | ||||||
| Hardware: | Any | ||||||
| OS: | Any | ||||||
| Attachments: |
|
||||||
Context: documentation primer section 1.2.2 (https://docs.freebsd.org/en/books/fdp-primer/overview/#gnu-linux-installation-process) suggests running `bmake` from top of tree to build the docs, followed by `bmake run`. What it doesn't point out is you first need to change directory to say documentation or website before invoking `bmake run`. The patch adds a warning about this. A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/doc/commit/?id=02a9f38f18db8c0465214ac2bc3a1f5337786610 commit 02a9f38f18db8c0465214ac2bc3a1f5337786610 Author: Andrey Portnoy <aportnoy@fastmail.com> AuthorDate: 2023-02-17 15:30:44 +0000 Commit: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org> CommitDate: 2023-02-17 15:30:44 +0000 Warn users that 'make run' should be used on subdirectories PR: 269540 Makefile | 3 +++ 1 file changed, 3 insertions(+) Fixed. Thanks, I'll upgrade the FDP too |
Created attachment 240140 [details] Fix suggested by Ceri Davies.