Added rpm2pkg(8) man page

3 files changed, 139 insertions, 2 deletions

diff --git a/pkgtools/rpm2pkg/Makefile b/pkgtools/rpm2pkg/Makefile
index 3a9b94605f2..6079325b8d2 100644
--- a/pkgtools/rpm2pkg/Makefile
+++ b/pkgtools/rpm2pkg/Makefile
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.1.1.1 2001/01/25 08:57:53 tron Exp $
+# $NetBSD: Makefile,v 1.2 2001/01/28 10:44:39 manu Exp $
 
 DISTNAME=	rpm2pkg-1.0
 CATEGORIES=	pkgtools
@@ -31,5 +31,6 @@ do-build:
 
 do-install:
 	${INSTALL_PROGRAM} ${WRKSRC}/rpm2pkg ${PREFIX}/sbin
+	${INSTALL_MAN} ${FILESDIR}/rpm2pkg.8 ${PREFIX}/man/man8
 
 .include "../../mk/bsd.pkg.mk"
diff --git a/pkgtools/rpm2pkg/files/rpm2pkg.8 b/pkgtools/rpm2pkg/files/rpm2pkg.8
new file mode 100644
index 00000000000..cfeb63e4ca0
--- /dev/null
+++ b/pkgtools/rpm2pkg/files/rpm2pkg.8
@@ -0,0 +1,135 @@
+.\"	$NetBSD: rpm2pkg.8,v 1.1 2001/01/28 10:44:39 manu Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Emmanuel Dreyfus.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\" This product includes software developed by the NetBSD
+.\" Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd January 27, 2001
+.Dt RPM2PKG 8
+.Os
+.Sh NAME
+.Nm rpm2pkg
+.Nd RPM to BSD package convertion helper
+.Sh SYNOPSIS
+.Nm
+.Op Fl d Ar directory
+.Op Fl f Ar package_list
+.Op Fl i Ar ignored_dir
+.Op Fl p Ar prefix
+.Ar rpm_file ...
+.Sh DESCRIPTION
+.Nm
+helps building BSD packages from RPM files by unpacking each specified
+.Ar rpm_file, 
+and by building a 
+.Ar package_list
+according to what was extraced. The
+.Ar packge_list
+has the format expected by the NetBSD package system.
+.Pp 
+.Nm 
+also provide a mecanism that helps selecting what is actually 
+extracted from the RPM files. It is therefore possible to reject files
+that are of no interest when building a BSD package. This is specially usefull for files that are to be extracted in
+.Pa /var
+or
+.Pa /etc
+directories.
+.Pp
+The following options are available:
+.Bl -tag -width indent
+.It Fl d Ar directory
+Change working directory to 
+.Ar directory
+.It Fl f Ar packge_list
+Produce a NetBSD package list 
+.Ar packge_list
+from what was actually extracted from the RPM files archives.
+.It Fl i Ar ignored_dir
+Do not extract files contained in the
+.Ar ignored_dir
+directory of the RPM files archives.
+.It Fl p Ar prefix
+Use 
+.Ar prefix 
+when extracting files.
+.Sh EXAMPLES
+.Nm
+.Fl d Ar /usr/pkg
+.Fl f Ar /usr/pkgsrc/emulator/more_linux_lib/work/PLIST_DYNAMIC
+.Fl p Ar emul/linux
+.Fl i Ar tmp
+.Fl i Ar var
+.Fl i Ar usr/tmp
+.Ar /usr/pkgsrc/distfiles/more_linux_lib/foo.rpm 
+.Ar /usr/pkgsrc/distfiles/more_linux_lib/bar.rpm
+.Pp
+This will extract 
+.Pa foo.rpm 
+and
+.Pa bar.rpm
+into 
+.Pa /usr/pkg/emul/linux.
+A Packing list, called 
+.Pa PLIST_DYNAMIC
+will be created, with pathnames relative to 
+.Pa /usr/pkg,
+because this is the directory we asked 
+.Nm
+to change to with the
+.Fl d
+option.
+.Pp
+.Nm 
+will not extract files contained in the
+.Pa tmp,
+.Pa var,
+and
+.Pa /usr/tmp
+directories of the RPM files archives.
+.Sh COMPATIBILITY
+.Nm 
+should work with any regular RPM file.
+.Sh AUTHOR(S)
+.An Matthias Scheler Aq tron@netbsd.org
+.br
+This man page was written by 
+.An Emmanuel Dreyfus Aq manu@netbsd.org
+.Sh SEE ALSO
+.Xr rpm 8 ,
+.Xr rpm2cpio 8 ,
+.Xr cpio 1
+.br
+.Em "Documentation on the NetBSD Package System", 
+.An Hubert Feyrer Aq hubert.feyrer@informatik.fh-regensburg.de , 
+.An Alistair Crooks Aq agc@pkgsrc.org
diff --git a/pkgtools/rpm2pkg/pkg/PLIST b/pkgtools/rpm2pkg/pkg/PLIST
index c08358a9015..6d67a535cd8 100644
--- a/pkgtools/rpm2pkg/pkg/PLIST
+++ b/pkgtools/rpm2pkg/pkg/PLIST
@@ -1,2 +1,3 @@
-@comment $NetBSD: PLIST,v 1.1.1.1 2001/01/25 08:57:53 tron Exp $
+@comment $NetBSD: PLIST,v 1.2 2001/01/28 10:44:39 manu Exp $
 sbin/rpm2pkg
+man/man8/rpm2pkg.8