From owner-freebsd-doc@freebsd.org Thu Oct 12 04:20:52 2017 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 A732DE42E34 for ; Thu, 12 Oct 2017 04:20:52 +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 801B464CDA for ; Thu, 12 Oct 2017 04:20:52 +0000 (UTC) (envelope-from russ.haley@gmail.com) Received: by mailman.ysv.freebsd.org (Postfix) id 7F663E42E32; Thu, 12 Oct 2017 04:20:52 +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 7EDF5E42E31; Thu, 12 Oct 2017 04:20:52 +0000 (UTC) (envelope-from russ.haley@gmail.com) Received: from mail-lf0-x22e.google.com (mail-lf0-x22e.google.com [IPv6:2a00:1450:4010:c07::22e]) (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 EF2F664CD8; Thu, 12 Oct 2017 04:20:51 +0000 (UTC) (envelope-from russ.haley@gmail.com) Received: by mail-lf0-x22e.google.com with SMTP id k40so4531983lfi.4; Wed, 11 Oct 2017 21:20:51 -0700 (PDT) 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=vHDOMk0vmkvoADFmtLVIVNN72iTHidrLWBTOBEF0i/g=; b=ZjxbznNwnKsE7oiJ+ya6eVfJt9BK3IFNd4T4jRF0uqHHEiUtjcrzZw99A73eWLZ/XK qiNgZOce/1gg4q7Av0JoBHP7WM1U/DJLFGaXdjeeIDP6Y6cTYP38hRb/IVu4ozTs48R8 e+GnsXBSILvd/WJ7v2p8ePGgSX6v92unbFe08TZyfaa7UCuvXfP4NQZGYp6n3mQTrza+ OzQNaMBvDBGNl30m/CBHJRVkeC78JFi/liv+CfyKyvuc+mpy0m4SWf3Af/TvZxzRR34m msesPTPxoVFZrA1gGg6GV8V1aoeuSMVJXLqi0Pfgbw3iGXNVh/FRyL1sl5UJ3H1rzfNG xXug== 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=vHDOMk0vmkvoADFmtLVIVNN72iTHidrLWBTOBEF0i/g=; b=X7YBHLxh0+l1KJjpJ0UGgBGpmjpETknf74LVRnizdRo0DyIEwzv99RdNyr69UHw8fC iKAhvt0sy4VIZCm82u5SxDTSN+J7sCfYm/pbyQLoxdYX5CpY3bJI5UqW7ZBf0za3XDCI XNvmU1dF969fI1Aw64nqNWvrzP//ulc5VHC7tjNc9k6dzsT65Ym3f4CnHIi6D/A7OQNS i/UBNv1K57ZI2w0IX5MDeP/uIUhw4yRaIrzdrKtf1xw25mxPjIdD+5++wJ09H5A8/rf8 AJ4WNNBiVcJwDjrY/cgKLSvvAhumO1nKOV6gty5uPDXoFhNRhQERY3FwMCvUnsi0zFFz IQiA== X-Gm-Message-State: AMCzsaWGmXGT07InJsi7k5lWv18uNX2EaBevl2G58776kjnjyTXRtbLn or5XT/0ua9l07LO/HmGAhwdIO+whKoIRFBog2fAikQ== X-Google-Smtp-Source: ABhQp+SAZ3x8u+TnlrG1kF+I70CPz/5nmMRQl7B2hQijOtOEFmsDHBCUIlEhXaacuN2eSWRmbvD+LLYc0zoMHR4SaD0= X-Received: by 10.25.202.12 with SMTP id a12mr383538lfg.54.1507782048462; Wed, 11 Oct 2017 21:20:48 -0700 (PDT) MIME-Version: 1.0 Received: by 10.46.14.2 with HTTP; Wed, 11 Oct 2017 21:20:47 -0700 (PDT) In-Reply-To: <20171011225205.GC96685@kduck.kaduk.org> References: <7b2f2464-5c35-e24a-2047-838c1a9e96a3@FreeBSD.org> <20171009224825.GM96685@kduck.kaduk.org> <20171011223253.GB96685@kduck.kaduk.org> <59DE9DD4.7010707@gmail.com> <20171011225205.GC96685@kduck.kaduk.org> From: Russell Haley Date: Wed, 11 Oct 2017 21:20:47 -0700 Message-ID: Subject: Re: Porters Handbook section 4.4 To: doc@freebsd.org Cc: freebsd-ports@freebsd.org Content-Type: text/plain; charset="UTF-8" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 12 Oct 2017 04:20:52 -0000 Hi, This is a rough cut of three new chapters at the beginning of the book. I have left all the original content in place (I think). I haven't attempted to get all the markup but I seem to have worked through all my xml errors. Unfortunately I'm getting an error about a missing xsl file "http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl". I was able to manually download the file but I don't know where to put it yet. I'd like to get the new chapters to compile and at least take a stab at cleaning up the formatting before I put it on the review board. However, a patch file can be found here for now: https://github.com/RussellHaley/portershandbook . Build error: russellh@prescott:~/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook% make install /usr/home/russellh/FreeBSD/doc/share/xml/catalog-cwd.xml /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/catalog-cwd.xml echo '' >> /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/autogen.ent env XML_CATALOG_FILES="file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/catalog-cwd.xml file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/share/xml/catalog.xml file:///usr/home/russellh/FreeBSD/doc/share/xml/catalog.xml file:///usr/local/share/xml/catalog" /usr/local/bin/xmllint --nonet --noent --valid --dropdtd --xinclude /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/book.xml > book.parsed.xml.tmp /bin/mv book.parsed.xml.tmp book.parsed.xml /usr/bin/sed 's|@@URL_RELPREFIX@@|https://www.FreeBSD.org|g' < book.parsed.xml > book.parsed.print.xml /usr/bin/sed -i '' -e 's|@@URL_RELPREFIX@@|../../../..|g' book.parsed.xml cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/1.png imagelib/callouts/1.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/2.png imagelib/callouts/2.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/3.png imagelib/callouts/3.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/4.png imagelib/callouts/4.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/5.png imagelib/callouts/5.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/6.png imagelib/callouts/6.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/7.png imagelib/callouts/7.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/8.png imagelib/callouts/8.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/9.png imagelib/callouts/9.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/10.png imagelib/callouts/10.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/11.png imagelib/callouts/11.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/12.png imagelib/callouts/12.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/13.png imagelib/callouts/13.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/14.png imagelib/callouts/14.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/15.png imagelib/callouts/15.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/16.png imagelib/callouts/16.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/17.png imagelib/callouts/17.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/18.png imagelib/callouts/18.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/19.png imagelib/callouts/19.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/20.png imagelib/callouts/20.png cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/21.png imagelib/callouts/21.png /bin/rm -f docbook.css /bin/cat /usr/home/russellh/FreeBSD/doc/share/misc/docbook.css > docbook.css env XML_CATALOG_FILES="file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/catalog-cwd.xml file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/share/xml/catalog.xml file:///usr/home/russellh/FreeBSD/doc/share/xml/catalog.xml file:///usr/local/share/xml/catalog" /usr/local/bin/xsltproc --xinclude --nonet --maxvars 20000 --stringparam latestrevision.timestamp "2017-09-29 03:54:21" --stringparam latestrevision.committer "wosch" --stringparam latestrevision.number "50969" http://www.FreeBSD.org/XML/share/xml/freebsd-xhtml-chunk.xsl book.parsed.xml I/O error : Attempt to load network entity http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl" compilation error: file file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-xhtml-chunk.xsl line 13 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl *** Error code 5 Stop. make: stopped in /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook Cheers, Russ On Wed, Oct 11, 2017 at 3:52 PM, Benjamin Kaduk wrote: > On Wed, Oct 11, 2017 at 06:40:20PM -0400, Ernie Luzar wrote: >> >> Have nothing to add here, but this post peaked my interest about what >> your talking about. >> >> What is Phabricator? > > Phabricator is a project/software for doing code review of all sorts. > The FreeBSD documentation tree contains a lot of XML file, which can > be treated as code and subjected to pre-commit review as well. > >> What is its use in generating doc markup file for handbook changes? > > It doesn't help with converting non-marked-up text to XML form, it's > just a convenient place to post a draft patch and be able to make > line-by-line comments on it that are archived in a useful way. > > https://www.phacility.com/phabricator/ seems to be the upstream project's > home page. > > -Ben > _______________________________________________ > freebsd-doc@freebsd.org mailing list > https://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"