NAME

portcvsweb — a tool to instantly browse a history via CVSweb or FreshPorts.org

SYNOPSIS

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 module 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 does not 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 pattern. 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 FreshPorts.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 commits 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”.

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.