<commit_before><?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<book>
  <bookinfo>
    <title>farbot: FreeBSD Automated Release 'Bot</title>

    <legalnotice>
      <para>The content of this guide is the original work of Three Rings
      Design, Inc. All rights reserved.</para>

      <para>The XML and CSS used to generate this guide is based on the work
      of <NAME> and <NAME>, as contributed to the DarwinPorts
      Project under the 3 clause BSD license. Their copyright remains.</para>
    </legalnotice>

    <copyright>
      <year>2006</year>

      <holder>Three Rings Design, Inc.</holder>
    </copyright>

    <copyright>
      <year>2002</year>

      <year>2003</year>

      <year>2004</year>

      <holder>The OpenDarwin Project</holder>
    </copyright>
  </bookinfo>

  <preface>
    <title>About farbot</title>

    <para>farbot was written by <NAME> and <NAME> for
    the purpose of automating the process of building FreeBSD Jumpstart
    [netboot] install releases. It handles the building of the releases,
    builds any packages you wish to install, configures the bootloader, and
    constructs the NFS exported directory structure needed for a netinstall,
    all from a simple configuration file. We encourage you to submit any patch
    you think would be useful. You may also join the <ulink
    url="https://dpw.threerings.net/mailman/listinfo/farbot">farbot mailing
    list</ulink>.</para>
  </preface>

  <chapter>
    <title>Installing and Using farbot</title>

    <sect1>
      <title>Installation</title>

      <sect2>
        <title>Prerequisites</title>

        <para>farbot depends on the following components:</para>

        <itemizedlist>
          <listitem>
            <para><ulink url="http://www.python.org/">Python
            2.4</ulink></para>
          </listitem>

          <listitem>
            <para><ulink url="http://twistedmatrix.com">Twisted Networking
            Framework</ulink></para>
          </listitem>

          <listitem>
            <para><ulink url="http://www.zope.org/Members/fdrake/zconfig/">
            Zconfig</ulink></para>
          </listitem>

          <listitem>
            <para><ulink url="http://www.freebsd.org">FreeBSD</ulink> is
            required to actually build installations. This build system must
            have full sources installed in <filename>/usr/src</filename>, and
            a completed buildworld must have been run prior to building
            installations with farbot.</para>
          </listitem>
        </itemizedlist>
      </sect2>

      <sect2><commit_msg>Some subtle but important information I happened to catch while reading release(7). Note to self: probably should update this when binary releases work, because you won't need to have anything in /usr/src or /usr/obj if you're not building any releases.<commit_after><?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<book>
  <bookinfo>
    <title>farbot: FreeBSD Automated Release 'Bot</title>

    <legalnotice>
      <para>The content of this guide is the original work of Three Rings
      Design, Inc. All rights reserved.</para>

      <para>The XML and CSS used to generate this guide is based on the work
      of <NAME> and <NAME>, as contributed to the DarwinPorts
      Project under the 3 clause BSD license. Their copyright remains.</para>
    </legalnotice>

    <copyright>
      <year>2006</year>

      <holder>Three Rings Design, Inc.</holder>
    </copyright>

    <copyright>
      <year>2002</year>

      <year>2003</year>

      <year>2004</year>

      <holder>The OpenDarwin Project</holder>
    </copyright>
  </bookinfo>

  <preface>
    <title>About farbot</title>

    <para>farbot was written by <NAME> and <NAME> for
    the purpose of automating the process of building FreeBSD Jumpstart
    [netboot] install releases. It handles the building of the releases,
    builds any packages you wish to install, configures the bootloader, and
    constructs the NFS exported directory structure needed for a netinstall,
    all from a simple configuration file. We encourage you to submit any patch
    you think would be useful. You may also join the <ulink
    url="https://dpw.threerings.net/mailman/listinfo/farbot">farbot mailing
    list</ulink>.</para>
  </preface>

  <chapter>
    <title>Installing and Using farbot</title>

    <sect1>
      <title>Installation</title>

      <sect2>
        <title>Prerequisites</title>

        <para>farbot depends on the following components:</para>

        <itemizedlist>
          <listitem>
            <para><ulink url="http://www.python.org/">Python
            2.4</ulink></para>
          </listitem>

          <listitem>
            <para><ulink url="http://twistedmatrix.com">Twisted Networking
            Framework</ulink></para>
          </listitem>

          <listitem>
            <para><ulink url="http://www.zope.org/Members/fdrake/zconfig/">
            Zconfig</ulink></para>
          </listitem>

          <listitem>
            <para><ulink url="http://www.freebsd.org">FreeBSD</ulink> is
            required to actually build installations. The system running farbot
            must have full sources installed in <filename>/usr/src</filename>, 
            and <filename>/usr/obj</filename> must be populated from a "make 
            buildworld" run on sources matching the currently running kernel. 
            </para>
          </listitem>
        </itemizedlist>
      </sect2>

      <sect2>
{'fraction_non_alphanumeric': 0.11295971978984239, 'fraction_numerical': 0.010683012259194396, 'mean_word_length': 2.5450031036623217, 'pattern_counts': {'":': 0, '<': 169, '<?xml version=': 2, '>': 169, 'https://': 2, 'lorem ipsum': 0, 'www.': 8, 'xml': 4}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1635072', 'n_tokens_mistral': 1726, 'n_tokens_neox': 1609, 'n_words': 513}