From owner-freebsd-doc@freebsd.org Mon Jan 1 07:37:09 2018 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id D0D36EB58B4 for ; Mon, 1 Jan 2018 07:37:09 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mailman.ysv.freebsd.org (unknown [127.0.1.3]) by mx1.freebsd.org (Postfix) with ESMTP id ADD10320C for ; Mon, 1 Jan 2018 07:37:09 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: by mailman.ysv.freebsd.org (Postfix) id A9AF1EB58B3; Mon, 1 Jan 2018 07:37:09 +0000 (UTC) Delivered-To: doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id A9475EB58B2 for ; Mon, 1 Jan 2018 07:37:09 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-yw0-x235.google.com (mail-yw0-x235.google.com [IPv6:2607:f8b0:4002:c05::235]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 65FBA320B for ; Mon, 1 Jan 2018 07:37:09 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: by mail-yw0-x235.google.com with SMTP id z132so8402856ywd.9 for ; Sun, 31 Dec 2017 23:37:09 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=sUIIme5fPStqZODqoihv3AIB/c3072SFdxwSfHP03qs=; b=gc3w0TOIWMlHdoCMouejt+y6BxdvM1nYSzh8PjAA0jXDKOWsXzEzPnEgDm6QPaYmUE Ub26p/MjJpge1UUUBmzMSpB//szZfbB2Qg3GcJV2Q9ISuzUGnObRBwfknzSKkPI5fVDM Qbo4ZlqYIpQC7z5HuB8nPQroOgx9hK92T9lZQ= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=sUIIme5fPStqZODqoihv3AIB/c3072SFdxwSfHP03qs=; b=JvxjXarEgXBzYPZnRUtwN2PTR51VdXq3QKkdL3ZPPZS9+Pnl1t7HnVxYUzD7FUeWeM L2zfkHQl7oxPZvtBgEyN5yqX7IgVsUhkUqkPX7bFuhrLxexqTDEp1dwngxOYLWyHTrOv q3MMqxuXVyCmh8h3Q0KfHUEnYd7C/ZhQO33JBSP1UfxUWOIompkn+ZkkmMJTQxsUeda4 Ad0NSTJQiPUWp2fhbXyPROTd6OQymZYFWqigsTVBB6CG+UKRlDgw0oLBDpFvds195ayA 2i5cBpMUnJXS5PJPpTLAteZV/DaSoh2TiyLB8isqafvxm0N0DRDNBNSq9GrAXnFPq6Ir gnLA== X-Gm-Message-State: AKGB3mLHWjzwyY3ZoiyiP64lnnCfS5wHdCdLC9hlsXsN/EvGJnvxCtPq N0NvIWPNMVn/YPPwmS74gbEhMz3c0XHx5k7u3RmyGw== X-Google-Smtp-Source: ACJfBot0T8qrEkMPCieMBgvmLIuAogfgSzD44lldYS2Wlck3ILiWQhnwqsZO0JQ7yp0+sSZ1ShoVEtScTJ3gQJWiJsU= X-Received: by 10.129.235.2 with SMTP id n2mr29624751ywm.180.1514792228545; Sun, 31 Dec 2017 23:37:08 -0800 (PST) MIME-Version: 1.0 Received: by 10.37.217.21 with HTTP; Sun, 31 Dec 2017 23:36:38 -0800 (PST) In-Reply-To: References: From: Eitan Adler Date: Sun, 31 Dec 2017 23:36:38 -0800 Message-ID: Subject: Re: Books not building on fresh checkout To: Russell Haley Cc: "freebsd-doc@freebsd.org" Content-Type: text/plain; charset="UTF-8" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 01 Jan 2018 07:37:09 -0000 On 31 December 2017 at 19:31, Russell Haley wrote: > On Sun, Dec 31, 2017 at 12:00 AM, Eitan Adler wrote: >> On 30 December 2017 at 23:57, Russell Haley wrote: >>> On Sat, Dec 30, 2017 at 11:39 PM, Eitan Adler wrote: >>>> On 30 December 2017 at 23:36, Russell Haley 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