From owner-freebsd-doc@freebsd.org Mon Jan 1 03:31:42 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 482F5EB54E9 for ; Mon, 1 Jan 2018 03:31:42 +0000 (UTC) (envelope-from russ.haley@gmail.com) Received: from mailman.ysv.freebsd.org (unknown [127.0.1.3]) by mx1.freebsd.org (Postfix) with ESMTP id 237D76FA5B for ; Mon, 1 Jan 2018 03:31:42 +0000 (UTC) (envelope-from russ.haley@gmail.com) Received: by mailman.ysv.freebsd.org (Postfix) id 22D58EB54E8; Mon, 1 Jan 2018 03:31:42 +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 227D2EB54E7 for ; Mon, 1 Jan 2018 03:31:42 +0000 (UTC) (envelope-from russ.haley@gmail.com) Received: from mail-lf0-x232.google.com (mail-lf0-x232.google.com [IPv6:2a00:1450:4010:c07::232]) (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 A98276FA58 for ; Mon, 1 Jan 2018 03:31:41 +0000 (UTC) (envelope-from russ.haley@gmail.com) Received: by mail-lf0-x232.google.com with SMTP id e27so18008420lfb.9 for ; Sun, 31 Dec 2017 19:31:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=3iO0WDknJJigo1ccHC3R3OYIIelVj0vu04K06At6Dd0=; b=VvMmjjX0pWMIP6OIQM8BlptuA+QjeubKEIMo2uNVDYNVgdqcBnh8MtlOAp0AGrnxoc Tl4PP+5s6pXO0efI4EJO7z0OkiZtaPllomw/VseTY2icdivPUahTrQpoQHA9pPHWVH+Y lzjD1SnGZeKy1TrJk4jV/03INcquSazYbaiDcXG9Lr1jfrDRmYLKtb3b0mVmXEAzJvQh bn7yCm3OXBlt+KTf0V26lku33HKpGNOqYiN7rfgmqVlYyy3gD+130NPWZConw54m8NZx OTyeSLULF3IXeq7KENoOrXUj7rRd/bP4dKPzi4mamhlIUzRwVIG12SORBvkbGMMywZwo f7iQ== 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=3iO0WDknJJigo1ccHC3R3OYIIelVj0vu04K06At6Dd0=; b=WWFx1kAK4+BvFQiyOkhBfGfFFhG4qP0y6HJ9BpaqoP/tmgLInduR5+pW6YdLj1A+c1 BCHsdJnGTJxWf0ZaDV4beZhJQeWCiMjC1w5sbhja066cfv9HwXc8ZX8HzcsyN7RhfA/g PWjgGAOpSEW4OFZsDk3ylL7lP5wC8uO6YO6AaR+vfzZH3gDcnrNIB3hRt+XN5RJfVXpL xWKL7MPzMueV6091rysbiUnMUsbWgk5vksAl6fMS2+Mzoe35Mr0nniY9NRTyt8Rh/h4W xoiF3As+h9+KfjY8ivydJJR10QGOfmAt254pzqQ1Aa6eUsuqzijSWiBZ6uIUhjCDlWog 8f/g== X-Gm-Message-State: AKGB3mIYQT1O4u388Qho64pPabVIcKnDP+Zi2hoT5+sdJnVs/Wj0UbW0 EKRjCEbMpM09JtZDEhSA+zRxl0raAcUUhNOypLEO6Q== X-Google-Smtp-Source: ACJfBovT6Z8CASy5b041iOB1x+05oNX7d2IdCtnS0TupczcCPwXemtJL5NVQ3V2cftF4T/JB6BeAcIXQ6CvE3OPYiws= X-Received: by 10.25.229.137 with SMTP id i9mr23802680lfk.42.1514777498375; Sun, 31 Dec 2017 19:31:38 -0800 (PST) MIME-Version: 1.0 Received: by 10.46.19.25 with HTTP; Sun, 31 Dec 2017 19:31:37 -0800 (PST) In-Reply-To: References: From: Russell Haley Date: Sun, 31 Dec 2017 19:31:37 -0800 Message-ID: Subject: Re: Books not building on fresh checkout To: Eitan Adler 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 03:31:42 -0000 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? ]> Thanks, Russ