From 7aa9b3a1452b52419cfc9954ff36ee6bed7e67b6 Mon Sep 17 00:00:00 2001 From: Daichi GOTO Date: Thu, 24 Jul 2003 06:03:10 +0000 Subject: update games/tractorgen: - add tractorgen(6) manpage and other documentation PR: 50514 Submitted by: Robin Elfrink (maintainer) --- games/tractorgen/Makefile | 14 ++++++ games/tractorgen/files/tractorgen.6 | 85 +++++++++++++++++++++++++++++++++++++ 2 files changed, 99 insertions(+) create mode 100644 games/tractorgen/files/tractorgen.6 (limited to 'games/tractorgen') 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 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 +.\" +.\" 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 +.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. -- cgit v1.2.3