Re: mention dpb in release(8)

2013-11-26 Thread Marc Espie
On Tue, Nov 26, 2013 at 03:38:49PM +, Stuart Henderson wrote:
> On 2013/11/26 16:28, Marc Espie wrote:
> > On Tue, Nov 26, 2013 at 02:38:43PM +, Stuart Henderson wrote:
> > > Is this OK, or should we remove bits about building packages
> > > individually too?
> > 
> > I'd rather send people to ports(7) directly... since that explains both
> > single port and bulk building.
> 
> Something like this?
> 
> Includes a bonus diff for ports(7), the "mirror-maker" target was removed.
> 
> Index: man8/release.8
> ===
> RCS file: /cvs/src/share/man/man8/release.8,v
> retrieving revision 1.66
> diff -u -p -r1.66 release.8
> --- man8/release.82 Sep 2012 13:47:25 -   1.66
> +++ man8/release.826 Nov 2013 15:37:29 -
> @@ -335,22 +335,11 @@ in your release directory.
>  .Ss 7. Make the third party packages
>  The
>  .Sq ports
> -subsystem of contributed applications is described in
> -.Xr ports 7 .
> -For ease of installation ports can be pre-compiled into
> +subsystem of contributed applications is capable of producing
>  .Sq packages
> -which can then be installed on multiple machines using
> -.Xr pkg_add 1 .
> -Packages are created by selecting an application to build
> -(we'll call this one CATEGORY/PORT) and then running the following:
> -as root:
> -.Bd -literal -offset indent
> -$ cd /usr/ports/CATEGORY/PORT
> -$ su
> -# make package
> -.Ed
> -.Pp
> -That's all there is to it.
> +for installation, either individually or in bulk.
> +This is described in
> +.Xr ports 7 .
>  .Sh SEE ALSO
>  .Xr cvs 1 ,
>  .Xr pkg_add 1 ,
> 
> Index: man7/ports.7
> ===
> RCS file: /cvs/src/share/man/man7/ports.7,v
> retrieving revision 1.96
> diff -u -p -r1.96 ports.7
> --- man7/ports.7  11 Nov 2013 21:14:29 -  1.96
> +++ man7/ports.7  26 Nov 2013 15:37:29 -
> @@ -83,9 +83,6 @@ offers a few useful targets.
>  .It Ar index
>  rebuild the ports complete index,
>  .Pa /usr/ports/INDEX
> -.It Ar mirror-maker
> -see
> -.Xr mirroring-ports 7 ,
>  .It Ar pkglocatedb
>  build a
>  .Xr pkg_mklocatedb 1
> @@ -740,6 +737,7 @@ List of users and groups created by port
>  .Xr pkg_info 1 ,
>  .Xr bsd.port.mk 5 ,
>  .Xr port-modules 5 ,
> +.Xr mirroring-ports 7 ,
>  .Xr packages 7
>  .Pp
>  The
okay for me.



Re: mention dpb in release(8)

2013-11-26 Thread Stuart Henderson
On 2013/11/26 16:28, Marc Espie wrote:
> On Tue, Nov 26, 2013 at 02:38:43PM +, Stuart Henderson wrote:
> > Is this OK, or should we remove bits about building packages
> > individually too?
> 
> I'd rather send people to ports(7) directly... since that explains both
> single port and bulk building.

Something like this?

Includes a bonus diff for ports(7), the "mirror-maker" target was removed.

Index: man8/release.8
===
RCS file: /cvs/src/share/man/man8/release.8,v
retrieving revision 1.66
diff -u -p -r1.66 release.8
--- man8/release.8  2 Sep 2012 13:47:25 -   1.66
+++ man8/release.8  26 Nov 2013 15:37:29 -
@@ -335,22 +335,11 @@ in your release directory.
 .Ss 7. Make the third party packages
 The
 .Sq ports
-subsystem of contributed applications is described in
-.Xr ports 7 .
-For ease of installation ports can be pre-compiled into
+subsystem of contributed applications is capable of producing
 .Sq packages
-which can then be installed on multiple machines using
-.Xr pkg_add 1 .
-Packages are created by selecting an application to build
-(we'll call this one CATEGORY/PORT) and then running the following:
-as root:
-.Bd -literal -offset indent
-$ cd /usr/ports/CATEGORY/PORT
-$ su
-# make package
-.Ed
-.Pp
-That's all there is to it.
+for installation, either individually or in bulk.
+This is described in
+.Xr ports 7 .
 .Sh SEE ALSO
 .Xr cvs 1 ,
 .Xr pkg_add 1 ,

Index: man7/ports.7
===
RCS file: /cvs/src/share/man/man7/ports.7,v
retrieving revision 1.96
diff -u -p -r1.96 ports.7
--- man7/ports.711 Nov 2013 21:14:29 -  1.96
+++ man7/ports.726 Nov 2013 15:37:29 -
@@ -83,9 +83,6 @@ offers a few useful targets.
 .It Ar index
 rebuild the ports complete index,
 .Pa /usr/ports/INDEX
-.It Ar mirror-maker
-see
-.Xr mirroring-ports 7 ,
 .It Ar pkglocatedb
 build a
 .Xr pkg_mklocatedb 1
@@ -740,6 +737,7 @@ List of users and groups created by port
 .Xr pkg_info 1 ,
 .Xr bsd.port.mk 5 ,
 .Xr port-modules 5 ,
+.Xr mirroring-ports 7 ,
 .Xr packages 7
 .Pp
 The



Re: mention dpb in release(8)

2013-11-26 Thread Marc Espie
On Tue, Nov 26, 2013 at 02:38:43PM +, Stuart Henderson wrote:
> Is this OK, or should we remove bits about building packages
> individually too?

I'd rather send people to ports(7) directly... since that explains both
single port and bulk building.

> Index: share/man/man8/release.8
> ===
> RCS file: /cvs/src/share/man/man8/release.8,v
> retrieving revision 1.66
> diff -u -p -u -1 -5 -r1.66 release.8
> --- share/man/man8/release.8  2 Sep 2012 13:47:25 -   1.66
> +++ share/man/man8/release.8  26 Nov 2013 14:36:59 -
> @@ -338,25 +338,29 @@ The
>  subsystem of contributed applications is described in
>  .Xr ports 7 .
>  For ease of installation ports can be pre-compiled into
>  .Sq packages
>  which can then be installed on multiple machines using
>  .Xr pkg_add 1 .
>  Packages are created by selecting an application to build
>  (we'll call this one CATEGORY/PORT) and then running the following:
>  as root:
>  .Bd -literal -offset indent
>  $ cd /usr/ports/CATEGORY/PORT
>  $ su
>  # make package
>  .Ed
>  .Pp
> -That's all there is to it.
> +To build a larger set of packages,
> +.Xr dpb 1
> +has various facilities to manage the build,
> +either on a single machine or a cluster.
>  .Sh SEE ALSO
>  .Xr cvs 1 ,
> +.Xr dpb 1 ,
>  .Xr pkg_add 1 ,
>  .Xr ports 7 ,
>  .Xr sudo 8 ,
>  .Xr sysmerge 8
>  .Sh HISTORY
>  This document first appeared in
>  .Ox 2.8 .



mention dpb in release(8)

2013-11-26 Thread Stuart Henderson
Is this OK, or should we remove bits about building packages
individually too?

Index: share/man/man8/release.8
===
RCS file: /cvs/src/share/man/man8/release.8,v
retrieving revision 1.66
diff -u -p -u -1 -5 -r1.66 release.8
--- share/man/man8/release.82 Sep 2012 13:47:25 -   1.66
+++ share/man/man8/release.826 Nov 2013 14:36:59 -
@@ -338,25 +338,29 @@ The
 subsystem of contributed applications is described in
 .Xr ports 7 .
 For ease of installation ports can be pre-compiled into
 .Sq packages
 which can then be installed on multiple machines using
 .Xr pkg_add 1 .
 Packages are created by selecting an application to build
 (we'll call this one CATEGORY/PORT) and then running the following:
 as root:
 .Bd -literal -offset indent
 $ cd /usr/ports/CATEGORY/PORT
 $ su
 # make package
 .Ed
 .Pp
-That's all there is to it.
+To build a larger set of packages,
+.Xr dpb 1
+has various facilities to manage the build,
+either on a single machine or a cluster.
 .Sh SEE ALSO
 .Xr cvs 1 ,
+.Xr dpb 1 ,
 .Xr pkg_add 1 ,
 .Xr ports 7 ,
 .Xr sudo 8 ,
 .Xr sysmerge 8
 .Sh HISTORY
 This document first appeared in
 .Ox 2.8 .