Annotation of cvsweb/README, Revision 3.1
3.1 ! knu 1: The cgi-script cvsweb.cgi is written by Bill Fenner <email@example.com>
! 2: (see ) for the freebsd project. It allows browsing of
! 3: CVS-repositories (see ) with an HTML-browser.
! 5: This version is based on Bill's script and is hacked to fit our needs,
! 6: so don't blame him if anything doesn't work ..
! 8: Added features:
! 9: - a colored side by side diff
! 10: - easier navigation
! 11: - mime-type aware checkout which allows for browsing
! 12: of version controlled HTML-pages
! 13: - easier configuration - everything configurable is in one
! 14: external file now
! 15: - added cvs-annotate - this requires cvs >= 1.9
! 16: (tested with cvs 1.10)
! 17: - a better way of viewing timestamps: they're shown as age
! 18: (something like 'changed 2 days 4 hours ago')
! 19: - sorting by filename / age - just click on the corresponding
! 20: column
! 21: - urlencodes all filenames so files with spaces and special
! 22: characters in their names are viewable as well.
! 23: - selectionbox for choosing different CVS-roots
! 24: - overview of last revisionnumber, age and logentry in the
! 25: directory view
! 26: - you can check out the current revision of a file if you are
! 27: in the directory view (idea from Nick Brachet)
! 28: - gzip'ed output if the browser accepts this; this can reduce the
! 29: size (and download time) by a factor of 4 (directory view) to
! 30: 10 (colored diff; the size of the colored diff could be reduced
! 31: with CSS .. anyone ?). The use of gzip has been in the very first
! 32: version of cvsweb (by Bill Fenner), but has been removed because
! 33: it wasn't easy to determine if a browser actually understands it. Today
! 34: the browsers state if they accept the Content-encoding gzip..
! 35: .. but MSIE lies about this (so cvsweb disables gzip-encoding in this
! 36: case).
! 37: - Tag based browsing. An easy and what I think intuitive way to browse a
! 38: CVS tree based on tags, with filtering of files and CVS logs to only
! 39: show whats relevant for the selected tag.
! 40: - "Pretty-printed" checkouts for text based files. My intention is to
! 41: eventually add cross-referencing to this, but for now the file is only
! 42: converted to HTML with automatic detection of various links.
! 43: - "Click-on-version" diff selection.
! 44: - sorting for every column now
! 45: - uses 'cvs co' for checkout instead of rcs co
! 46: - Ability to show directory descriptions from CVSROOT/descriptions
! 48: cvsweb.cgi became quite huge now and is bad style code (I am not a
! 49: perl-programmer - this is what I do in my spare time!) so this
! 50: should be rewritten.
! 52: I'd propose a Java-servlet which could use the C/S-protocol .. anyone ?
! 54: And what about using mod_perl, and rewriting it into a set of proper Perl-5
! 55: modules?
! 57: This software is distributed under the terms of the BSD-licence.
! 59: You can download the latest version at
! 60: <http://linux.stud.fh-heilbronn.de/~zeller/cgi/cvsweb.cgi/>
! 62: or get it directly with cvs at
! 63: CVSROOT: :pserver:firstname.lastname@example.org:/cvsroot/public
! 64: Password: anonymous
! 65: Module: cvsweb
! 67: Please send suggestions, bugs etc to
! 68: Henner Zeller <email@example.com>
! 69: or
! 70: Henrik Nordstrom <firstname.lastname@example.org>
! 72: -- refs
! 73:  for the original Version of cvsweb.cgi, see
! 74: <http://www.freebsd.org/~fenner/cvsweb/>
! 75:  for cvs, see <http://www.cyclic.com/>