Contents

Repository Instructions

This page gives a brief overview of interfacting with our repositories using the standard "svn" command-line client, available here. You might prefer a graphical interface: some suggestions are available.

For a complete guide to Subversion, this (free!) on-line book is invaluable.

The document repository is poorly indexed, which can make things hard to find. There's an incomplete list of available documents on the LOFAR wiki to which you are encouraged to add.

Examples are for the document repository. For the code repository replace "docs" with code".

To import/upload a file:

(useful if you don't want to check out the repository to your local machine, but simply want to add a new document):
  • $ svn import mynewfile.pdf http://svn.transientskp.org/docs/Documents/mynewfile.pdf -m "adding new document"

To download a specific version of a file:

  • $ svn export http://svn.transientskp.org/docs/Documents/TKP_dcla_project_plan.pdf@30 ./TKP_project_plan_rev30.pdf
    ( creates "TKP_project_plan_rev30.pdf" locally )

To checkout the repository to a directory on your machine:

  • $ svn checkout http://svn.transientskp.org/docs/ tkp-document-repository
    ( creates "tkp-document-repository/" directory locally )

To checkout a specific version of the repository to a directory on your machine:

  • $ svn co http://svn.transientskp.org/docs@10 repository-rev10
    ( creates "repository-rev10/" directory locally )

To checkout only one directory in the repository to a directory on your machine:

  • $ svn co http://svn.transientskp.org/docs/Documents docs-only
    ( creates "docs-only/" directory locally)

To checkin a new version of an existing file:

  1. Modify documentX from within i.e. "tkp-document-repository/Documents" directory
  2. $ svn commit documentX -m "changed xxx"

To add new file(s):

  1. Create or copy documentY to "tkp-document-repository/Documents/" created above.
  2. $ svn add documentY documentZ (from within "tkp-document-repository/Documents/")
  3. $ svn commit -m "new document"

To remove file(s) from the list:

  1. $ svn remove documentA documentB (from within "tkp-document-repository/Documents/")
  2. $ svn commit -m "remove documents"

To move a file:

  1. $ svn move documentA directory/
  2. $ svn commit -m "move document to appropriate directory"
  • Note that file history is maintained!

To rename a file:

  1. $ svn rename oldname newname
  2. $ svn commit -m "gave file a more desciptive name"
  • Note that file history is maintained!

To view the history of a file:

    $ svn log filename

To check the status of your local repository:

  • From within the "tkp-document-repository/" directory:

    $ svn status

To bring your local copy of the repository up to date:

  • From within the "tkp-document-repository/" directory:

    $ svn update