This manual page documents the vo command.
vo is a program to easily handle files which are under control of RCS. vo uses ci and co to handle the check out and check in of RCS controlled files on the fly.
The initial idea behind vo was to have more control over system configuration files. With vo one knows who made which changes and when because RCS tracks the full history of modifications. This is extremly useful e.g. if working with co-admins on the same system.
vo is somewhat aggressive concerning which files have to be RCS controlled. It takes what it gets.
Automatical check in. Files not under RCS' control get checked in initially without hesitation.
If necessary a subdirectory named RCS is created automatically.
The environment variable $EDITOR is recognized. The default editor is vi.
Changes made circumventing RCS are a problem for RCS. Normally they get lost with the next check out. vo detects those illegal changes and updates them to the RCS repository before modifying the file's content further. Those updates are marked with the comment "recovering from RCS unaware modification".
If newer versions of sudo have set your $LOGIN and $USER environment variables to "root", vo uses $SUDO_USER to track the user who changed the file. You are strongly encouraged to use sudo instead of su or even rude login as root.
If vo is called as vom make is called automatically after closing the editor. This is handy when maintaining NIS maps, /etc/aliases or programming.
vo provides a simplified interface to RCS for scripting purpose. See OPTIONS for further intermation.
vo ignores symbolic links. This is because symbolic links will mangle RCS files.
The environment variable $VO_ASK_RCS may be set to "Y" to make vo prompt the user before initially checking a file into RCS.
Check out the given files(s). If a file it not unter RCS control it gets initially checked in. If necessary a subdirectory named RCS is created also.
Check in the given files(s) without asking for a comment.
The editor program to use. The default editor is vi.
The user which is logged as last maintainer of a file.
The user which is logged as last maintainer of a file.
The user which is logged as last maintainer of a file. This will override settings of LOGNAME and USER.
The environment variable $VO_ASK_RCS may be set to "Y" to make vo prompt the user before initially checking a file into RCS.
This manual page was written by Christian Recktenwald <vo-contact@citecs.de> for the vo software and may be used by others. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.
The newest version of vo can be obtained from http://www.fischglas.de/software/vo
vo is (C) 1997-2004 by Christian Recktenwald.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; Version 2. This guarantees your right to use, modify, and redistribute vo under certain conditions. If this license is unacceptable to you, citecs GmbH may be willing to sell alternative licenses. (contact <vo-contact@citecs.de>)
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details (it is in the COPYING file of the vo distribution).