/usr/share/doc/fcm/user_guide/overview.html is in fcm 2017.10.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 | <!DOCTYPE html>
<html>
<head>
<title>FCM: User Guide: System Overview</title>
<meta name="author" content="FCM team" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="icon" href="../etc/fcm-icon.png" type="image/png" />
<link rel="shortcut icon" href="../etc/fcm-icon.png" type="image/png" />
<link href="../etc/bootstrap/css/bootstrap.min.css" rel="stylesheet" media="screen" />
<link href="../etc/fcm.css" rel="stylesheet" media="screen" />
</head>
<body>
<div class="navbar navbar-inverse">
<div class="container-fluid">
<div class="navbar-header">
<a class="navbar-brand" href=".."><span class="fcm-version">FCM</span></a>
</div>
<div class="collapse navbar-collapse">
<ul class="nav navbar-nav">
<li><a href="../installation/">Installation</a></li>
<li><a class="active" href="#">User Guide</a></li>
</ul>
</div>
</div>
</div>
<div class="page-header">
<div class="fcm-page-content pull-right well well-sm"></div>
<h1>FCM: User Guide: System Overview</h1>
</div>
<div class="container">
<div class="row">
<div class="col-md-12">
<p>The FCM system is designed to simplify the task of managing and building
source code. It consists of the following components:</p>
<h2 id="code-management">Code Management</h2>
<p>FCM uses <a href="http://subversion.apache.org/">Subversion</a> for
version control. For a summary of its main features please refer to the
<a href="http://svnbook.red-bean.com/">Version Control with
Subversion</a> book. Subversion is a generalised tool which can be used
in lots of different ways. This makes some day-to-day tasks more complex
than they need be. FCM defines a simplified process and appropriate
naming conventions. It then adds a layer on top of Subversion to provide
a natural interface which is specifically tailored to this process. Where
appropriate it simply makes use of the command line tools provided by
Subversion. However, in other cases it provides significant additional
functionality, e.g.:</p>
<ul>
<li>By making some assumptions about the repository layout (i.e. by
imposing a standard working practice) FCM simplifies the task of
creating branches and enforces a standard branch naming
convention.</li>
<li>Having defined working practices and standard log messages allows
FCM to greatly simplify the process of merging changes between
branches.</li>
<li>FCM makes use of <a href="http://furius.ca/xxdiff/">xxdiff</a> (a
graphical diff and merge tool) to allow users to easily examine changes
they have made and to simplify the process of resolving any conflicts
which result from a merge.</li>
</ul>
<p>FCM uses <a href="http://trac.edgewall.org/">Trac</a>, a powerful web
based tool, to manage software projects. <a href=
"http://trac.edgewall.org/">Trac</a> has the following features:</p>
<ul>
<li>A flexible issue tracker which can be used to keep track of bugs,
feature requests, etc. Each issue (known as a <q title=
"http://trac.edgewall.org/wiki/TracTickets">ticket</q> within Trac) can
be given a priority and assigned to a particular person. Changes made
to your Subversion repository can easily be traced to the relevant
ticket. Where appropriate, tickets can be used to record information
about who has reviewed each change.</li>
<li>A <q title="http://trac.edgewall.org/wiki/TracRoadmap">roadmap</q>
feature which helps you to plan and manage project releases. Each
ticket can be associated with a particular milestone. Trac can then
easily show you what features or fixes went into a particular release
or what work remains before a particular milestone is reached.</li>
<li>A <q title="http://trac.edgewall.org/wiki/TracWiki">wiki</q> which
can be used for project documentation.</li>
<li>A browser for viewing your Subversion repository which allows you
to browse the project tree / files and examine revision logs and
changesets.</li>
<li>A timeline view which summarises all the activity on a project
(changes to the tickets, wiki pages or the Subversion repository).</li>
</ul>
<h2 id="build-and-extract">Build and Extract</h2>
<p>FCM features a powerful build system, mainly aimed at building modern
Fortran software applications. It has the following features:</p>
<ul>
<li>Parallel build.</li>
<li>Efficient incremental build. Changes to the checksums of source files
and/or the build configuration (e.g. changes to the compiler flags) trigger
the appropriate re-compilation.</li>
<li>Inheritance of items from an existing build.</li>
<li>Build dependency analysis.</li>
<li>Automatic generation of include files to contain the calling
interfaces of standalone functions and subroutinues in Fortran source
files.</li>
<li>Extract of source files from multiple repositories and working
copies.</li>
<li>Extract and merge of source files from different branches of
development.</li>
<li>Minimal configuration.</li>
</ul>
<h2 id="illustration">Illustration</h2>
<p>The diagram below illustrates how these components fit together.</p>
<p><img class="img-polaroid" src="fcm_overview.png"
alt="FCM system overview" /></p>
</div>
</div>
</div>
<hr/>
<div class="container-fluid text-center">
<div class="row"><div class="col-md-12">
<address><small>
© British Crown Copyright 2006-16
<a href="http://www.metoffice.gov.uk">Met Office</a>.
See <a href="../etc/fcm-terms-of-use.html">Terms of Use</a>.<br />
This document is released under the British <a href=
"http://www.nationalarchives.gov.uk/doc/open-government-licence/" rel=
"license">Open Government Licence</a>.<br />
</small></address>
</div></div>
</div>
<script type="text/javascript" src="../etc/jquery.min.js"></script>
<script type="text/javascript" src="../etc/bootstrap/js/bootstrap.min.js"></script>
<script type="text/javascript" src="../etc/fcm.js"></script>
<script type="text/javascript" src="../etc/fcm-version.js"></script>
</body>
</html>
|