Subversion Usage

For HSEB AWIPS and CHPS Projects

Created 9/19/08

Updated 11/18/08

# Introduction

The purpose of this document is to provide guidelines for effective
usage of version control using Subversion. It will *not* explain all the
options of every Subversion command. It *will* describe a general
process which developers can use to maintain control of their source
code over multiple releases. It will introduce the relevant commands
(with a minimum of discussion) as necessary for a discussion of the
whole process. Command details can be found by following the hyperlinks
in Section 5, in other online documentation such as at
[http://svnbook.red-bean.com](http://svnbook.red-bean.com/), and in
various books.

# Repository and Working Copies

Subversion stores version histories of files in a central repository.
The central repository can be located locally or remotely. HSEB uses
multiple repositories, all of which are accessible through CasaNOSA. In
general, a project that should be built and delivered independently as a
unit should be stored in its own repository or its own section of a
repository, if that repository contains multiple projects.

Unlike other version control systems, in the conventional usage of
Subversion, one does not lock files while they are being modified.
Instead, each developer first "checks out" a working copy of a portion
of the repository to a local file system. Then the user makes changes to
files within that working copy and "commits" them back to the
repository. The new versions of the files are then available to other
users.

# Trunks, Branches, and Tags

Subversion stores versions of files and directories. It doesn't
understand what you are doing with them, so users have come up with
standard conventions concerning high-level directory names within a
repository.

**Trunk** -- a directory under which the source code for latest
(unreleased) version of a system is stored and maintained. Developers
typically create their working copy from the trunk and commit their
changes there.

**Branch** -- a directory under which the source code is stored and
maintained and is usually created as a space in which to fix bugs and
make enhancements for a particular release. A branch exists as a
subdirectory under the **branches** directory. Developers normally use
branches to perform alternate lines of development on the same code.

**Tag** -- a directory in which a "snapshot" of a set of files is
stored, but not modified. The snapshot is useful to determine what files
were delivered for a release. The snapshot is also useful for
determining the minimal set of files which contain all the necessary
changes since a particular release. A tag exists as a subdirectory under
the **tags** directory. By convention, files should not be edited and
committed back to the tag directory, since that will make it no longer a
snapshot, but really a poorly-named branch.

# What to Store in the Repository

One should store only files required to re-create a release. For C and
FORTRAN, this means you should not store .o files. For Java programs,
you should not store .class files. Store non-generated .java, .c, .h,
.f, and scripts that are used to build, run, or test the system.

If your project uses code generators, do not store the generated code in
the repository, unless the code is generated once only and then modified
by hand. For example, the OHD-Common system uses generated code in C and
Java to access the IHFS database. The source code for the generator is
stored in Subversion, but the generated code is not stored there, since
it can be re-created by the generator and it is not modified by hand.

There may be a need to store externally-created library or jar files
when those files are not commonly available to the system. Examples of
this include Postgres drivers and even OHD libraries created from other
OHD projects.

Some applications may need to store images for icons.

One can assume that compilers and linkers, etc. are available and do not
need to be stored.

# Basic Commands

The following is a list of Subversion's commands, with links to the
document from which it was extracted,
**<http://svnbook.red-bean.com/en/1.1/ch09.html> .**

[[svn add]{.underline}](http://svnbook.red-bean.com/en/1.1/re01.html)

[[svn blame]{.underline}](http://svnbook.red-bean.com/en/1.1/re02.html)
= (svn praise, annotate, ann)

[[svn cat]{.underline}](http://svnbook.red-bean.com/en/1.1/re03.html)

[[svn
checkout]{.underline}](http://svnbook.red-bean.com/en/1.1/re04.html) =
(svn co)

[[svn
cleanup]{.underline}](http://svnbook.red-bean.com/en/1.1/re05.html)

[[svn commit]{.underline}](http://svnbook.red-bean.com/en/1.1/re06.html)
= (svn ci)

[[svn copy]{.underline}](http://svnbook.red-bean.com/en/1.1/re07.html) =
(svn cp)

[[svn delete]{.underline}](http://svnbook.red-bean.com/en/1.1/re08.html)
= (svn del, remove, rm)

[[svn diff]{.underline}](http://svnbook.red-bean.com/en/1.1/re09.html) =
(svn di)

[[svn export]{.underline}](http://svnbook.red-bean.com/en/1.1/re10.html)

[[svn help]{.underline}](http://svnbook.red-bean.com/en/1.1/re11.html) =
(svn ?, h)

[[svn import]{.underline}](http://svnbook.red-bean.com/en/1.1/re12.html)

[[svn info]{.underline}](http://svnbook.red-bean.com/en/1.1/re13.html)

[[svn list]{.underline}](http://svnbook.red-bean.com/en/1.1/re14.html) =
(svn ls)

[[svn log]{.underline}](http://svnbook.red-bean.com/en/1.1/re15.html)

[[svn merge]{.underline}](http://svnbook.red-bean.com/en/1.1/re16.html)

[[svn mkdir]{.underline}](http://svnbook.red-bean.com/en/1.1/re17.html)

[[svn move]{.underline}](http://svnbook.red-bean.com/en/1.1/re18.html) =
(svn mv, rename, ren)

[[svn
propdel]{.underline}](http://svnbook.red-bean.com/en/1.1/re19.html) =
(svn pdel, pd)

[[svn
propedit]{.underline}](http://svnbook.red-bean.com/en/1.1/re20.html) =
(svn pedit, pe)

[[svn
propget]{.underline}](http://svnbook.red-bean.com/en/1.1/re21.html) =
(svn pget, pg)

[[svn
proplist]{.underline}](http://svnbook.red-bean.com/en/1.1/re22.html) =
(svn plist, pl)

[[svn
propset]{.underline}](http://svnbook.red-bean.com/en/1.1/re23.html) =
(svn pset, ps)

[[svn
resolved]{.underline}](http://svnbook.red-bean.com/en/1.1/re24.html)

[[svn revert]{.underline}](http://svnbook.red-bean.com/en/1.1/re25.html)

[[svn status]{.underline}](http://svnbook.red-bean.com/en/1.1/re26.html)
= (svn stat, st)

[[svn switch]{.underline}](http://svnbook.red-bean.com/en/1.1/re27.html)
= (svn sw)

[[svn
update]{.underline}](http://svnbook.red-bean.com/en/1.1/re28.html)= (svn
up)

# Role Definitions

For clarity, this document defines various user roles. An individual
developer working with Subversion may fill one or more of these roles.
These roles will be used to describe reasonable Subversion usage in a
later section.

**Programmer** -- a developer who creates new code or changes existing
code.

**Release Manager** -- a developer who is responsible for delivering
either an executable system or the set of files required to build such a
system. Duties include managing tags and branches. (Q: Does your release
manager ever work with the trunk?)

# Programmer Role

The programmer's job is to create or modify code and then to get that
code into the repository. The subsections below show reasonable ways for
a **programmer** to use Subversion in various scenarios, such as
modifying existing code with or without conflicts and adding new code.

## Scenarios

+---+---------------------------------+----------------------------------+
|   | **[Scenario P1]{.underline} --  |                                  |
|   | Initial checkout from           |                                  |
|   | repository**                    |                                  |
|   |                                 |                                  |
|   | **Project :** ABC               |                                  |
|   |                                 |                                  |
|   | **Deliverables:** Source code + |                                  |
|   | build scripts + run scripts.    |                                  |
|   |                                 |                                  |
|   | **Working directory parent:**   |                                  |
|   | /                               |                                  |
|   | fs/hseb/pda/users/jschmoe/trunk |                                  |
+---+---------------------------------+----------------------------------+
| \ | **Steps**                       | **Details**                      |
| # |                                 |                                  |
+---+---------------------------------+----------------------------------+
| 1 | **cd                            | Use Linux command to switch to   |
|   | /fs                             | the directory the level          |
|   | /hseb/pda/users/jschmoe/trunk** | immediately above the desired    |
|   |                                 | working copy.                    |
+---+---------------------------------+----------------------------------+
| 2 | **svn co                        | Creates the SVN working copy     |
|   | <https://casan                  | "abc" in the                     |
|   | osa.noaa.gov/svn/ABC/abc/trunk> | **/f                             |
|   | abc**                           | s/hseb/pda/users/jschmoe/trunk** |
|   |                                 | directory, pointing to the abc   |
|   |                                 | project's trunk in the           |
|   |                                 | repository. If the string "abc"  |
|   |                                 | is omitted in the command, the   |
|   |                                 | working copy would be named      |
|   |                                 | "trunk", so the full path would  |
|   |                                 | have been                        |
|   |                                 |                                  |
|   |                                 | **/fs/hseb/                      |
|   |                                 | pda/users/jschmoe/trunk/trunk**. |
|   |                                 | To be consistent with working    |
|   |                                 | copies for branches and to avoid |
|   |                                 | needless redundancy, the         |
|   |                                 | previous naming convention was   |
|   |                                 | chosen. Using this convention,   |
|   |                                 | multiple working copies for      |
|   |                                 | various projects can be placed   |
|   |                                 | in the working copy parent named |
|   |                                 | "trunk".                         |
|   |                                 |                                  |
|   |                                 | **Note**: a user or project may  |
|   |                                 | adopt a convention such that the |
|   |                                 | omission of "trunk" as the       |
|   |                                 | working directory parent is      |
|   |                                 | represents the trunk by          |
|   |                                 | convention. In that case, the    |
|   |                                 | working directory parent could   |
|   |                                 | be                               |
|   |                                 | **/fs/hseb/pda/users/jschmoe**.  |
+---+---------------------------------+----------------------------------+

+---+------------------------+------------------------------------------+
| * |                        |                                          |
| * |                        |                                          |
| [ |                        |                                          |
| S |                        |                                          |
| c |                        |                                          |
| e |                        |                                          |
| n |                        |                                          |
| a |                        |                                          |
| r |                        |                                          |
| i |                        |                                          |
| o |                        |                                          |
| P |                        |                                          |
| 2 |                        |                                          |
| ] |                        |                                          |
| { |                        |                                          |
| . |                        |                                          |
| u |                        |                                          |
| n |                        |                                          |
| d |                        |                                          |
| e |                        |                                          |
| r |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| e |                        |                                          |
| } |                        |                                          |
| - |                        |                                          |
| - |                        |                                          |
| M |                        |                                          |
| o |                        |                                          |
| d |                        |                                          |
| i |                        |                                          |
| f |                        |                                          |
| y |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| g |                        |                                          |
| e |                        |                                          |
| x |                        |                                          |
| i |                        |                                          |
| s |                        |                                          |
| t |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| g |                        |                                          |
| c |                        |                                          |
| o |                        |                                          |
| d |                        |                                          |
| e |                        |                                          |
| w |                        |                                          |
| i |                        |                                          |
| t |                        |                                          |
| h |                        |                                          |
| n |                        |                                          |
| o |                        |                                          |
| c |                        |                                          |
| o |                        |                                          |
| n |                        |                                          |
| f |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| c |                        |                                          |
| t |                        |                                          |
| s |                        |                                          |
| * |                        |                                          |
| * |                        |                                          |
+---+------------------------+------------------------------------------+
| \ | **Steps**              | **Details**                              |
| # |                        |                                          |
+---+------------------------+------------------------------------------+
| 1 | change to the working  | At a shell prompt, the user changes to   |
|   | directory.             | the working copy. This directory         |
|   |                        | resulted from a prior svn checkout       |
|   | Example: **cd          | command.                                 |
|   | /hseb/pda/use          |                                          |
|   | rs/jschmoe/trunk/abc** |                                          |
+---+------------------------+------------------------------------------+
| 2 | **svn update**         | Retrieve the latest version of the code  |
|   |                        | from the repository into your working    |
|   |                        | copy.                                    |
+---+------------------------+------------------------------------------+
| 3 | modify one or more     | Make changes to source code or other     |
|   | existing files         | file(s).                                 |
+---+------------------------+------------------------------------------+
| 4 | **svn status -u**      | Shows what files have been modified in   |
|   |                        | your working copy, what files have been  |
|   |                        | changed in the repository since your     |
|   |                        | last update, and which files, if any,    |
|   |                        | conflict with your modifications. The    |
|   |                        | --u option is what forces the command to |
|   |                        | access the repository for this check.    |
+---+------------------------+------------------------------------------+
| 5 | **svn update**         | If anything has changed, as determined   |
|   |                        | in previous step, retrieve the latest    |
|   |                        | version of the code from the repository. |
+---+------------------------+------------------------------------------+
| 6 | build/test             | Build and test software to ensure that   |
|   |                        | it still compiles and works.             |
+---+------------------------+------------------------------------------+
| 7 | **svn commit**         | Put the changed code into the            |
|   |                        | repository.                              |
|   | Include informative    |                                          |
|   | comment with the       |                                          |
|   | commit.                |                                          |
+---+------------------------+------------------------------------------+

+---+-----------------------+-------------------------------------------+
| * |                       |                                           |
| * |                       |                                           |
| [ |                       |                                           |
| S |                       |                                           |
| c |                       |                                           |
| e |                       |                                           |
| n |                       |                                           |
| a |                       |                                           |
| r |                       |                                           |
| i |                       |                                           |
| o |                       |                                           |
| P |                       |                                           |
| 3 |                       |                                           |
| ] |                       |                                           |
| { |                       |                                           |
| . |                       |                                           |
| u |                       |                                           |
| n |                       |                                           |
| d |                       |                                           |
| e |                       |                                           |
| r |                       |                                           |
| l |                       |                                           |
| i |                       |                                           |
| n |                       |                                           |
| e |                       |                                           |
| } |                       |                                           |
| - |                       |                                           |
| - |                       |                                           |
| M |                       |                                           |
| o |                       |                                           |
| d |                       |                                           |
| i |                       |                                           |
| f |                       |                                           |
| y |                       |                                           |
| i |                       |                                           |
| n |                       |                                           |
| g |                       |                                           |
| e |                       |                                           |
| x |                       |                                           |
| i |                       |                                           |
| s |                       |                                           |
| t |                       |                                           |
| i |                       |                                           |
| n |                       |                                           |
| g |                       |                                           |
| c |                       |                                           |
| o |                       |                                           |
| d |                       |                                           |
| e |                       |                                           |
| w |                       |                                           |
| h |                       |                                           |
| i |                       |                                           |
| l |                       |                                           |
| e |                       |                                           |
| a |                       |                                           |
| v |                       |                                           |
| o |                       |                                           |
| i |                       |                                           |
| d |                       |                                           |
| i |                       |                                           |
| n |                       |                                           |
| g |                       |                                           |
| a |                       |                                           |
| n |                       |                                           |
| e |                       |                                           |
| x |                       |                                           |
| p |                       |                                           |
| l |                       |                                           |
| i |                       |                                           |
| c |                       |                                           |
| i |                       |                                           |
| t |                       |                                           |
| c |                       |                                           |
| o |                       |                                           |
| n |                       |                                           |
| f |                       |                                           |
| l |                       |                                           |
| i |                       |                                           |
| c |                       |                                           |
| t |                       |                                           |
| * |                       |                                           |
| * |                       |                                           |
|   |                       |                                           |
| * |                       |                                           |
| * |                       |                                           |
| N |                       |                                           |
| o |                       |                                           |
| t |                       |                                           |
| e |                       |                                           |
| : |                       |                                           |
| * |                       |                                           |
| * |                       |                                           |
| A |                       |                                           |
| v |                       |                                           |
| o |                       |                                           |
| i |                       |                                           |
| d |                       |                                           |
| i |                       |                                           |
| n |                       |                                           |
| g |                       |                                           |
| o |                       |                                           |
| r |                       |                                           |
| n |                       |                                           |
| o |                       |                                           |
| t |                       |                                           |
| a |                       |                                           |
| v |                       |                                           |
| o |                       |                                           |
| i |                       |                                           |
| d |                       |                                           |
| i |                       |                                           |
| n |                       |                                           |
| g |                       |                                           |
| a |                       |                                           |
| n |                       |                                           |
| e |                       |                                           |
| x |                       |                                           |
| p |                       |                                           |
| l |                       |                                           |
| i |                       |                                           |
| c |                       |                                           |
| i |                       |                                           |
| t |                       |                                           |
| c |                       |                                           |
| o |                       |                                           |
| n |                       |                                           |
| f |                       |                                           |
| l |                       |                                           |
| i |                       |                                           |
| c |                       |                                           |
| t |                       |                                           |
| i |                       |                                           |
| s |                       |                                           |
| a |                       |                                           |
| m |                       |                                           |
| a |                       |                                           |
| t |                       |                                           |
| t |                       |                                           |
| e |                       |                                           |
| r |                       |                                           |
| o |                       |                                           |
| f |                       |                                           |
| p |                       |                                           |
| r |                       |                                           |
| e |                       |                                           |
| f |                       |                                           |
| e |                       |                                           |
| r |                       |                                           |
| e |                       |                                           |
| n |                       |                                           |
| c |                       |                                           |
| e |                       |                                           |
| f |                       |                                           |
| o |                       |                                           |
| r |                       |                                           |
| a |                       |                                           |
| d |                       |                                           |
| e |                       |                                           |
| v |                       |                                           |
| e |                       |                                           |
| l |                       |                                           |
| o |                       |                                           |
| p |                       |                                           |
| e |                       |                                           |
| r |                       |                                           |
| . |                       |                                           |
| T |                       |                                           |
| h |                       |                                           |
| e |                       |                                           |
| p |                       |                                           |
| r |                       |                                           |
| o |                       |                                           |
| g |                       |                                           |
| r |                       |                                           |
| a |                       |                                           |
| m |                       |                                           |
| m |                       |                                           |
| e |                       |                                           |
| r |                       |                                           |
| m |                       |                                           |
| a |                       |                                           |
| y |                       |                                           |
| c |                       |                                           |
| h |                       |                                           |
| o |                       |                                           |
| o |                       |                                           |
| s |                       |                                           |
| e |                       |                                           |
| t |                       |                                           |
| o |                       |                                           |
| u |                       |                                           |
| s |                       |                                           |
| e |                       |                                           |
| e |                       |                                           |
| i |                       |                                           |
| t |                       |                                           |
| h |                       |                                           |
| e |                       |                                           |
| r |                       |                                           |
| S |                       |                                           |
| c |                       |                                           |
| e |                       |                                           |
| n |                       |                                           |
| a |                       |                                           |
| r |                       |                                           |
| i |                       |                                           |
| o |                       |                                           |
| P |                       |                                           |
| 3 |                       |                                           |
| o |                       |                                           |
| r |                       |                                           |
| P |                       |                                           |
| 4 |                       |                                           |
| w |                       |                                           |
| h |                       |                                           |
| e |                       |                                           |
| n |                       |                                           |
| d |                       |                                           |
| e |                       |                                           |
| a |                       |                                           |
| l |                       |                                           |
| i |                       |                                           |
| n |                       |                                           |
| g |                       |                                           |
| w |                       |                                           |
| i |                       |                                           |
| t |                       |                                           |
| h |                       |                                           |
| c |                       |                                           |
| o |                       |                                           |
| n |                       |                                           |
| f |                       |                                           |
| l |                       |                                           |
| i |                       |                                           |
| c |                       |                                           |
| t |                       |                                           |
| s |                       |                                           |
| . |                       |                                           |
+---+-----------------------+-------------------------------------------+
| \ | **Steps**             | **Details**                               |
| # |                       |                                           |
+---+-----------------------+-------------------------------------------+
| 1 | change to working     | At a shell prompt, the user changes to    |
|   | directory             | the working copy. This directory resulted |
|   |                       | from a prior svn checkout command, as     |
|   |                       | seen in **Scenario P1**.                  |
+---+-----------------------+-------------------------------------------+
| 2 | **svn update**        | Retrieve the latest version of the code   |
|   |                       | from the repository into your working     |
|   |                       | copy.                                     |
+---+-----------------------+-------------------------------------------+
| 3 | modify one or more    | Make changes to source code or other      |
|   | existing files        | file(s).                                  |
+---+-----------------------+-------------------------------------------+
| 4 | **svn status -u**     | Shows what files have been modified in    |
|   |                       | your workspace, what files have been      |
|   |                       | changed in the repository since your last |
|   |                       | update, and which files, if any, conflict |
|   |                       | with your modifications. The --u option   |
|   |                       | is what forces the command to access the  |
|   |                       | repository for this check.                |
+---+-----------------------+-------------------------------------------+
| 5 | avoid conflict        | At this point, the programmer will see    |
|   |                       | that there is a conflict and should       |
|   |                       | manually back up his/her modified version |
|   |                       | of the file for later merging. Use **svn  |
|   |                       | revert** to avoid an official conflict    |
|   |                       | that would have been recorded when using  |
|   |                       | svn update.                               |
+---+-----------------------+-------------------------------------------+
| 6 | **svn update**        | Retrieve the latest version of the files  |
|   |                       | from the repository.                      |
+---+-----------------------+-------------------------------------------+
| 7 | resolve file          | Modify files manually to merge the        |
|   | differences.          | changes you want with the updated files.  |
+---+-----------------------+-------------------------------------------+
| 8 | build/test            | Build and test software to ensure that it |
|   |                       | still compiles and works.                 |
+---+-----------------------+-------------------------------------------+
| 9 | **svn commit**        | Put the changed code into the repository. |
|   |                       |                                           |
|   | Include informative   |                                           |
|   | comment with the      |                                           |
|   | commit.               |                                           |
+---+-----------------------+-------------------------------------------+

+---+------------------------+------------------------------------------+
| * |                        |                                          |
| * |                        |                                          |
| [ |                        |                                          |
| S |                        |                                          |
| c |                        |                                          |
| e |                        |                                          |
| n |                        |                                          |
| a |                        |                                          |
| r |                        |                                          |
| i |                        |                                          |
| o |                        |                                          |
| P |                        |                                          |
| 4 |                        |                                          |
| ] |                        |                                          |
| { |                        |                                          |
| . |                        |                                          |
| u |                        |                                          |
| n |                        |                                          |
| d |                        |                                          |
| e |                        |                                          |
| r |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| e |                        |                                          |
| } |                        |                                          |
| - |                        |                                          |
| - |                        |                                          |
| M |                        |                                          |
| o |                        |                                          |
| d |                        |                                          |
| i |                        |                                          |
| f |                        |                                          |
| y |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| g |                        |                                          |
| e |                        |                                          |
| x |                        |                                          |
| i |                        |                                          |
| s |                        |                                          |
| t |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| g |                        |                                          |
| c |                        |                                          |
| o |                        |                                          |
| d |                        |                                          |
| e |                        |                                          |
| w |                        |                                          |
| i |                        |                                          |
| t |                        |                                          |
| h |                        |                                          |
| a |                        |                                          |
| n |                        |                                          |
| e |                        |                                          |
| x |                        |                                          |
| p |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| c |                        |                                          |
| i |                        |                                          |
| t |                        |                                          |
| c |                        |                                          |
| o |                        |                                          |
| n |                        |                                          |
| f |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| c |                        |                                          |
| t |                        |                                          |
| * |                        |                                          |
| * |                        |                                          |
|   |                        |                                          |
| * |                        |                                          |
| * |                        |                                          |
| N |                        |                                          |
| o |                        |                                          |
| t |                        |                                          |
| e |                        |                                          |
| : |                        |                                          |
| * |                        |                                          |
| * |                        |                                          |
| A |                        |                                          |
| v |                        |                                          |
| o |                        |                                          |
| i |                        |                                          |
| d |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| g |                        |                                          |
| o |                        |                                          |
| r |                        |                                          |
| n |                        |                                          |
| o |                        |                                          |
| t |                        |                                          |
| a |                        |                                          |
| v |                        |                                          |
| o |                        |                                          |
| i |                        |                                          |
| d |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| g |                        |                                          |
| a |                        |                                          |
| n |                        |                                          |
| e |                        |                                          |
| x |                        |                                          |
| p |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| c |                        |                                          |
| i |                        |                                          |
| t |                        |                                          |
| c |                        |                                          |
| o |                        |                                          |
| n |                        |                                          |
| f |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| c |                        |                                          |
| t |                        |                                          |
| i |                        |                                          |
| s |                        |                                          |
| a |                        |                                          |
| m |                        |                                          |
| a |                        |                                          |
| t |                        |                                          |
| t |                        |                                          |
| e |                        |                                          |
| r |                        |                                          |
| o |                        |                                          |
| f |                        |                                          |
| p |                        |                                          |
| r |                        |                                          |
| e |                        |                                          |
| f |                        |                                          |
| e |                        |                                          |
| r |                        |                                          |
| e |                        |                                          |
| n |                        |                                          |
| c |                        |                                          |
| e |                        |                                          |
| f |                        |                                          |
| o |                        |                                          |
| r |                        |                                          |
| a |                        |                                          |
| d |                        |                                          |
| e |                        |                                          |
| v |                        |                                          |
| e |                        |                                          |
| l |                        |                                          |
| o |                        |                                          |
| p |                        |                                          |
| e |                        |                                          |
| r |                        |                                          |
| . |                        |                                          |
| T |                        |                                          |
| h |                        |                                          |
| e |                        |                                          |
| p |                        |                                          |
| r |                        |                                          |
| o |                        |                                          |
| g |                        |                                          |
| r |                        |                                          |
| a |                        |                                          |
| m |                        |                                          |
| m |                        |                                          |
| e |                        |                                          |
| r |                        |                                          |
| m |                        |                                          |
| a |                        |                                          |
| y |                        |                                          |
| c |                        |                                          |
| h |                        |                                          |
| o |                        |                                          |
| o |                        |                                          |
| s |                        |                                          |
| e |                        |                                          |
| t |                        |                                          |
| o |                        |                                          |
| u |                        |                                          |
| s |                        |                                          |
| e |                        |                                          |
| e |                        |                                          |
| i |                        |                                          |
| t |                        |                                          |
| h |                        |                                          |
| e |                        |                                          |
| r |                        |                                          |
| S |                        |                                          |
| c |                        |                                          |
| e |                        |                                          |
| n |                        |                                          |
| a |                        |                                          |
| r |                        |                                          |
| i |                        |                                          |
| o |                        |                                          |
| P |                        |                                          |
| 3 |                        |                                          |
| o |                        |                                          |
| r |                        |                                          |
| P |                        |                                          |
| 4 |                        |                                          |
| w |                        |                                          |
| h |                        |                                          |
| e |                        |                                          |
| n |                        |                                          |
| d |                        |                                          |
| e |                        |                                          |
| a |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| g |                        |                                          |
| w |                        |                                          |
| i |                        |                                          |
| t |                        |                                          |
| h |                        |                                          |
| c |                        |                                          |
| o |                        |                                          |
| n |                        |                                          |
| f |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| c |                        |                                          |
| t |                        |                                          |
| s |                        |                                          |
| . |                        |                                          |
+---+------------------------+------------------------------------------+
| * | **Steps**              | **Details**                              |
| * |                        |                                          |
| \ |                        |                                          |
| # |                        |                                          |
| * |                        |                                          |
| * |                        |                                          |
+---+------------------------+------------------------------------------+
| 1 | change to working      | At a shell prompt, the user changes to   |
|   | directory              | the working copy. This directory         |
|   |                        | resulted from a prior svn checkout       |
|   |                        | command.                                 |
+---+------------------------+------------------------------------------+
| 2 | **svn update**         | Retrieve the latest version of the code  |
|   |                        | from the repository into your working    |
|   |                        | copy.                                    |
+---+------------------------+------------------------------------------+
| 3 | modify one or more     | Make changes to source code or other     |
|   | existing files         | file(s).                                 |
+---+------------------------+------------------------------------------+
| 4 | **svn status -u**      | Check to see what effect your changes    |
|   |                        | may have.                                |
+---+------------------------+------------------------------------------+
| 5 | **svn update**         | Retrieve the latest version of the files |
|   |                        | from the repository.                     |
+---+------------------------+------------------------------------------+
| 6 | resolve file           | There will be several versions of the    |
|   | differences            | conflicted file added to your working    |
|   |                        | copy. These include 1) the most current  |
|   |                        | in the repository, 2) the version you    |
|   |                        | attempted to commit, and 3) the version  |
|   |                        | in your workspace before you made        |
|   |                        | changes to the file. The original file   |
|   |                        | will have special markers in it that     |
|   |                        | will indicate the places of conflict.    |
|   |                        | Examine the various files and modify the |
|   |                        | original file, remembering to remove the |
|   |                        | conflict markers.                        |
+---+------------------------+------------------------------------------+
| 7 | **svn resolve          | The conflict is known to Subversion and  |
|   | \<filename\>** for     | thus requires a Subversion command to    |
|   | every conflicted file  | resolve it. Using this command will get  |
|   |                        | rid of the extra versions of the         |
|   |                        | conflicted file.                         |
+---+------------------------+------------------------------------------+
| 8 | build/test             | Build and test software to ensure that   |
|   |                        | it still compiles and works.             |
+---+------------------------+------------------------------------------+
| 9 | **svn commit**         | Put the changed code into the            |
|   |                        | repository.                              |
|   | Include an informative |                                          |
|   | comment.               |                                          |
+---+------------------------+------------------------------------------+

+---+------------------------+------------------------------------------+
| * |                        |                                          |
| * |                        |                                          |
| [ |                        |                                          |
| S |                        |                                          |
| c |                        |                                          |
| e |                        |                                          |
| n |                        |                                          |
| a |                        |                                          |
| r |                        |                                          |
| i |                        |                                          |
| o |                        |                                          |
| P |                        |                                          |
| 5 |                        |                                          |
| ] |                        |                                          |
| { |                        |                                          |
| . |                        |                                          |
| u |                        |                                          |
| n |                        |                                          |
| d |                        |                                          |
| e |                        |                                          |
| r |                        |                                          |
| l |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| e |                        |                                          |
| } |                        |                                          |
| - |                        |                                          |
| - |                        |                                          |
| A |                        |                                          |
| d |                        |                                          |
| d |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| g |                        |                                          |
| c |                        |                                          |
| o |                        |                                          |
| d |                        |                                          |
| e |                        |                                          |
| i |                        |                                          |
| n |                        |                                          |
| a |                        |                                          |
| n |                        |                                          |
| e |                        |                                          |
| w |                        |                                          |
| s |                        |                                          |
| o |                        |                                          |
| u |                        |                                          |
| r |                        |                                          |
| c |                        |                                          |
| e |                        |                                          |
| f |                        |                                          |
| i |                        |                                          |
| l |                        |                                          |
| e |                        |                                          |
| * |                        |                                          |
| * |                        |                                          |
+---+------------------------+------------------------------------------+
| * | **Steps**              | **Details**                              |
| * |                        |                                          |
| \ |                        |                                          |
| # |                        |                                          |
| * |                        |                                          |
| * |                        |                                          |
+---+------------------------+------------------------------------------+
| 1 | change to working      | At a shell prompt, the user changes to   |
|   | directory              | the working copy. This directory         |
|   |                        | resulted from a prior svn checkout       |
|   |                        | command.                                 |
+---+------------------------+------------------------------------------+
| 2 | **svn update**         | Retrieve the latest version of the code  |
|   |                        | from the repository into your working    |
|   |                        | copy.                                    |
+---+------------------------+------------------------------------------+
| 3 | add a new source code  | Create a new file containing source      |
|   | file.                  | code.                                    |
+---+------------------------+------------------------------------------+
| 4 | **svn add              | Tell Subversion that the new file        |
|   | \<filename\>**         | exists.                                  |
+---+------------------------+------------------------------------------+
| 5 | build/test             | Build and test software to ensure that   |
|   |                        | it still compiles and works.             |
+---+------------------------+------------------------------------------+
| 6 | **svn commit**         | Put the new code into the repository.    |
|   |                        |                                          |
|   | Include an informative |                                          |
|   | comment.               |                                          |
+---+------------------------+------------------------------------------+

+---+--------------------+----------------------------------------------+
| * |                    |                                              |
| * |                    |                                              |
| [ |                    |                                              |
| S |                    |                                              |
| c |                    |                                              |
| e |                    |                                              |
| n |                    |                                              |
| a |                    |                                              |
| r |                    |                                              |
| i |                    |                                              |
| o |                    |                                              |
| P |                    |                                              |
| 6 |                    |                                              |
| ] |                    |                                              |
| { |                    |                                              |
| . |                    |                                              |
| u |                    |                                              |
| n |                    |                                              |
| d |                    |                                              |
| e |                    |                                              |
| r |                    |                                              |
| l |                    |                                              |
| i |                    |                                              |
| n |                    |                                              |
| e |                    |                                              |
| } |                    |                                              |
| - |                    |                                              |
| - |                    |                                              |
| C |                    |                                              |
| h |                    |                                              |
| a |                    |                                              |
| n |                    |                                              |
| g |                    |                                              |
| i |                    |                                              |
| n |                    |                                              |
| g |                    |                                              |
| t |                    |                                              |
| h |                    |                                              |
| e |                    |                                              |
| n |                    |                                              |
| a |                    |                                              |
| m |                    |                                              |
| e |                    |                                              |
| o |                    |                                              |
| f |                    |                                              |
| a |                    |                                              |
| s |                    |                                              |
| o |                    |                                              |
| u |                    |                                              |
| r |                    |                                              |
| c |                    |                                              |
| e |                    |                                              |
| f |                    |                                              |
| i |                    |                                              |
| l |                    |                                              |
| e |                    |                                              |
| o |                    |                                              |
| r |                    |                                              |
| i |                    |                                              |
| t |                    |                                              |
| s |                    |                                              |
| d |                    |                                              |
| i |                    |                                              |
| r |                    |                                              |
| e |                    |                                              |
| c |                    |                                              |
| t |                    |                                              |
| o |                    |                                              |
| r |                    |                                              |
| y |                    |                                              |
| . |                    |                                              |
| * |                    |                                              |
| * |                    |                                              |
+---+--------------------+----------------------------------------------+
| * | **Steps**          | **Details**                                  |
| * |                    |                                              |
| \ |                    |                                              |
| # |                    |                                              |
| * |                    |                                              |
| * |                    |                                              |
+---+--------------------+----------------------------------------------+
| 1 | change to working  | At a shell prompt, the user changes to the   |
|   | copy               | working copy. This directory resulted from a |
|   |                    | prior svn checkout command.                  |
+---+--------------------+----------------------------------------------+
| 2 | **svn update**     | Retrieve the latest version of the code from |
|   |                    | the repository into your working copy.       |
+---+--------------------+----------------------------------------------+
| 3 | **svn rename**     | Rename a file or move the file to a          |
|   | \<original         | different directory. Two things happen: 1)   |
|   | filename\> \<new   | the file is renamed or moved in your working |
|   | filename\>         | directory tree and 2) Subversion is prepared |
|   |                    | to rename or move the file in the repository |
|   |                    | once the **svn commit** has been issued.     |
+---+--------------------+----------------------------------------------+
| 4 | build/test         | Build and test software to ensure that it    |
|   |                    | still compiles and works.                    |
+---+--------------------+----------------------------------------------+
| 5 | **svn commit**     | To rename the file, Subversion will use a    |
|   |                    | delete command and an add command on the old |
|   | Include an         | name and new name of the file.               |
|   | informative        |                                              |
|   | comment.           |                                              |
+---+--------------------+----------------------------------------------+

## Programmer Rules

When committing files to the repository, please attempt to follow these
rules:

1.  Don't break the build. Make sure that the files you commit will
    allow the project to compile successfully. It is permissible to
    commit with bugs, since the times between commits might be much too
    long if commits required perfectly working code. It should be a rare
    case, though for the changes to introduce known, new bugs.

2.  Commit logically-grouped changes at the same time. For example, if
    you make changes to five different files for one bug fix, then
    commit all five changes files at the same time. Don't commit one
    file at a time. This way, you won't violate rule #1. A partial fix
    may break the build, even if only for a short time. Occasional
    broken builds are not a big problem, but they should be avoided.

3.  To avoid huge integration headaches, commit frequently. If you wait
    too long, you will not be able to follow rule #2 and you are more
    likely to have a large number of incompatibilities between your code
    and other programmers' code. Commit frequently and you will have the
    opportunity for better communication with other developers,
    preventing problems early.

4.  Update before committing. You need to be using the latest files
    available for the release.

5.  In general, work in the trunk and then arrange with the Release
    Manager to determine which files belong in the release branch. Then
    move them there and complete Scenarios P1-P3.*\
    *

6.  When making a change to a branch, do not forget to update the trunk
    as appropriate. If you do not update the trunk, bugs may
    mysteriously reappear in future releases. One way to avoid this
    problem is to make changes first in the trunk and then make the
    changes in the branch.

7.  A programmer can have several working copies that each point to
    different Subversion repositories or different parts of a single
    repository. Pay attention to where your working copy is pointing in
    the Subversion repository: the trunk, a branch, or a tag. Use **svn
    info** to check. If you do not pay attention to this, you may find
    that you committed code to the wrong portion of the repository.

8.  Don't use **svn switch** in the middle of a working copy tree. Use
    it only at the top of your working copy tree, as it can really
    corrupt your working copy if done incorrectly, leaving you with a
    working copy tree that points to multiple parts of the repository.

# Release Manager Role

The role of the Release Manager is to ensure that the proper files are
held in a release branch, so that the correct files can be delivered
(whether they are source code to be delivered to a third party or the
executables built from the versioned source code).

## Release Manager Scenarios

+---+-------------------------------------------+----------------------+
| * |                                           |                      |
| * |                                           |                      |
| [ |                                           |                      |
| S |                                           |                      |
| c |                                           |                      |
| e |                                           |                      |
| n |                                           |                      |
| a |                                           |                      |
| r |                                           |                      |
| i |                                           |                      |
| o |                                           |                      |
| R |                                           |                      |
| M |                                           |                      |
| - |                                           |                      |
| 1 |                                           |                      |
| ] |                                           |                      |
| { |                                           |                      |
| . |                                           |                      |
| u |                                           |                      |
| n |                                           |                      |
| d |                                           |                      |
| e |                                           |                      |
| r |                                           |                      |
| l |                                           |                      |
| i |                                           |                      |
| n |                                           |                      |
| e |                                           |                      |
| } |                                           |                      |
|   |                                           |                      |
| - |                                           |                      |
| C |                                           |                      |
| r |                                           |                      |
| e |                                           |                      |
| a |                                           |                      |
| t |                                           |                      |
| i |                                           |                      |
| n |                                           |                      |
| g |                                           |                      |
| a |                                           |                      |
| r |                                           |                      |
| e |                                           |                      |
| l |                                           |                      |
| e |                                           |                      |
| a |                                           |                      |
| s |                                           |                      |
| e |                                           |                      |
| b |                                           |                      |
| r |                                           |                      |
| a |                                           |                      |
| n |                                           |                      |
| c |                                           |                      |
| h |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
|   |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
| P |                                           |                      |
| r |                                           |                      |
| o |                                           |                      |
| j |                                           |                      |
| e |                                           |                      |
| c |                                           |                      |
| t |                                           |                      |
| : |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
| A |                                           |                      |
| B |                                           |                      |
| C |                                           |                      |
|   |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
| D |                                           |                      |
| e |                                           |                      |
| l |                                           |                      |
| i |                                           |                      |
| v |                                           |                      |
| e |                                           |                      |
| r |                                           |                      |
| a |                                           |                      |
| b |                                           |                      |
| l |                                           |                      |
| e |                                           |                      |
| s |                                           |                      |
| : |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
| S |                                           |                      |
| o |                                           |                      |
| u |                                           |                      |
| r |                                           |                      |
| c |                                           |                      |
| e |                                           |                      |
| c |                                           |                      |
| o |                                           |                      |
| d |                                           |                      |
| e |                                           |                      |
|   |                                           |                      |
| + |                                           |                      |
| b |                                           |                      |
| u |                                           |                      |
| i |                                           |                      |
| l |                                           |                      |
| d |                                           |                      |
| s |                                           |                      |
| c |                                           |                      |
| r |                                           |                      |
| i |                                           |                      |
| p |                                           |                      |
| t |                                           |                      |
| s |                                           |                      |
|   |                                           |                      |
| + |                                           |                      |
| r |                                           |                      |
| u |                                           |                      |
| n |                                           |                      |
| s |                                           |                      |
| c |                                           |                      |
| r |                                           |                      |
| i |                                           |                      |
| p |                                           |                      |
| t |                                           |                      |
| s |                                           |                      |
| . |                                           |                      |
|   |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
| W |                                           |                      |
| o |                                           |                      |
| r |                                           |                      |
| k |                                           |                      |
| i |                                           |                      |
| n |                                           |                      |
| g |                                           |                      |
| d |                                           |                      |
| i |                                           |                      |
| r |                                           |                      |
| e |                                           |                      |
| c |                                           |                      |
| t |                                           |                      |
| o |                                           |                      |
| r |                                           |                      |
| y |                                           |                      |
| g |                                           |                      |
| r |                                           |                      |
| a |                                           |                      |
| n |                                           |                      |
| d |                                           |                      |
| p |                                           |                      |
| a |                                           |                      |
| r |                                           |                      |
| e |                                           |                      |
| n |                                           |                      |
| t |                                           |                      |
| : |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
| / |                                           |                      |
| f |                                           |                      |
| s |                                           |                      |
| / |                                           |                      |
| h |                                           |                      |
| s |                                           |                      |
| e |                                           |                      |
| b |                                           |                      |
| / |                                           |                      |
| p |                                           |                      |
| d |                                           |                      |
| a |                                           |                      |
| / |                                           |                      |
| u |                                           |                      |
| s |                                           |                      |
| e |                                           |                      |
| r |                                           |                      |
| s |                                           |                      |
| / |                                           |                      |
| j |                                           |                      |
| s |                                           |                      |
| c |                                           |                      |
| h |                                           |                      |
| m |                                           |                      |
| o |                                           |                      |
| e |                                           |                      |
| / |                                           |                      |
|   |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
| W |                                           |                      |
| o |                                           |                      |
| r |                                           |                      |
| k |                                           |                      |
| i |                                           |                      |
| n |                                           |                      |
| g |                                           |                      |
| d |                                           |                      |
| i |                                           |                      |
| r |                                           |                      |
| e |                                           |                      |
| c |                                           |                      |
| t |                                           |                      |
| o |                                           |                      |
| r |                                           |                      |
| y |                                           |                      |
| p |                                           |                      |
| a |                                           |                      |
| r |                                           |                      |
| e |                                           |                      |
| n |                                           |                      |
| t |                                           |                      |
| : |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
| / |                                           |                      |
| f |                                           |                      |
| s |                                           |                      |
| / |                                           |                      |
| h |                                           |                      |
| s |                                           |                      |
| e |                                           |                      |
| b |                                           |                      |
| / |                                           |                      |
| p |                                           |                      |
| d |                                           |                      |
| a |                                           |                      |
| / |                                           |                      |
| u |                                           |                      |
| s |                                           |                      |
| e |                                           |                      |
| r |                                           |                      |
| s |                                           |                      |
| / |                                           |                      |
| j |                                           |                      |
| s |                                           |                      |
| c |                                           |                      |
| h |                                           |                      |
| m |                                           |                      |
| o |                                           |                      |
| e |                                           |                      |
| / |                                           |                      |
| o |                                           |                      |
| b |                                           |                      |
| 9 |                                           |                      |
| 0 |                                           |                      |
+---+-------------------------------------------+----------------------+
| * | **Steps**                                 | **Details**          |
| * |                                           |                      |
| \ |                                           |                      |
| # |                                           |                      |
| * |                                           |                      |
| * |                                           |                      |
+---+-------------------------------------------+----------------------+
| 1 | \<all one line\>                          | Copies the trunk to  |
|   |                                           | the OB9.0 branch for |
|   | **svn cp                                  | later modification.  |
|   | <htt                                      |                      |
|   | ps://casanosa.noaa.gov/svn/ABC/abc/trunk> |                      |
|   | https://ca                                |                      |
|   | sanosa.noaa.gov/svn/ABC/abc/branches/ob90 |                      |
|   | -m \"Copy the files from trunk to ob90    |                      |
|   | branch\"**                                |                      |
+---+-------------------------------------------+----------------------+
| 2 | Change to the working directory           | Use Linux commands   |
|   | grandparent. Create the parent directory  | for this. Let the    |
|   | and change to it.\                        | userid be "jschmoe"  |
|   | **cd /fs/hseb/pda/users/jschmoe/**        | and the overall      |
|   |                                           | project name be      |
|   | **mkdir ob90**                            | "abc". The release   |
|   |                                           | version is 9.0.      |
|   | **cd ob90**                               |                      |
+---+-------------------------------------------+----------------------+
| 3 | **svn co                                  | Check out the branch |
|   | https://ca                                | to your branch       |
|   | sanosa.noaa.gov/svn/ABC/abc/branches/ob90 | working copy, named  |
|   | abc**                                     | abc.                 |
+---+-------------------------------------------+----------------------+
| 4 | change/add/remove files as needed for the | Remove any           |
|   | build                                     | experimental work or |
|   |                                           | work that is planned |
|   | **svn add \<filename\>**                  | for a future         |
|   |                                           | release. Change any  |
|   | **svn rm \<filename\>**                   | build files as       |
|   |                                           | needed to take out   |
|   |                                           | anything not to be   |
|   |                                           | delivered in the     |
|   |                                           | release.             |
+---+-------------------------------------------+----------------------+
| 5 | build/test                                | Build and test       |
|   |                                           | software to ensure   |
|   |                                           | that it still        |
|   |                                           | compiles and works.  |
+---+-------------------------------------------+----------------------+
| 6 | **svn commit**                            | Put the changed code |
|   |                                           | into the repository. |
|   |                                           | Include informative  |
|   |                                           | comment with the     |
|   |                                           | commit.              |
+---+-------------------------------------------+----------------------+

+---+-----------------------------------+-------------------------------+
| * |                                   |                               |
| * |                                   |                               |
| [ |                                   |                               |
| S |                                   |                               |
| c |                                   |                               |
| e |                                   |                               |
| n |                                   |                               |
| a |                                   |                               |
| r |                                   |                               |
| i |                                   |                               |
| o |                                   |                               |
| R |                                   |                               |
| M |                                   |                               |
| - |                                   |                               |
| 2 |                                   |                               |
| ] |                                   |                               |
| { |                                   |                               |
| . |                                   |                               |
| u |                                   |                               |
| n |                                   |                               |
| d |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
| l |                                   |                               |
| i |                                   |                               |
| n |                                   |                               |
| e |                                   |                               |
| } |                                   |                               |
|   |                                   |                               |
| - |                                   |                               |
| D |                                   |                               |
| e |                                   |                               |
| t |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
| m |                                   |                               |
| i |                                   |                               |
| n |                                   |                               |
| i |                                   |                               |
| n |                                   |                               |
| g |                                   |                               |
| w |                                   |                               |
| h |                                   |                               |
| a |                                   |                               |
| t |                                   |                               |
| f |                                   |                               |
| i |                                   |                               |
| l |                                   |                               |
| e |                                   |                               |
| s |                                   |                               |
| h |                                   |                               |
| a |                                   |                               |
| v |                                   |                               |
| e |                                   |                               |
| c |                                   |                               |
| h |                                   |                               |
| a |                                   |                               |
| n |                                   |                               |
| g |                                   |                               |
| e |                                   |                               |
| d |                                   |                               |
| f |                                   |                               |
| r |                                   |                               |
| o |                                   |                               |
| m |                                   |                               |
| o |                                   |                               |
| n |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
| e |                                   |                               |
| l |                                   |                               |
| e |                                   |                               |
| a |                                   |                               |
| s |                                   |                               |
| e |                                   |                               |
| t |                                   |                               |
| o |                                   |                               |
| a |                                   |                               |
| n |                                   |                               |
| o |                                   |                               |
| t |                                   |                               |
| h |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
| . |                                   |                               |
| O |                                   |                               |
| p |                                   |                               |
| t |                                   |                               |
| i |                                   |                               |
| o |                                   |                               |
| n |                                   |                               |
| 1 |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
|   |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| P |                                   |                               |
| r |                                   |                               |
| o |                                   |                               |
| j |                                   |                               |
| e |                                   |                               |
| c |                                   |                               |
| t |                                   |                               |
| : |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| A |                                   |                               |
| B |                                   |                               |
| C |                                   |                               |
|   |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| D |                                   |                               |
| e |                                   |                               |
| l |                                   |                               |
| i |                                   |                               |
| v |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
| a |                                   |                               |
| b |                                   |                               |
| l |                                   |                               |
| e |                                   |                               |
| s |                                   |                               |
| : |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| S |                                   |                               |
| o |                                   |                               |
| u |                                   |                               |
| r |                                   |                               |
| c |                                   |                               |
| e |                                   |                               |
| c |                                   |                               |
| o |                                   |                               |
| d |                                   |                               |
| e |                                   |                               |
|   |                                   |                               |
| + |                                   |                               |
| b |                                   |                               |
| u |                                   |                               |
| i |                                   |                               |
| l |                                   |                               |
| d |                                   |                               |
| s |                                   |                               |
| c |                                   |                               |
| r |                                   |                               |
| i |                                   |                               |
| p |                                   |                               |
| t |                                   |                               |
| s |                                   |                               |
|   |                                   |                               |
| + |                                   |                               |
| r |                                   |                               |
| u |                                   |                               |
| n |                                   |                               |
| s |                                   |                               |
| c |                                   |                               |
| r |                                   |                               |
| i |                                   |                               |
| p |                                   |                               |
| t |                                   |                               |
| s |                                   |                               |
| . |                                   |                               |
|   |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| P |                                   |                               |
| r |                                   |                               |
| e |                                   |                               |
| v |                                   |                               |
| i |                                   |                               |
| o |                                   |                               |
| u |                                   |                               |
| s |                                   |                               |
| l |                                   |                               |
| y |                                   |                               |
| d |                                   |                               |
| e |                                   |                               |
| l |                                   |                               |
| i |                                   |                               |
| v |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
| e |                                   |                               |
| d |                                   |                               |
| r |                                   |                               |
| e |                                   |                               |
| l |                                   |                               |
| e |                                   |                               |
| a |                                   |                               |
| s |                                   |                               |
| e |                                   |                               |
| : |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| t |                                   |                               |
| a |                                   |                               |
| g |                                   |                               |
| s |                                   |                               |
| / |                                   |                               |
| o |                                   |                               |
| b |                                   |                               |
| 9 |                                   |                               |
| 0 |                                   |                               |
| _ |                                   |                               |
| p |                                   |                               |
| o |                                   |                               |
| s |                                   |                               |
| t |                                   |                               |
| _ |                                   |                               |
| p |                                   |                               |
| i |                                   |                               |
| t |                                   |                               |
| 2 |                                   |                               |
| ( |                                   |                               |
| 2 |                                   |                               |
| d |                                   |                               |
| e |                                   |                               |
| l |                                   |                               |
| i |                                   |                               |
| v |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
| i |                                   |                               |
| e |                                   |                               |
| s |                                   |                               |
| a |                                   |                               |
| f |                                   |                               |
| t |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
| P |                                   |                               |
| I |                                   |                               |
| T |                                   |                               |
| ) |                                   |                               |
|   |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| N |                                   |                               |
| e |                                   |                               |
| w |                                   |                               |
| r |                                   |                               |
| e |                                   |                               |
| l |                                   |                               |
| e |                                   |                               |
| a |                                   |                               |
| s |                                   |                               |
| e |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| : |                                   |                               |
| / |                                   |                               |
| b |                                   |                               |
| r |                                   |                               |
| a |                                   |                               |
| n |                                   |                               |
| c |                                   |                               |
| h |                                   |                               |
| e |                                   |                               |
| s |                                   |                               |
| / |                                   |                               |
| o |                                   |                               |
| b |                                   |                               |
| 9 |                                   |                               |
| 1 |                                   |                               |
|   |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| W |                                   |                               |
| o |                                   |                               |
| r |                                   |                               |
| k |                                   |                               |
| i |                                   |                               |
| n |                                   |                               |
| g |                                   |                               |
| d |                                   |                               |
| i |                                   |                               |
| r |                                   |                               |
| e |                                   |                               |
| c |                                   |                               |
| t |                                   |                               |
| o |                                   |                               |
| r |                                   |                               |
| y |                                   |                               |
| : |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| / |                                   |                               |
| f |                                   |                               |
| s |                                   |                               |
| / |                                   |                               |
| h |                                   |                               |
| s |                                   |                               |
| e |                                   |                               |
| b |                                   |                               |
| / |                                   |                               |
| p |                                   |                               |
| d |                                   |                               |
| a |                                   |                               |
| / |                                   |                               |
| u |                                   |                               |
| s |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
| s |                                   |                               |
| / |                                   |                               |
| j |                                   |                               |
| s |                                   |                               |
| c |                                   |                               |
| h |                                   |                               |
| m |                                   |                               |
| o |                                   |                               |
| e |                                   |                               |
| / |                                   |                               |
| s |                                   |                               |
| w |                                   |                               |
| i |                                   |                               |
| t |                                   |                               |
| c |                                   |                               |
| h |                                   |                               |
| e |                                   |                               |
| r |                                   |                               |
|   |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| N |                                   |                               |
| o |                                   |                               |
| t |                                   |                               |
| e |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
| : |                                   |                               |
| I |                                   |                               |
| t |                                   |                               |
| i |                                   |                               |
| s |                                   |                               |
| b |                                   |                               |
| e |                                   |                               |
| s |                                   |                               |
| t |                                   |                               |
| t |                                   |                               |
| o |                                   |                               |
| d |                                   |                               |
| o |                                   |                               |
| t |                                   |                               |
| h |                                   |                               |
| i |                                   |                               |
| s |                                   |                               |
| k |                                   |                               |
| i |                                   |                               |
| n |                                   |                               |
| d |                                   |                               |
| o |                                   |                               |
| f |                                   |                               |
| c |                                   |                               |
| h |                                   |                               |
| e |                                   |                               |
| c |                                   |                               |
| k |                                   |                               |
| i |                                   |                               |
| n |                                   |                               |
| g |                                   |                               |
| w |                                   |                               |
| i |                                   |                               |
| t |                                   |                               |
| h |                                   |                               |
| a |                                   |                               |
| s |                                   |                               |
| c |                                   |                               |
| r |                                   |                               |
| i |                                   |                               |
| p |                                   |                               |
| t |                                   |                               |
| , |                                   |                               |
| s |                                   |                               |
| o |                                   |                               |
| t |                                   |                               |
| h |                                   |                               |
| a |                                   |                               |
| t |                                   |                               |
| i |                                   |                               |
| t |                                   |                               |
| i |                                   |                               |
| s |                                   |                               |
| r |                                   |                               |
| e |                                   |                               |
| p |                                   |                               |
| e |                                   |                               |
| a |                                   |                               |
| t |                                   |                               |
| a |                                   |                               |
| b |                                   |                               |
| l |                                   |                               |
| e |                                   |                               |
| . |                                   |                               |
+---+-----------------------------------+-------------------------------+
| * | **Steps**                         | **Details**                   |
| * |                                   |                               |
| \ |                                   |                               |
| # |                                   |                               |
| * |                                   |                               |
| * |                                   |                               |
+---+-----------------------------------+-------------------------------+
| 1 | **cd                              | At a shell prompt, the user   |
|   | /fs/                              | changes to a special working  |
|   | hseb/pda/users/jschmoe/switcher** | copy. This directory resulted |
|   |                                   | from a prior svn checkout     |
|   |                                   | command and is special        |
|   |                                   | because the user does not     |
|   |                                   | actually commit files from    |
|   |                                   | this working copy. This       |
|   |                                   | directory exists only to help |
|   |                                   | the Release Manager determine |
|   |                                   | what differences there are    |
|   |                                   | between releases.             |
+---+-----------------------------------+-------------------------------+
| 2 | **svn switch                      | Retrieve the latest version   |
|   | https://casanosa.noaa.gov/        | of the already delivered code |
|   | svn/ABC/abc/tags/ob90_post_pit2** | from the repository into your |
|   |                                   | working copy. This sets up    |
|   |                                   | the baseline of delivered     |
|   |                                   | files.                        |
+---+-----------------------------------+-------------------------------+
| 3 | **svn switch                      | Switch the working copy to    |
|   | https://casanosa.n                | the targeted release and save |
|   | oaa.gov/svn/ABC/abc/branches/ob91 | the standard output, which is |
|   | \> change.log**                   | a list of the files and       |
|   |                                   | directories changed, whether  |
|   |                                   | they are added (new),         |
|   |                                   | deleted, or updated,          |
|   |                                   | designated by "A" for added,  |
|   |                                   | "D" for deleted, and "U" for  |
|   |                                   | updated in front of the file  |
|   |                                   | or directory name.            |
+---+-----------------------------------+-------------------------------+
| 4 | **sort change.log \>              | Sort the files and            |
|   | change.log.sorted**               | directories by the operation  |
|   |                                   | performed on them, as         |
|   |                                   | designated by "U", "D", or    |
|   |                                   | "A".                          |
+---+-----------------------------------+-------------------------------+
| 5 | Copy text (modified as needed)    | Using the output in standard  |
|   | from **change.log.sorted** into a | template delivery scripts     |
|   | script or scripts used to help    | prevents copying errors,      |
|   | deliver files.                    | speeds up the delivery        |
|   |                                   | process, and provides for     |
|   |                                   | traceability and              |
|   |                                   | repeatability.                |
+---+-----------------------------------+-------------------------------+

+---+------------------------------------+-------------------------------+
| * |                                    |                               |
| * |                                    |                               |
| [ |                                    |                               |
| S |                                    |                               |
| c |                                    |                               |
| e |                                    |                               |
| n |                                    |                               |
| a |                                    |                               |
| r |                                    |                               |
| i |                                    |                               |
| o |                                    |                               |
| R |                                    |                               |
| M |                                    |                               |
| - |                                    |                               |
| 3 |                                    |                               |
| ] |                                    |                               |
| { |                                    |                               |
| . |                                    |                               |
| u |                                    |                               |
| n |                                    |                               |
| d |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| l |                                    |                               |
| i |                                    |                               |
| n |                                    |                               |
| e |                                    |                               |
| } |                                    |                               |
|   |                                    |                               |
| - |                                    |                               |
| D |                                    |                               |
| e |                                    |                               |
| t |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| m |                                    |                               |
| i |                                    |                               |
| n |                                    |                               |
| i |                                    |                               |
| n |                                    |                               |
| g |                                    |                               |
| w |                                    |                               |
| h |                                    |                               |
| a |                                    |                               |
| t |                                    |                               |
| f |                                    |                               |
| i |                                    |                               |
| l |                                    |                               |
| e |                                    |                               |
| s |                                    |                               |
| h |                                    |                               |
| a |                                    |                               |
| v |                                    |                               |
| e |                                    |                               |
| c |                                    |                               |
| h |                                    |                               |
| a |                                    |                               |
| n |                                    |                               |
| g |                                    |                               |
| e |                                    |                               |
| d |                                    |                               |
| f |                                    |                               |
| r |                                    |                               |
| o |                                    |                               |
| m |                                    |                               |
| o |                                    |                               |
| n |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| l |                                    |                               |
| e |                                    |                               |
| a |                                    |                               |
| s |                                    |                               |
| e |                                    |                               |
| t |                                    |                               |
| o |                                    |                               |
| a |                                    |                               |
| n |                                    |                               |
| o |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| . |                                    |                               |
| O |                                    |                               |
| p |                                    |                               |
| t |                                    |                               |
| i |                                    |                               |
| o |                                    |                               |
| n |                                    |                               |
| 2 |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
|   |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| P |                                    |                               |
| r |                                    |                               |
| o |                                    |                               |
| j |                                    |                               |
| e |                                    |                               |
| c |                                    |                               |
| t |                                    |                               |
| : |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| A |                                    |                               |
| B |                                    |                               |
| C |                                    |                               |
|   |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| D |                                    |                               |
| e |                                    |                               |
| l |                                    |                               |
| i |                                    |                               |
| v |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| a |                                    |                               |
| b |                                    |                               |
| l |                                    |                               |
| e |                                    |                               |
| s |                                    |                               |
| : |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| S |                                    |                               |
| o |                                    |                               |
| u |                                    |                               |
| r |                                    |                               |
| c |                                    |                               |
| e |                                    |                               |
| c |                                    |                               |
| o |                                    |                               |
| d |                                    |                               |
| e |                                    |                               |
|   |                                    |                               |
| + |                                    |                               |
| b |                                    |                               |
| u |                                    |                               |
| i |                                    |                               |
| l |                                    |                               |
| d |                                    |                               |
| s |                                    |                               |
| c |                                    |                               |
| r |                                    |                               |
| i |                                    |                               |
| p |                                    |                               |
| t |                                    |                               |
| s |                                    |                               |
|   |                                    |                               |
| + |                                    |                               |
| r |                                    |                               |
| u |                                    |                               |
| n |                                    |                               |
| s |                                    |                               |
| c |                                    |                               |
| r |                                    |                               |
| i |                                    |                               |
| p |                                    |                               |
| t |                                    |                               |
| s |                                    |                               |
| . |                                    |                               |
|   |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| P |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| v |                                    |                               |
| i |                                    |                               |
| o |                                    |                               |
| u |                                    |                               |
| s |                                    |                               |
| l |                                    |                               |
| y |                                    |                               |
| d |                                    |                               |
| e |                                    |                               |
| l |                                    |                               |
| i |                                    |                               |
| v |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| d |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| l |                                    |                               |
| e |                                    |                               |
| a |                                    |                               |
| s |                                    |                               |
| e |                                    |                               |
| : |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| t |                                    |                               |
| a |                                    |                               |
| g |                                    |                               |
| s |                                    |                               |
| / |                                    |                               |
| o |                                    |                               |
| b |                                    |                               |
| 9 |                                    |                               |
| 0 |                                    |                               |
| _ |                                    |                               |
| p |                                    |                               |
| o |                                    |                               |
| s |                                    |                               |
| t |                                    |                               |
| _ |                                    |                               |
| p |                                    |                               |
| i |                                    |                               |
| t |                                    |                               |
| 2 |                                    |                               |
| ( |                                    |                               |
| 2 |                                    |                               |
| d |                                    |                               |
| e |                                    |                               |
| l |                                    |                               |
| i |                                    |                               |
| v |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| i |                                    |                               |
| e |                                    |                               |
| s |                                    |                               |
| a |                                    |                               |
| f |                                    |                               |
| t |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| P |                                    |                               |
| I |                                    |                               |
| T |                                    |                               |
| ) |                                    |                               |
|   |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| N |                                    |                               |
| e |                                    |                               |
| w |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| l |                                    |                               |
| e |                                    |                               |
| a |                                    |                               |
| s |                                    |                               |
| e |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| : |                                    |                               |
| / |                                    |                               |
| b |                                    |                               |
| r |                                    |                               |
| a |                                    |                               |
| n |                                    |                               |
| c |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| s |                                    |                               |
| / |                                    |                               |
| o |                                    |                               |
| b |                                    |                               |
| 9 |                                    |                               |
| 1 |                                    |                               |
|   |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| W |                                    |                               |
| o |                                    |                               |
| r |                                    |                               |
| k |                                    |                               |
| i |                                    |                               |
| n |                                    |                               |
| g |                                    |                               |
| c |                                    |                               |
| o |                                    |                               |
| p |                                    |                               |
| y |                                    |                               |
| : |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| / |                                    |                               |
| f |                                    |                               |
| s |                                    |                               |
| / |                                    |                               |
| h |                                    |                               |
| s |                                    |                               |
| e |                                    |                               |
| b |                                    |                               |
| / |                                    |                               |
| p |                                    |                               |
| d |                                    |                               |
| a |                                    |                               |
| / |                                    |                               |
| u |                                    |                               |
| s |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| s |                                    |                               |
| / |                                    |                               |
| j |                                    |                               |
| s |                                    |                               |
| c |                                    |                               |
| h |                                    |                               |
| m |                                    |                               |
| o |                                    |                               |
| e |                                    |                               |
| / |                                    |                               |
| a |                                    |                               |
| b |                                    |                               |
| c |                                    |                               |
| . |                                    |                               |
| T |                                    |                               |
| h |                                    |                               |
| i |                                    |                               |
| s |                                    |                               |
| c |                                    |                               |
| a |                                    |                               |
| n |                                    |                               |
| b |                                    |                               |
| e |                                    |                               |
| a |                                    |                               |
| n |                                    |                               |
| y |                                    |                               |
| w |                                    |                               |
| o |                                    |                               |
| r |                                    |                               |
| k |                                    |                               |
| i |                                    |                               |
| n |                                    |                               |
| g |                                    |                               |
| c |                                    |                               |
| o |                                    |                               |
| p |                                    |                               |
| y |                                    |                               |
| i |                                    |                               |
| n |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| s |                                    |                               |
| a |                                    |                               |
| m |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| p |                                    |                               |
| o |                                    |                               |
| s |                                    |                               |
| i |                                    |                               |
| t |                                    |                               |
| o |                                    |                               |
| r |                                    |                               |
| y |                                    |                               |
| a |                                    |                               |
| s |                                    |                               |
| o |                                    |                               |
| n |                                    |                               |
| e |                                    |                               |
| o |                                    |                               |
| f |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| l |                                    |                               |
| e |                                    |                               |
| a |                                    |                               |
| s |                                    |                               |
| e |                                    |                               |
| s |                                    |                               |
| ( |                                    |                               |
| e |                                    |                               |
| i |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| d |                                    |                               |
| e |                                    |                               |
| l |                                    |                               |
| i |                                    |                               |
| v |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| d |                                    |                               |
| o |                                    |                               |
| r |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| n |                                    |                               |
| e |                                    |                               |
| w |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| l |                                    |                               |
| e |                                    |                               |
| a |                                    |                               |
| s |                                    |                               |
| e |                                    |                               |
| ) |                                    |                               |
| . |                                    |                               |
| I |                                    |                               |
| n |                                    |                               |
| o |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| w |                                    |                               |
| o |                                    |                               |
| r |                                    |                               |
| d |                                    |                               |
| s |                                    |                               |
| , |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| i |                                    |                               |
| s |                                    |                               |
| c |                                    |                               |
| a |                                    |                               |
| n |                                    |                               |
| b |                                    |                               |
| e |                                    |                               |
| d |                                    |                               |
| o |                                    |                               |
| n |                                    |                               |
| e |                                    |                               |
| f |                                    |                               |
| r |                                    |                               |
| o |                                    |                               |
| m |                                    |                               |
| * |                                    |                               |
| a |                                    |                               |
| n |                                    |                               |
| y |                                    |                               |
| * |                                    |                               |
| S |                                    |                               |
| u |                                    |                               |
| b |                                    |                               |
| v |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| s |                                    |                               |
| i |                                    |                               |
| o |                                    |                               |
| n |                                    |                               |
| e |                                    |                               |
| d |                                    |                               |
| d |                                    |                               |
| i |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| c |                                    |                               |
| t |                                    |                               |
| o |                                    |                               |
| r |                                    |                               |
| y |                                    |                               |
| . |                                    |                               |
|   |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| N |                                    |                               |
| o |                                    |                               |
| t |                                    |                               |
| e |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
| : |                                    |                               |
| I |                                    |                               |
| t |                                    |                               |
| i |                                    |                               |
| s |                                    |                               |
| b |                                    |                               |
| e |                                    |                               |
| s |                                    |                               |
| t |                                    |                               |
| t |                                    |                               |
| o |                                    |                               |
| s |                                    |                               |
| t |                                    |                               |
| o |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| s |                                    |                               |
| e |                                    |                               |
| c |                                    |                               |
| o |                                    |                               |
| m |                                    |                               |
| m |                                    |                               |
| a |                                    |                               |
| n |                                    |                               |
| d |                                    |                               |
| s |                                    |                               |
| , |                                    |                               |
| p |                                    |                               |
| o |                                    |                               |
| s |                                    |                               |
| s |                                    |                               |
| i |                                    |                               |
| b |                                    |                               |
| l |                                    |                               |
| y |                                    |                               |
| i |                                    |                               |
| n |                                    |                               |
| a |                                    |                               |
| s |                                    |                               |
| c |                                    |                               |
| r |                                    |                               |
| i |                                    |                               |
| p |                                    |                               |
| t |                                    |                               |
| , |                                    |                               |
| s |                                    |                               |
| o |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| a |                                    |                               |
| t |                                    |                               |
| t |                                    |                               |
| h |                                    |                               |
| e |                                    |                               |
| y |                                    |                               |
| ' |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| r |                                    |                               |
| e |                                    |                               |
| p |                                    |                               |
| e |                                    |                               |
| a |                                    |                               |
| t |                                    |                               |
| a |                                    |                               |
| b |                                    |                               |
| l |                                    |                               |
| e |                                    |                               |
| . |                                    |                               |
+---+------------------------------------+-------------------------------+
| * | **Steps**                          | **Details**                   |
| * |                                    |                               |
| \ |                                    |                               |
| # |                                    |                               |
| * |                                    |                               |
| * |                                    |                               |
+---+------------------------------------+-------------------------------+
| 1 | **cd                               | At a shell prompt, the user   |
|   | /fs/hseb/pda/users/jschmoe/abc**   | changes to a working copy.    |
|   |                                    | This directory resulted from  |
|   |                                    | a prior svn checkout command. |
+---+------------------------------------+-------------------------------+
| 2 | **svn diff \--no-diff-deleted      | NOTE: The general form of the |
|   | htt                                | "svn diff" command is to put  |
|   | ps://casanosa.noaa.gov/svn/ABC/abc | the old url first followed by |
|   | \...\<*path*\>/branches/ob91       | the new url. This order is    |
|   | https://casanosa.no                | reversed here to make new     |
|   | aa.gov/svn/ABC/abc/\...\<*path*\>/ | files appear to be deleted.   |
|   | tags/ob90_post_pit2 \| grep        | "grep \'Index:\'" allows only |
|   | \'Index:\' \| grep -v deleted \>   | a list of changed files to be |
|   | mod_old_files_old_dirs**           | output; "grep -v deleted"     |
|   |                                    | filters out (removes)         |
|   |                                    | "deleted" (i.e. new) files.   |
|   |                                    | The list of files in          |
|   |                                    | mod_files_old_dirs files will |
|   |                                    | be only pre-existing files    |
|   |                                    | that have been modified.      |
+---+------------------------------------+-------------------------------+
| 3 | **svn diff \--no-diff-deleted      | "grep deleted" shows *only*   |
|   | https://casanosa.noaa.gov/svn/A    | "deleted" (i.e. new) files.   |
|   | BC/abc\...\<*path*\>/branches/ob91 | The list of files in          |
|   | https://casanosa.no                | new_files_old_dirs will be    |
|   | aa.gov/svn/ABC/abc/\...\<*path*\>/ | only files from previously    |
|   | tags/ob90_post_pit2 \| grep        | -existing directories that    |
|   | \'Index:\' \| grep deleted \>      | have been newly created since |
|   | new_files_old_dirs**               | the last release.             |
+---+------------------------------------+-------------------------------+
| 4 | NOTE: If the release manager       | The list of files in          |
|   | doesn't need to differentiate      | changes_in_old_dirs will be   |
|   | between old and new files from     | all new and modified files    |
|   | previously existing directories,   | from previously existing      |
|   | steps 2 and 3 above can be         | directories.                  |
|   | combined as:                       |                               |
|   |                                    |                               |
|   | **svn diff \--no-diff-deleted      |                               |
|   | https://casanosa.                  |                               |
|   | noaa.gov/svn/ABC/abc/branches/ob91 |                               |
|   | https://casanosa.noaa.g            |                               |
|   | ov/svn/ABC/abc/tags/ob90_post_pit2 |                               |
|   | \| grep \'Index:\' \>              |                               |
|   | changes_in_old_dirs**              |                               |
+---+------------------------------------+-------------------------------+
| 5 | **svn ls -R                        | old_lsout will contain a      |
|   | https://casanosa.no                | recursive listing of all      |
|   | aa.gov/svn/ABC/abc/\...\<*path*\>/ | files from the old version of |
|   | tags/ob90_post_pit2 \> old_lsout** | the code                      |
+---+------------------------------------+-------------------------------+
| 6 | **svn ls -R                        | new_lsout will contain a      |
|   | https://casanosa.noaa.gov/svn/A    | recursive listing of all      |
|   | BC/abc\...\<*path*\>/branches/ob91 | files from the new version of |
|   | \> new_lsout**                     | the code                      |
+---+------------------------------------+-------------------------------+
| 7 | **diff old_lsout new_lsout \>      | new_files_new_dirs will       |
|   | new_files_new_dirs**               | contain a listing of all      |
|   |                                    | newly created files in newly  |
|   |                                    | created directories           |
+---+------------------------------------+-------------------------------+
| 8 | Copy text (modified as needed)     | Using the output in standard  |
|   | from mod_files_old_dirs,           | template delivery scripts     |
|   | new_files_old_dirs,                | prevents copying errors,      |
|   | changes_in_old_dirs, and           | speeds up the delivery        |
|   | new_files_new_dirs into a script   | process, and provides for     |
|   | or scripts used to help deliver    | traceability and              |
|   | files.                             | repeatability.                |
+---+------------------------------------+-------------------------------+
| 9 | Copy text (modified as needed)     | Using the output in standard  |
|   | from change.log.sorted into a      | template delivery scripts     |
|   | script or scripts used to help     | prevents copying errors,      |
|   | deliver files.                     | speeds up the delivery        |
|   |                                    | process, and provides for     |
|   |                                    | traceability and              |
|   |                                    | repeatability.                |
+---+------------------------------------+-------------------------------+

## Release Manager Rules

1.  Make sure to create a tag after each release so that you have a
    snapshot of the system as of that release.

2.  Tags are for snapshots, and branches are for editing.

3.  Automate what you can. Use Subversion to tell you what files have
    changed between builds (**Scenarios RM-2 and RM-3**). Don't rely
    solely on developers' memories.

## Release Manager Suggestion

Use scripts to execute **Steps 1-4** of **Scenario RM-2**, saving the
list of changed files. Then, take the list of files and cut and paste it
into a script for delivering those files as discussed in **Step 5** of
**RM-2.**