PORTCVSWEB(1)		FreeBSD General Commands Manual 	 PORTCVSWEB(1)

NAME
     portcvsweb -- a tool to instantly browse a history via CVSweb or Fresh-
     Ports.org

SYNOPSIS
     portcvsweb [-qv] [pkgname_glob] | [ports_glob] | [file] | [directory] |

		[cvs_module_alias] | [dead port]
     portcvsweb -F [-qv] [--datespec[=DATESPEC]] [pkgname_glob] | [ports_glob]

		| [file] | [directory] | [cvs_module_alias] | [dead port]
     portcvsweb -h | --help

DESCRIPTION
     The portcvsweb command invokes the first available web browser in w3m,
     lynx, links, firefox, mozilla and netscape (or the ones listed in BROWSER
     if set) to view the CVS history of a given port, file, directory, or mod-
     ule via the CVSweb or FreshPorts.org.  If no file is given, the current
     directory is assumed.

     To detect which repository the file/directory belongs and what revision
     it is, portcvsweb reads the CVS/* files if found, or scans the given file
     for a CVS tag.  If the file does not contain a CVS tag, it scans the
     Makefile in the directory.  If yet there is no Makefile in the directory,
     it moves up through the directory hierarchy until it finds one.

     If the given path doesn't exist in the first place, portcvsweb assumes it
     should be under the ports tree, which assumption allows specifying a
     deleted ports directory/file.

     Currently portcvsweb recognizes FreeBSD, NetBSD and OpenBSD tags, and the
     one whichever comes first is used.

OPTIONS
     The following command line arguments are supported:

     pkgname_glob
     portorigin_glob	    Pick the first port that matched the given pat-
			    tern.  See pkg_glob(1) and portorigin_glob(1) for
			    details and concrete examples.

     file
     directory		    Pick the file or the directory if it exists.
     cvs_module_alias
     dead port		    recognizes these too.

     -h
     --help		    Show help and exit.

     -F
     --freshports	    FreshPorts mode. View CVS history via Fresh-
			    Ports.org instead of CVSweb.

     --datespec[=DATESPEC]  (FreshPorts mode only) View the commit of the day
			    specified by DATESPEC via FreshPorts. When
			    DATESPEC is omittied, view the commits of today.
			    When DATESPEC is a negative value, view the com-
			    mits of DATESPEC days before.

     -q
     --noconfig 	    Do not read the configuration file -
			    $PREFIX/etc/pkgtools.conf.

     -v
     --verbose		    Turn on verbose output.

EXAMPLES OF FRESHPORTS MODE
     When invoked with -F option, view CVS history via FreshPorts.org instead
     of CVSweb.

	   % portcvsweb -F
	   => http://www.FreshPorts.org/


	   % portcvsweb -F japanese/kterm
	   => http://www.FreshPorts.org/japanese/kterm


     When --datespec is also supplied, view the commits of specified day.

	   % portcvsweb -F --datespec=0405
	   => http://www.FreshPorts.org/date.php?date=2005/04/05

	   % portcvsweb -F --datespec=04/05
	   => http://www.FreshPorts.org/date.php?date=2005/04/05

	   % portcvsweb -F --datespec=20030405
	   => http://www.FreshPorts.org/date.php?date=2003/04/05

	   % portcvsweb -F --datespec=2003/04/05
	   => http://www.FreshPorts.org/date.php?date=2003/04/05

	   % portcvsweb -F --datespec=2003-04-05
	   => http://www.FreshPorts.org/date.php?date=2003/04/05

     Without DATESPEC , view the commits of today.

	   % date -u
	   Sun Jan 1 03:47:59 UTC 2006
	   % portcvsweb -F --datespec
	   => http://www.FreshPorts.org/date.php?date=2006/01/01

     When DATESPEC is a negative value, view the commits of DATESPEC days
     before.

	   % portcvsweb -F --datespec=-3
	   => http://www.FreshPorts.org/date.php?date=2005/12/29


ENVIRONMENT
     BROWSER  Alternative WWW browser.	Default is
	      ``w3m:lynx:links:firefox:mozilla:netscape''.

SEE ALSO
     pkgtools.conf(5), ports(7)

AUTHORS
     Akinori MUSHA <knu@iDaemons.org>

BUGS
     Since a NetBSD or OpenBSD tag does not contain a path component, when
     portcvsweb detects a NetBSD or OpenBSD tag but there is no CVS/* files in
     the directory, it assumes that it belongs to NetBSD pkgsrc or OpenBSD
     ports.

FreeBSD 			August 11, 2001 		       FreeBSD

NAME - SYNOPSIS - DESCRIPTION - OPTIONS - EXAMPLES OF FRESHPORTS MODE - 
ENVIRONMENT - SEE ALSO - AUTHORS - BUGS -