Annotation of cvsweb/cvsweb.conf, Revision 3.36.2.12
3.1 knu 1: # -*-perl-*-
3.36.2.12! schwarze 2: # $Id: cvsweb.conf,v 3.36.2.11 2019/03/21 22:18:40 schwarze Exp $
! 3: # $knu: cvsweb.conf,v 1.36.2.3 2002/09/23 05:30:17 scop
! 4: #
3.1 knu 5: # Configuration of cvsweb.cgi, the
6: # CGI interface to CVS Repositories.
7: #
8: # (c) 1998-1999 H. Zeller <zeller@think.de>
9: # 1999 H. Nordstrom <hno@hem.passagen.se>
3.30 knu 10: # 2000-2002 A. MUSHA <knu@FreeBSD.org>
3.32 scop 11: # 2002 V. Skyttä <scop@FreeBSD.org>
3.1 knu 12: # based on work by Bill Fenner <fenner@FreeBSD.org>
13:
3.19 knu 14: # Set the path for the following commands:
15: # uname, cvs, rlog, rcsdiff
16: # gzip (if you enable $allow_compress)
3.25 knu 17: # tar, rm, zip (if you enable $allow_tar)
3.19 knu 18: $command_path = '/bin:/usr/bin:/usr/local/bin';
19:
20: # Search the above directories for each command
3.25 knu 21: for (qw(uname cvs rlog rcsdiff gzip tar rm zip)) {
3.26 knu 22: $CMD{$_} = search_path($_);
3.19 knu 23: }
24:
25: # The name of the operating system implementation
3.21 knu 26: chomp($uname = `$CMD{uname}`);
3.19 knu 27:
3.1 knu 28: ##############
29: # CVS Root
30: ##############
31: # CVSweb can handle several CVS-Repositories
32: # at once. Enter a short symbolic names and the
33: # full path of these repositories here.
34: # NOTE that the symbolic names may not contain
35: # whitespaces.
36: # Note, that cvsweb.cgi currently needs to have physical access
37: # to the CVS repository so :pserver:someone@xyz.com:/data/cvsroot
38: # won't work!
39:
3.17 knu 40: # 'symbolic_name' => ['name_to_display', 'path_to_the_actual_repository']
41: # Listed in the order specified:
42: @CVSrepositories = (
3.26 knu 43: 'local' => ['Local Repository', '/home/cvs'],
44: # 'freebsd' => ['FreeBSD', '/home/ncvs'],
45: # 'openbsd' => ['OpenBSD', '/home/ncvs'],
46: # 'netbsd' => ['NetBSD', '/home/ncvs'],
47: # 'ruby' => ['Ruby', '/var/anoncvs/ruby'],
48: );
3.1 knu 49:
50: # This tree is enabled by default when
51: # you enter the page
3.26 knu 52: $cvstreedefault = $CVSrepositories[2 * 0]; # The first one
3.1 knu 53:
54: ##############
3.15 knu 55: # Bug tracking system options
56: # ("PR" means Problem Report, as in GNATS)
3.1 knu 57: ##############
3.15 knu 58: #@prcategories = qw(
3.26 knu 59: # advocacy
60: # alpha
61: # bin
62: # conf
63: # docs
64: # gnu
65: # i386
66: # kern
67: # misc
68: # pending
69: # ports
70: # sparc
71: #);
72:
3.15 knu 73: #
74: #$prcgi = "http://www.FreeBSD.org/cgi/query-pr.cgi?pr=%s";
75: #
76: #$prkeyword = "PR";
3.1 knu 77:
78: ##############
3.15 knu 79: # Manual gateway
3.8 knu 80: ##############
3.36.2.6 schwarze 81: $mancgi = "https://man.openbsd.org/%s.%s";
3.1 knu 82:
83: ##############
84: # Defaults for UserSettings
85: ##############
86: %DEFAULTVALUE = (
3.26 knu 87:
88: # sortby: File sort order
89: # file Sort by filename
90: # rev Sort by revision number
91: # date Sort by commit date
92: # author Sort by author
93: # log Sort by log message
94:
95: "sortby" => "file",
96:
97: # hideattic: Hide or show files in Attic
98: # 1 Hide files in Attic
99: # 0 Show files in Attic
100:
101: "hideattic" => "1",
102:
103: # logsort: Sort order for CVS logs
104: # date Sort revisions by date
105: # rev Sort revision by revision number
106: # cvs Don't sort them. Same order as CVS/RCS shows them.
107:
108: "logsort" => "date",
109:
110: # f: Default diff format
111: # h Human readable
112: # u Unified diff
113: # c Context diff
114: "f" => "u",
115:
116: # hidecvsroot: Don't show the CVSROOT directory
117: # 1 Hide CVSROOT directory
118: # 0 Show CVSROOT directory
119: "hidecvsroot" => "0",
120:
121: # hidenonreadable: Don't show entries which cannot be read
122: # 1 Hide non-readable entries
123: # 0 Show non-readable entries
124: "hidenonreadable" => "1",
3.1 knu 125: );
126:
127: ##############
128: # some layout stuff
129: ##############
130:
3.9 knu 131: # The body-tag for directory views and logs
3.1 knu 132: $body_tag = '<body text="#000000" bgcolor="#ffffff">';
133:
3.9 knu 134: # The body-tag for diffs and annotations
135: $body_tag_for_src = '<body text="#000000" bgcolor="#eeeeee">';
136:
3.1 knu 137: # Wanna have a logo on the page ?
3.36.2.10 schwarze 138: #$logo = '<p><img src="/icons/apache_pb.gif" alt="Powered by Apache"></p>';
139: $logo = '';
3.1 knu 140:
3.34 scop 141: # The title of the Page on startup. This will be put inside a <h1> tag.
3.1 knu 142: $defaulttitle = "CVS Repository";
143:
3.34 scop 144: # The address is shown on the footer. This will be put inside a <address> tag.
3.36.2.11 schwarze 145: $address = '<span style="font-size: smaller"><a href="https://mandoc.bsd.lv/cvsweb/">CVSweb</a></span>';
3.1 knu 146:
147: # color of navigation Header for
148: # diffs and annotations
149: $navigationHeaderColor = '#9999ee';
150:
151: $long_intro = <<EOT;
152: <p>
153: This is a WWW interface for CVS Repositories.
154: You can browse the file hierarchy by picking directories
155: (which have slashes after them, <i>e.g.</i>, <b>src/</b>).
156: If you pick a file, you will see the revision history
157: for that file.
158: Selecting a revision number will download that revision of
159: the file. There is a link at each revision to display
160: diffs between that revision and the previous one, and
161: a form at the bottom of the page that allows you to
162: display diffs between arbitrary revisions.
163: </p>
164: EOT
165:
166: $short_instruction = <<EOT;
167: <p>
168: Click on a directory to enter that directory. Click on a file to display
3.32 scop 169: its revision history and to get a chance to display diffs between revisions.
3.1 knu 170: </p>
171: EOT
172:
173: # used icons; if icon-url is empty, the text representation is used; if
174: # you do not want to have an ugly tooltip for the icon, remove the
175: # text-representation.
176: # The width and height of the icon allow the browser to correcly display
177: # the table while still loading the icons.
178: # These default icons are coming with apache.
179: # If these icons are too large, check out the miniicons in the
180: # icons/ directory; they have a width/height of 16/16
3.36.2.9 schwarze 181: my $iconsdir = "/cvsweb/icons";
3.26 knu 182:
3.15 knu 183: # format: TEXT ICON-URL width height
3.26 knu 184: %ICONS = (
185: back => [("[BACK]", "$iconsdir/back.gif", 20, 22)],
186: dir => [("[DIR]", "$iconsdir/dir.gif", 20, 22)],
187: file => [("[TXT]", "$iconsdir/text.gif", 20, 22)],
188: );
3.15 knu 189: undef $iconsdir;
3.1 knu 190:
191: # the length to which the last logentry should
192: # be truncated when shown in the directory view
193: $shortLogLen = 80;
194:
195: # Show author of last change
196: $show_author = 1;
197:
198: ##############
199: # table view for directories
200: ##############
201:
202: # Show directory as table
203: # this is much more readable but has one
204: # drawback: the whole table has to be loaded
205: # before common browsers display it which may
206: # be annoying if you have a slow link - and a
207: # large directory ..
208: $dirtable = 1;
209:
210: # show different colors for even/odd rows
211: @tabcolors = ('#ffffff', '#ffffff');
212: $tablepadding = 2;
213:
214: # Color of Header
215: $columnHeaderColorDefault = '#ffffcc';
216: $columnHeaderColorSorted = '#ffcc66';
217:
218: #
219: # If you want to have colored borders
220: # around each row, uncomment this
221: $tableBorderColor = '#cccccc';
222:
223: #
224: # Modules in the repository that should not be displayed, either by default
225: # nor by explicit path specification.
226: #
3.27 knu 227: @HideModules = (
228: # "^my/secret/module",
229: );
230:
231: #
232: # Files matching these pathnames shouldn't be checked out with cvsweb,
233: # since they may contain sensitive information. Simple file name based
234: # filter. Often, the CVSROOT/passwd is exposed and some people tend
235: # to check in their .cvspass, though this is a bad idea. These files
236: # shouldn't be readable by default. Thanks to Damian Gryski to point
237: # this out.
3.36 scop 238: # Note that this affects only files, not directories.
3.27 knu 239: @ForbiddenFiles = (
240: "^CVSROOT/passwd\$", # CVSROOT/passwd should not be cvs add'ed, though
241: "/\\.cvspass\$", # Ditto. Just in case.
242: );
3.1 knu 243:
244: #
245: # Use CVSROOT/CVSROOT/descriptions for describing the directories/modules
246: # See INSTALL section 8
247: #
248: $use_descriptions = 0;
249:
250: ##############
251: # Human Readable Diff
252: ##############
253:
254: # (c) 1998 H. Zeller <zeller@think.de>
255: #
256: # Generates two columns of color encoded
257: # diff; much like xdiff or emacs-ediff mode.
258: #
259: # The diff-stuff is a piece of code I once made for
260: # cvs2html which is under GPL,
261: # see http://www.sslug.dk/cvs2html
262: # (c) 1997/98 Peter Toft <pto@sslug.imm.dtu.dk>
263: #
264: # some parameters to screw:
265: ##
266:
267: # make lines breakable so that the columns do not
268: # exceed the width of the browser
269: $hr_breakable = 1;
270:
3.4 knu 271: # give out function names in diffs
3.1 knu 272: # this just makes sense if we have C-files, otherwise
273: # diff's heuristic doesn't work well ..
274: # ( '-p' option to diff)
3.4 knu 275: $showfunc = 1;
3.1 knu 276:
277: # ignore whitespaces for human readable diffs
278: # (indendation and stuff ..)
279: # ( '-w' option to diff)
3.7 knu 280: $hr_ignwhite = 0;
3.1 knu 281:
282: # ignore diffs which are caused by
283: # keyword-substitution like $Id - Stuff
284: # ( '-kk' option to rcsdiff)
285: $hr_ignkeysubst = 1;
286:
287: # Colors and font to show the diff type of code changes
3.26 knu 288: $diffcolorHeading = '#99cccc'; # color of 'Line'-head of each diffed file
289: $diffcolorEmpty = '#cccccc'; # color of 'empty' lines
290: $diffcolorRemove = '#ff9999'; # Removed line(s) (left) ( - )
291: $diffcolorChange = '#99ff99'; # Changed line(s) ( both )
292: $diffcolorAdd = '#ccccff'; # Added line(s) ( - ) (right)
293: $diffcolorDarkChange = '#99cc99'; # lines, which are empty in change
294: $difffontface = "Helvetica,Arial";
295: $difffontsize = "-1";
3.1 knu 296:
297: # the width of the textinput of the
298: # request-diff-form
299: $inputTextSize = 12;
300:
301: ##############
302: # Mime Types
303: ##############
304:
305: # mapping to mimetypes to help
306: # cvsweb to guess the correct mime-type on
307: # checkout; you can use the mime.types from
308: # apache here:
3.36.2.7 schwarze 309: $mime_types = '/conf/mime.types';
3.1 knu 310:
311: # quick mime-type lookup; maps file-suffices to
312: # mime-types for displaying checkouts in the browser.
313: # Further MimeTypes will be found in the
314: # file $mime_types (apache style mime.types - file)
315: # - add common mappings here for faster lookup
316: %MTYPES = (
3.26 knu 317: "html" => "text/html",
318: "shtml" => "text/html",
319: "gif" => "image/gif",
320: "jpeg" => "image/jpeg",
321: "jpg" => "image/jpeg",
322: "png" => "image/png",
323: "xpm" => "image/xpm",
324: "*" => "text/plain",
325: );
3.11 knu 326:
327: # Charset for HTML output
3.13 knu 328: $charset = '';
3.26 knu 329:
3.13 knu 330: # e.g.
331: #$charset = $where =~ m,/ru[/_-], ? 'koi8-r'
332: # : $where =~ m,/zh[/_-], ? 'big5'
333: # : $where =~ m,/ja[/_-], ? 'x-euc-jp'
334: # : $where =~ m,/ko[/_-], ? 'x-euc-kr'
335: # : 'iso-8859-1';
3.29 knu 336:
337: # Output filter
338: $output_filter = '';
339:
340: # e.g.
341: ## unify/convert Japanese code into EUC-JP
342: #$output_filter= '/usr/local/bin/nkf -e';
3.1 knu 343:
344: ##############
345: # Misc
346: ##############
347: # allow annotation of files
348: # this requires rw-access to the
3.12 knu 349: # CVSROOT/history file (if you have one)
350: # and rw-access to the subdirectory to
351: # place the lock so you maybe don't want it
3.1 knu 352: $allow_annotate = 1;
353:
354: # allow pretty-printed version of files
355: $allow_markup = 1;
356:
3.31 knu 357: # allow extra hlink formatting (such as PR xrefs) in logs
358: $allow_log_extra = 1; # default: enabled
359:
360: # allow extra hlink formatting (such as PR xrefs) in directories
361: $allow_dir_extra = 1;
362:
363: # allow extra hlink formatting in source code/formatted diff views
364: $allow_source_extra = 1;
365:
3.1 knu 366: # allow compression with gzip
367: # of output if the Browser accepts
368: # it (HTTP_ACCEPT_ENCODING=gzip)
369: # [make sure to have gzip in the path]
3.16 knu 370: $allow_compress = 0;
3.1 knu 371:
372: # Make use of javascript functions.
373: # This way you can select one of your CVSroot
374: # without pressing 'Go' (.. if you do have more
375: # than one CVSROOT defined)
376: $use_java_script = 1;
377:
378: # open Download-Links in another window
379: $open_extern_window = 1;
380:
381: # The size of this extern window; this size option
382: # needs use_java_script to be defined
383: # just comment them if you don't want to have a fixed
384: # size
385: #$extern_window_width = 600;
386: #$extern_window_height = 440;
387:
388: # Edit Options
389: # Enable form to edit your options (hideattic,sortbydate)
390: # this isn't necessary if you've $dirtable defined 'cause
391: # this allows editing of all your options more intuitive
392: $edit_option_form = (not $dirtable);
393:
394: # If you have files which automatically refers to other files
395: # (such as HTML) then this allows you to browse the checked
396: # out files as if outside CVS.
397: $checkout_magic = 1;
398:
399: # Show last changelog message for sub directories
400: # The current implementation makes many assumptions and may show the
401: # incorrect file at some times. The main assumption is that the last
402: # modified file has the newest filedate. But some CVS operations
403: # touches the file without even when a new version is't checked in,
404: # and TAG based browsing essientially puts this out of order, unless
405: # the last checkin was on the same tag as you are viewing.
406: # Enable this if you like the feature, but don't rely on correct results.
407: $show_subdir_lastmod = 0;
408:
409: # Background color of logentry in markup
410: $markupLogColor = "#ffffff";
411:
412: # Show CVS log when viewing file contents
413: $show_log_in_markup = 1;
414:
3.13 knu 415: # Preformat when viewing file contents. This should be turned off
416: # when you have files in the repository that are in a multibyte
417: # encoding which uses HTML special characters ([<>&"]) as part of a
418: # multi-byte character. (such as iso-2022-jp, ShiftJIS, etc.)
419: # Otherwise those files will get screwed up in markup.
420: $preformat_in_markup = '';
421:
3.1 knu 422: # Tabstop used to expand tabs in colored diffs. If undefined then
423: # tabs are always expanded to 8 spaces.
424: $tabstop = 8;
425:
426: # if you wish to display absolute times in your local timezone,
427: # then define mytz and fill in the strings for your standard and
428: # daylight time. Note that you must also make sure the system
429: # timezone is correctly set.
430: # @mytz=("EST", "EDT");
431:
432: # cvsweb is friendly to caches by indicating a suitable
433: # last-modified timestamp. Doing this uses slightly more
434: # CPU so you might want to disable it if you have a slow
435: # server
436: $use_moddate = 1;
437:
3.12 knu 438: # Allows downloading a tarball of the current directory if set.
439: # Bear in mind that this allows downloading a tarball of your entire
440: # repository, which can take a lot of time and disk space to create!
441: # If you enable this, you may need to make sure that cvsweb can write to
442: # CVSROOT/val-tags, due to a bug in cvs.
443: $allow_tar = '';
3.13 knu 444:
445: # Options to pass to tar(1).
3.15 knu 446: @tar_options = qw();
3.26 knu 447:
3.13 knu 448: # e.g. @tar_options = qw(--ignore-failed-read);
449: # GNU tar has some useful options against unexpected errors.
450:
3.19 knu 451: # Options to pass to gzip(1) when compressing a tarball to download.
452: @gzip_options = qw();
3.26 knu 453:
3.19 knu 454: # e.g. @gzip_options = qw(-3);
3.25 knu 455: # Try lower compression level than 6 (default) if you want faster
456: # compression, or higher, for better compression.
457:
458: # Options to pass to zip(1) when compressing a zip archive to download.
459: @zip_options = qw();
3.26 knu 460:
3.25 knu 461: # e.g. @zip_options = qw(-3);
3.19 knu 462: # Try lower compression level than 6 (default) if you want faster
3.21 knu 463: # compression, or higher, for better compression.
3.19 knu 464:
3.13 knu 465: # Options to pass to cvs(1).
3.36.2.1 scop 466: # For cvs versions prior to 1.11, the '-l' option doesn't work; If you want
467: # working checkouts with an older cvs version, you'll have to make sure that
468: # the cvsweb user can read and write to CVSROOT/history.
3.35 scop 469: @cvs_options = qw(-lf);
3.19 knu 470:
471: push @cvs_options, '-R' if ($uname eq 'FreeBSD' || $uname eq 'OpenBSD');
3.36.2.2 scop 472: push @cvs_options, '-u' if ($uname eq 'NetBSD');
3.26 knu 473:
3.19 knu 474: # Only FreeBSD's and OpenBSD's cvs(1) supports -R (read only access
475: # mode) option, which considerably speeds up checkouts over NFS.
3.36.2.2 scop 476: # A similar effect is provided by -u on NetBSD.
3.12 knu 477:
3.36.2.3 scop 478: # Options to pass to the 'cvs annotate' command, usually the normal
479: # @cvs_options are good enough here.
480: @annotate_options = @cvs_options;
481:
482: # To make annotate work against a read only repository, add -n, e.g.:
483: # @annotate_options = (@cvs_options, '-n');
484:
3.12 knu 485: 1;
3.26 knu 486:
3.1 knu 487: #EOF
CVSweb