Using CVS to update this page

To edit these pages, you need to check them out. This makes a local copy on your machine (laptop, workstation, or whatever). You edit the local copy, and then commit the changes. CVS supports concurrent editing, and will attempt to merge the changes of multiple authors. When conflicts occur, it tells you upon commiting the changes.

• The command to check out this website is:

     cvs -d :ext:gigasource.eecs.berkeley.edu:/home/cvs co metropolis
     enter your password
  

  This will create a directory "metropolis" with a subdirectory "web" with at least one file, "index.html". After this directory is created, you never need to do this again.
• Next time you want to edit files on the website, just go to this metropolis directory and type:

     cvs update -d -P
     enter your password
  

  It will update your local copies of the files.
• You can edit the index.html file, or any other file in the directory.
• You can add a new file or directory by putting it in the same directory and doing:

     cvs add filename.html  (if it's a text file)
     cvs add -kb filename.doc (for example, if it's a binary file)
  

  It's critical to remember the -kb for binary files (Word, PDF, etc.), or else CVS corrupts the file.
• To commit your changes do

     cvs commit -m "explanation of changes"
     enter your password
  

• Once you have committed the changes, you can make them visible on the website by going to the website and clicking on "CVS update" at the bottom of any page.

For more information, see How do I edit pages in a group with the "CVS Authoring" option?

The general CVS faq is at http://www.gigascale.org/softdevel/faq/1/

www.gigascale.org vs embedded

In fact, they share the same files because the embedded metropolis directory is merely a symbolic link to the gigascale metropolis site.

One artifact of this is that the we use JavaScript to adjust the links sometimes. See toc.html.