From owner-freebsd-gnome@FreeBSD.ORG Wed Oct 29 19:21:10 2003 Return-Path: Delivered-To: freebsd-gnome@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C717E16A4CE for ; Wed, 29 Oct 2003 19:21:10 -0800 (PST) Received: from lakemtao06.cox.net (lakemtao06.cox.net [68.1.17.115]) by mx1.FreeBSD.org (Postfix) with ESMTP id A115143FBF for ; Wed, 29 Oct 2003 19:21:09 -0800 (PST) (envelope-from mezz7@cox.net) Received: from mezz.mezzweb.com ([68.103.32.11]) by lakemtao06.cox.net (InterMail vM.5.01.06.05 201-253-122-130-105-20030824) with ESMTP id <20031030032106.GGGL10862.lakemtao06.cox.net@mezz.mezzweb.com> for ; Wed, 29 Oct 2003 22:21:06 -0500 Date: Wed, 29 Oct 2003 21:20:24 -0600 To: freebsd-gnome@freebsd.org From: Jeremy Messenger Content-Type: multipart/mixed; boundary=----------oM0K0zMKQylQKoqwRkKtzO MIME-Version: 1.0 Message-ID: User-Agent: Opera7.21/Linux M2 build 480 Subject: The manpage of marcusmerge is 98% done.. X-BeenThere: freebsd-gnome@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: GNOME for FreeBSD -- porting and maintaining List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Oct 2003 03:21:10 -0000 ------------oM0K0zMKQylQKoqwRkKtzO Content-Type: text/plain; format=flowed; charset=iso-8859-1 Content-Transfer-Encoding: 8bit I have clean a lot of stuff from the previous attaches and done filled out all varibles/commands. The only left thing to do is to finish the 'DESCRIPTION'. I am not sure how I can write it, so I rather someone with skill write to do it for me. :-) The left of it so far is feedback, no doubt of need to clean the grammars and finish DESCRIPTION. Here's an attach of marcusmerge.1.. So.. If one of you think it's good then go ahead make the change and commit it. Cheers, Mezz -- bsdforums.org 's moderator, mezz. ------------oM0K0zMKQylQKoqwRkKtzO Content-Disposition: attachment; filename=marcusmerge.1 Content-Type: application/octet-stream; name=marcusmerge.1 Content-Transfer-Encoding: 8bit .\" Copyright 1996-2003 Jeremy Messenger . .\" All rights reserved. .\" .\" 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 acknowledgment: .\" This product includes software developed by John D. Polstra. .\" 4. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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. .\" .\" $Id$ .\" .Dd October 27, 2003 .Os FreeBSD .Dt MARCUSMERGE 1 .Sh NAME .Nm marcusmerge .Nd FreeBSD GNOME package for MarcusCom CVS repositories .Sh SYNOPSIS .Nm .Op Fl alptuv .Op Fl c Ar cvsroot .Op Fl d Ar directory .Op Fl m Ar module .Op Fl s Ar directory .Sh DESCRIPTION .Nm is a shell script for blah, blah, blah and blah. .Sh OPTIONS The following options are supported by .Nm : .Bl -tag -width Fl .It Fl a Combinations three options; .Fl u , .Fl l and .Fl p . .It Fl c Specifies the CVSROOT, overriding any .Cm CVSROOT specifications in the cvsup. The default .Cm CVSROOT is .Ar creme-brulee.marcuscom.com , MarcusCom CVS. .It Fl d Specifies the path of official ports collection, overriding any .Cm DESTDIR specifications in the .Nm . The default path is .Ar /usr/ports . .It Fl l Lists the outdated ports to show which application(s) will need to update, overridding any .Cm pkgversion specifications in the .Nm . The default is .Ar no , disable. .It Fl m Specifies the CVS module to checkout from MarcusCom CVS. There has the different modules following: .Pp .Bl -bullet -compact .It .Cm ports : The GNOME desktop development snapshots as well as the Evolution beta ports and some other GT2K apps related. .It .Cm ports-stable : This module is only being use when the ports tree freeze for a month. The Gnome packages will be update in here. .El .Pp Overridding any .Cm MODULE specifications in the .Nm . The default CVS module is .Ar ports . .It Fl p Updates the official ports collection and checkouts the MarcusCom ports. You should fill out the .Cm SUPFILE in the .Nm , before use this option. The default is .Ar no , disable. .It Fl s Specifies the path of MarcusCom ports without the trailing module name (i.e. without the trailing /ports), overriding any .Cm SRCDIR specifications in the .Nm . There is no default path, so this is recommend for you to either use this option or fillout the .Cm SRCDIR . .It Fl t Enables the download a tarball instead of using CVS, overriding any .Cm TARBALL specifications in the .Nm . The default is .Ar no , using CVS. .It Fl u Updates the MarcusCom ports repo, overridding any .Cm updating specifications in the .Nm . The default is .Ar no , disable. .It Fl v Enables the verbose output, overridding any .Cm VERBOSE specifications in the .Nm . The default is .Ar no , disable. .El .Sh VARIBLES You can either edit in the .Nm or .Ar marcusmerge.cfg the varibles. The .Ar marcusmerge.cfg will overridding any varibles in the .Nm , so you can copy the varibles from .Nm and put them in the .Ar marcusmerge.cfg . Uses .Ar marcusmerge.cfg , you won't have to edit the new .Nm at the every time when you download it. .Pp Default, you will have to create .Ar marcusmerge.cfg by manual if you want to use it. .Pp The varibles in the .Nm are: .Bl -tag -width Cm .It Cm CVSUP_CMD=" Ns Ar " Specifies the command you what rather to use for update your offical ports collection. This only will be being use if you set the .Cm update_main as .Ar yes or use the .Fl p option. You will need to fill out the .Cm SUPFILE before you use this option. The default command is .Ar /usr/local/bin/cvsup -g . .It Cm DESTDIR=" Ns Ar " Specifies the path of official ports collection, overriding any .Fl d option. The default path is .Ar /usr/ports . .It Cm FETCH_ARGS=" Ns Ar " Specifies the option(s) what you want to use for .Cm FETCH_CMD to be use to download the tarball. This only will be being use if you set the .Cm TARBALL as .Ar yes or use the .Fl t option. The default options is .Ar -4 -q . .It Cm FETCH_CMD=" Ns Ar " Specifies the command what you rather to use for download the tarball. This only will be being use if you set the .Cm TARBALL as .Ar yes or use the .Fl t option. The default command is .Ar /usr/bin/fetch . .It Cm MODULE=" Ns Ar " Specifies the CVS module to checkout from MarcusCom CVS. There has the different modules following: .Pp .Bl -bullet -compact .It .Cm ports : The GNOME desktop development snapshots as well as the Evolution beta ports and some other GT2K apps related. .It .Cm ports-stable : This module is only being use when the ports tree freeze for a month. The Gnome packages will be update in here. .El .Pp Overridding any .Fl m option. The default CVS module is .Ar ports . .It Cm PKGVERSION_ARGS=" Ns Ar " Specifies the option(s) what you want to use for .Cm PKGVERSION_CMD to be use to lists the outdated ports to show which application(s) will need to update. This only will be being use if you set the .Cm pkgversion as .Ar yes or use the .Fl l option. The default options is .Ar -l \< . .It Cm PKGVERSION_CMD=" Ns Ar " Specifies the command what you rather to use for lists the outdated ports to show which application(s) will need to update. This only will be being use if you set the .Cm pkgversion as .Ar yes or use the .Fl l option. The default options is .Ar /usr/sbin/pkg_version . .It Cm SRCDIR=" Ns Ar " Specifies the path of MarcusCom ports without the trailing module name (i.e. without the trailing /ports), overriding any .Fl s options. There is no default path, so this is recommend for you to either fill this out or use .Fl s option. .It Cm SUPFILE=" Ns Ar " Specifies the path of your ports-supfile (default: auto). .It Cm TARBALL=" Ns Ar " Enables or disables the download a tarball instead of using CVS, overriding any .Fl t option. The default is .Ar no , using CVS. .It Cm VERBOSE=" Ns Ar " Enables or disables the verbose output, overridding any .Fl v option. The default is .Ar no , disable. .It Cm pkgversion=" Ns Ar " Enables or disables the lists the outdated ports to show which application(s) will need to update, overridding any .Fl l option. The default is .Ar no , disable. .It Cm update_main=" Ns Ar " Enables or disables the updates official ports collection and checkouts the MarcusCom ports, overridding any .Fl p option. You should fill out the .Cm SUPFILE in .Nm , before use this option. The default is .Ar no , disable. .It Cm updating=" Ns Ar " Enables or disables the updates MarcusCom ports repo, overridding any .Fl u option. The default is .Ar no , disable. .El .Sh FILES .Bl -tag -width Pa .It Pa $ Ns Ev PATH Ns Pa /marcusmerge Any path, up to your prefer. .It Pa /usr/local/etc/marcusmerge.cfg Read under the .Ar VARIBLES subject above to learn more about it. Default, you will have to create it by manual. .El .Sh AUTHORS .An Joe Marcus Clarke Aq marcus@FreeBSD.org . .An Martin Klaffenboeck Aq martin.klaffenboeck@gmx.at . .An Franz Klammer Aq klammer@webonaut.com . .Pp .An This manual page was written by Jeremy Messenger Aq mezz7@cox.net . .Sh LICENCE AND DISCLAIME BSD License ------------oM0K0zMKQylQKoqwRkKtzO--