This page is outdated. You will be redirected to http://wiki.services.openoffice.org /wiki/Documentation/FAQ shortly.

Documentation / User FAQ / Maintainers' FAQ / Previous-Next

How do I commit or update pages?

1. After you establish a tunnel, open a second working 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.
2. Type pwd in the working terminal to verify that you are in your home directory.
3. Use the change directory cd command in the second terminal to move to the directory of the file or folder you wish to commit.
4. There are two ways to use the commit command to format the comments.
   
   • To use one line of comments, type
     cvs -d :pserver:username@projectname.domain.net:/cvs commit -m "comment" [projectname]
     in the second terminal, where:
     • username is your openoffice.org user login,
     • projectname.domain.net is the path to where the file lives
     • [projectname] is the name of a file or directory in the CVS file server, and
     • comment is a one line description of the change.
   • To allow a more formatted description of the change, use a modified version of this same command to pull up a CVS template. Type
     cvs -d :pserver:username@projectname.domain.net:/cvs commit [projectname]
     in the working terminal, where:
     • username is your openoffice.org user login,
     • projectname.domain.net is the path to where the file lives, and
     • [projectname] is the name of a file or directory in the CVS file server.

     After you press enter, a cvs template will pop up in vi, a Unix text editor. Type A to begin the Insert mode at the end of the first line. Notice Insert shows at the bottom of the form during this mode. Add your entry. Use the arrow keys to drive around the template. The lines that begin with CVS are informative, and will not show as part of your commits. When your edits are complete, press the Esc key to leave the Insert mode. Type :wq to write and quit the cvs template. The template closes and the commit process continues in the working terminal window.

5. The commit is complete when your cursor comes back in the working terminal.

Examples of the commit command for user zzzzzz, (assuming pwd = /home/zzzzzz):

• Type
  cvs -d :pserver:zzzzzz@localhost:/cvs commit documentation
  in the second terminal to update the entire documentation directory, which is the entire project, with changes to those files on your system.
• Type
  cd documentation/www
  Type
  cvs -d :pserver:zzzzzz@localhost:/cvs commit faqs
  in the second terminal to update the entire faqs directory.
• Type
  cd documentation/www/faqs
  Type
  cvs -d :pserver:zzzzzz@localhost:/cvs commit -m "Add comments for the commit inside of the quotation marks." index.html
  in the second terminal to update only the index page from faqs directory.
• Type
  cd marketing/www
  Type
  cvs -d :pserver:zzzzzz@localhost:/cvs commit index.html
  in the second terminal to update only the index page from marketing project directory.
• Type
  cd qa/www
  Type
  cvs -d :pserver:zzzzzz@localhost:/cvs commit index.html
  in the second terminal to update only the index page from qa project directory.

Note: The commands commit or ci work to perform commits.

Tip: 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.

For more information:

• Contributing source code changes
• Comparing versions of files before you commit (diff)
• A.10 diff--Show differences between revisions
• Committing
• CVS Quick Reference
• Is there a place where I can see the CVS directory tree?

Documentation / User FAQ / Maintainers' FAQ / Previous-Next