Annotation of cvsweb/README, Revision 4.8
4.8 ! schwarze 1: $Id: README,v 4.7 2019/11/11 15:46:39 schwarze Exp $
4.2 schwarze 2: $knu: README,v 1.9 2006/06/22 22:25:27 linimon
3.3 scop 3:
4.3 schwarze 4: CVSweb is a WWW interface for CVS repositories.
3.3 scop 5:
3.5 scop 6: CVSweb was originally written by Bill Fenner and improved by Henner
7: Zeller, Henrik Nordström, and Ken Coar, then Akinori MUSHA brought
8: it back to FreeBSD community and made further improvements. Ville
4.1 schwarze 9: Skyttä continued that work; after that, the project was briefly
10: maintained by Jonathan Noack <noackjr@alumni.rice.edu>.
3.5 scop 11:
12: To track the development, access the MAIN branch of the module
4.1 schwarze 13: `cvsweb' in the mandoc.bsd.lv CVS repository. For legacy 2.x
14: versions, see the branch named 'FreeBSD-cvsweb-2_0-branch'.
3.3 scop 15:
16: Project home page:
4.3 schwarze 17: <http://cvsweb.bsd.lv/>
3.3 scop 18:
19: Repository access:
4.1 schwarze 20: <http://mandoc.bsd.lv/anoncvs.html>
3.3 scop 21:
22: CVSweb of CVSweb:
4.1 schwarze 23: <http://mandoc.bsd.lv/cgi-bin/cvsweb/?cvsroot=cvsweb>
3.3 scop 24:
25: Release archives:
4.3 schwarze 26: <http://cvsweb.bsd.lv/release/>
3.3 scop 27: <http://people.FreeBSD.org/~scop/cvsweb/>
28:
4.1 schwarze 29: A mailing list used to exist at the following place,
30: but was deleted in 2014 or maybe even earlier:
3.3 scop 31: <freebsd-cvsweb@FreeBSD.org>
32: <http://lists.freebsd.org/mailman/listinfo/freebsd-cvsweb>
33:
34: Here is the list of added features over Zeller's version:
35:
36: o Customizable "show functions" option
37: You can specify a regexp for each file type to teach rcsdiff(1) to
38: recognize function lines.
39:
40: o Improved support for text-based browsers
41: Unidiff is the default format for diffs, for text-based browsers.
42:
43: o Enhanced PR # hyperlinking.
44: The following styles are supported.
45:
46: PR: 12345, 67890, ..
47:
48: PR: #12345, #67890, ..
49:
50: PR# sparc/12345, i386/67890
51:
52: PR: ports/43210
53: kern/98765
54:
55: .. is related to bin/4567, which is ...
56:
57: o Manpage hyperlinking.
58: Both `cat(1)' and `cat.1' styles are supported.
59:
60: o Revision numbers hyperlinking in annotation.
61:
62: o Automatic tarball generation. (Obtained from Debian)
63:
64: o Automatic zipball generation.
65:
66: o Customizable repository entry order.
67:
68: o Location text field.
69:
70: o Support for the use of localized charsets.
71:
72: o Workaround for buggy web servers.
73:
74: o Numerous bugfixes regarding URI/filename manipulation.
75:
76: o HTML improvements, XHTML 1.0 Transitional, and a separate CSS file for
77: presentation.
78:
79: o Security fixes to let it work under perl -T.
80:
81: o Annotate works under mod_perl and against a read only repository.
3.6 scop 82:
3.3 scop 83: o Line number output for HTMLized views.
84:
85: o Support for showing README.cvs.html and README.cvs akin to Apache's
86: FancyIndexes.
87:
88: o Support for external diff tools.
89:
90: o Works with mod_perl >= 1.99_11 as well as 1.2x.
91:
3.5 scop 92: o ...and much more! See NEWS for high level changes between releases.
93:
94: See also README, as well as TODO for new features under consideration
95: and development.
3.3 scop 96:
97: -------------------------------------------------------------------------------
98: The original Zeller README follows (possibly outdated to some extent):
99: -------------------------------------------------------------------------------
3.2 scop 100:
3.1 knu 101: The cgi-script cvsweb.cgi is written by Bill Fenner <fenner@freebsd.org>
102: (see [1]) for the freebsd project. It allows browsing of
103: CVS-repositories (see [2]) with an HTML-browser.
104:
105: This version is based on Bill's script and is hacked to fit our needs,
106: so don't blame him if anything doesn't work ..
107:
108: Added features:
109: - a colored side by side diff
110: - easier navigation
111: - mime-type aware checkout which allows for browsing
112: of version controlled HTML-pages
113: - easier configuration - everything configurable is in one
114: external file now
115: - added cvs-annotate - this requires cvs >= 1.9
116: (tested with cvs 1.10)
117: - a better way of viewing timestamps: they're shown as age
118: (something like 'changed 2 days 4 hours ago')
119: - sorting by filename / age - just click on the corresponding
120: column
121: - urlencodes all filenames so files with spaces and special
122: characters in their names are viewable as well.
123: - selectionbox for choosing different CVS-roots
124: - overview of last revisionnumber, age and logentry in the
125: directory view
126: - you can check out the current revision of a file if you are
127: in the directory view (idea from Nick Brachet)
128: - gzip'ed output if the browser accepts this; this can reduce the
129: size (and download time) by a factor of 4 (directory view) to
130: 10 (colored diff; the size of the colored diff could be reduced
131: with CSS .. anyone ?). The use of gzip has been in the very first
132: version of cvsweb (by Bill Fenner), but has been removed because
133: it wasn't easy to determine if a browser actually understands it. Today
134: the browsers state if they accept the Content-encoding gzip..
135: .. but MSIE lies about this (so cvsweb disables gzip-encoding in this
136: case).
137: - Tag based browsing. An easy and what I think intuitive way to browse a
138: CVS tree based on tags, with filtering of files and CVS logs to only
139: show whats relevant for the selected tag.
140: - "Pretty-printed" checkouts for text based files. My intention is to
141: eventually add cross-referencing to this, but for now the file is only
142: converted to HTML with automatic detection of various links.
143: - "Click-on-version" diff selection.
144: - sorting for every column now
145: - uses 'cvs co' for checkout instead of rcs co
146: - Ability to show directory descriptions from CVSROOT/descriptions
147:
148: cvsweb.cgi became quite huge now and is bad style code (I am not a
149: perl-programmer - this is what I do in my spare time!) so this
150: should be rewritten.
151:
152: And what about using mod_perl, and rewriting it into a set of proper Perl-5
153: modules?
154:
155: This software is distributed under the terms of the BSD-licence.
156:
157: You can download the latest version at
3.2 scop 158: <http://stud.fh-heilbronn.de/~zeller/cgi/cvsweb.cgi/>
3.1 knu 159:
160: or get it directly with cvs at
161: CVSROOT: :pserver:anonymous@cvs.stud.fh-heilbronn.de:/cvsroot/public
162: Password: anonymous
163: Module: cvsweb
164:
165: Please send suggestions, bugs etc to
166: Henner Zeller <zeller@think.de>
167: or
168: Henrik Nordstrom <hno@hem.passagen.se>
169:
170: -- refs
171: [1] for the original Version of cvsweb.cgi, see
172: <http://www.freebsd.org/~fenner/cvsweb/>
3.7 scop 173: [2] for cvs, see <http://www.nongnu.org/cvs/>
CVSweb
![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to README CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [cvsweb.bsd.lv] / cvsweb