Porters Handbook section 4.4

[Russell Haley]

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 at 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 '<!ENTITY base "..">' >>
/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 <bjk at freebsd.org> 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 at freebsd.org mailing list
> https://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe at freebsd.org"