update games/tractorgen:

  - add tractorgen(6) manpage and other documentation

PR:		50514
Submitted by:	Robin Elfrink <elfrink@introcom.nl> (maintainer)

2 files changed, 99 insertions, 0 deletions

diff --git a/games/tractorgen/Makefile b/games/tractorgen/Makefile
index 3d242be8b96a..1d8e9975f7a0 100644
--- a/games/tractorgen/Makefile
+++ b/games/tractorgen/Makefile
@@ -7,6 +7,7 @@
 
 PORTNAME=	tractorgen
 PORTVERSION=	0.31.7
+PORTREVISION=	1
 CATEGORIES=	games
 MASTER_SITES=	http://www.vergenet.net/~conrad/software/tractorgen/dl/
 MASTER_SITE_SUBDIR=	${PORTNAME}
@@ -16,4 +17,17 @@ COMMENT=	Generates ASCII tractors
 
 USE_LIBTOOL=	yes
 
+MAN6=		tractorgen.6
+
+post-install:
+	${INSTALL_MAN} ${FILESDIR}/tractorgen.6 ${PREFIX}/man/man6/tractorgen.6
+.if !defined(NOPORTDOCS)
+	${MKDIR} ${DOCSDIR}
+	${INSTALL_DATA} ${WRKSRC}/AUTHORS ${DOCSDIR}
+	${INSTALL_DATA} ${WRKSRC}/COPYING ${DOCSDIR}
+	${INSTALL_DATA} ${WRKSRC}/ChangeLog ${DOCSDIR}
+	${INSTALL_DATA} ${WRKSRC}/NEWS ${DOCSDIR}
+	${INSTALL_DATA} ${WRKSRC}/README ${DOCSDIR}
+.endif
+
 .include <bsd.port.mk>
diff --git a/games/tractorgen/files/tractorgen.6 b/games/tractorgen/files/tractorgen.6
new file mode 100644
index 000000000000..791aa2f7d4d3
--- /dev/null
+++ b/games/tractorgen/files/tractorgen.6
@@ -0,0 +1,85 @@
+.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.\" tractorgen.6                                              March 2000
+.\" Kbert                                                 k@vergenet.net
+.\"
+.\" tractorgen
+.\" Generates ASCII tractors
+.\" Copyright (C) 1999-2002  Kbert <k@vergenet.net>
+.\" 
+.\" This program is free software; you can redistribute it and/or
+.\" modify it under the terms of the GNU General Public License as
+.\" published by the Free Software Foundation; either version 2 of the
+.\" License, or (at your option) any later version.
+.\" 
+.\" This program is distributed in the hope that it will be useful, but
+.\" WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+.\" General Public License for more details.
+.\" 
+.\" You should have received a copy of the GNU General Public License
+.\" along with this program; if not, write to the Free Software
+.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
+.\" 02111-1307  USA
+.\"
+.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.TH TRACTORGEN 6 "3th March 2000"
+.SH NAME
+tractorgen \- Generates ASCII tractors
+.SH SYNOPSIS
+\fBtractorgen [number of wheels]\fP
+.SH DESCRIPTION
+\fBtractorgen\fP generates ASCII tractors using the universal tractor
+coefficient (TC). The intended audience is practical ASCII tractor
+theorists and lay people interested in abstract tractor theory.
+
+Before using this program, ensure that you understand the fundamental
+theorem of ASCII tractor mechanics:
+
+"ASCII Tractors must have at least four wheels." [1]
+
+Note that this theorem applies to side-on views. No useful models of
+two-sided ASCII tractors have been found, nor is there even any
+concrete proof of their existence.
+
+In keeping with this theorem, TRACTORGEN will politely inform the user
+if any attempt to make tractors with less than four wheels is made
+(by calling abort(3) and dumping core).
+
+[1] See, for example, "Introductory ASCII tractor design, vols 3-7",
+Blum&Merven, Slarken Press 1973.
+.SH OPTIONS
+.TP
+\fBnumber of wheels\fP
+If no argument is given, the optimal configuration of 7 is generated.
+.SH USAGE
+Tractorgen takes one argument. This argument is indirectly related
+to the TC and is a cardinal enumerating the desired wheel
+configuration.
+
+For example, if you want a tractor with 5 wheels, type at the shell
+prompt:
+
+$ tractorgen 5
+
+Conversely, if you want a tractor with 113 wheels, type:
+
+$ tractorgen 113
+
+Remember that tractors with large numbers of wheels may overflow the
+width of your terminal, with unpredictable results. Actually, it will
+probably just look like shit.
+.SH FILES
+.TP
+None
+.SH SEE ALSO
+abort(3)
+.SH WEBSITE
+http://www.vergenet.net/~konradd/software/tractorgen/
+.SH AUTHOR
+.br
+Kbert <k@vergenet.net>
+.SH LICENSE
+.br
+This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. See the file COPYING for details. 
+
+Though I have no idea why you'd want to do any of this.