cvs2fossil: add a man page

[Thomas Klausner <wiz%gatalith.at@localhost>]

Module Name:	pkgsrc-wip
Committed By:	Thomas Klausner <wiz%gatalith.at@localhost>
Pushed By:	wiz
Date:		Tue Jun 27 18:37:04 2023 +0200
Changeset:	ca40633427c9cbdce1dec2c6a3c6195c94b6f24f

Modified Files:
	cvs2fossil/Makefile
	cvs2fossil/PLIST
Added Files:
	cvs2fossil/files/cvs2fossil.1

Log Message:
cvs2fossil: add a man page

To see a diff of this commit:
https://wip.pkgsrc.org/cgi-bin/gitweb.cgi?p=pkgsrc-wip.git;a=commitdiff;h=ca40633427c9cbdce1dec2c6a3c6195c94b6f24f

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

diffstat:
 cvs2fossil/Makefile           |  3 +-
 cvs2fossil/PLIST              |  1 +
 cvs2fossil/files/cvs2fossil.1 | 75 +++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 78 insertions(+), 1 deletion(-)

diffs:
diff --git a/cvs2fossil/Makefile b/cvs2fossil/Makefile
index 743f8d0e87..fb0a8ff376 100644
--- a/cvs2fossil/Makefile
+++ b/cvs2fossil/Makefile
@@ -13,7 +13,7 @@ DEPENDS+=	fossil1-[0-9]*:../../wip/fossil1
 
 WRKSRC=		${WRKDIR}/cvs2fossil
 
-INSTALLATION_DIRS+=	bin libexec/cvs2fossil
+INSTALLATION_DIRS+=	bin libexec/cvs2fossil ${PKGMANDIR}/man1
 
 SUBST_CLASSES+=		prefix
 SUBST_FILES.prefix=	convert.sh
@@ -29,5 +29,6 @@ do-install:
 	${INSTALL_PROGRAM} ${WRKSRC}/${file}/${file} ${DESTDIR}${PREFIX}/libexec/cvs2fossil
 .endfor
 	${INSTALL_SCRIPT} ${WRKSRC}/convert.sh ${DESTDIR}${PREFIX}/bin/cvs2fossil
+	${INSTALL_DATA} ${FILESDIR}/cvs2fossil.1 ${DESTDIR}${PREFIX}/${PKGMANDIR}/man1
 
 .include "../../mk/bsd.pkg.mk"
diff --git a/cvs2fossil/PLIST b/cvs2fossil/PLIST
index ef01025e16..be3a897601 100644
--- a/cvs2fossil/PLIST
+++ b/cvs2fossil/PLIST
@@ -5,3 +5,4 @@ libexec/cvs2fossil/02-vendorbranches
 libexec/cvs2fossil/03-branchtime
 libexec/cvs2fossil/04-commit
 libexec/cvs2fossil/99-warnings
+man/man1/cvs2fossil.1
diff --git a/cvs2fossil/files/cvs2fossil.1 b/cvs2fossil/files/cvs2fossil.1
new file mode 100644
index 0000000000..076db6f034
--- /dev/null
+++ b/cvs2fossil/files/cvs2fossil.1
@@ -0,0 +1,75 @@
+.\"	$NetBSD$
+.\"
+.\" Copyright (c) 2023 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Thomas Klausner.
+.\"
+.\" 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.
+.\"
+.\" 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 June 27, 2023
+.Dt CVS2FOSSIL 1
+.Os
+.Sh NAME
+.Nm cvs2fossil
+.Nd convert CVS repository to fossil
+.Sh SYNOPSIS
+.Nm
+.Ar source
+.Ar destination
+.Sh DESCRIPTION
+.Nm
+is a script to convert a
+.Xr cvs 1
+repository to a
+.Xr fossil 1
+repository.
+.Pp
+.Ar source
+must be a CVS repository (the server side, i.e. the RCS files, not a
+checkout).
+.Nm
+will create
+.Ar destination ,
+an intermediate
+.Xr sqlite3 1
+database, and
+.Ar destination Ns Pa .fossil ,
+the fossil conversion.
+It will also run some tests on the conversion to report possible problems.
+.Sh WARNINGS
+These warnings usually indicate that some manual changes were done
+to the RCS files.
+.Bl -ohang
+.It Dq Files with default branch, but no vendor branch
+The branch symbol for the vendor branch was removed.
+.It Dq Disconnected revisions
+The branch symbol was removed, but the revision was left lying around.
+.It Dq Revisions not newer than previous revision
+A newer revision of a file has an older timestamp than an older
+revision it is based on.
+.El
+.Sh SEE ALSO
+.Xr cvs 1 ,
+.Xr fossil 1 ,
+.Xr sqlite3 1