PORTCVSWEB(1) BSD General Commands Manual PORTCVSWEB(1)NAMEportcvsweb — a tool to instantly browse a history via CVSweb or Fresh‐
Ports.org
SYNOPSISportcvsweb [-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 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 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 ALSOpkgtools.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 June 13, 2006 FreeBSD