home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / wvwar062.zip / doc / CVS-FAQ < prev    next >
Text File  |  2000-10-07  |  2KB  |  89 lines
  1.              CVS FREQUENTLY ASKED QUESTIONS
  2.  
  3. ...if you want to contribute to the development of 
  4. wvWare or libwmf in the SourceForge CVS repository.
  5.  
  6. First of all, you need an *account* (<userid> on SourceForge,
  7. with a personal password. Then you will have to have 
  8. ssh (Secure Shell) working. SourceForge's CVS uses ssh for
  9. secure developer access. See
  10.  
  11.    http://sourceforge.net/docman/display_doc.php?docid=765&group_id=1
  12.  
  13. and links therein for the technical details.
  14.  
  15. 1. Add the following lines to your start-up script
  16.    (like .bashrc or whatever)
  17.  
  18. export CVS_RSH=ssh
  19. export CVSROOT=<userid>@cvs.wvware.sourceforge.net:/cvsroot/wvware
  20.  
  21. ... or execute these from the command line. 
  22. (Do not try to execute this as a shell script. Won't work :-)
  23.  
  24. (check with printenv that CVS_RHS and CVSROOT are really set)
  25.  
  26. 2. Give commands like the following (RTFM):
  27.  
  28. cvs -d $CVSROOT checkout wv
  29. cvs -d $CVSROOT checkout libwmf
  30. cvs -d $CVSROOT diff
  31. cvs -d $CVSROOT update
  32. cvs -t -d $CVSROOT commit
  33. ...
  34.  
  35. It appears to be important to have the -d $CVSROOT switch.
  36.  
  37. 3. Before committing, do a 
  38.  
  39. cvs -d $CVSROOT diff >diff-file
  40.  
  41. to check what precisely will be checked in. If too much
  42. will be checked in, you can limit it by using a regular expression
  43.  
  44. cvs -d $CVSROOT commit <file-reg-exp>
  45.  
  46. 4. Remember, before commit, always to *first update* your
  47. local copy, and resolve any possible conflicts that may arise,
  48. which will be delineated in the file by >>>> and <<<< markers.
  49.  
  50. 5. For large or "deep" changes, go through a make clean -- make
  51. [make install] cycle to test that all is OK. Do not modify files
  52. that are generated from .in files -- change the .in files instead,
  53. and *if* the derived file is part of CVS, generate that again before
  54. committing.
  55.  
  56. 6. If you want to add files to the CVS repository, tell the repository
  57. about it:
  58.  
  59. cvs -d $CVSROOT add <filename-expr>
  60.  
  61. Removal:
  62.  
  63. cvs -d $CVSROOT remove <filename-expr>
  64.  
  65. ...and only then commit.
  66.  
  67. 7. Useful CVS switches:
  68.  
  69. -t trace
  70. -n "do as if" (like in make).
  71.  
  72. 8. Use the SourceForge Web interface to study the code history.
  73. Cool!
  74.  
  75. There is also a "cvs history" shell command available.
  76.  
  77. 9. Send a *message* (e.g. containing the CVS comment block) to the
  78. mailing list, currently one and the same for *both* modules 
  79. wv and libwmf :
  80.  
  81. wvware-devel@lists.sourceforge.net 
  82.  
  83. Good luck!
  84.  
  85. -- 
  86. "Dom Lachowicz" <cinamod@hotmail.com> 
  87. Martin Vermeer  <martin.vermeer@hut.fi>
  88.  
  89.