CVS commit: pkgsrc/pkgtools/url2pkg/files

["Roland Illig" <rillig%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   rillig
Date:           Sun Oct  6 12:50:41 UTC 2019

Modified Files:
        pkgsrc/pkgtools/url2pkg/files: url2pkg.8

Log Message:
pkgtools/url2pkg: update man page


To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 pkgsrc/pkgtools/url2pkg/files/url2pkg.8

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/pkgtools/url2pkg/files/url2pkg.8
diff -u pkgsrc/pkgtools/url2pkg/files/url2pkg.8:1.13 pkgsrc/pkgtools/url2pkg/files/url2pkg.8:1.14
--- pkgsrc/pkgtools/url2pkg/files/url2pkg.8:1.13        Thu Oct  3 09:37:41 2019
+++ pkgsrc/pkgtools/url2pkg/files/url2pkg.8     Sun Oct  6 12:50:41 2019
@@ -1,10 +1,10 @@
-.\"    $NetBSD: url2pkg.8,v 1.13 2019/10/03 09:37:41 rillig Exp $
+.\"    $NetBSD: url2pkg.8,v 1.14 2019/10/06 12:50:41 rillig Exp $
 .\"
 .\" Copyright (c) 2001, 2019 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to The NetBSD Foundation
-.\" by Emmanuel Dreyfus.
+.\" by Emmanuel Dreyfus and Roland Illig.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
@@ -42,45 +42,18 @@
 takes the
 .Ar URL
 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
-.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.
-.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
+It fetches the distfile, extracts it, and by looking at the extracted files,
+fills in some variables in the package
 .Pa Makefile .
 .Pp
-After the
-.Pa Makefile
-is completed,
-.Nm
-fetches the archive, and computes its checksum via the
-.Ic make makesum
-target.
-Then, archive extraction is done, via the
-.Ic make extract
-target, and finally,
 .Nm
-attempts to detect if the software uses a
-.Ic configure
-script, and if it's from GNU
-.Ic autoconf .
+helps creating a package;
+it is not intended to fly on autopilot, though.
+Hence, after creating the package, the user's usual editor is invoked
+to edit the
+.Pa Makefile ,
+since in almost all cases the package needs manual work.
 .Pp
-If the user does not supply the
-.Ar URL
-on the command line, then
-.Nm
-will prompt for it.
 .Sh ENVIRONMENT
 .Bl -tag -width indent
 .It PKGEDITOR, EDITOR
@@ -94,17 +67,16 @@ Name used for the MAINTAINER field in th
 .Sh EXAMPLES
 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 :
+.Lk https://www.example.org/download/buz-19.3.tar.gz :
 .Bd -literal
-url2pkg http://www.example.com/bar/buz.tgz
+url2pkg https://www.example.org/download/buz-19.3.tar.gz
 .Ed
 .Sh SEE ALSO
 .Xr pkgsrc 7
 .Sh AUTHORS
-.Nm
-was written by
-.An Roland Illig Aq Mt rillig%NetBSD.org@localhost ,
-enhancing the previous version by
-.An Hubert Feyrer Aq Mt hubertf%NetBSD.org@localhost .
-This man page was written by
-.An Emmanuel Dreyfus Aq Mt manu%NetBSD.org@localhost .
+.An Roland Illig Aq Mt rillig%NetBSD.org@localhost
+wrote the current version.
+.An Hubert Feyrer Aq Mt hubertf%NetBSD.org@localhost
+wrote the initial version.
+.An Emmanuel Dreyfus Aq Mt manu%NetBSD.org@localhost
+initially wrote this man page.