On Wed, May 10, 2006 at 04:03:32PM -0400, Johnny Lam wrote:
> It seems like the pkgsrc Guide should be split along the lines of 
> "user", "package maintainer", and "developer".  The "user" part speaks 
> to users about how to use pkgsrc, and would address issues like:
> 
>   * how to get pkgsrc
>   * how to build from pkgsrc
>   * how to use binary packages
>   * what special shell variables can influence a binary pkg install
>   * what /etc/mk.conf make variables can influence a build

--> both in the sense of "which does a normal user want / should want to
change"

> The "package maintainer" part speaks to package maintainers about how to 
> create and maintain packages within pkgsrc, and would address things like:
> 
>   * structure of package directory and files
>   * how to create and name PLISTs
>   * how to use buildlink3.mk files
>   * describing the interface presented by the various frameworks
>   * walk-through of a package build

--> PKG_DEVELOPER and related variables
--> make mps and related targets for maintainance

> The "developer" part speaks to infrastructure developers and documents 
> things like:
> 
>   * the design and implementation of the various frameworks
>   * coding style
>   * porting pkgsrc to a new platform
>   * shared library handling
>   * regression tests

Joerg