# -*- shell-script -*- (Not really, but I like Emacs' syntax highlighting.)
# @configure_input@
#
# Configuration for package cvsweb-converters.
#
# This is a INI style configuration file for 3 perl scripts.
# Each script has its own [section] and "commitlog2cvsweb"
# has its parameters split into several subsections.
#
# $Id: cvsweb-converters.conf.sample.in,v 1.7 2006/06/22 07:46:19 martin Exp $
#
###
#
# Notes:
# + Avoid blank lines in this file as it may cause wrong line numbers
#   reported in error messages.
# + Several options are NOT USEFUL HERE and should only be used at the
#   commandline. They are listed here ONLY FOR DOCUMENTATION purposes
#   and completeness. (It is hardly useful to hardcode a query.)
# + Variables having no commandline option are marked with '%'.
# + Only section "[common]" is hard coded inside the scripts. The
#   scripts find their sections by matching against their name. Thus
#   if you rename a script you have to change its section names too.
# + This file is processed by the Config::IniFiles module. Lines
#   beginning with hash (#) or semicolon(;) are comments.
#
;
# =====================================================================
# ============================== common ===============================
# =====================================================================
# Parameters not found in their per-program sections will be looked up
# in this section. This is good for placing options common to all scripts.
[common]
;
##############
# --cvsweb
##############
# You might want to use a mirror or a local copy instead.  Check out
# http://www.FreeBSD.org/support.html#cvs for a complete list of
# available cvsweb mirrors. At the time of this writing you have the
# choice between Germany, Japan, Portugal, San Marino, Spain,
# USA/California and Ukraine. There are numerous other open source
# projects having public CVS repositories and many are offering cvsup
# and/or cvsweb access.
cvsweb= http://cvsweb.FreeBSD.org/
;
##############
# --urlsuffix
##############
# suffix which will be appended to all cvsweb URLs
# (do not begin with '?` or `&`, it will we prefixed automatically)
urlsuffix=
;
##############
# --output-file
##############
# A single dash sends output to STDOUT
outfile= -
;
;
# =====================================================================
# ========================== cvsuplog2cvsweb ==========================
# =====================================================================
# Parameters for "cvsuplog2cvsweb"
[cvsuplog2cvsweb]
;
##############
# --branch
##############
# Tell cvsweb.cgi to show only file revisions on this branch.
branch=
;
##############
# --cvsrootdir
##############
# Add "file:cvsrootdir/???" links to non-versioned (rsynced or appended)
# files. If used, this should point to your CVS root directory.
cvsrootdir=
;
;
# =====================================================================
# ========================== cvsrdiff2cvsweb ==========================
# =====================================================================
# Parameters for "cvsrdiff2cvsweb"
[cvsrdiff2cvsweb]
;
##############
# --branch
##############
# Tell cvsweb.cgi to show only file revisions on this branch.
branch=
;
##############
# --repository
##############
# This is used to invoke the cvs rdiff command. This option requires
# options --rev1 and --rev2 too.
repository=
;
##############
# --rev1 --rev2
##############
# Configuring these here is probably not what you want...
rev1=
rev2=
;
;
# =====================================================================
# ========================== commitlog2cvsweb =========================
# =====================================================================
# Parameters for "commitlog2cvsweb" are split into several subsections
# below.
;
# ---------------------------------------------------------
# --------------------- miscellanous ----------------------
# ---------------------------------------------------------
[commitlog2cvsweb misc]
;
;
##############
# --verbose
##############
verbose= 0
;
##############
# --sort-arguments
##############
# sort input files according to timestamp before processing them
sort_arguments= 0
;
##############
# --help
##############
# path of perldoc script
# Set this to the full pathname if "perldoc" isn't in your systems
# default search path for executables.
perldoc= @PERLDOC@
;
##############
# --commitlogdir
##############
# Default directory where commitlog files are searched,
# e.g. "/home/ncvs/CVSROOT/commitlogs"
commitlogdir=
;
# ---------------------------------------------------------
# -------------------- URL generation ---------------------
# ---------------------------------------------------------
[commitlog2cvsweb urls]
;
##############
# --showall-branches
##############
# cvsweb.cgi will show all branches even when --branch is used
show_all_branches= 0
;
##############
# --queryprcgi
##############
query_pr_cgi= http://www.FreeBSD.org/cgi/query-pr.cgi
;
##############
# --prefix
##############
# assume this directory prefix unless the input file matches ^self_prefix
# (the trailing slash is required here)
pfx= src/
;
##############
# %
##############
# matching input files use their filename as prefix
self_prefix= CVSROOT|distrib|doc|ports|www
;
##############
# %
##############
# matching input files have no default prefix
unknown_prefix= other
;
##############
# --stdin-with-prefix
##############
# use pfx for input from stdin
stdin_with_pfx= 0
;
# ---------------------------------------------------------
# ----------------------- filtering -----------------------
# ---------------------------------------------------------
[commitlog2cvsweb filtering]
;
##############
# --branch
##############
# only commits to this branch will be displayed
# (empty string = all branches)
branch_wanted=
;
##############
# --comitter
##############
# show only commits from this committer(s)
committer_wanted=
;
##############
# --filename --file
##############
# show only commits affecting the file(s)
# this is a Perl regexp, e.g. "netinet6?/(tcp|udp)"
filenm_pattern=
;
##############
# --logmessage
##############
# show only commits with matching log messages
# (multiple patterns are possible, one per line)
#logmsg_patterns= <<EndOfLogMsgPatterns
#EndOfLogMsgPatterns
;
##############
# --insensitive
##############
# logmsg_patterns are case insensitive
case_insensitive= 0
;
##############
# --and
##############
# logmsg_patterns are ANDed
and_patterns= 0
;
##############
# --maximum
##############
# upper limit for commit messages (from one input file)
# (0 = no limit)
maximum_output= 0
;
##############
# --from --after --since
##############
# only show commits made after this date
start_date=
;
##############
# --to --before --upto
##############
# only show commits made before this date
end_date=
;
# ---------------------------------------------------------
# -------------------- HTML generation --------------------
# ---------------------------------------------------------
[commitlog2cvsweb html]
;
##############
# --fileheaders
##############
# add <H1> tags at start of each input file
file_headers= 1
;
##############
# --link-committers
##############
# add hyperlinks to previous/next commit by same committer
hyperlink_committers= 0
;
##############
# --hr
##############
# add horizontal rule before each commit
hr= 1
;
##############
# --headfoot
##############
# print <HTML>, <HEAD> and <BODY> tags
html_header_and_footer= 1
;
##############
# --body-attributes
##############
# attributes for <BODY> tag
body_attributes= bgcolor=white
;
##############
# %
##############
# <font> for per committer links and commit numbers
extra_font1= <font size=-1>
extra_font2= </font>
;
##############
# %
##############
# <font> for branch tags
branch_font1= <font color=green>
branch_font2= </font>
;
##############
# %
##############
# <font> for matched part of commit logs
log_font1= <font color=red>
log_font2= </font>
;
#EOF#