Annotation of cvsweb/cvsweb.conf, Revision 3.1
3.1 ! knu 1: # -*-perl-*-
! 2: # Configuration of cvsweb.cgi, the
! 3: # CGI interface to CVS Repositories.
! 4: #
! 5: # (c) 1998-1999 H. Zeller <zeller@think.de>
! 6: # 1999 H. Nordstrom <hno@hem.passagen.se>
! 7: # 2000 A. MUSHA <knu@FreeBSD.org>
! 8: # based on work by Bill Fenner <fenner@FreeBSD.org>
! 9: # $Id: cvsweb.conf,v 3.1.1.1 2000/07/19 21:55:57 knu Exp $
! 10: #
! 11: ###
! 12:
! 13: ##############
! 14: # CVS Root
! 15: ##############
! 16: # CVSweb can handle several CVS-Repositories
! 17: # at once. Enter a short symbolic names and the
! 18: # full path of these repositories here.
! 19: # NOTE that the symbolic names may not contain
! 20: # whitespaces.
! 21: # Note, that cvsweb.cgi currently needs to have physical access
! 22: # to the CVS repository so :pserver:someone@xyz.com:/data/cvsroot
! 23: # won't work!
! 24:
! 25: # 'symbolic_name' 'path_to_the_actual_repository'
! 26: %CVSROOT = (
! 27: 'local' => '/home/cvs',
! 28: 'freebsd' => '/home/ncvs',
! 29: );
! 30:
! 31: %CVSROOTdescr = (
! 32: 'local' => 'Local Repository',
! 33: 'freebsd' => 'FreeBSD',
! 34: );
! 35:
! 36: # This tree is enabled by default when
! 37: # you enter the page
! 38: $cvstreedefault = 'local';
! 39:
! 40: ##############
! 41: # PR categoties
! 42: ##############
! 43: @prcategories = qw(
! 44: advocacy
! 45: alpha
! 46: bin
! 47: conf
! 48: docs
! 49: gnu
! 50: i386
! 51: kern
! 52: misc
! 53: ports
! 54: sparc
! 55: );
! 56:
! 57: ##############
! 58: # query-pr.cgi
! 59: ##############
! 60: $prcgi = "http://www.FreeBSD.org/cgi/query-pr.cgi";
! 61:
! 62: ##############
! 63: # Defaults for UserSettings
! 64: ##############
! 65: %DEFAULTVALUE = (
! 66: # sortby: File sort order
! 67: # file Sort by filename
! 68: # rev Sort by revision number
! 69: # date Sort by commit date
! 70: # author Sort by author
! 71: # log Sort by log message
! 72:
! 73: "sortby" => "file",
! 74:
! 75: # hideattic: Hide or show files in Attic
! 76: # 1 Hide files in Attic
! 77: # 0 Show files in Attic
! 78:
! 79: "hideattic" => "1",
! 80:
! 81: # logsort: Sort order for CVS logs
! 82: # date Sort revisions by date
! 83: # rev Sort revision by revision number
! 84: # cvs Don't sort them. Same order as CVS/RCS shows them.
! 85:
! 86: "logsort" => "date",
! 87:
! 88: # f: Default diff format
! 89: # h Human readable
! 90: # u Unified diff
! 91: # c Context diff
! 92: # s Side by side
! 93: "f" => "h",
! 94:
! 95: # hidecvsroot: Don't show the CVSROOT directory
! 96: # 1 Hide CVSROOT directory
! 97: # 0 Show CVSROOT directory
! 98: "hidecvsroot" => "0",
! 99:
! 100: # hidenonreadable: Don't show entries which cannot be read
! 101: # 1 Hide non-readable entries
! 102: # 0 Show non-readble entries
! 103: "hidenonreadable" => "1",
! 104: );
! 105:
! 106: ##############
! 107: # some layout stuff
! 108: ##############
! 109:
! 110: # color settings in the body-tag
! 111: $body_tag = '<body text="#000000" bgcolor="#ffffff">';
! 112:
! 113: # Wanna have a logo on the page ?
! 114: $logo = '<img src="/icons/apache_pb.gif">';
! 115:
! 116: # The title of the Page on startup
! 117: $defaulttitle = "CVS Repository";
! 118:
! 119: # The address is shown on the footer
! 120: $address = "<font size=-1>CVSweb by <zeller\@think.de></font>";
! 121:
! 122: # Default page background color for the diffs
! 123: # and annotations
! 124: $backcolor = "#eeeeee";
! 125:
! 126: # color of navigation Header for
! 127: # diffs and annotations
! 128: $navigationHeaderColor = '#9999ee';
! 129:
! 130: $long_intro = <<EOT;
! 131: <p>
! 132: This is a WWW interface for CVS Repositories.
! 133: You can browse the file hierarchy by picking directories
! 134: (which have slashes after them, <i>e.g.</i>, <b>src/</b>).
! 135: If you pick a file, you will see the revision history
! 136: for that file.
! 137: Selecting a revision number will download that revision of
! 138: the file. There is a link at each revision to display
! 139: diffs between that revision and the previous one, and
! 140: a form at the bottom of the page that allows you to
! 141: display diffs between arbitrary revisions.
! 142: </p>
! 143: <p>
! 144: This script has been written by Bill Fenner
! 145: <<a href="mailto:fenner\@freebsd.org">fenner\@freebsd.org</a>>
! 146: and improved by Henner Zeller
! 147: <<a href="mailto:zeller\@think.de">zeller\@think.de</a>>,
! 148: Henrik Nordström
! 149: <<a href="mailto:hno\@hem.passagen.se">hno\@hem.passagen.se</a>>, and
! 150: Ken Coar
! 151: <<a href="mailto:Ken.Coar\@Golux.Com">Ken.Coar\@Golux.Com</a>>, then
! 152: Akinori MUSHA <<a href="mailto:knu\@FreeBSD.org">knu\@FreeBSD.org</a>>
! 153: brought it back to FreeBSD community and added more facilities;
! 154: it is covered by the
! 155: <a href="http://www.opensource.org/licenses/bsd-license.html">BSD-Licence</a>.
! 156: </p>
! 157: <p>
! 158: If you would like to use this CGI script on your own web server and
! 159: CVS tree, see Zeller's
! 160: <a href="http://linux.fh-heilbronn.de/~zeller/cgi/cvsweb.cgi"
! 161: >CVSweb distribution site</a>. Bill's original script can be found
! 162: <a href="http://www.freebsd.org/~fenner/cvsweb/">here</a>.
! 163: </p>
! 164: <p>
! 165: Please send any suggestions, comments, etc. to
! 166: <a href="mailto:fenner\@freebsd.org">Bill Fenner</a> or, regarding the
! 167: modifications, to
! 168: <a href="mailto:knu\@FreeBSD.org">Akinori MUSHA</a>,
! 169: <a href="mailto:zeller\@think.de">Henner Zeller</a>,
! 170: <a href="mailto:hno\@hem.passagen.se">Henrik Nordström</a>, or
! 171: <a href="mailto:Ken.Coar\@Golux.Com">Ken Coar</a>.
! 172: </p>
! 173: EOT
! 174:
! 175: $short_instruction = <<EOT;
! 176: <p>
! 177: Click on a directory to enter that directory. Click on a file to display
! 178: its revision history and to get a chance to display diffs between revisions.
! 179: </p>
! 180: EOT
! 181:
! 182: # used icons; if icon-url is empty, the text representation is used; if
! 183: # you do not want to have an ugly tooltip for the icon, remove the
! 184: # text-representation.
! 185: # The width and height of the icon allow the browser to correcly display
! 186: # the table while still loading the icons.
! 187: # These default icons are coming with apache.
! 188: # If these icons are too large, check out the miniicons in the
! 189: # icons/ directory; they have a width/height of 16/16
! 190: # format: TEXT ICON-URL width height
! 191: %ICONS = (
! 192: back => [ ("[BACK]", "/icons/cvsweb/back.gif", 20, 22) ],
! 193: dir => [ ("[DIR]", "/icons/cvsweb/dir.gif", 20, 22) ],
! 194: file => [ ("[TXT]", "/icons/cvsweb/text.gif", 20, 22) ],
! 195: );
! 196:
! 197: # the length to which the last logentry should
! 198: # be truncated when shown in the directory view
! 199: $shortLogLen = 80;
! 200:
! 201: # Show author of last change
! 202: $show_author = 1;
! 203:
! 204: ##############
! 205: # table view for directories
! 206: ##############
! 207:
! 208: # Show directory as table
! 209: # this is much more readable but has one
! 210: # drawback: the whole table has to be loaded
! 211: # before common browsers display it which may
! 212: # be annoying if you have a slow link - and a
! 213: # large directory ..
! 214: $dirtable = 1;
! 215:
! 216: # show different colors for even/odd rows
! 217: @tabcolors = ('#ffffff', '#ffffff');
! 218: $tablepadding = 2;
! 219:
! 220: # Color of Header
! 221: $columnHeaderColorDefault = '#ffffcc';
! 222: $columnHeaderColorSorted = '#ffcc66';
! 223:
! 224: #
! 225: # If you want to have colored borders
! 226: # around each row, uncomment this
! 227: $tableBorderColor = '#cccccc';
! 228:
! 229: #
! 230: # Modules in the repository that should not be displayed, either by default
! 231: # nor by explicit path specification.
! 232: #
! 233: @HideModules = (
! 234: );
! 235:
! 236: #
! 237: # Use CVSROOT/CVSROOT/descriptions for describing the directories/modules
! 238: # See INSTALL section 8
! 239: #
! 240: $use_descriptions = 0;
! 241:
! 242: ##############
! 243: # Human Readable Diff
! 244: ##############
! 245:
! 246: # (c) 1998 H. Zeller <zeller@think.de>
! 247: #
! 248: # Generates two columns of color encoded
! 249: # diff; much like xdiff or emacs-ediff mode.
! 250: #
! 251: # The diff-stuff is a piece of code I once made for
! 252: # cvs2html which is under GPL,
! 253: # see http://www.sslug.dk/cvs2html
! 254: # (c) 1997/98 Peter Toft <pto@sslug.imm.dtu.dk>
! 255: #
! 256: # some parameters to screw:
! 257: ##
! 258:
! 259: # make lines breakable so that the columns do not
! 260: # exceed the width of the browser
! 261: $hr_breakable = 1;
! 262:
! 263: # give out function names in human readable diffs
! 264: # this just makes sense if we have C-files, otherwise
! 265: # diff's heuristic doesn't work well ..
! 266: # ( '-p' option to diff)
! 267: $hr_funout = 0;
! 268:
! 269: # For each pair of regexps, files that match the first regexp will be diff'ed
! 270: # with an '-F' option with the second regexp.
! 271: %functionlineregexp = (
! 272: "\\.(4th|fr)\$" => "\\(^\\| \\|\t\\): ",
! 273: );
! 274:
! 275: # ignore whitespaces for human readable diffs
! 276: # (indendation and stuff ..)
! 277: # ( '-w' option to diff)
! 278: $hr_ignwhite = 1;
! 279:
! 280: # ignore diffs which are caused by
! 281: # keyword-substitution like $Id - Stuff
! 282: # ( '-kk' option to rcsdiff)
! 283: $hr_ignkeysubst = 1;
! 284:
! 285: # Colors and font to show the diff type of code changes
! 286: $diffcolorHeading = '#99cccc'; # color of 'Line'-head of each diffed file
! 287: $diffcolorEmpty = '#cccccc'; # color of 'empty' lines
! 288: $diffcolorRemove = '#ff9999'; # Removed line(s) (left) ( - )
! 289: $diffcolorChange = '#99ff99'; # Changed line(s) ( both )
! 290: $diffcolorAdd = '#ccccff'; # Added line(s) ( - ) (right)
! 291: $diffcolorDarkChange = '#99cc99'; # lines, which are empty in change
! 292: $difffontface = "Helvetica,Arial";
! 293: $difffontsize = "-1";
! 294:
! 295: # the width of the textinput of the
! 296: # request-diff-form
! 297: $inputTextSize = 12;
! 298:
! 299: ##############
! 300: # Mime Types
! 301: ##############
! 302:
! 303: # mapping to mimetypes to help
! 304: # cvsweb to guess the correct mime-type on
! 305: # checkout; you can use the mime.types from
! 306: # apache here:
! 307: $mime_types = '/usr/local/etc/apache/mime.types';
! 308:
! 309: # quick mime-type lookup; maps file-suffices to
! 310: # mime-types for displaying checkouts in the browser.
! 311: # Further MimeTypes will be found in the
! 312: # file $mime_types (apache style mime.types - file)
! 313: # - add common mappings here for faster lookup
! 314: %MTYPES = (
! 315: "html" => "text/html",
! 316: "shtml" => "text/html",
! 317: "gif" => "image/gif",
! 318: "jpeg" => "image/jpeg",
! 319: "jpg" => "image/jpeg",
! 320: "*" => "text/plain",
! 321: );
! 322:
! 323: ##############
! 324: # Misc
! 325: ##############
! 326: # allow annotation of files
! 327: # this requires rw-access to the
! 328: # CVSROOT/history - file and rw-access
! 329: # to the subdirectory to place the lock
! 330: # so you maybe don't want it
! 331: $allow_annotate = 1;
! 332:
! 333: # allow pretty-printed version of files
! 334: $allow_markup = 1;
! 335:
! 336: # allow compression with gzip
! 337: # of output if the Browser accepts
! 338: # it (HTTP_ACCEPT_ENCODING=gzip)
! 339: # [make sure to have gzip in the path]
! 340: $allow_compress = 1;
! 341:
! 342: # Make use of javascript functions.
! 343: # This way you can select one of your CVSroot
! 344: # without pressing 'Go' (.. if you do have more
! 345: # than one CVSROOT defined)
! 346: $use_java_script = 1;
! 347:
! 348: # open Download-Links in another window
! 349: $open_extern_window = 1;
! 350:
! 351: # The size of this extern window; this size option
! 352: # needs use_java_script to be defined
! 353: # just comment them if you don't want to have a fixed
! 354: # size
! 355: #$extern_window_width = 600;
! 356: #$extern_window_height = 440;
! 357:
! 358: # Edit Options
! 359: # Enable form to edit your options (hideattic,sortbydate)
! 360: # this isn't necessary if you've $dirtable defined 'cause
! 361: # this allows editing of all your options more intuitive
! 362: $edit_option_form = (not $dirtable);
! 363:
! 364: # remember to set the path to your
! 365: # rcsutils: rlog, rcsdiff (gzip if you use compression)
! 366: #$ENV{'PATH'} = '/usr/local/bin';
! 367:
! 368: # If you have files which automatically refers to other files
! 369: # (such as HTML) then this allows you to browse the checked
! 370: # out files as if outside CVS.
! 371: $checkout_magic = 1;
! 372:
! 373: # Show last changelog message for sub directories
! 374: # The current implementation makes many assumptions and may show the
! 375: # incorrect file at some times. The main assumption is that the last
! 376: # modified file has the newest filedate. But some CVS operations
! 377: # touches the file without even when a new version is't checked in,
! 378: # and TAG based browsing essientially puts this out of order, unless
! 379: # the last checkin was on the same tag as you are viewing.
! 380: # Enable this if you like the feature, but don't rely on correct results.
! 381: $show_subdir_lastmod = 0;
! 382:
! 383: # Background color of logentry in markup
! 384: $markupLogColor = "#ffffff";
! 385:
! 386: # Show CVS log when viewing file contents
! 387: $show_log_in_markup = 1;
! 388:
! 389: # Tabstop used to expand tabs in colored diffs. If undefined then
! 390: # tabs are always expanded to 8 spaces.
! 391: $tabstop = 8;
! 392:
! 393: # if you wish to display absolute times in your local timezone,
! 394: # then define mytz and fill in the strings for your standard and
! 395: # daylight time. Note that you must also make sure the system
! 396: # timezone is correctly set.
! 397: # @mytz=("EST", "EDT");
! 398:
! 399: # cvsweb is friendly to caches by indicating a suitable
! 400: # last-modified timestamp. Doing this uses slightly more
! 401: # CPU so you might want to disable it if you have a slow
! 402: # server
! 403: $use_moddate = 1;
! 404:
! 405: #EOF
CVSweb