Upgrading a ViewCVS Installation

This document describes some of the things that you will need to consider, change, or handle when upgrading an existing ViewCVS installation to a newer version.

It is always recommended to install the new version in a fresh directory and to carefully compare the configuration files. A possible approach is to name the directories /usr/local/viewcvs-0.6, /usr/local/viewcvs-0.7 and so on and than create a symbolic link viewcvs pointing to the production version. This way you can easily test several versions and switch back, if your users start to complain.

• Upgrading from ViewCVS 0.8
• Upgrading from ViewCVS 0.7 or earlier

Upgrading from ViewCVS 0.8

This section discusses how to upgrade ViewCVS 0.8 to version 0.9 or a later version of the software.

Configuration Options

More templates were introduced in version 0.8 of the software, which made many of the configuration options obsolete. This section covers which options were removed. If you made any changes to these options, then you will need to make corresponding changes in the templates.

Colors: diff_heading, diff_empty, diff_remove, diff_change, diff_add, and diff_dark_change

These options have been incorporated into the diff.ezt template.

markup_log

This option has been incorporated into the markup.ezt template.

Colors: nav_header and alt_background

These options have been incorporated into the header.ezt template.

Images: back_icon, dir_icon, and file_icon

These options have been incorporated into the directory.ezt, header.ezt, log.ezt, log_table.ezt, and query.ezt templates.

use_java_script and open_extern_window

The templates now use JavaScript in all applicable places, and open external windows for most downloading and viewing of files. If you wish to not use JavaScript and/or external windows, then remove the feature(s) from the templates.

show_author

Changing this option would be quite strange and rare. If you do not want to show the author for the revisions, then you should remove it from the various templates.

hide_non_readable

This option was never used, so it has been removed.

flip_links_in_dirview

This option is no longer available. If you want the links in your directory view flipped, then you may use the dir_alternate.ezt template.

Template Variables

Some template variables that were available in 0.8 have been removed in 0.9. If you have custom templates that refer to these variables, then you will need to modify your templates.

directory.ezt: headers

The headers are now listed explicitly in the template, rather than made available through a list.

directory.ezt: rows.cols, and rows.span

These variables were used in conjunction with the headers variable to control the column displays. This is now controlled explicitly within the templates.

directory.ezt: rev_in_front

This was used to indicate that revision links should be used in the first column, rather than in their standard place in the second column. Changing the links should now be done in the template, rather than according to this variable. You may want to look at the dir_alternate.ezt template, which has the revision in front.

directory.ezt: rows.attic and rows.hide_attic_href

These variable were used to manage the hide and showing of the contents of the Attic/ subdirectory. Several new variables were introduced which can be used to replace this functionality: show_attic_href, hide_attic_href, and rows.state.

Upgrading from ViewCVS 0.7 or earlier

This section discusses how to upgrade ViewCVS 0.7, or earlier, to 0.8 or a later version of the software.

NOTE: these changes will bring you up to the requirements of version 0.8. You must also follow the directions for upgrading from 0.8.

Configuration Options

The largest change from 0.7 to 0.8, that you will need to deal with, is the introduction of templates. This shifted many configuration file options into the templates, for more direct editing of the output style, colors, and layout. Below is a list of options that no longer exist, and where you can find their counterpart in the current version of ViewCVS.

The following options have all been removed in ViewCVS 0.8. If you made local changes to your ViewCVS configuration, then you will need to edit templates in the templates/ subdirectory.

The [text] section: short_intro, long_intro, and doc_info

These options have been incorporated into the doc/help_rootview.html page and the doc/help_dirview.html page.

repository_info

This option is now incorporated into the directory.ezt template.

table_padding

The table padding values can be changed in the directory.ezt template.

table_border

Edit directory.ezt to add a border around the directory table.

column_header_normal and column_header_sorted

Edit directory.ezt to modify the colors of the column headers.

extern_window_width and extern_window_height

These options were never used and have been removed.

logo

Edit the templates directly (directory.ezt, log.ezt or log_table.ezt and if needed query.ezt) to alter the URL and size of your logo.

allow_version_select

Edit the log.ezt template if you want to remove the link which allows the user to select a revision for a diff.

input_text_size

Edit the log.ezt template if you want to change the size of the entry box for revisions for performing diffs.

even_odd

Edit the directory.ezt and query.ezt templates if you want to change the colors of the rows in the directory and query result tables.

Colors: text and background

These options have been incorporated into the directory.ezt, log.ezt, and log_table.ezt templates.