home *** CD-ROM | disk | FTP | other *** search
/ MACD 4 / MACD4.iso / Emulatory / AROS / README.CVS < prev    next >
Encoding:
Text File  |  1978-03-06  |  6.4 KB  |  175 lines
  1. To use the AROS CVS Server:
  2.  
  3. Changes since the last version: It seems that with a CVS later than 1.8.1,
  4. you must always prepend :pserver: (even for the login !).
  5.  
  6. 1. Create a passwort with "crypt":
  7.  
  8.     > make crypt
  9.     > crypt my_password
  10.     Encrypting my_password: cbEVHg0j9uNRs
  11.  
  12. 1b) If you have an Amiga and you have AmiTCP (you can get a Demo from
  13. AmiNET), you can use that one to generate a password. To use the CVS
  14. server, you must have some way to connect to the Internet, anyway, so it
  15. might be a good idea to install AmiTCP (no idea if Miami works, too.
  16. Anyone ?).
  17.  
  18.     > cd AmiTCP:bin
  19.     > login username
  20.     > passwd
  21.     Old password: *******
  22.     New password: *****
  23.     Retype new password: *****
  24.  
  25. (replace the "*" by your password). After this, open the file AmiTCP:db/passwd
  26. and look for "username". The encrypted password can be found in the second
  27. field:
  28.  
  29.     username|hrGxherytY|1000|1000|name|home:|shell
  30.          ^^^^^^^^^^
  31.  
  32. This is the password you can send to me (see next section).
  33.  
  34. NOTE: Don't forget to change the password back to your original password,
  35. or clear the password field if you didn't have an AmiTCP password !
  36. If you don't want to mess with your original user, do this:
  37.  
  38.     username|hrGxherytY|1000|1000|name|home:|shell
  39.  
  40. make a copy of the line
  41.  
  42.     username|hrGxherytY|1000|1000|name|home:|shell
  43.     username|hrGxherytY|1000|1000|name|home:|shell
  44.  
  45. erase the password and change the login name and user id:
  46.  
  47.     username|hrGxherytY|1000|1000|name|home:|shell
  48.     aros||1001|1000|name|home:|shell
  49.  
  50. login:
  51.  
  52.     > login aros
  53.     > passwd
  54.     Old password:
  55.  
  56. Just press Return here
  57.  
  58.     New password: ******
  59.     Retype new password: ******
  60.  
  61. And then type the AROS password twice. After that, edit the passwd-file
  62. again:
  63.  
  64.     username|hrGxherytY|1000|1000|name|home:|shell
  65.     aros|xyJSD87sdfk|1001|1000|name|home:|shell
  66.  
  67. Now you can send me the password ("xyJSD87sdfk") and simply delete the
  68. dummy "aros" user. That's it :-)
  69.  
  70. 2. Mail that password to
  71.  
  72.     digulla@wi-pc44.fh-konstanz.de
  73.     Subject: Access to AROS CVS Server
  74.  
  75.     Please add <my_login, eg. digulla> <password, eg. cbEVHg0j9uNRs>
  76.  
  77. 3. Wait until I confirm this. While you wait, look for CVS 1.8.1 and
  78. install it. If you have an Amiga, install ADE. They have a working
  79. CVS (Thanks Lennard).
  80.  
  81. 4. When you got my reply and you have CVS 1.8.1, use this to login:
  82.  
  83.     > cvs -d :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS login
  84.  
  85. where "user" is your login, eg. digulla:
  86.  
  87.     > cvs -d :pserver:digulla@wi-pc44.fh-konstanz.de:/home/AROS/CVS login
  88.  
  89. This asks you for your password. Type it in and if there is no error
  90. displayed, you are connected.
  91.  
  92. NOTE: It seems that the protocol for CVS has changed. Version of CVS
  93. upto 1.8.1 and earlier need not have ":pserver:" before the login name,
  94. but later versions require it. If you have problems to login, try to omit
  95. ":pserver:" or prepend it. If CVS wants it, you will get an error reading
  96. "cvs login: can only use pserver method with `login' command".
  97.  
  98. 5. Now you can use _any_ CVS command as if the main source tree was
  99. on your local host. To get a complete copy of the current tree, use:
  100.  
  101.     > cvs -d :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS checkout AROS
  102.  
  103. (don´t forget to substitute user by your login !)
  104.  
  105. 6. What can I do now ? Well, you can edit any file or create any number
  106. of new files. To send me your changes, you must commit them, namely with:
  107.  
  108.     > cvs -d :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS commit [<file>]
  109.  
  110. where <file> is the name of a file you want to update on MY host. If
  111. you don't specify a certain file, CVS will update all files in the CURRENT
  112. DIRECTORY and ALL SUB-DIRECTORIES. This command is the last one to really
  113. make the change here on my host. All other commands simply change the
  114. state at YOUR place.
  115.  
  116. 7. What do I do it I have a new file ? Then you must register it with
  117. "cvs ... add <file>", eg.
  118.  
  119.     > cvs -d :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS add some_new_file.c
  120.  
  121. This won't do anything here at my place but simply tell CVS at YOUR
  122. place that there is a new file. The next "cvs ... commit" then registers
  123. your new file here.
  124.  
  125. 8. All right but what when others change files ? In this case, nothing
  126. happens. CVS won't notice you or update your files. To tell CVS to look
  127. for new files and changes by other people (ie. make YOUR files uptodate),
  128. use
  129.  
  130.     > cvs -d :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS update [<file>]
  131.  
  132. As usual, give a file if you want only this file to be checked and updated
  133. or nothing and CVS will check all files in this dir and all subdirs.
  134.  
  135. 9. What happens when two people edit the same file ? Good question. The
  136. answer is that I don't know exactly. What I know is that no changes will
  137. be lost. CVS will always keep a backup copy of the original file (it is
  138. kinda smart; it will notice when you try to change a file someone else
  139. has already changed), so there is no chance that your changes might be
  140. made in a file edited by someone else in the mean time. CVS will try
  141. to figure out what the differences are between your version and the one
  142. you used as a starting point and the version now in the repository and
  143. also the version you used as a starting point. Then these diffs are
  144. compared, too. If CVS doesn't find any places where both diffs show
  145. changes (ie. you edited somewhere at the end of the file and the other
  146. guy edited at the beginning), it will simply merge both diffs and create
  147. a new version with BOTH YOUR changes and the changes of the other person.
  148. If CVS cannot resolve all every change, it does as best as it can and
  149. then offers you a file which contains the rest: Your changes and the
  150. changes of the other person. Then you have to manually clean this up
  151. and after that CVS will use this file as the new version. At least that's
  152. what the manual says :)
  153.  
  154. 10. And now the goodie for all those who read upto here: You don't need
  155. to type the looong line above every time. If you use csh or similar
  156. (to find out, try it. If it says "setenv: command not found" then you
  157. don't :), use this:
  158.  
  159.     > setenv CVSROOT :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS
  160.  
  161. on the other shells, the command looks like this:
  162.  
  163.     > export CVSROOT=:pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS
  164.  
  165. (have you thought to replace "user" by your login ?)
  166.  
  167. NOTE: This must be done _after_ the login !! If you do it before, CVS
  168. will try to use an existing login to login :)
  169.  
  170. After this, you can omit the "-d :pserver..." and just type, for example:
  171.  
  172.     > cvs help
  173.  
  174. Have a lot of fun :)
  175.