Bochs Developers Guide
<<< Previous | Resources for developers | Next >>>

# Using CVS write access

## Checking in files

Once you have a Bochs directory with cvs write access, you can compile the files, edit them, test them, etc. See the documentation section, "Tracking the source code with CVS" for more info on CVS, in the User Manual. (FIXME: add cross reference) But what's new and different is that you can now do cvs commits. When a file is all fixed and ready to share with the rest of the world, you run a commit command to upload your version to the server. First, it's good to do a cvs update to make sure nobody else has changed it since you downloaded it last.

      $ cvs update file.cc
      sfusername@bochs.cvs.sf.net's password:        <--type your password
      $ cvs commit file.cc
      sfusername@bochs.cvs.sf.net's password:        <--type your password
      [editor opens. type log message, save, and exit.]

When CVS starts an editor, The default is usually vi. If you want a different editor, set the EDITOR environment variable to the name of your preferred editor. When you're done, just save the file and quit the editor. Unless there's some problem, you will see a message that says what the new revision number for the file is, and then "done". If while you're editing the log message, you decide that you don't want to commit after all, don't save the file. Quit the editor, and when it asks where the log message went, tell it to abort.

Here is an example of a successful checkin:

      $ cvs commit misc.txt
      sfusername@bochs.cvs.sf.net's password:        <--type your password
      [edit log msg]
      Checking in misc.txt;
      /cvsroot/bochs/bochs/doc/docbook/misc.txt,v  <--  misc.txt
      new revision: 1.6; previous revision: 1.5
      done

And here is an aborted one:

      $ cvs commit misc.txt
      sfusername@bochs.cvs.sf.net's password:        <--type your password
      [quit editor without saving]
      Log message unchanged or not specified
      a)bort, c)ontinue, e)dit, !)reuse this message unchanged for remaining dirs
      Action: a
      cvs [commit aborted]: aborted by user

<<< Previous | Home | Next >>>
Resources for developers | Up | SourceForge bug, feature, and patch trackers