# HG changeset patch
# User diego
# Date 1068063975 0
# Node ID 5484bc13e90a26a035640d033a546e17e37eb9b8
# Parent  4e8081a5035197d8f49c9299825d04952fb9b551
Some notes about general CVS documentation added, new 'cvs admin' section
about reverting broken commits, small changes.

diff -r 4e8081a50351 -r 5484bc13e90a DOCS/tech/cvs-howto.txt
--- a/DOCS/tech/cvs-howto.txt	Wed Nov 05 15:59:07 2003 +0000
+++ b/DOCS/tech/cvs-howto.txt	Wed Nov 05 20:26:15 2003 +0000
@@ -2,6 +2,29 @@
 About CVS write access:
 ~~~~~~~~~~~~~~~~~~~~~~~
 
+Before everything else, you should know how to use CVS properly. CVS comes with
+some documentation, as usual
+
+  cvs --help
+  man cvs
+
+are a good start. The most comprehensive manual is the book "Version Management
+with CVS" by Per Cederqvist. It may be available on your system via
+
+  info cvs
+
+or online at
+
+  http://www.cvshome.org/docs/manual/
+
+Another very good resource is "The CVS Book - Open Source Development with CVS"
+by Karl Fogel and Moshe Bar. It is also available online:
+
+http://cvsbook.red-bean.com/
+
+Consult these resources whenever you have problems, they are quite exhaustive.
+What follows now are MPlayer specific guidelines.
+
 
 I. TECH SIDE:
 =============
@@ -21,6 +44,7 @@
     export CVS_RSH=ssh
     cvs -z3 -d:ext:LOGIN@mplayerhq.hu:/cvsroot/mplayer co main
   
+  Replace LOGIN with your login name.
   NOTE: cvs -d:pserver: mode doesn't allow writing, even with password!
   
 3. Committing changes:
@@ -31,7 +55,7 @@
   You don't have to include the filename in the comment, as comments are linked
   to files. If you have different comments for different files, commit them
   separately, not at the same time. If you leave out -m at the command line you
-  will be prompted for a comment in an editor.
+  will be prompted for a comment in an editor (usually vi).
   
 4. Adding new files/dirs:
 
@@ -67,8 +91,19 @@
 
   Such actions are useless and treated as cosmetics in 99% of cases,
   so try to avoid them.
-  
-  
+
+9. Reverting broken commits
+
+  In case you committed something really broken and wish to undo it completely,
+  you can use the 'cvs admin -o' command. Assuming that 1.123 is the latest
+  version of the file and the one you want to remove
+
+  cvs -z3 admin -o1.123 filename
+
+  Do NOT do this unless you really know what you are doing and the version you
+  are removing is the last version, e.g. there were no commits after yours.
+
+
 Contact A'rpi <arpi@thot.banki.hu> if you have technical problems with the CVS
 server.