This file is indexed.

/usr/share/doc/openbabel/FAQ.html is in openbabel 2.3.2+dfsg-1.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
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Open Babel: Frequently Asked Questions</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />

<link rel="top" href="http://openbabel.org/" />
<link rel="stylesheet" href="site.css" type="text/css" media="all" />
</head>
<body bgcolor="#ffffff">

<div id="header">
<img src="babel130.png" width=130 height=124 alt="Babel Logo" id="logo" />
<h1><img src="OBTitle.jpg" width=333 height=92 alt="Open Babel" /></h1>
</div>

<div id="content">

<h1>FAQ</h1>

<p>$Date: 2008-07-03 12:02:45 -0400 (Thu, 03 Jul 2008) $</p>

<h2>General:</h2>
<h3>1.1 What is Open Babel?</h3>

<p>Put simply, Open Babel is a free, open-source version of the Babel 
chemistry file translation program. Open Babel is a project designed to pick up where Babel left off, as
a cross-platform program and library designed to interconvert between
many file formats used in molecular modeling, computational
chemistry, and many related areas.</p>

<p>Open Babel includes two components, a command-line utility and a
C++ library. The command-line utility is intended to be used as a
replacement for the original babel program, to translate between
various chemical file formats. The C++ library includes all of the
file-translation code as well as a wide variety of utilities to
foster development of other open source scientific software.</p>

<h3>1.2 How does this relate to BabelChat, BabelFish, Babel IM, etc. ...?</h3>
<p>It doesn't. Not surprisingly, "babel" is used frequently in a lot of software names.</p>

<h3>1.3 Is it Open Babel or OpenBabel?</h3>
<p>Your choice. It's probably easier to call it Open Babel since 
that's what it is--an open version of Babel. But if you like 
one-word, mixed-case project names, then go for OpenBabel. In that 
case, the space is just too small to be printed. <pre>;-)</pre></p>

