content/documentation/faqs/site_maintainers/017.html

<meta http-equiv="REFRESH" content="10;url=http://wiki.services.openoffice.org/wiki/Documentation/FAQ">
<h3>This page is outdated. You will be redirected to <a href="http://wiki.services.openoffice.org/wiki/Documentation/FAQ">http://wiki.services.openoffice.org
/wiki/Documentation/FAQ</a> shortly.</h3>
<div style="margin-bottom: 10em;"></div>
<p><a href="../../index.html">Documentation</a> / <a href="../index.html">User FAQ</a> / <a href="index.html">Maintainers' FAQ</a> / <a href="016.html" accesskey="p">Previous</a>-<a href="018.html" accesskey="n">Next</a></p>
<h3>How do I checkout pages?</h3>
<ol>
  <li>After you establish a tunnel, open a second terminal. You will not work in the terminal where you established the tunnel. Minimize that first terminal, and use it to close the tunnel when you are done moving files to or from the site.</li>
  <li>Type <code>pwd</code> in the second terminal to verify that you are in your home directory.</li>
  <li>If this is the first time you have connected to this project through a tunnel, type<br/>
    <code>cvs -d :pserver:[username]@localhost:/cvs login</code>
    <br/>to log into the CVS, where <code>[username]</code> is your login name for the OpenOffice.org web site. This login step only needs to be done the first time you do work at a project.</li>
  <li>Type<br/>
    <code>cvs -d :pserver:username@projectname.domain.net:/cvs checkout [projectname]</code>
    <br/>in the second terminal to verify that you are in your home directory, where:
    <ul>
      <li><code>username</code> is your openoffice.org user login,</li>
      <li><code>projectname.domain.net</code> is the path to where the file lives, and</li>
      <li><code>[projectname]</code> is the name of a file or directory in the CVS file server.</li>
    </ul>
  </li>
</ol>
<p><b>Examples of the checkout command for user zzzzzz:</b></p>
<ul>
  <li>Type<br/>
    <code>cvs -d :pserver:zzzzzz@localhost:/cvs checkout documentation</code>
    <br/>in the second terminal to check out the entire documentation directory, which is the entire project.</li>
  <li>Type<br/>
    <code>cvs -d :pserver:zzzzzz@localhost:/cvs checkout documentation/www/faqs</code>
    <br/>in the second terminal to checkout the entire faqs directory.</li>
  <li>Type<br/>
    <code>cvs -d :pserver:zzzzzz@localhost:/cvs checkout documentation/www/faqs/index.html</code>
    <br/> in the second terminal to checkout only the index page from faqs directory.</li>
  <li>Type<br/>
    <code>cvs -d :pserver:zzzzzz@localhost:/cvs checkout marketing/www/index.html</code>
    <br/>in the second terminal to checkout only the index page from marketing project directory.</li>
  <li>Type<br/>
    <code>cvs -d :pserver:zzzzzz@localhost:/cvs checkout qa/www/index.html</code>
    <br/>in the second terminal to checkout only the index page from qa project directory.</li>
</ul>
<p>Once you have checked out a document or folder of documents, you can go off-line to do your edits. You will find the files in your home folder in the directory structure called out during the checkout command. (If you were not in your home directory when you started, the files will be in whatever pwd you were in when you initiated the checkout command. You will want to fix that.) When you are done with your off-line work, you will establish a new tunnel and upload your <a href="018.html">changed</a> and <a href="020.html">new</a> files to the site.</p>
<p><b>Note:</b> The commands <code>checkout</code> or <code>co</code> or <code>get</code> work to perform checkouts.</p>
<p><b>Tip:</b> In a terminal, use the up-arrow key to cycle through the past commands used. You can select and edit commands, instead of typing them each time. The computer will only read what is visible at the command prompt when you hit the Enter key.</p>
<p><b>For more information:</b></p>
<ul>
  <li><a href="http://www.openoffice.org/scdocs/CVSCheckout.html">CVS checkout</a></li>
  <li><a href="https://www.cvshome.org/docs/manual/cvs-1.11.18/cvs_16.html#SEC123">A.8 checkout--Check out sources for editing</a></li>
  <li><a href="http://www.openoffice.org/servlets/ProjectSource">CVS client setup</a></li>
  <li><a href="https://www.cvshome.org/docs/ref.html">CVS Quick Reference</a></li>
  <li><a href="025.html">Is there a place where I can see the CVS directory tree?</a></li>
</ul>
<p><a href="../../index.html">Documentation</a> / <a href="../index.html">User FAQ</a> / <a href="index.html">Maintainers' FAQ</a> / <a href="016.html" accesskey="p">Previous</a>-<a href="018.html" accesskey="n">Next</a></p>