head	1.1;
access;
symbols
	TIGRIS_1_0:1.1.2.1.0.2
	TIGRIS_1_0_5:1.1.0.2;
locks; strict;
comment	@# @;


1.1
date	2001.06.06.15.54.31;	author jrobbins;	state dead;
branches
	1.1.2.1;
next	;

1.1.2.1
date	2001.06.06.15.54.31;	author jrobbins;	state Exp;
branches;
next	;


desc
@@


1.1
log
@file ProjectSource.wm was initially added on branch TIGRIS_1_0_5.
@
text
@@


1.1.2.1
log
@supplying guest password
@
text
@a0 117
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" WIDTH="100%">
  <TR>
    <TD CLASS="Header" NOWRAP>Project Source: <SPAN CLASS="ProjectNameHeader"><A HREF="$currentProject.getProjectHome()">$currentProject.getWordMark()</A></SPAN></TD>  
  </TR>
</TABLE>

<TABLE BORDER="0" CELLSPACING="0" CELLPADDING="2" WIDTH="100%">
  <TR>
    <TD COLSPAN="2" CLASS="InputHeader" VALIGN="top">Access the source code repository for this project in one of the following ways:</TD>
  </TR>
  <TR>
    <TD COLSPAN="2" CLASS="PlainText" VALIGN="top">
      <UL>
#set $browse_path = "/source/browse/$currentProject.getName()"
#set $browse_url  = $currentProject.getProjectFileURL($browse_path)   
<P>
        <LI><A HREF="$browse_url;/">Browse</A> source code on-line to view this project's directory structure and files.</LI><BR><BR>

        <LI><A HREF="$currentProject.getProjectPageURL("ProjectDownloadList")">Download</A> source code archives, if any are available, to copy read-only source files for this project on to your local system.</LI><BR><BR>

#set $cvshost="cvs.$currentDomain.getName()"

<P>
#if ($myProperties.getProperty("offerAnonymousCVS") == "true") 
{
        <LI>Check out source code via anonymous CVS. For example:<BR>
           <tt>cvs -d :pserver:anoncvs@@$cvshost:/cvs login</tt><br>
           Use empty password<br>
           followed by<BR>
           <tt>cvs -d :pserver:anoncvs@@$cvshost:/cvs checkout $currentProject.getName()</tt><br><br>

        </LI> 
} #else {
        <LI>You can use CVS to check out your own copies of project source code files if you have the appropriate permissions. CVS is an open source version control for keeping track of all modifications to project source code files. You can choose either a <A HREF="http://www.cvshome.org/downloads.html">command-line CVS client</A> or <A HREF="http://www.cvsgui.org/download.html">WinCvs</A> with a Windows interface. Whether you have CVS permissions and what you can do with source files depends upon your role in this project. (<A HREF="/project/www/docs/ProjectRoles.html">Roles?</A>)
<P>
<B>Important note:</B> The following instructions cover checking out your own working copies of project source files. To contribute or check in modified files:
<P>
<UL>
<LI>you must be a member of this project with the appropriate permissions, <I>and</I>
<LI>you must <I>first</I> <A HREF="/project/www/docs/ddSSHGuide.html">set up an SSH tunnel</A> for security purposes.
</UL>
}
</UL>
<P>
<HR noShade SIZE=1>
#set $cvshost="cvs.$currentDomain.getName()"

<A NAME="commandlinecvs"></A><SPAN CLASS="InputHeader">CVS command line checkout
 instructions</SPAN>&nbsp;&nbsp;&nbsp;(<A HREF="#wincvs">Skip to WinCvs checkout
 instructions</A>)
<P>
Before you can do a cvs checkout, you must set the cvsroot to indicate where the
 CVS repository for this project is located.
<OL>
<LI>The command to set cvsroot and login is:
<P>
<BLOCKQUOTE>
           <B>cvs -d :pserver:$loginUser.getLoginName()@@$cvshost:/cvs login</B><BR>
           Login with your own password, the same as the one you use to access the site.  Or use the password "guest" with username "guest".
</BLOCKQUOTE>
<P>Then you can check out a working copy with:
<P>
<BLOCKQUOTE>
           <B>cvs -d :pserver:$loginUser.getLoginName()@@$cvshost:/cvs checkout $currentProject.getName()</B><BR><BR>
</BLOCKQUOTE>
<P>

If this is the only project you working on, you only need to set the cvsroot once. Thereafter when you log in to this domain, the cvs repository for this project is assumed. If you are working multiple projects, however, you must specify the cvsroot each time you log in to ensure that the cvs repository you are accessing is the right one.
<P>
<LI>To check out the project source repository an individual module (if you don't need the entire repository), type:
<P>
<BLOCKQUOTE>
          <B>cvs -d :pserver:$loginUser.getLoginName()@@$cvshost:/cvs checkout $currentProject.getName()/[modulename]</B>
</BLOCKQUOTE>
This command should result in a scrolling list of files being added to the local directory you specified on your machine. Now you are ready to use your file editor to work with individual files and make changes.
</OL>
<P>
If you wish to contribute to the project's CVS repository, you must have "cvs-commit" permissions as a project member. <B>Note: Before you may <I>commit</I> modified files into the project repository, you must set up an SSH tunnel for security purposes.</B>
<P>
<A HREF="/project/www/docs/ddSSHGuide.html">More about SSH tunneling</A><BR>
<A HREF="/project/www/docs/ddUsingCVS_command-line.html">CVS how-to guide for this site</A>
<P>

<HR noShade SIZE=1>
<A NAME="wincvs"></A><SPAN CLASS="InputHeader">WinCvs checkout instructions</SPAN><BR>
<P>
To use WinCvs to check out your own set of source code files, you must first set up the correct cvs root using the following steps.
<P>
<OL>
<LI>Launch WinCvs and select <B>Cvs Admin - Preferences</B>. Enter the CVSroot:
<P>
<BLOCKQUOTE>
<B>:pserver:$loginUser.getLoginName()@@$cvshost:/cvs</B>
</BLOCKQUOTE>
Click OK.
<P>
<LI>If this your first cvs checkout, create a folder in Windows Explorer to hold all of your cvs project folders. Then create a subfolder for this project. (You may even want to create separate subfolders for each module if you're working in more than one.)
<P>
<LI>In WinCvs, select <B>Cvs Admin - Login</B> and enter your cvs password.
<P>
<LI>Click on the left window in the program and select a folder. Then select <B>
Cvs Admin - Checkout Module</B>. Select the project folder you created earlier.
<P>
<LI>Enter project module name and click OK. You should see a scrolling list of filenames as these are created in your folder(s).
<P>
<LI>Repeat the module creation process for each additional cvs module you wish to check out.
</OL>
</UL>

<A HREF="/project/www/docs/ddUsingWinCvs.html">WinCvs how-to guide for this site
</A>



  </TD>
  </TR>
</TABLE>
@

