<?xml version="1.0"?>
<!-- $NetBSD: pkgsrc.xml,v 1.42 2023/01/02 05:45:23 jnemeth Exp $ -->

<!DOCTYPE book PUBLIC "-//NetBSD//DTD DocBook XML V4.5-Based DocBook Extension//EN" [

<!ENTITY % man-refs.ent PUBLIC "-//NetBSD//ENTITIES NetBSD Manual Page Entities//EN">
%man-refs.ent;
<!ENTITY % misc.ent PUBLIC "-//NetBSD//ENTITIES NetBSD Miscellaneous Entities//EN">
%misc.ent;
<!ENTITY % chapters SYSTEM "chapters.ent">
%chapters;
<!ENTITY % entities SYSTEM "pkgsrc.ent">
%entities;
]>

<book id="the-pkgsrc-guide">
  <bookinfo>
    <title>The pkgsrc guide</title>
    <subtitle>Documentation on the NetBSD packages system</subtitle>

    <authorgroup>
      <author>
	<firstname>Alistair</firstname>
	<surname>Crooks</surname>

	<affiliation>
	  <address><email>agc@NetBSD.org</email></address>
	</affiliation>
      </author>

      <author>
	<firstname>Hubert</firstname>
	<surname>Feyrer</surname>

	<affiliation>
	  <address><email>hubertf@NetBSD.org</email></address>
	</affiliation>
      </author>
      <corpauthor>
        The pkgsrc Developers
      </corpauthor>
    </authorgroup>

    <copyright>
      <year>1994-2023</year>

      <holder role="mailto:www@NetBSD.org">The NetBSD Foundation, Inc</holder>
    </copyright>

    <pubdate>$NetBSD: pkgsrc.xml,v 1.42 2023/01/02 05:45:23 jnemeth Exp $</pubdate>

    <abstract>

	<para>pkgsrc is a centralized package management system for
	Unix-like operating systems. This guide provides information for
	users and developers of pkgsrc. It covers installation of binary
	and source packages, creation of binary and source packages and
	a high-level overview about the infrastructure.</para>

    </abstract>
  </bookinfo>

  &chap.intro;

  <part id="users-guide"> <?dbhtml filename="users-guide.html"?>
    <title id="users-guide.title">The pkgsrc user's guide</title>

    &chap.help-user;
    &chap.getting;
    &chap.platform;
    &chap.using;
    &chap.configuring;
    &chap.binary;
    &chap.bulk;
    &chap.files;
    &chap.faq;
  </part>

  <!-- "part II" (we need to rid the documentation of this reference) -->
  <part id="developers-guide"> <?dbhtml filename="developers-guide.html"?>
    <title id="developers-guide.title">The pkgsrc developer's guide</title>

	<partintro><para>This part of the book deals with creating and
	modifying packages. It starts with a <quote>HOWTO</quote>-like
	guide on creating a new package. The remaining chapters are more
	like a reference manual for pkgsrc.</para></partintro>

    &chap.help-devel;
    &chap.components;
    &chap.build;
    &chap.creating;
    &chap.makefile;
    &chap.options;
    &chap.tools;
    &chap.buildlink;
    &chap.plist;
    &chap.pkginstall;
    &chap.fixes;
    &chap.gnome;
    &chap.submit;
    &chap.devfaq;
  </part>

  <!-- The pkgsrc infrastructure -->
  <part id="infrastructure"><?dbhtml filename="infrastructure.html"?>
    <title id="infrastructure.title">The pkgsrc infrastructure internals</title>

	<partintro><para>This part of the guide deals with everything
	from the infrastructure that is behind the interfaces described
	in the developer's guide. A casual package maintainer should not
	need anything from this part.</para></partintro>

    &chap.infr.design;
    &chap.regression;
    &chap.porting;
  </part>

  <!-- appendix -->
  &chap.examples;
  &chap.hardening;
  &chap.logs;
  &chap.ftp-layout;
  &chap.help-topics;
  &chap.editing;
</book>
