This file is indexed.

/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>
      &copy; 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>