From owner-freebsd-gnome@FreeBSD.ORG Wed Oct 29 21:01:35 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 E199316A4CE for ; Wed, 29 Oct 2003 21:01:35 -0800 (PST) Received: from lakemtao07.cox.net (lakemtao07.cox.net [68.1.17.114]) by mx1.FreeBSD.org (Postfix) with ESMTP id B037D43FCB for ; Wed, 29 Oct 2003 21:01:34 -0800 (PST) (envelope-from mezz7@cox.net) Received: from mezz.mezzweb.com ([68.103.32.11]) by lakemtao07.cox.net (InterMail vM.5.01.06.05 201-253-122-130-105-20030824) with ESMTP id <20031030050132.FJUE21605.lakemtao07.cox.net@mezz.mezzweb.com>; Thu, 30 Oct 2003 00:01:32 -0500 To: Khairil Yusof References: <1067485920.2292.283.camel@wolverine.home.net> Message-ID: From: Jeremy Messenger Content-Type: multipart/mixed; boundary=----------ccrVf2POO0kMKTPyveV0l2 MIME-Version: 1.0 Date: Wed, 29 Oct 2003 23:00:47 -0600 In-Reply-To: <1067485920.2292.283.camel@wolverine.home.net> User-Agent: Opera7.21/Linux M2 build 480 cc: gnome@FreeBSD.org Subject: Re: 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 05:01:36 -0000 ------------ccrVf2POO0kMKTPyveV0l2 Content-Type: text/plain; format=flowed; charset=iso-8859-1 Content-Transfer-Encoding: 8bit On Thu, 30 Oct 2003 11:52:01 +0800, Khairil Yusof wrote: > On Thu, 2003-10-30 at 11:20, Jeremy Messenger wrote: >> 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. :-) > > Here's my first stab at it, also should there be a mention of > portupgrade?: Thanks, it looks good to me! I have update the marcusmerge.1, so here's an attach of it. Umm, portupgrade.. It's good idea, but I am not sure where I should put? Well, I am not sure thought.. BTW: CC'ing to freebsd-gnome... Oh.. I forgot to add your credit in it.. I am editing it in my local right now, so it should be in there before commit in MarcusCom CVS.. Cheers, Mezz > DESCRIPTION > The marcusmerge script automates the procedure of merging the latest > development versions of the Gnome Desktop ports from marcuscom.com cvs > repository with your current ports collection. The script can also > checkout the ports module from cvs, or download a tarball for those > behind firewalls. > > The Gnome Desktop ports from marcuscom.com repository are development > versions and a work in progress. Users are expected to help in reporting > and debugging any problems found when building and using these ports to > the FreeBSD Gnome team . > > -- > "Optimized, readable, on time; Pick any two." > > FreeBSD 5.1-CURRENT i386 > 11:32AM up 1 day, 26 mins, 4 users, load averages: 0.51, 0.50, 0.45 -- bsdforums.org 's moderator, mezz. ------------ccrVf2POO0kMKTPyveV0l2 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 The .Nm script automates the procedure of merging the latest development versions of the Gnome Desktop ports from marcuscom.com cvs repository with your current ports collection. The script can also checkout the ports module from cvs, or download a tarball for those behind firewalls. .Pp The Gnome Desktop ports from marcuscom.com repository are development versions and a work in progress. Users are expected to help in reporting and debugging any problems found when building and using these ports to the FreeBSD Gnome team .Aq gnome@freesbd.org . .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 ------------ccrVf2POO0kMKTPyveV0l2--