FCM System
User Guide

Release: 1.2

Last updated: 22 March 2007

Met Office
FitzRoy Road, Exeter
Devon, EX1 3PB
United Kingdom

© Crown copyright 2005-7. All rights reserved.

Questions regarding this document or permissions to quote from it should be directed to the IPR Manager.

Contents

1. Introduction
2. System Overview
3. Getting Started
   • How to set yourself up to run FCM
   • Tutorial
4. Code Management System
   • Using Subversion
     • Basic Concepts
     • Basic Command Line Usage
       • URL & Revision Keywords
       • Examining Changes
       • Resolving Conflicts
       • Adding and Removing Files
       • Committing Changes
     • Branching & Merging
       • Creating Branches
       • Listing Branches Created by You or Other Users
       • Getting Information About Branches
       • Switching your working copy to point to another branch
       • Deleting Branches
       • Merging
     • Using the GUI
       • Starting the GUI
       • GUI Commands
       • Accessing the GUI from Konqueror
     • Known Problems with Subversion
   • Using Trac
     • Logging In
     • Using the Wiki Pages
     • Using the Repository Browser
     • Using the Issue Tracker
     • Using the Roadmap
     • Using the Timeline
5. Code Management Working Practices
   • Making Changes
   • Working Copies
   • Branching & Merging
     • When to Branch
     • Where to Branch From
     • Merging From the Trunk
     • Merging Back to the Trunk
     • When to Delete Branches
   • Working with Binary Files
     • Resolving Conflicts in Binary Files
     • Using Locking
   • Commit Log Messages
   • Trac Tickets
     • Creating Tickets
     • Using Tickets
   • Creating Packages
   • Preparing System Releases
   • Rapid vs Staged Development Practises
6. The Extract System
   • The Extract Command
   • Simple Usage
     • Extract from a local path
     • Extract from a Subversion URL
     • Mirror code to a remote machine
   • Advanced Usage
     • Extract from multiple repositories
     • Extract from multiple branches
     • Incremental extract based on a previous extraction
     • Extract - Build Configuration
   • Diagnostic verbose level
   • When Subversion Is Not Available
7. The Build System
   • The Build Command
   • Basic Features
     • Basic build configuration
     • Build configuration via the extract system
     • Naming of executables
     • Setting the compiler flags
     • Automatic Fortran 9X interface block
     • Automatic dependency
   • Advanced Features
     • Further dependency features
     • Linking a Fortran executable with a BLOCKDATA program unit
     • Creating library archives
     • Pre-processing
     • File type
     • Incremental build based on a pre-compiled build
     • Using a package configuration file
     • Building data files
   • Diagnostic verbose level
   • Overview of the build process
8. System Administration
   • Subversion
     • Repository design
     • Creating a repository
     • Access control
     • Repository hosting
     • Watching changes in log messages
   • Trac
     • Trac configuration
     • Trac hosting
   • FCM keywords
   • Extract and build configuration
   • Maintaining alternate versions of namelists and data files
   • Defining working practises and policies
9. FCM Command Reference
   • fcm Configuration File
   • fcm build
   • fcm extract
   • fcm cmp-ext-cfg
   • fcm gui
   • fcm Subversion Subcommands
     • fcm add
     • fcm branch
     • fcm commit
     • fcm conflicts
     • fcm delete
     • fcm diff
     • fcm merge
     • fcm mkpatch
     • fcm switch
     • fcm trac
     • Other Subversion Commands
10. Further Information

Annex:

• Quick reference
• Declarations in FCM central/user configuration file
• Declarations in FCM extract configuration file
• Declarations in FCM build configuration file
• Declarations in FCM build package configuration file