docs/htmldocs/CVS-Access.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >HOWTO Access Samba source code via CVS</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
   8 ><BODY
   9 CLASS="ARTICLE"
  10 BGCOLOR="#FFFFFF"
  11 TEXT="#000000"
  12 LINK="#0000FF"
  13 VLINK="#840084"
  14 ALINK="#0000FF"
  15 ><DIV
  16 CLASS="ARTICLE"
  17 ><DIV
  18 CLASS="TITLEPAGE"
  19 ><H1
  20 CLASS="TITLE"
  21 ><A
  22 NAME="AEN1"
  23 >HOWTO Access Samba source code via CVS</A
  24 ></H1
  25 ><HR></DIV
  26 ><DIV
  27 CLASS="SECT1"
  28 ><H1
  29 CLASS="SECT1"
  30 ><A
  31 NAME="AEN3"
  32 >Introduction</A
  33 ></H1
  34 ><P
  35 >Samba is developed in an open environnment.  Developers use CVS
  36 (Concurrent Versioning System) to "checkin" (also known as
  37 "commit") new source code.  Samba's various CVS branches can
  38 be accessed via anonymouns CVS using the instructions
  39 detailed in this chapter.</P
  40 ><P
  41 >This document is a modified version of the instructions found at
  42 <A
  43 HREF="http://samba.org/samba/cvs.html"
  44 TARGET="_top"
  45 >http://samba.org/samba/cvs.html</A
  46 ></P
  47 ></DIV
  48 ><DIV
  49 CLASS="SECT1"
  50 ><HR><H1
  51 CLASS="SECT1"
  52 ><A
  53 NAME="AEN8"
  54 >CVS Access to samba.org</A
  55 ></H1
  56 ><P
  57 >The machine samba.org runs a publicly accessible CVS
  58 repository for access to the source code of several packages,
  59 including samba, rsync and jitterbug. There are two main ways of
  60 accessing the CVS server on this host.</P
  61 ><DIV
  62 CLASS="SECT2"
  63 ><HR><H2
  64 CLASS="SECT2"
  65 ><A
  66 NAME="AEN11"
  67 >Access via CVSweb</A
  68 ></H2
  69 ><P
  70 >You can access the source code via your
  71 favourite WWW browser. This allows you to access the contents of
  72 individual files in the repository and also to look at the revision
  73 history and commit logs of individual files. You can also ask for a diff
  74 listing between any two versions on the repository.</P
  75 ><P
  76 >Use the URL : <A
  77 HREF="http://samba.org/cgi-bin/cvsweb"
  78 TARGET="_top"
  79 >http://samba.org/cgi-bin/cvsweb</A
  80 ></P
  81 ></DIV
  82 ><DIV
  83 CLASS="SECT2"
  84 ><HR><H2
  85 CLASS="SECT2"
  86 ><A
  87 NAME="AEN16"
  88 >Access via cvs</A
  89 ></H2
  90 ><P
  91 >You can also access the source code via a
  92 normal cvs client.  This gives you much more control over you can
  93 do with the repository and allows you to checkout whole source trees
  94 and keep them uptodate via normal cvs commands. This is the
  95 preferred method of access if you are a developer and not
  96 just a casual browser.</P
  97 ><P
  98 >To download the latest cvs source code, point your
  99 browser at the URL : <A
 100 HREF="http://www.cyclic.com/"
 101 TARGET="_top"
 102 >http://www.cyclic.com/</A
 103 >.
 104 and click on the 'How to get cvs' link. CVS is free software under
 105 the GNU GPL (as is Samba).  Note that there are several graphical CVS clients
 106 which provide a graphical interface to the sometimes mundane CVS commands.
 107 Links to theses clients are also available from http://www.cyclic.com.</P
 108 ><P
 109 >To gain access via anonymous cvs use the following steps.
 110 For this example it is assumed that you want a copy of the
 111 samba source code. For the other source code repositories
 112 on this system just substitute the correct package name</P
 113 ><P
 114 ></P
 115 ><OL
 116 TYPE="1"
 117 ><LI
 118 ><P
 119 >       Install a recent copy of cvs. All you really need is a
 120         copy of the cvs client binary.
 121         </P
 122 ></LI
 123 ><LI
 124 ><P
 125 >       Run the command
 126         </P
 127 ><P
 128 >       <B
 129 CLASS="COMMAND"
 130 >cvs -d :pserver:cvs@samba.org:/cvsroot login</B
 131 >
 132         </P
 133 ><P
 134 >       When it asks you for a password type <TT
 135 CLASS="USERINPUT"
 136 ><B
 137 >cvs</B
 138 ></TT
 139 >.
 140         </P
 141 ></LI
 142 ><LI
 143 ><P
 144 >       Run the command
 145         </P
 146 ><P
 147 >       <B
 148 CLASS="COMMAND"
 149 >cvs -d :pserver:cvs@samba.org:/cvsroot co samba</B
 150 >
 151         </P
 152 ><P
 153 >       This will create a directory called samba containing the
 154         latest samba source code (i.e. the HEAD tagged cvs branch). This
 155         currently corresponds to the 3.0 development tree.
 156         </P
 157 ><P
 158 >       CVS branches other HEAD can be obtained by using the <TT
 159 CLASS="PARAMETER"
 160 ><I
 161 >-r</I
 162 ></TT
 163 >
 164         and defining a tag name.  A list of branch tag names can be found on the
 165         "Development" page of the samba web site.  A common request is to obtain the
 166         latest 2.2 release code.  This could be done by using the following command.
 167         </P
 168 ><P
 169 >       <B
 170 CLASS="COMMAND"
 171 >cvs -d :pserver:cvs@samba.org:/cvsroot co -r SAMBA_2_2 samba</B
 172 >
 173         </P
 174 ></LI
 175 ><LI
 176 ><P
 177 >       Whenever you want to merge in the latest code changes use
 178         the following command from within the samba directory:
 179         </P
 180 ><P
 181 >       <B
 182 CLASS="COMMAND"
 183 >cvs update -d -P</B
 184 >
 185         </P
 186 ></LI
 187 ></OL
 188 ></DIV
 189 ></DIV
 190 ></DIV
 191 ></BODY
 192 ></HTML
 193 >