This file is indexed.

/usr/share/gtk-doc/html/bonobo-activation/configuring.html is in libbonobo2-dev 2.32.1-3.

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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Bonobo Activation API Reference Manual: Configuring Bonobo Activation</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="Bonobo Activation API Reference Manual">
<link rel="up" href="index.html" title="Bonobo Activation API Reference Manual">
<link rel="prev" href="checklist.html" title="Checklist">
<link rel="next" href="architecture.html" title="Bonobo Activation Architecture">
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
<td width="100%" align="left" class="shortcuts"></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
<td><a accesskey="p" href="checklist.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="architecture.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="chapter">
<div class="titlepage"><div><div><h1 class="title">
<a name="configuring"></a>Configuring Bonobo Activation</h1></div></div></div>
<div class="toc"><dl class="toc"><dt><span class="sect1"><a href="configuring.html#id-1.3.2"><code class="filename">.server</code> search path.</a></span></dt></dl></div>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="id-1.3.2"></a><code class="filename">.server</code> search path.</h2></div></div></div>
<p>
      To know the list of available <a href="http://foldoc.org/CORBA"><span class="acronym">CORBA</span></a> servers on your
      local machine, the Bonobo Activation daemon searches a number of
      directories for <code class="filename">.server</code> <a href="http://foldoc.org/XML"><span class="acronym">XML</span></a>
      files which contain the description of the services offered by these
      servers.

      By default, Bonobo Activation will try to find them in 
      <code class="filename">${prefix}/lib/bonobo/servers</code> which may be a problem
      if users install other applications using Bonobo Activation in different
      prefixes.
    </p>
<p>
      To work around this problem, Bonobo Activation will parse a number of
      other directories.
      It will parse the directories listed in the 
      <code class="envar">BONOBO_ACTIVATION_PATH</code> environment variable.
      It will parse the prefixes listed in the <code class="envar">GNOME2_PATH</code>
      environment variable.

      If, for example,
      <span class="emphasis"><em>BONOBO_ACTIVATION_PATH=/opt/gnome2/lib/bonobo/servers:/opt/gnome2/bonobo-activation/lib/bonobo/servers</em></span>,
      Bonobo Activation will parse
      <span class="emphasis"><em>/opt/gnome2/lib/bonobo/servers</em></span> and 
      <span class="emphasis"><em>/opt/gnome2/bonobo-activation/lib/bonobo/servers</em></span>

      If <span class="emphasis"><em>GNOME2_PATH=/opt/gnome2:/opt/gnome2/bonobo-activation</em></span>,
      Bonobo Activation will parse
      <span class="emphasis"><em>/opt/gnome2/lib/bonobo/servers</em></span> and
      <span class="emphasis"><em>/opt/gnome2/bonobo-activation/lib/bonobo/servers</em></span>.
    </p>
<p>
      The above environment variables are kept to ease development with
      Bonobo Activation and for <a href="http://foldoc.org/GNOME"><span class="acronym">GNOME</span></a> integration.
      Bonobo Activation has a much nicer configuration file which allows 
      you to control which directories are parsed by Bonobo Activation.
      This <a href="http://foldoc.org/XML"><span class="acronym">XML</span></a> configuration file is located in
      <code class="filename">/etc/bonobo-activation/bonobo-activation-config.xml</code>
      or
      <code class="filename">${prefix}/etc/bonobo-activation/bonobo-activation-config.xml</code>.
      An empty <code class="filename">bonobo-activation-config.xml</code> and a sample
      <code class="filename">bonobo-activation-config.xml.sample</code> file should be
      installed on your system.
    </p>
<p>
      It is recommended to use the
      <span class="command"><strong>bonobo-activation-sysconf</strong></span> command-line
      configuration tool to edit this file. However, here is an example of its
      format.
    </p>
<pre class="programlisting">
&lt;?xml version="1.0"?&gt;

&lt;oafconfig&gt;

&lt;searchpath&gt;
&lt;item&gt;/opt/gnome2/lib/bonobo/servers&lt;/item&gt;
&lt;item&gt;/usr/local/gnome2/lib/bonobo/servers&lt;/item&gt;
&lt;item&gt;/usr/local/lib/bonobo/servers&lt;/item&gt;
&lt;item&gt;/opt/gnome2/bonobo-activation/lib/bonobo/servers&lt;/item&gt;
&lt;/searchpath&gt;

&lt;searchpath&gt;
&lt;item&gt;/opt/gnome2/bonobo-activation/lib/bonobo/servers&lt;/item&gt;
&lt;/searchpath&gt;

&lt;/oafconfig&gt;</pre>
<p>
      There can be any number of <code class="sgmltag-element">item</code> tags in a
      <code class="sgmltag-element">searchpath</code> tag and any number of
      <code class="sgmltag-element">searchpath</code> tags in the <code class="sgmltag-element">oafconfig</code>
      tag.
    </p>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.20</div>
</body>
</html>