<h3>1.4 How does this relate to the original Babel and OELib, the
&quot;next&quot; Babel?</h3>
<p>The original Babel was written by Pat Walters and Matt Stahl, based
on the &quot;convert&quot; program by Ajay Shah, and is
still a remarkable application. Both Pat and Matt have moved on to
other work. The original Babel is hosted by Smog.com on a 
<a href="http://smog.com/chem/babel/">Babel homepage</a>, by the <a href="http://ccl.net/cca/software/UNIX/babel/index.shtml">Computational Chemistry List (CCL)</a> and of course by <a href="http://sourceforge.net/project/showfiles.php?group_id=40728&package_id=100796">Open Babel at SourceForge.net</a>
</p>
<p>Along the way, the two original authors started a rewrite of Babel
into C++ they called OBabel, which was never really publicly
released. But Matt used some of these ideas in OELib, which was generously
released under the GNU GPL by his employer, OpenEye Software, and the last known
version of this OELib is still available from our <a
href="http://sourceforge.net/project/showfiles.php?group_id=40728&package_id=100796">file repository.</a>
</p>
<p>OpenEye decided that for their purposes, OELib needed a rewrite,
(now called <a
href="http://www.eyesopen.com/products/toolkits/oechem.html">OEChem</a>
but this would be closed-source to include some advanced
algorithms. So the GPL'ed version of OELib would not be maintained.
Instead, the free version of OELib was renamed and has become &quot;Open
Babel&quot; with the blessing of Matt and other contributors.
</p>
<p>Open Babel has evolved quite a lot in since 2001, when it was born.</p>

<h3>1.5 What's the latest version?</h3>
<p>As of this writing, the latest version is <a
href="RELEASE.shtml">2.0</a>, which represents a stable version for widespread use and development.</p>

<h3>1.6 Can I use Open Babel code in a personal project?</h3>
<p>One common misconception about the GNU GPL license for Open Babel
is that it requires users to release any code that uses the Open Babel
library. This is completely untrue. There are no restrictions on use
of Open Babel code for personal projects, regardless of where you work (academia, industry, ... wherever).</p>

<p><strong>However</strong>, if you intend on releasing a software
package that uses Open Babel code, the GPL requires that your package
be released under the GNU GPL license. The distinction is between
<strong>use</strong> and <strong>distribution</strong>. See section 3 of this FAQ
for more on the licensing issues and why you might want to contribute.</p>

<h2>Features, Formats, Roadmap:</h2>
<h3>2.1 Why don't you support file format X?</h3>
<p>The file formats currently supported are some of the more common 
file formats and, admittedly, those we use in our work. If you'd like 
to see other file formats added, we need one of:</p>
<ul>
    <li>documentation on the file format</li>
    <li>working code to read the file format or translate it</li>
    <li>example files in the new file format and in some other format</li>
</ul>
<p>The latter obviously is the easiest with text file formats. Binary 
files take some time to reverse engineer without documentation or 
working code. Also consider pointing developers to this FAQ and the 
&quot;What's in it for me?&quot; section.</p>

<h3>2.2 What doesn't Open Babel support yet?</h3>
<p>Lots of things. See the <a href="Roadmap.shtml">proposed
roadmap</a> for examples of things we'd like to see in future
versions.</p>

<h3>2.3 What sorts of features will be added in the future?</h3>
<p>It's an open project, so if features are suggested or donated, 
they'll be considered as much as anything else on the drawing board. 
Some things are pretty clear from the <a href="Roadmap.shtml">roadmap.</a></p>

<h2>What's in it for me to contribute?</h2>
<h3>3.1 What's in it for my chemistry software company?</h3>
<p>If your product is closed-source or otherwise incompatible with 
the GPL, you cannot link directly to the code library. You can, however, 
distribute Open Babel in unmodified form with your products to use the
command-line interface. This is fairly easy because the Open Babel
babel program allow reading from the standard input and writing to the
standard output (functioning as a POSIX pipe).</p>

<p>If you decide to distribute binaries, you
should either offer users the source if they want, or point them to
the Open Babel website. Note that if you modify the source, you
obviously can't point back to the Open Babel website -- the GPL
requires that you distribute the changed source. (Or you can convince
us to incorporate the changes and point back to us.)</p>

<p>What's not to like with this deal? You can have Open Babel 
translate foreign file formats for you and can point users at the 
website for distribution. You don't need to write tons of code for 
all these formats and bug reports can be passed back to us.</p>

<p>Of course, there's one catch. You'll most likely need to add 
feature-rich support for <em>your</em> file formats. So if you contribute a 
small amount of code under the GPL to read/write your files, 
everything else is handled by Open Babel.</p>

<p>It's a win-win for everyone. The community benefits by having 
feature-rich translation code and open file formats. Your company and 
its programs benefit by the ability to read just about every format 
imaginable. Users benefit by using the programs they need for the 
tasks they need.</p>

<h3>3.2 What's in it for me as an academic?</h3>
<p>If you're an academic developer, you certainly should read the 
previous answer too. It takes little work on your part to interface 
with Open Babel and you get a lot in return.</p>

<p>But even if you're just an academic user, there's a lot of reasons 
to contribute. Most of us deal with a variety of file formats in our 
work. So it's useful to translate these cleanly. If a format isn't 
currently supported by Open Babel, see question 2.1 above. If you 
find bugs please report them. Since it's open source, you can patch 
the code yourself, recompile and have the problem fixed very quickly.</p>

<p>If you're inclined to write code, the GPL is an excellent option 
for the academic. You're the original copyright holder, so you can do 
whatever you want with the code, in addition to selling it. But if 
you've also licensed it under the GPL, no one can distribute it 
proprietarily (i.e., closed-source) without your agreement. 
Fellow acadmics can use it 
directly, learn from it, improve it and contribute back to you. Isn't 
that why many of us went into science?</p>

<p>Once licensed under the GPL, the code <strong>must</strong> remain free to 
interested parties. If someone modifies it, that code must still 
remain under the GPL, free for all.</p>

<h3>3.3 What's in it for an open-source software project?</h3>

<p>Certainly the answers for closed-source software and academics 
also apply for you. Beyond that, if your code is compatible with the 
GPL, you can directly use Open Babel and all of the API. This is 
already happening with the Ghemical molecular editor, available under 
the GPL and <a href="links.shtml">many others</a> There's a lot of
code in Open Babel beyond file translation and more to come. Why
reinvent the wheel?</p>

<h3>3.4 Why is this covered under the GPL instead of license X?</h3>
<p>The short answer is that <a href="http://www.eyesopen.com">OpenEye Scientific Software</a> employs Matt 
Stahl, one of the authors of the original Babel. They released a 
library called OELib under the GPL that did many things that Babel 
did. Later they decided to release the next version of OELib as a 
closed-source project--their choice for their code. We took the 
version of OELib still under GPL and went from there.</p>

<p>If you'd like to see Open Babel licensed differently, we'd suggest 
asking OpenEye if they'd consider releasing the old code under a new 
license, e.g. the LGPL. At that point, we'd consider whether Open 
Babel should be relicensed or not. Obviously all copyright holders 
must agree to the new license.</p>

<p>It's worth noting that since OpenEye is developing a
closed-source library called <a
href="http://www.eyesopen.com/products/toolkits/oechem.html">OEChem</a>
and implies one reason for purchase is in closed-source development
products. So we think it's highly unlikely that OpenEye would allow
Open Babel to become a competitor by relicensing under the LGPL.</p>

<h3>Where can I read more about the GNU GPL?</h3>

<p>The Free Software Foundation maintains a <a
href="http://www.fsf.org/licenses/gpl-faq.html">FAQ</a> list about the
GNU GPL. The <a
href="http://www.fsf.org/licenses/gpl-faq.html">FAQ</a> attempts to
address common questions in an easy-to-read (i.e., not in legal
language) form.</p>

</div> <!-- end content -->

<!--#include file="footer.html" -->