summaryrefslogtreecommitdiff
path: root/pkgtools
diff options
context:
space:
mode:
authorwiz <wiz@pkgsrc.org>2013-05-29 14:37:29 +0000
committerwiz <wiz@pkgsrc.org>2013-05-29 14:37:29 +0000
commit77cf3d7bc1f46f438916e31a48089f5e2e2aa865 (patch)
tree6658b3b89c91c0680323e068e404a158649685fa /pkgtools
parent7f6ee1890c4f9a5d38a3cccf9bee1252c6a31e90 (diff)
downloadpkgsrc-77cf3d7bc1f46f438916e31a48089f5e2e2aa865.tar.gz
- re-adjust sentence widths, and put new sentences on new lines;
- add an appropriate comma; - correct (also macro wise) / rewrite `EXAMPLES' section; - replace packages(7) reference in `SEE ALSO' with pkgsrc(7) one (src/share/man/man7/packages.7 was removed in 2007); - remove ``Documentation on the NetBSD Package System'' reference from `SEE ALSO' (it's referenced in pkgsrc(7)); - remove unneccesary `.br' macro (and low level macros should generally not be used anyway); - remove `BUGS' section, as the ``bug'' described in it isn't a bug at all; - bump date. From Bug Hunting.
Diffstat (limited to 'pkgtools')
-rw-r--r--pkgtools/url2pkg/files/url2pkg.853
1 files changed, 21 insertions, 32 deletions
diff --git a/pkgtools/url2pkg/files/url2pkg.8 b/pkgtools/url2pkg/files/url2pkg.8
index a41041b00f3..7662264665d 100644
--- a/pkgtools/url2pkg/files/url2pkg.8
+++ b/pkgtools/url2pkg/files/url2pkg.8
@@ -1,4 +1,4 @@
-.\" $NetBSD: url2pkg.8,v 1.9 2012/02/26 02:34:43 dholland Exp $
+.\" $NetBSD: url2pkg.8,v 1.10 2013/05/29 14:37:29 wiz Exp $
.\"
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -34,7 +34,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd January 28, 2001
+.Dd May 29, 2013
.Dt URL2PKG 8
.Os
.Sh NAME
@@ -47,23 +47,23 @@
.Nm
takes the
.Ar URL
-to a package's distfile that should be
-turned into a package. The
-generated package includes a
+to a package's distfile that should be turned into a package.
+The generated package includes a
.Pa Makefile
-and a basic set of files to get the
-package going. Any customisations to get the package going need to be
-adjusted manually after
+and a basic set of files to get the package going.
+Any customisations to get the package going need to be adjusted manually after
.Nm
has finished its job.
.Pp
.Nm
-is intended to help starting to create a package; it is not
-intended to fly on autopilot, though.
+is intended to help starting to create a package;
+it is not intended to fly on autopilot, though.
.Pp
The
.Pa Makefile
-contains all the required variables, such as DISTNAME or MASTER_SITES, but some of them cannot be automatically set. Hence, the user's usual editor is invoked to edit the
+contains all the required variables, such as DISTNAME or MASTER_SITES,
+but some of them cannot be automatically set.
+Hence, the user's usual editor is invoked to edit the
.Pa Makefile .
.Pp
After the
@@ -72,12 +72,12 @@ is completed,
.Nm
fetches the archive, and computes its checksum via the
.Ic make makesum
-target. Then archive extraction is done, via the
+target.
+Then, archive extraction is done, via the
.Ic make extract
target, and finally,
.Nm
-attempts to detect if
-the software uses a
+attempts to detect if the software uses a
.Ic configure
script, and if it's from GNU
.Ic autoconf .
@@ -98,30 +98,19 @@ Name used for the MAINTAINER field in the package
.Pa Makefile .
.El
.Sh EXAMPLES
-.Nm
-.Ar http://www.foo.com/bar/buz.tgz
-.Pp
-Will generate a template
-.Nx
-package for the software that can be found at
-.Ar http://www.foo.com/bar/buz.tgz .
+The following command will generate a template pkgsrc package
+for the software that can be found at
+.Lk http://www.example.com/bar/buz.tgz :
+.Bd -literal
+url2pkg http://www.example.com/bar/buz.tgz
+.Ed
.Sh SEE ALSO
-.Xr packages 7
-.br
-.Em "Documentation on the NetBSD Package System" ,
-.An Hubert Feyrer Aq hubertf@NetBSD.org ,
-.An Alistair Crooks Aq agc@NetBSD.org .
+.Xr pkgsrc 7
.Sh AUTHORS
.Nm
was written by
.An Roland Illig Aq rillig@NetBSD.org ,
enhancing the previous version by
.An Hubert Feyrer Aq hubertf@NetBSD.org .
-.br
This man page was written by
.An Emmanuel Dreyfus Aq manu@NetBSD.org .
-.Sh BUGS
-.Nm
-does not generate an empty
-.Pa patches
-directory.