Books not building on fresh checkout

[Eitan Adler]

On 31 December 2017 at 19:31, Russell Haley <russ.haley at gmail.com> wrote:
> On Sun, Dec 31, 2017 at 12:00 AM, Eitan Adler <lists at eitanadler.com> wrote:
>> On 30 December 2017 at 23:57, Russell Haley <russ.haley at gmail.com> wrote:
>>> On Sat, Dec 30, 2017 at 11:39 PM, Eitan Adler <lists at eitanadler.com> wrote:
>>>> On 30 December 2017 at 23:36, Russell Haley <russ.haley at gmail.com> wrote:
>>>>> Hi,
>>>>>
>>>>> I'm getting a build error on a fresh checkout. My base directory is
>>>>> ~/freebsd. This is the same error that stumped me some months back.
>>>>> Any advice would be grand. As follows:
>>>>>
>>>>> mkdir docs; svn co https://svn.freebsd.org/doc/head/ docs/
>>>>
>>>> do you have the 'docproj' package installed?
>>>
>>> No I did not (but will shortly). Thank you!
>>
>> I would also encourage you to read the documentation primer. Available
>> here: https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer
>>
>>
>>
>> --
>> Eitan Adler
>
> Hello, Section 7.7.1 discusses using General Entities to reference
> other chapters in the book. The section uses an example listing
> chapter1.xml, chapter2.xml and chapter3.xml. An introductory section
> explained that the books are now organized using a directory per
> chapter and the files are now simply called chapter.xml.
>
> Does the above dichotomy mean the section should use an example of
> chapter1/chapter.xml like below?

I think that specific section is supposed to be an example. Take a
look at en_US.ISO8859-1/books/handbook/book.xml and
books/handbook/chapters.ent for how to add a chapter.

What you intending to contribute? Are you trying to write specific new
content or generally want to learn how the system works. Both are
fine, but might have differing approaches for what to do next.

-- 
Eitan Adler