doc-maint/web-pages.org

   1 The home page for XBoard are kept in CVS. This is a unfortunate, since
   2 we keep the code in git and hopefully will change in the
   3 future. Luckily there is a cvsexport/import command for git that can help.
   4
   5 Possible setup:
   6
   7 cvs web page in /home/user/xboard-cvs
   8 git in          /home/user/xboard-git
   9
  10 Add the following entries in /home/user/xboard-git/.git/config:
  11
  12 [cvsimport]
  13         module = xboard
  14         d = :ext:<savannah user name>@cvs.sv.gnu.org:/webcvs/xboard
  15 [cvsexportcommit]
  16         cvsdir = /home/user/xboard-cvs
  17
  18 It's probably best to have a tracking branch for the cvs tree, one
  19 that branch you should be able to use:
  20
  21 git cvsimport -a
  22
  23 to import all cvs-commits into the git tree. You can merge that branch
  24 with the www-branch in git.
  25
  26 To push a git-commit (from branch www) into cvs, you can use:
  27
  28 git cvsexportcommit -v -c <sha1>
  29
  30 This can only be done one commit at a time AFAIK. In case of conflicts
  31 cvsexportcommit will leave a .msg and patchfile (something like
  32 .cvscommitpatch) in the CVS directory that you can apply by hand and
  33 then fix the merge conflicts and apply the commit by hand via "cvs
  34 commit" (use "cvs add <file>" if you need to add new files).
  35
  36 GNU also provides a script to update the online manual from the texi
  37 file. It's called gendocs.sh (see same directory as this file). There
  38 might be newer version around, so it could be worth checking for them
  39 every now and then.
  40