DragonFly On-Line Manual Pages

PORTCVSWEB(1)          DragonFly General Commands Manual         PORTCVSWEB(1)

NAME
     portcvsweb - a tool to instantly browse a history via CVSweb or
     FreshPorts.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
     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".

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                          June 13, 2006                         FreeBSD