ports/50514: TCH] Added tractorgen(6) manpage and other documentation.

[Robin Elfrink]

>Number:         50514
>Category:       ports
>Synopsis:       TCH] Added tractorgen(6) manpage and other documentation.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-ports-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Mar 31 23:30:08 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     Robin Elfrink <elfrink at introcom.nl>
>Release:        FreeBSD 4.7-RELEASE i386
>Organization:
IntroWeb
>Environment:
System: FreeBSD mmworks1.introweb.nl 4.7-RELEASE FreeBSD 4.7-RELEASE #6: Mon Jan 27 11:50:39 CET 2003 root at mmworks1.introweb.nl:/usr/src/sys/compile/pannenkoek i386
>Description:
Original archive has no manual page. The hereby included manual page was created by carefully extracting relevant information from several documentation files included in the original archive. Also, the original documentation files will be installed.
>How-To-Repeat:
>Fix:
Apply the attached patch.

--- tractorgen.diff begins here ---
diff -uNr tractorgen.orig/Makefile tractorgen/Makefile
--- tractorgen.orig/Makefile	Tue Apr  1 01:09:25 2003
+++ tractorgen/Makefile	Tue Apr  1 08:49:56 2003
@@ -7,6 +7,7 @@
 
 PORTNAME=	tractorgen
 PORTVERSION=	0.31.7
+PORTREVISION=	1
 CATEGORIES=	games
 MASTER_SITES=	http://heidi.vergenet.net/~conrad/software/tractorgen/dl/
 MASTER_SITE_SUBDIR=	${PORTNAME}
@@ -15,5 +16,18 @@
 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 -uNr tractorgen.orig/files/tractorgen.6 tractorgen/files/tractorgen.6
--- tractorgen.orig/files/tractorgen.6	Thu Jan  1 01:00:00 1970
+++ tractorgen/files/tractorgen.6	Tue Apr  1 08:53:29 2003
@@ -0,0 +1,85 @@
+.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.\" tractorgen.6                                              March 2000
+.\" Kbert                                                 k at vergenet.net
+.\"
+.\" tractorgen
+.\" Generates ASCII tractors
+.\" Copyright (C) 1999-2002  Kbert <k at 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 at 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.
--- tractorgen.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: