From a4268681f5cbeab6413de450db15e194ccff0d82 Mon Sep 17 00:00:00 2001
From: github-actions
 <site-update+github-actions[bot]@users.noreply.github.com>
Date: Thu, 10 Oct 2024 09:53:47 +0000
Subject: [PATCH] [automated site update]

---
 apidoc/html/index.html           |  39 ++++---
 apidoc/html/navtreedata.js       |  33 +++---
 apidoc/html/navtreeindex0.js     |  30 ++---
 apidoc/html/navtreeindex1.js     |   1 +
 apidoc/html/search/all_1.js      |  12 +-
 apidoc/html/search/all_10.js     |   5 +-
 apidoc/html/search/all_13.js     | 181 ++++++++++++++++---------------
 apidoc/html/search/all_14.js     |  27 +----
 apidoc/html/search/all_2.js      |   2 +-
 apidoc/html/search/all_3.js      |   2 +-
 apidoc/html/search/all_4.js      |   6 +-
 apidoc/html/search/all_5.js      |   6 +-
 apidoc/html/search/all_6.js      |   4 +-
 apidoc/html/search/all_7.js      |   2 +-
 apidoc/html/search/all_8.js      |   4 +-
 apidoc/html/search/all_9.js      |   2 +-
 apidoc/html/search/all_a.js      |   5 +-
 apidoc/html/search/all_d.js      |   2 +-
 apidoc/html/search/all_e.js      |   4 +-
 apidoc/html/search/all_f.js      |  16 +--
 apidoc/html/search/searchdata.js |   2 +-
 apidoc/html/toc.xml              |  31 +++---
 apidoc/xchange.tag               |   1 +
 doc/README.md                    |  19 ++++
 24 files changed, 224 insertions(+), 212 deletions(-)

diff --git a/apidoc/html/index.html b/apidoc/html/index.html
index 2afd591..5050f7d 100644
--- a/apidoc/html/index.html
+++ b/apidoc/html/index.html
@@ -127,6 +127,7 @@ <h2><a class="anchor" id="autotoc_md3"></a>
 <ul>
 <li><a class="el" href="index.html#introduction">Introduction</a></li>
 <li><a class="el" href="index.html#building">Building</a></li>
+<li><a class="el" href="index.html#linking">Linking your application against `xchange`</a></li>
 <li><a class="el" href="index.html#structured-data">Structured data</a></li>
 <li><a class="el" href="index.html#json-interchange">JSON parser and emitter</a></li>
 <li><a class="el" href="index.html#error-handling">Error handling</a></li>
@@ -157,8 +158,16 @@ <h2><a class="anchor" id="autotoc_md7"></a>
 </ul>
 <p>After configuring, you can simply run <code>make</code>, which will build the <code>shared</code> (<code>lib/libxchange.so[.1]</code>) and <code>static</code> (<code>lib/libxchange.a</code>) libraries, local HTML documentation (provided <code>doxygen</code> is available), and performs static analysis via the <code>check</code> target. Or, you may build just the components you are interested in, by specifying the desired <code>make</code> target(s). (You can use <code>make help</code> to get a summary of the available <code>make</code> targets).</p>
 <hr  />
-<p><a class="anchor" id="structured-data"></a> </p>
+<p><a class="anchor" id="linking"></a> </p>
 <h2><a class="anchor" id="autotoc_md9"></a>
+Linking your application against &lt;tt&gt;xchange&lt;/tt&gt;</h2>
+<p>Provided you have installed the shared (<code>libxchange.so</code>) or static (<code>libxchange.a</code>) library in a location that is in your <code>LD_LIBRARY_PATH</code> (e.g. in <code>/usr/lib</code> or <code>/usr/local/lib</code>) you can simply link your program using the <code>-lxchange</code> flag. Your <code>Makefile</code> may look like:</p>
+<div class="fragment"><div class="line">myprog: ...</div>
+<div class="line">    cc -o $@ $^ $(LDFLAGS) -lxchange </div>
+</div><!-- fragment --><p>(Or, you might simply add <code>-lxchange</code> to <code>LDFLAGS</code> and use a more standard recipe.) And, in if you installed the <b>xchange</b> library elsewhere, you can simply add the location to <code>LD_LIBRARY_PATH</code> prior to linking.</p>
+<hr  />
+<p><a class="anchor" id="structured-data"></a> </p>
+<h2><a class="anchor" id="autotoc_md11"></a>
 Structured data</h2>
 <ul>
 <li><a class="el" href="index.html#data-types">Basic data types</a></li>
@@ -172,7 +181,7 @@ <h2><a class="anchor" id="autotoc_md9"></a>
 <p>The <b>xchange</b> library defines the <code><a class="el" href="structXStructure.html" title="SMA-X structure object, containing a linked-list of XField elements.">XStructure</a></code> type to represent structured data. It is defined in <code><a class="el" href="xchange_8h.html">xchange.h</a></code>, but as a user you really do not need to know much about its layout, as you probably want to avoid low-level direct access to its elements. Rather, you should be using the functions of the <b>xchange</b> API to create, modify, or access data within.</p>
 <p>Under the hood, the <code><a class="el" href="structXStructure.html" title="SMA-X structure object, containing a linked-list of XField elements.">XStructure</a></code> contains a linked list of fields, each an <code><a class="el" href="structXField.html" title="An SMA-X field, typically as part of an XStructure. A field may be a reference to a nested XStructure...">XField</a></code> data type to represent a single element, or an array of elements, of the above mentioned types, including embedded <code>Xstructure</code>s. In this way, an <code>Xstructure</code> can easily represent a multi-level hierarchy of a composite data object. Each <code><a class="el" href="structXField.html" title="An SMA-X field, typically as part of an XStructure. A field may be a reference to a nested XStructure...">XField</a></code> has a name/ID, an associated data type, a dimensionality, a shape (for multidimensional arrays).</p>
 <p><a class="anchor" id="data-types"></a> </p>
-<h3><a class="anchor" id="autotoc_md10"></a>
+<h3><a class="anchor" id="autotoc_md12"></a>
 Basic data types</h3>
 <p>The <b>xchange</b> library supports most basic (primitive) data types used across programming languages. The table below shows the (<code>XType</code>) types recognized by the library and their C equivalents etc.:</p>
 <table class="markdownTable">
@@ -210,12 +219,12 @@ <h3><a class="anchor" id="autotoc_md10"></a>
 <p><sup>*</sup> The <code>boolean</code> type is defined in <code><a class="el" href="xchange_8h.html">xchange.h</a></code>.</p>
 <p>The <code>[...]_HEX</code> types are meaningful only for ASCII representations, and are otherwise equivalent to the corresponding regular integer-types of the same width. They are meant only as a way to explicitly define whether or not an integer value is to be represented in hexadecimal format rather than the default decimal format.</p>
 <p><a class="anchor" id="strings"></a> </p>
-<h4><a class="anchor" id="autotoc_md11"></a>
+<h4><a class="anchor" id="autotoc_md13"></a>
 Strings</h4>
 <p>Strings can be either fixed-length or else a 0-terminated sequence of ASCII characters. At its basic level the library does not impose any restriction of what ASCII characters may be used. However, we recommend that users stick to the JSON convention, and represent special characters in escaped form. E.g. carriage return (<code>0xd</code>) as <code>\</code> followed by <code>n</code>, tabs as <code>\</code> followed by <code>t</code>, etc. As a result a single backslash should also be escaped as two consecutive <code>\</code> characters. You might use <code><a class="el" href="xjson_8c.html#aad83ebcc397046a875040dfc2297d892">xjsonEscapeString()</a></code> or <code><a class="el" href="xjson_8c.html#ae11aed18561818c2e39a5709a8e3374d">xjsonUnescapeString()</a></code> to perform the conversion to/from standard JSON representation.</p>
 <p>Fixed-length strings of up to <em>n</em> characters are represented internally as the <code>XCHAR(n)</code> type. They may be 0-terminated as appropriate, or else represent exactly <em>n</em> ASCII characters without explicit termination. Alternatively, the <code>X_STRING</code> type represents ASCII strings of arbitrary length, up to the 0-termination character.</p>
 <p><a class="anchor" id="scalars"></a> </p>
-<h3><a class="anchor" id="autotoc_md12"></a>
+<h3><a class="anchor" id="autotoc_md14"></a>
 Scalars</h3>
 <p>You can create scalar fields easily, e.g.:</p>
 <div class="fragment"><div class="line"><span class="comment">// Create &quot;is_ok&quot; as a boolean field with TRUE</span></div>
@@ -238,7 +247,7 @@ <h3><a class="anchor" id="autotoc_md12"></a>
 </div><!-- fragment --><p>Under the hood, scalar values are a special case of arrays containing a single element. Scalars have dimension zero i.e., a shape defined by an empty integer array, e.g. <code>int shape[0]</code> in a corresponding <code><a class="el" href="structXField.html" title="An SMA-X field, typically as part of an XStructure. A field may be a reference to a nested XStructure...">XField</a></code> element.</p>
 <p>In this way scalars are distinguished from true arrays containing just a single elements, which have dimensionality &lt;=1 and shapes e.g., <code>int shape[1] = {1}</code> or <code>int shape[2] = {1, 1}</code>. The difference, while subtle, becomes more obvious when serializing the array, e.g. to JSON. A scalar floating point value of 1.04, for example, will appear as <code>1.04</code> in JSON, whereas the 1D and 2D single-element arrays will be serialized as <code>{ 1.04 }</code> or <code>{{ 1.04 }}</code>, respectively.</p>
 <p><a class="anchor" id="arrays"></a> </p>
-<h3><a class="anchor" id="autotoc_md13"></a>
+<h3><a class="anchor" id="autotoc_md15"></a>
 Arrays</h3>
 <p>The <b>xchange</b> library supports array data types in one or more dimensions (up to 20 dimensions). For example, to create a field for 2&times;3&times;4 array of <code>double</code>s, you may have something along:</p>
 <div class="fragment"><div class="line"><span class="keywordtype">double</span> data[2][3][4] = ...;       <span class="comment">// The native array in C</span></div>
@@ -250,7 +259,7 @@ <h3><a class="anchor" id="autotoc_md13"></a>
 <div class="ttc" id="axstruct_8c_html_a42e4e75cbf8f721ef4b251c692dcd7cb"><div class="ttname"><a href="xstruct_8c.html#a42e4e75cbf8f721ef4b251c692dcd7cb">xCreateField</a></div><div class="ttdeci">XField * xCreateField(const char *name, XType type, int ndim, const int *sizes, const void *value)</div><div class="ttdef"><b>Definition</b> xstruct.c:261</div></div>
 </div><!-- fragment --><p>Note, that there is no requirement that the native array has the same dimensionality as it's nominal format in the field. We could have declared <code>data</code> as a 1D array <code>double data[2 * 3 * 4] = ...</code>, or really any array (pointer) containing doubles with storage for at least 24 elements. It is the <code>sizes</code> array, along with the dimensionality, which together define the number of elements used from it, and the shape of the array for <b>xchange</b>.</p>
 <p><a class="anchor" id="creating-structure"></a> </p>
-<h3><a class="anchor" id="autotoc_md14"></a>
+<h3><a class="anchor" id="autotoc_md16"></a>
 Creating structure</h3>
 <p>Structures should always be created by calling <code><a class="el" href="xstruct_8c.html#a12112584a34e07f9ef7b08f6ef1bc865">xCreateStruct()</a></code> (or else by an appropriate de-serialization function such as <code><a class="el" href="xjson_8c.html#af180900a4afeef713a3fdaeb77a9cba3">xjsonParseAt()</a></code>, or as a copy via <code>xCopyStruct()</code>). Once the structure is no longer used it should be explicitly destroyed (freed) by calling <code><a class="el" href="xstruct_8c.html#afe3fda2f392bae11e136e8c0c90f086d">xDestroyStruct()</a></code>. Named substructures can be added to any structure with <code><a class="el" href="xstruct_8c.html#ad84cbb4639f2fbfb604b698a86caf944">xSetSubstruct()</a></code>, and named fields via <code><a class="el" href="xstruct_8c.html#ab1cb91bd6aa14c0dae9d24bfbe7b76f4">xSetField()</a></code>. That is the gist of it. So for example, the skeleton structure from the example above can be created programatically as:</p>
 <div class="fragment"><div class="line"><a class="code hl_struct" href="structXStructure.html">XStructure</a> *s, *sys, *sub;</div>
@@ -277,7 +286,7 @@ <h3><a class="anchor" id="autotoc_md14"></a>
 <div class="line"><a class="code hl_function" href="xstruct_8c.html#afe3fda2f392bae11e136e8c0c90f086d">xDestroyStruct</a>(s);</div>
 <div class="ttc" id="axstruct_8c_html_afe3fda2f392bae11e136e8c0c90f086d"><div class="ttname"><a href="xstruct_8c.html#afe3fda2f392bae11e136e8c0c90f086d">xDestroyStruct</a></div><div class="ttdeci">void xDestroyStruct(XStructure *s)</div><div class="ttdef"><b>Definition</b> xstruct.c:723</div></div>
 </div><!-- fragment --><p><a class="anchor" id="aggregate-ids"></a> </p>
-<h3><a class="anchor" id="autotoc_md15"></a>
+<h3><a class="anchor" id="autotoc_md17"></a>
 Aggregate IDs</h3>
 <p>Since the <code><a class="el" href="structXStructure.html" title="SMA-X structure object, containing a linked-list of XField elements.">XStructure</a></code> data type can represent hierarchies of arbitrary depth, and named at every level of the hierarchy, we can uniquely identify any particular field, at any level, with an aggregate ID, which concatenates the field names each every level, top-down, with a separator. The convention of <b>xchange</b> is to use colon (':') as the separator. Consider an example structure (in JSON notation):</p>
 <div class="fragment"><div class="line">{</div>
@@ -292,7 +301,7 @@ <h3><a class="anchor" id="autotoc_md15"></a>
 <div class="line">}</div>
 </div><!-- fragment --><p>Then, the leaf "properly" entry can be 'addressed' with the aggregate ID of <code>system:subsystem:property</code> from the top level. The <code><a class="el" href="xstruct_8c.html#a2cbbd824406d862b2018e28a466ff318">xGetAggregateID()</a></code> function is provided to construct such aggregate IDs by gluing together a leading and trailing component.</p>
 <p><a class="anchor" id="accessing-data"></a> </p>
-<h3><a class="anchor" id="autotoc_md16"></a>
+<h3><a class="anchor" id="autotoc_md18"></a>
 Accessing substructures and elements</h3>
 <p>Once a structure is populated &ndash; either by having constructed it programatically, or e.g. by parsing a JSON definition of it from a string or file &ndash; you can access its content and/or modify it.</p>
 <p>E.g., to retrieve the "property" field from the above example structure:</p>
@@ -317,7 +326,7 @@ <h3><a class="anchor" id="autotoc_md16"></a>
 <div class="fragment"><div class="line"><span class="comment">// Remove and then destroy the field named &quot;blah&quot; in structure &#39;s&#39;.</span></div>
 <div class="line"><a class="code hl_function" href="xstruct_8c.html#ae0ce99c867b11bd14971031eec8ba4ad">xDestroyField</a>(<a class="code hl_function" href="xstruct_8c.html#aec9f913cdb79d8653668a5d9bdda6ab1">xRemoveField</a>(s, <span class="stringliteral">&quot;blah&quot;</span>));</div>
 <div class="ttc" id="axstruct_8c_html_aec9f913cdb79d8653668a5d9bdda6ab1"><div class="ttname"><a href="xstruct_8c.html#aec9f913cdb79d8653668a5d9bdda6ab1">xRemoveField</a></div><div class="ttdeci">XField * xRemoveField(XStructure *s, const char *name)</div><div class="ttdef"><b>Definition</b> xstruct.c:551</div></div>
-</div><!-- fragment --><h4><a class="anchor" id="autotoc_md17"></a>
+</div><!-- fragment --><h4><a class="anchor" id="autotoc_md19"></a>
 Large structures</h4>
 <p>The normal <code><a class="el" href="xstruct_8c.html#a442f155b0c6549549737510ce42bb66d">xGetField()</a></code> and <code><a class="el" href="xstruct_8c.html#a97a58e33c4730e272af459dfb7f016f9">xGetSubstruct()</a></code> functions have computational costs that scale linearly with the number of direct fields in the structure. It is not much of an issue for structures that contain dozens of, or even a couple hundred, fields (per layer). For much larger structures, which have a fixed layout, there is an option for a potentially much more efficient hash-based lookup also. E.g. instead of <code><a class="el" href="xstruct_8c.html#a442f155b0c6549549737510ce42bb66d">xGetField()</a></code> you may use <code><a class="el" href="xlookup_8c.html#a5e3a316b7d0c5c40ed079f3df2d9fcc9">xLookupField()</a></code>:</p>
 <div class="fragment"><div class="line"><a class="code hl_struct" href="structXStructure.html">XStructure</a> *s = ...</div>
@@ -335,7 +344,7 @@ <h3><a class="anchor" id="autotoc_md16"></a>
 <div class="ttc" id="axlookup_8c_html_a5e3a316b7d0c5c40ed079f3df2d9fcc9"><div class="ttname"><a href="xlookup_8c.html#a5e3a316b7d0c5c40ed079f3df2d9fcc9">xLookupField</a></div><div class="ttdeci">XField * xLookupField(const XLookupTable *tab, const char *id)</div><div class="ttdef"><b>Definition</b> xlookup.c:409</div></div>
 </div><!-- fragment --><p>Note however, that preparing the lookup table has significant <em>O(N)</em> computational cost also. Therefore, a lookup table is practical only if you are going to use it repeatedly, many times over. As a rule of thumb, lookups may have the advantage if accessing fields in a structure by name hundreds of times, or more.</p>
 <p>The same performance limitation also applies to building large structures, since the <code><a class="el" href="xstruct_8c.html#ab1cb91bd6aa14c0dae9d24bfbe7b76f4">xSetField()</a></code> and <code><a class="el" href="xstruct_8c.html#ad84cbb4639f2fbfb604b698a86caf944">xSetSubstruct()</a></code> functions iterate over the existing fields to check if a prior field by the same name was already present, and which should be removed before the new field is set (hence the time to build up a structure with <em>N</em> fields will scale as _O(N<sup>2</sup>)_ in general). The user may consider using <code><a class="el" href="xstruct_8c.html#ad6249db6da0a1294d5621cd9fd829f7a">xInsertField()</a></code> instead, which is much more scalable for building large structures, since it does not check for duplicates (hence scales as <em>O(N)</em> overall). However, <code><a class="el" href="xstruct_8c.html#ad6249db6da0a1294d5621cd9fd829f7a">xInsertField()</a></code> also makes the ordering of fields less intuitive, and it is left up to the caller to ensure that field names added this way are never duplicated. (Tip: if you used <code>InsertField()</code> consistently, you may call <code><a class="el" href="xstruct_8c.html#ad32d8a3f211a3b101142879ae31146ec">xReverseFieldOrder()</a></code> at the end, so the fields will appear in the same order in which they were inserted.)</p>
-<h4><a class="anchor" id="autotoc_md18"></a>
+<h4><a class="anchor" id="autotoc_md20"></a>
 Iterating over elements</h4>
 <p>You can easily iterate over the elements also. This is one application where you may want to know the internal layout of <code><a class="el" href="structXStructure.html" title="SMA-X structure object, containing a linked-list of XField elements.">XStructure</a></code>, namely that it contains a simple linked-list of <code><a class="el" href="structXField.html" title="An SMA-X field, typically as part of an XStructure. A field may be a reference to a nested XStructure...">XField</a></code> fields. One way to iterate over a structures elements is with a <code>for</code> loop, e.g.:</p>
 <div class="fragment"><div class="line"><a class="code hl_struct" href="structXStructure.html">XStructure</a> *s = ...</div>
@@ -348,7 +357,7 @@ <h4><a class="anchor" id="autotoc_md18"></a>
 <div class="ttc" id="astructXField_html_ae1ebaf87eb62e6266b14908eee28e565"><div class="ttname"><a href="structXField.html#ae1ebaf87eb62e6266b14908eee28e565">XField::next</a></div><div class="ttdeci">struct XField * next</div><div class="ttdoc">Pointer to the next linked element (if inside an XStructure).</div><div class="ttdef"><b>Definition</b> xchange.h:141</div></div>
 <div class="ttc" id="astructXStructure_html_a501ae8af2201d9cfaa60e3af21ff58fc"><div class="ttname"><a href="structXStructure.html#a501ae8af2201d9cfaa60e3af21ff58fc">XStructure::firstField</a></div><div class="ttdeci">XField * firstField</div><div class="ttdoc">Pointer to the first field in this structure or NULL if the structure is empty.</div><div class="ttdef"><b>Definition</b> xchange.h:157</div></div>
 </div><!-- fragment --><p><a class="anchor" id="sorting-fields"></a> </p>
-<h3><a class="anchor" id="autotoc_md19"></a>
+<h3><a class="anchor" id="autotoc_md21"></a>
 Sorting fields</h3>
 <p>You can easily sort fields by name using <code><a class="el" href="xstruct_8c.html#a74d1f6b9b92ebe82353e75a3d7e9daae">xSortFieldsByName()</a></code>, or with using a custom comparator function with <code><a class="el" href="xstruct_8c.html#aa1d006a2788adeb0fc9b4799297a69ff">xSortFields()</a></code>. You can also reverse the order with <code><a class="el" href="xstruct_8c.html#ad32d8a3f211a3b101142879ae31146ec">xReverseFieldOrder()</a></code>. For example to sort fields in a structure (and its substructures) in descending alphabetical order:</p>
 <div class="fragment"><div class="line"><a class="code hl_struct" href="structXStructure.html">XStructure</a> *s = ...</div>
@@ -361,7 +370,7 @@ <h3><a class="anchor" id="autotoc_md19"></a>
 <div class="ttc" id="axstruct_8c_html_ad32d8a3f211a3b101142879ae31146ec"><div class="ttname"><a href="xstruct_8c.html#ad32d8a3f211a3b101142879ae31146ec">xReverseFieldOrder</a></div><div class="ttdeci">int xReverseFieldOrder(XStructure *s, boolean recursive)</div><div class="ttdef"><b>Definition</b> xstruct.c:1154</div></div>
 </div><!-- fragment --><hr  />
 <p><a class="anchor" id="json-interchange"></a> </p>
-<h2><a class="anchor" id="autotoc_md21"></a>
+<h2><a class="anchor" id="autotoc_md23"></a>
 JSON parser and emitter</h2>
 <p>Once you have an <code><a class="el" href="structXStructure.html" title="SMA-X structure object, containing a linked-list of XField elements.">XStructure</a></code> data object, you can easily convert it to a JSON string representation, as:</p>
 <div class="fragment"><div class="line"><span class="comment">// Obtain a JSON string representation of the structure &#39;s&#39;.</span></div>
@@ -382,7 +391,7 @@ <h2><a class="anchor" id="autotoc_md21"></a>
 <div class="ttc" id="axjson_8c_html_afff9ee9473a0c939d18dba977cfac075"><div class="ttname"><a href="xjson_8c.html#afff9ee9473a0c939d18dba977cfac075">xjsonParseFilename</a></div><div class="ttdeci">XStructure * xjsonParseFilename(const char *fileName, int *lineNumber)</div><div class="ttdef"><b>Definition</b> xjson.c:206</div></div>
 </div><!-- fragment --><hr  />
 <p><a class="anchor" id="error-handling"></a> </p>
-<h2><a class="anchor" id="autotoc_md23"></a>
+<h2><a class="anchor" id="autotoc_md25"></a>
 Error handling</h2>
 <p>The functions that can encounter an error will return either one of the error codes defined in <code><a class="el" href="xchange_8h.html">xchange.h</a></code>, or <code>NULL</code> pointers. String descriptions for the error codes can be produced by <code><a class="el" href="xchange_8c.html#acc701c734a3b95d356660ca5ee16a96a">xErrorDescription(int)</a></code>. For example,</p>
 <div class="fragment"><div class="line"><span class="keywordtype">char</span> *text = ...</div>
@@ -398,12 +407,12 @@ <h2><a class="anchor" id="autotoc_md23"></a>
 </div><!-- fragment --><p>The JSON parser can also sink its error messages to a designated file or stream, which can be set by <code><a class="el" href="xjson_8c.html#a23a7bd364a80bc2bab9ce917ed5f22ea">xjsonSetErrorStream(FILE *)</a></code>.</p>
 <hr  />
 <p><a class="anchor" id="debugging-support"></a> </p>
-<h2><a class="anchor" id="autotoc_md25"></a>
+<h2><a class="anchor" id="autotoc_md27"></a>
 Debugging support</h2>
 <p>You can enable verbose output of the <b>xchange</b> library with <code><a class="el" href="xchange_8c.html#afbe85067ddbc92577cd00ac8f6e3026f">xSetVerbose(boolean)</a></code>. When enabled, it will produce status messages to <code>stderr</code>so you can follow what's going on. In addition (or alternatively), you can enable debug messages with <code><a class="el" href="xchange_8c.html#a6c1304b59a5882b2286e86c6837faead">xSetDebug(boolean)</a></code>. When enabled, all errors encountered by the library (such as invalid arguments passed) will be printed to <code>stderr</code>, including call traces, so you can walk back to see where the error may have originated from. (You can also enable debug messages by default by defining the <code>DEBUG</code> constant for the compiler, e.g. by adding <code>-DDEBUG</code> to <code>CFLAGS</code> prior to calling <code>make</code>).</p>
 <p>For helping to debug your application, the <b>xchange</b> library provides two macros: <code><a class="el" href="xchange_8h.html#a1f038bf7ddb58819805cfc44162cb403" title="Use for generating verbose output.">xvprintf()</a></code> and <code><a class="el" href="xchange_8h.html#a2b0edfea798e9e08122f09dba5f189f8" title="Use for generating debug output.">xdprintf()</a></code>, for printing verbose and debug messages to <code>stderr</code>. Both work just like <code>printf()</code>, but they are conditional on verbosity being enabled via <code><a class="el" href="xchange_8c.html#afbe85067ddbc92577cd00ac8f6e3026f">xSetVerbose(boolean)</a></code> and <code><a class="el" href="xchange_8c.html#a6c1304b59a5882b2286e86c6837faead">xSetDebug(boolean)</a></code>, respectively. Applications using <b>xchange</b> may use these macros to produce their own verbose and/or debugging outputs conditional on the same global settings.</p>
 <p><a class="anchor" id="future-plans"></a> </p>
-<h2><a class="anchor" id="autotoc_md26"></a>
+<h2><a class="anchor" id="autotoc_md28"></a>
 Future plans</h2>
 <p>There are a number of ways this little library can evolve and grow in the not too distant future. Some of the obvious paths forward are:</p>
 <ul>
diff --git a/apidoc/html/navtreedata.js b/apidoc/html/navtreedata.js
index 7d2ba21..d74be8f 100644
--- a/apidoc/html/navtreedata.js
+++ b/apidoc/html/navtreedata.js
@@ -29,24 +29,25 @@ var NAVTREE =
       [ "Table of Contents", "index.html#autotoc_md3", null ],
       [ "Introduction", "index.html#autotoc_md5", null ],
       [ "Building", "index.html#autotoc_md7", null ],
-      [ "Structured data", "index.html#autotoc_md9", [
-        [ "Basic data types", "index.html#autotoc_md10", [
-          [ "Strings", "index.html#autotoc_md11", null ]
+      [ "Linking your application against <tt>xchange</tt>", "index.html#autotoc_md9", null ],
+      [ "Structured data", "index.html#autotoc_md11", [
+        [ "Basic data types", "index.html#autotoc_md12", [
+          [ "Strings", "index.html#autotoc_md13", null ]
         ] ],
-        [ "Scalars", "index.html#autotoc_md12", null ],
-        [ "Arrays", "index.html#autotoc_md13", null ],
-        [ "Creating structure", "index.html#autotoc_md14", null ],
-        [ "Aggregate IDs", "index.html#autotoc_md15", null ],
-        [ "Accessing substructures and elements", "index.html#autotoc_md16", [
-          [ "Large structures", "index.html#autotoc_md17", null ],
-          [ "Iterating over elements", "index.html#autotoc_md18", null ]
+        [ "Scalars", "index.html#autotoc_md14", null ],
+        [ "Arrays", "index.html#autotoc_md15", null ],
+        [ "Creating structure", "index.html#autotoc_md16", null ],
+        [ "Aggregate IDs", "index.html#autotoc_md17", null ],
+        [ "Accessing substructures and elements", "index.html#autotoc_md18", [
+          [ "Large structures", "index.html#autotoc_md19", null ],
+          [ "Iterating over elements", "index.html#autotoc_md20", null ]
         ] ],
-        [ "Sorting fields", "index.html#autotoc_md19", null ]
+        [ "Sorting fields", "index.html#autotoc_md21", null ]
       ] ],
-      [ "JSON parser and emitter", "index.html#autotoc_md21", null ],
-      [ "Error handling", "index.html#autotoc_md23", null ],
-      [ "Debugging support", "index.html#autotoc_md25", null ],
-      [ "Future plans", "index.html#autotoc_md26", null ],
+      [ "JSON parser and emitter", "index.html#autotoc_md23", null ],
+      [ "Error handling", "index.html#autotoc_md25", null ],
+      [ "Debugging support", "index.html#autotoc_md27", null ],
+      [ "Future plans", "index.html#autotoc_md28", null ],
       [ "[Unreleased]", "md_CHANGELOG.html#autotoc_md1", null ]
     ] ],
     [ "Contributing to the xchange library", "md_CONTRIBUTING.html", null ],
@@ -74,7 +75,7 @@ var NAVTREE =
 var NAVTREEINDEX =
 [
 "annotated.html",
-"xstruct_8c.html#a42e4e75cbf8f721ef4b251c692dcd7cb"
+"xstruct_8c.html#a36fb99b219c5a61db1d1c3d630277987"
 ];
 
 var SYNCONMSG = 'click to disable panel synchronisation';
diff --git a/apidoc/html/navtreeindex0.js b/apidoc/html/navtreeindex0.js
index 4b91e22..8f551eb 100644
--- a/apidoc/html/navtreeindex0.js
+++ b/apidoc/html/navtreeindex0.js
@@ -22,26 +22,27 @@ var NAVTREEINDEX0 =
 "globals_vars.html":[3,1,2],
 "globals_x.html":[3,1,0,8],
 "index.html":[],
-"index.html#autotoc_md10":[3,0],
-"index.html#autotoc_md11":[3,0,0],
-"index.html#autotoc_md12":[3,1],
-"index.html#autotoc_md13":[3,2],
-"index.html#autotoc_md14":[3,3],
-"index.html#autotoc_md15":[3,4],
-"index.html#autotoc_md16":[3,5],
-"index.html#autotoc_md17":[3,5,0],
-"index.html#autotoc_md18":[3,5,1],
-"index.html#autotoc_md19":[3,6],
-"index.html#autotoc_md21":[4],
+"index.html#autotoc_md11":[4],
+"index.html#autotoc_md12":[4,0],
+"index.html#autotoc_md13":[4,0,0],
+"index.html#autotoc_md14":[4,1],
+"index.html#autotoc_md15":[4,2],
+"index.html#autotoc_md16":[4,3],
+"index.html#autotoc_md17":[4,4],
+"index.html#autotoc_md18":[4,5],
+"index.html#autotoc_md19":[4,5,0],
+"index.html#autotoc_md20":[4,5,1],
+"index.html#autotoc_md21":[4,6],
 "index.html#autotoc_md23":[5],
 "index.html#autotoc_md25":[6],
-"index.html#autotoc_md26":[7],
+"index.html#autotoc_md27":[7],
+"index.html#autotoc_md28":[8],
 "index.html#autotoc_md3":[0],
 "index.html#autotoc_md5":[1],
 "index.html#autotoc_md7":[2],
 "index.html#autotoc_md9":[3],
 "md_CHANGELOG.html":[0],
-"md_CHANGELOG.html#autotoc_md1":[0,8],
+"md_CHANGELOG.html#autotoc_md1":[0,9],
 "md_CONTRIBUTING.html":[1],
 "pages.html":[],
 "structXField.html":[2,0,0],
@@ -248,6 +249,5 @@ var NAVTREEINDEX0 =
 "xstruct_8c.html":[3,0,1,3],
 "xstruct_8c.html#a12112584a34e07f9ef7b08f6ef1bc865":[3,0,1,3,14],
 "xstruct_8c.html#a1720e156de63fd0585224738ccbb5688":[3,0,1,3,20],
-"xstruct_8c.html#a2cbbd824406d862b2018e28a466ff318":[3,0,1,3,18],
-"xstruct_8c.html#a36fb99b219c5a61db1d1c3d630277987":[3,0,1,3,28]
+"xstruct_8c.html#a2cbbd824406d862b2018e28a466ff318":[3,0,1,3,18]
 };
diff --git a/apidoc/html/navtreeindex1.js b/apidoc/html/navtreeindex1.js
index e78187e..b36576a 100644
--- a/apidoc/html/navtreeindex1.js
+++ b/apidoc/html/navtreeindex1.js
@@ -1,5 +1,6 @@
 var NAVTREEINDEX1 =
 {
+"xstruct_8c.html#a36fb99b219c5a61db1d1c3d630277987":[3,0,1,3,28],
 "xstruct_8c.html#a42e4e75cbf8f721ef4b251c692dcd7cb":[3,0,1,3,9],
 "xstruct_8c.html#a442f155b0c6549549737510ce42bb66d":[3,0,1,3,19],
 "xstruct_8c.html#a4587dcd0157acce30373288e19f1237d":[3,0,1,3,11],
diff --git a/apidoc/html/search/all_1.js b/apidoc/html/search/all_1.js
index 1db4de5..94cae86 100644
--- a/apidoc/html/search/all_1.js
+++ b/apidoc/html/search/all_1.js
@@ -1,8 +1,10 @@
 var searchData=
 [
-  ['accessing_20substructures_20and_20elements_0',['Accessing substructures and elements',['../index.html#autotoc_md16',1,'']]],
-  ['aggregate_20ids_1',['Aggregate IDs',['../index.html#autotoc_md15',1,'']]],
-  ['and_20elements_2',['Accessing substructures and elements',['../index.html#autotoc_md16',1,'']]],
-  ['and_20emitter_3',['JSON parser and emitter',['../index.html#autotoc_md21',1,'']]],
-  ['arrays_4',['Arrays',['../index.html#autotoc_md13',1,'']]]
+  ['accessing_20substructures_20and_20elements_0',['Accessing substructures and elements',['../index.html#autotoc_md18',1,'']]],
+  ['against_20tt_20xchange_20tt_1',['Linking your application against &lt;tt&gt;xchange&lt;/tt&gt;',['../index.html#autotoc_md9',1,'']]],
+  ['aggregate_20ids_2',['Aggregate IDs',['../index.html#autotoc_md17',1,'']]],
+  ['and_20elements_3',['Accessing substructures and elements',['../index.html#autotoc_md18',1,'']]],
+  ['and_20emitter_4',['JSON parser and emitter',['../index.html#autotoc_md23',1,'']]],
+  ['application_20against_20tt_20xchange_20tt_5',['Linking your application against &lt;tt&gt;xchange&lt;/tt&gt;',['../index.html#autotoc_md9',1,'']]],
+  ['arrays_6',['Arrays',['../index.html#autotoc_md15',1,'']]]
 ];
diff --git a/apidoc/html/search/all_10.js b/apidoc/html/search/all_10.js
index 6151930..a0a0725 100644
--- a/apidoc/html/search/all_10.js
+++ b/apidoc/html/search/all_10.js
@@ -4,6 +4,7 @@ var searchData=
   ['the_20xchange_20library_1',['Contributing to the xchange library',['../md_CONTRIBUTING.html',1,'']]],
   ['to_20the_20xchange_20library_2',['Contributing to the xchange library',['../md_CONTRIBUTING.html',1,'']]],
   ['true_3',['true',['../xjson_8c.html#aa8cecfc5c5c054d2875c03e77b7be15d',1,'TRUE:&#160;xjson.c'],['../xchange_8h.html#aa8cecfc5c5c054d2875c03e77b7be15d',1,'TRUE:&#160;xchange.h']]],
-  ['type_4',['type',['../structXField.html#a6535ecc7e6d29e64f0d34cd926823fd9',1,'XField']]],
-  ['types_5',['Basic data types',['../index.html#autotoc_md10',1,'']]]
+  ['tt_20xchange_20tt_4',['Linking your application against &lt;tt&gt;xchange&lt;/tt&gt;',['../index.html#autotoc_md9',1,'']]],
+  ['type_5',['type',['../structXField.html#a6535ecc7e6d29e64f0d34cd926823fd9',1,'XField']]],
+  ['types_6',['Basic data types',['../index.html#autotoc_md12',1,'']]]
 ];
diff --git a/apidoc/html/search/all_13.js b/apidoc/html/search/all_13.js
index a185cdb..fefe9ef 100644
--- a/apidoc/html/search/all_13.js
+++ b/apidoc/html/search/all_13.js
@@ -50,94 +50,95 @@ var searchData=
   ['xalloclookup_47',['xalloclookup',['../xlookup_8c.html#a01a94b3210aed984dbee956fbb26fcfd',1,'xAllocLookup(unsigned int size):&#160;xlookup.c'],['../xchange_8h.html#a01a94b3210aed984dbee956fbb26fcfd',1,'xAllocLookup(unsigned int size):&#160;xlookup.c']]],
   ['xchange_48',['xchange',['../index.html',1,'']]],
   ['xchange_20library_49',['Contributing to the xchange library',['../md_CONTRIBUTING.html',1,'']]],
-  ['xchange_2ec_50',['xchange.c',['../xchange_8c.html',1,'']]],
-  ['xchange_2eh_51',['xchange.h',['../xchange_8h.html',1,'']]],
-  ['xchange_5fmajor_5fversion_52',['XCHANGE_MAJOR_VERSION',['../xchange_8h.html#a13ea68e798d0cd9cab06667707737055',1,'xchange.h']]],
-  ['xchange_5fminor_5fversion_53',['XCHANGE_MINOR_VERSION',['../xchange_8h.html#a52519844e66bcff3ed17e4feaab76b2f',1,'xchange.h']]],
-  ['xchange_5fpatchlevel_54',['XCHANGE_PATCHLEVEL',['../xchange_8h.html#aef108c611a8388c435502dfd89c41a5f',1,'xchange.h']]],
-  ['xchange_5frelease_5fstring_55',['XCHANGE_RELEASE_STRING',['../xchange_8h.html#a1cda2967190e2d61c5560bf6b43d930d',1,'xchange.h']]],
-  ['xchange_5fversion_5fstring_56',['XCHANGE_VERSION_STRING',['../xchange_8h.html#a2e8ac004db0f6cb82e1b7a13b79380c5',1,'xchange.h']]],
-  ['xclearstruct_57',['xclearstruct',['../xstruct_8c.html#ae45c0a047c30a17aba84d2fc8c08a2dc',1,'xClearStruct(XStructure *s):&#160;xstruct.c'],['../xchange_8h.html#ae45c0a047c30a17aba84d2fc8c08a2dc',1,'xClearStruct(XStructure *s):&#160;xstruct.c']]],
-  ['xcopyidtoken_58',['xcopyidtoken',['../xchange_8h.html#ab20a0213369a947a7e48ff45aabee3c0',1,'xCopyIDToken(const char *id):&#160;xstruct.c'],['../xstruct_8c.html#ab20a0213369a947a7e48ff45aabee3c0',1,'xCopyIDToken(const char *id):&#160;xstruct.c']]],
-  ['xcopyoffield_59',['xcopyoffield',['../xchange_8h.html#afdb31906269568772fdf63adb6685fbc',1,'xCopyOfField(const XField *f):&#160;xstruct.c'],['../xstruct_8c.html#afdb31906269568772fdf63adb6685fbc',1,'xCopyOfField(const XField *f):&#160;xstruct.c']]],
-  ['xcopyofstruct_60',['xcopyofstruct',['../xchange_8h.html#ad78b2fb3d6d1474c8a44c57575a6e13b',1,'xCopyOfStruct(const XStructure *s):&#160;xstruct.c'],['../xstruct_8c.html#ad78b2fb3d6d1474c8a44c57575a6e13b',1,'xCopyOfStruct(const XStructure *s):&#160;xstruct.c']]],
-  ['xcountfields_61',['xcountfields',['../xstruct_8c.html#af7447cdd983402a27a25a70cc7187275',1,'xCountFields(const XStructure *s):&#160;xstruct.c'],['../xchange_8h.html#af7447cdd983402a27a25a70cc7187275',1,'xCountFields(const XStructure *s):&#160;xstruct.c']]],
-  ['xcreate1dfield_62',['xcreate1dfield',['../xstruct_8c.html#a9897f06ef8a22d5ddb8538d5fe223ae2',1,'xCreate1DField(const char *name, XType type, int count, const void *values):&#160;xstruct.c'],['../xchange_8h.html#a9897f06ef8a22d5ddb8538d5fe223ae2',1,'xCreate1DField(const char *name, XType type, int count, const void *values):&#160;xstruct.c']]],
-  ['xcreatebooleanfield_63',['xcreatebooleanfield',['../xstruct_8c.html#ad2fa86a7d296f1efa6b41079bc2a6b65',1,'xCreateBooleanField(const char *name, boolean value):&#160;xstruct.c'],['../xchange_8h.html#ad2fa86a7d296f1efa6b41079bc2a6b65',1,'xCreateBooleanField(const char *name, boolean value):&#160;xstruct.c']]],
-  ['xcreatedoublefield_64',['xcreatedoublefield',['../xstruct_8c.html#ab7ac206d0ec3608a0872f09c7f7bc189',1,'xCreateDoubleField(const char *name, double value):&#160;xstruct.c'],['../xchange_8h.html#ab7ac206d0ec3608a0872f09c7f7bc189',1,'xCreateDoubleField(const char *name, double value):&#160;xstruct.c']]],
-  ['xcreatefield_65',['xcreatefield',['../xstruct_8c.html#a42e4e75cbf8f721ef4b251c692dcd7cb',1,'xCreateField(const char *name, XType type, int ndim, const int *sizes, const void *value):&#160;xstruct.c'],['../xchange_8h.html#a42e4e75cbf8f721ef4b251c692dcd7cb',1,'xCreateField(const char *name, XType type, int ndim, const int *sizes, const void *value):&#160;xstruct.c']]],
-  ['xcreateintfield_66',['xcreateintfield',['../xstruct_8c.html#aa4405d56659397e044b6d4fdda394dfa',1,'xCreateIntField(const char *name, int value):&#160;xstruct.c'],['../xchange_8h.html#aa4405d56659397e044b6d4fdda394dfa',1,'xCreateIntField(const char *name, int value):&#160;xstruct.c']]],
-  ['xcreatelongfield_67',['xcreatelongfield',['../xstruct_8c.html#a4587dcd0157acce30373288e19f1237d',1,'xCreateLongField(const char *name, long long value):&#160;xstruct.c'],['../xchange_8h.html#a4587dcd0157acce30373288e19f1237d',1,'xCreateLongField(const char *name, long long value):&#160;xstruct.c']]],
-  ['xcreatelookup_68',['xcreatelookup',['../xlookup_8c.html#af8bee9eeac947d7e36ea436252e8dc2d',1,'xCreateLookup(const XStructure *s, boolean recursive):&#160;xlookup.c'],['../xchange_8h.html#af8bee9eeac947d7e36ea436252e8dc2d',1,'xCreateLookup(const XStructure *s, boolean recursive):&#160;xlookup.c']]],
-  ['xcreatescalarfield_69',['xcreatescalarfield',['../xstruct_8c.html#a965f7e58fd1c10570c6f6a472599b08f',1,'xCreateScalarField(const char *name, XType type, const void *value):&#160;xstruct.c'],['../xchange_8h.html#a965f7e58fd1c10570c6f6a472599b08f',1,'xCreateScalarField(const char *name, XType type, const void *value):&#160;xstruct.c']]],
-  ['xcreatestringfield_70',['xcreatestringfield',['../xstruct_8c.html#a9dc77bed0d8b738ba615019721a6a2b6',1,'xCreateStringField(const char *name, const char *value):&#160;xstruct.c'],['../xchange_8h.html#a9dc77bed0d8b738ba615019721a6a2b6',1,'xCreateStringField(const char *name, const char *value):&#160;xstruct.c']]],
-  ['xcreatestruct_71',['xcreatestruct',['../xstruct_8c.html#a12112584a34e07f9ef7b08f6ef1bc865',1,'xCreateStruct():&#160;xstruct.c'],['../xchange_8h.html#a12112584a34e07f9ef7b08f6ef1bc865',1,'xCreateStruct():&#160;xstruct.c']]],
-  ['xdebug_72',['xdebug',['../xchange_8c.html#ace21b1dd3eab2ce044a2fea31e393e7b',1,'xDebug:&#160;xchange.c'],['../xchange_8h.html#ace21b1dd3eab2ce044a2fea31e393e7b',1,'xDebug:&#160;xchange.c']]],
-  ['xdeepcountfields_73',['xdeepcountfields',['../xstruct_8c.html#a789489313df89d33aa50de911e1e42ff',1,'xDeepCountFields(const XStructure *s):&#160;xstruct.c'],['../xchange_8h.html#a789489313df89d33aa50de911e1e42ff',1,'xDeepCountFields(const XStructure *s):&#160;xstruct.c']]],
-  ['xdestroyfield_74',['xdestroyfield',['../xstruct_8c.html#ae0ce99c867b11bd14971031eec8ba4ad',1,'xDestroyField(XField *f):&#160;xstruct.c'],['../xchange_8h.html#ae0ce99c867b11bd14971031eec8ba4ad',1,'xDestroyField(XField *f):&#160;xstruct.c']]],
-  ['xdestroylookup_75',['xdestroylookup',['../xlookup_8c.html#a02ea2d67e4c540ad706edcc1b3a0431e',1,'xDestroyLookup(XLookupTable *tab):&#160;xlookup.c'],['../xchange_8h.html#a02ea2d67e4c540ad706edcc1b3a0431e',1,'xDestroyLookup(XLookupTable *tab):&#160;xlookup.c']]],
-  ['xdestroystruct_76',['xdestroystruct',['../xchange_8h.html#afe3fda2f392bae11e136e8c0c90f086d',1,'xDestroyStruct(XStructure *s):&#160;xstruct.c'],['../xstruct_8c.html#afe3fda2f392bae11e136e8c0c90f086d',1,'xDestroyStruct(XStructure *s):&#160;xstruct.c']]],
-  ['xdprintf_77',['xdprintf',['../xchange_8h.html#a2b0edfea798e9e08122f09dba5f189f8',1,'xchange.h']]],
-  ['xelementsizeof_78',['xelementsizeof',['../xchange_8h.html#af5ec26d18b20fc0da9ec9032af73fa9e',1,'xElementSizeOf(XType type):&#160;xchange.c'],['../xchange_8c.html#af5ec26d18b20fc0da9ec9032af73fa9e',1,'xElementSizeOf(XType type):&#160;xchange.c']]],
-  ['xerror_79',['xerror',['../xchange_8c.html#a606c4844e51124bee155e30bac8ca885',1,'xError(const char *fn, int code):&#160;xchange.c'],['../xchange_8h.html#a606c4844e51124bee155e30bac8ca885',1,'xError(const char *fn, int code):&#160;xchange.c']]],
-  ['xerrordescription_80',['xerrordescription',['../xchange_8c.html#acc701c734a3b95d356660ca5ee16a96a',1,'xErrorDescription(int code):&#160;xchange.c'],['../xchange_8h.html#acc701c734a3b95d356660ca5ee16a96a',1,'xErrorDescription(int code):&#160;xchange.c']]],
-  ['xfield_81',['XField',['../structXField.html',1,'']]],
-  ['xgetaggregateid_82',['xgetaggregateid',['../xstruct_8c.html#a2cbbd824406d862b2018e28a466ff318',1,'xGetAggregateID(const char *table, const char *key):&#160;xstruct.c'],['../xchange_8h.html#a32e104d7a23090f8ae0e6ea3cc55a84f',1,'xGetAggregateID(const char *group, const char *key):&#160;xstruct.c']]],
-  ['xgetelementcount_83',['xgetelementcount',['../xchange_8h.html#ad35e0d8c0ebbb4948c233f96c54bd8d6',1,'xGetElementCount(int ndim, const int *sizes):&#160;xchange.c'],['../xchange_8c.html#ad35e0d8c0ebbb4948c233f96c54bd8d6',1,'xGetElementCount(int ndim, const int *sizes):&#160;xchange.c']]],
-  ['xgetfield_84',['xgetfield',['../xstruct_8c.html#a442f155b0c6549549737510ce42bb66d',1,'xGetField(const XStructure *s, const char *id):&#160;xstruct.c'],['../xchange_8h.html#ad3f1d50fc0f1553b806bedbd17d2206e',1,'xGetField(const XStructure *s, const char *name):&#160;xstruct.c']]],
-  ['xgetfieldcount_85',['xgetfieldcount',['../xstruct_8c.html#a1720e156de63fd0585224738ccbb5688',1,'xGetFieldCount(const XField *f):&#160;xstruct.c'],['../xchange_8h.html#a1720e156de63fd0585224738ccbb5688',1,'xGetFieldCount(const XField *f):&#160;xstruct.c']]],
-  ['xgetsubstruct_86',['xgetsubstruct',['../xstruct_8c.html#a97a58e33c4730e272af459dfb7f016f9',1,'xGetSubstruct(const XStructure *s, const char *id):&#160;xstruct.c'],['../xchange_8h.html#a97a58e33c4730e272af459dfb7f016f9',1,'xGetSubstruct(const XStructure *s, const char *id):&#160;xstruct.c']]],
-  ['xinsertfield_87',['xInsertField',['../xstruct_8c.html#ad6249db6da0a1294d5621cd9fd829f7a',1,'xstruct.c']]],
-  ['xischarsequence_88',['xischarsequence',['../xchange_8c.html#adcc86baacb3ddebcc529e269223274b8',1,'xIsCharSequence(XType type):&#160;xchange.c'],['../xchange_8h.html#adcc86baacb3ddebcc529e269223274b8',1,'xIsCharSequence(XType type):&#160;xchange.c']]],
-  ['xisfieldvalid_89',['xisfieldvalid',['../xstruct_8c.html#aec6e78e07733ca246ca485b0fcf02d21',1,'xIsFieldValid(const XField *f):&#160;xstruct.c'],['../xchange_8h.html#aec6e78e07733ca246ca485b0fcf02d21',1,'xIsFieldValid(const XField *f):&#160;xstruct.c']]],
-  ['xisverbose_90',['xisverbose',['../xchange_8h.html#a46a6c2d802ebadd46ffcfdde7fb438b8',1,'xIsVerbose():&#160;xchange.c'],['../xchange_8c.html#a46a6c2d802ebadd46ffcfdde7fb438b8',1,'xIsVerbose():&#160;xchange.c']]],
-  ['xjson_2ec_91',['xjson.c',['../xjson_8c.html',1,'']]],
-  ['xjson_2eh_92',['xjson.h',['../xjson_8h.html',1,'']]],
-  ['xjson_5findent_93',['XJSON_INDENT',['../xjson_8h.html#ab69c52214e2e6daa2626bf8722f2d73e',1,'xjson.h']]],
-  ['xjsonescapestring_94',['xjsonescapestring',['../xjson_8c.html#aad83ebcc397046a875040dfc2297d892',1,'xjsonEscapeString(const char *src, int maxLength):&#160;xjson.c'],['../xjson_8h.html#aad83ebcc397046a875040dfc2297d892',1,'xjsonEscapeString(const char *src, int maxLength):&#160;xjson.c']]],
-  ['xjsongetindent_95',['xjsongetindent',['../xjson_8c.html#a9f11227a58e797a4a335331d94c8e888',1,'xjsonGetIndent():&#160;xjson.c'],['../xjson_8h.html#a9f11227a58e797a4a335331d94c8e888',1,'xjsonGetIndent():&#160;xjson.c']]],
-  ['xjsonparseat_96',['xjsonparseat',['../xjson_8c.html#af180900a4afeef713a3fdaeb77a9cba3',1,'xjsonParseAt(char **pos, int *lineNumber):&#160;xjson.c'],['../xjson_8h.html#acdb7d242c80b4c9dbeedc62b479bfcc7',1,'xjsonParseAt(char **src, int *lineNumber):&#160;xjson.c']]],
-  ['xjsonparsefile_97',['xjsonparsefile',['../xjson_8c.html#a9bdaf6099829f03eb2658342e856f0ad',1,'xjsonParseFile(FILE *fp, size_t length, int *lineNumber):&#160;xjson.c'],['../xjson_8h.html#a5b542fdced2080503cdbf2cf9a071324',1,'xjsonParseFile(FILE *file, size_t length, int *lineNumber):&#160;xjson.c']]],
-  ['xjsonparsefilename_98',['xjsonparsefilename',['../xjson_8c.html#afff9ee9473a0c939d18dba977cfac075',1,'xjsonParseFilename(const char *fileName, int *lineNumber):&#160;xjson.c'],['../xjson_8h.html#afff9ee9473a0c939d18dba977cfac075',1,'xjsonParseFilename(const char *fileName, int *lineNumber):&#160;xjson.c']]],
-  ['xjsonseterrorstream_99',['xjsonseterrorstream',['../xjson_8c.html#a23a7bd364a80bc2bab9ce917ed5f22ea',1,'xjsonSetErrorStream(FILE *fp):&#160;xjson.c'],['../xjson_8h.html#a23a7bd364a80bc2bab9ce917ed5f22ea',1,'xjsonSetErrorStream(FILE *fp):&#160;xjson.c']]],
-  ['xjsonsetindent_100',['xjsonsetindent',['../xjson_8c.html#a1f877c9790a53582cdda10659a3d033a',1,'xjsonSetIndent(int nchars):&#160;xjson.c'],['../xjson_8h.html#a1f877c9790a53582cdda10659a3d033a',1,'xjsonSetIndent(int nchars):&#160;xjson.c']]],
-  ['xjsontostring_101',['xjsontostring',['../xjson_8c.html#a53128045970e973134867c96a6465abc',1,'xjsonToString(const XStructure *s):&#160;xjson.c'],['../xjson_8h.html#a53128045970e973134867c96a6465abc',1,'xjsonToString(const XStructure *s):&#160;xjson.c']]],
-  ['xjsonunescapestring_102',['xjsonunescapestring',['../xjson_8c.html#ae11aed18561818c2e39a5709a8e3374d',1,'xjsonUnescapeString(const char *str):&#160;xjson.c'],['../xjson_8h.html#ad576b96ec3efe2b20bd762de0c5af751',1,'xjsonUnescapeString(const char *json):&#160;xjson.c']]],
-  ['xlastseparator_103',['xlastseparator',['../xstruct_8c.html#ab9a9fbc1235164bfeed5fbba1f7d8692',1,'xLastSeparator(const char *id):&#160;xstruct.c'],['../xchange_8h.html#ab9a9fbc1235164bfeed5fbba1f7d8692',1,'xLastSeparator(const char *id):&#160;xstruct.c']]],
-  ['xlookup_2ec_104',['xlookup.c',['../xlookup_8c.html',1,'']]],
-  ['xlookupcount_105',['xlookupcount',['../xlookup_8c.html#a13e81b8f1bf3e1c3572ca74edb2836fe',1,'xLookupCount(const XLookupTable *tab):&#160;xlookup.c'],['../xchange_8h.html#a13e81b8f1bf3e1c3572ca74edb2836fe',1,'xLookupCount(const XLookupTable *tab):&#160;xlookup.c']]],
-  ['xlookupfield_106',['xlookupfield',['../xlookup_8c.html#a5e3a316b7d0c5c40ed079f3df2d9fcc9',1,'xLookupField(const XLookupTable *tab, const char *id):&#160;xlookup.c'],['../xchange_8h.html#a5e3a316b7d0c5c40ed079f3df2d9fcc9',1,'xLookupField(const XLookupTable *tab, const char *id):&#160;xlookup.c']]],
-  ['xlookupput_107',['xlookupput',['../xlookup_8c.html#a3b423bf135d2ed42319abff99fda78e4',1,'xLookupPut(XLookupTable *tab, const char *prefix, const XField *field, XField **oldValue):&#160;xlookup.c'],['../xchange_8h.html#a3b423bf135d2ed42319abff99fda78e4',1,'xLookupPut(XLookupTable *tab, const char *prefix, const XField *field, XField **oldValue):&#160;xlookup.c']]],
-  ['xlookupputall_108',['xlookupputall',['../xlookup_8c.html#a91a19055586ae79dee6d43c5de0cb32b',1,'xLookupPutAll(XLookupTable *tab, const char *prefix, const XStructure *s, boolean recursive):&#160;xlookup.c'],['../xchange_8h.html#a91a19055586ae79dee6d43c5de0cb32b',1,'xLookupPutAll(XLookupTable *tab, const char *prefix, const XStructure *s, boolean recursive):&#160;xlookup.c']]],
-  ['xlookupremove_109',['xlookupremove',['../xlookup_8c.html#a85f2c5443ebef48499398453a39710da',1,'xLookupRemove(XLookupTable *tab, const char *id):&#160;xlookup.c'],['../xchange_8h.html#a85f2c5443ebef48499398453a39710da',1,'xLookupRemove(XLookupTable *tab, const char *id):&#160;xlookup.c']]],
-  ['xlookupremoveall_110',['xlookupremoveall',['../xlookup_8c.html#add4a6ffa5866d770bd21636d00b9d3d7',1,'xLookupRemoveAll(XLookupTable *tab, const char *prefix, const XStructure *s, boolean recursive):&#160;xlookup.c'],['../xchange_8h.html#add4a6ffa5866d770bd21636d00b9d3d7',1,'xLookupRemoveAll(XLookupTable *tab, const char *prefix, const XStructure *s, boolean recursive):&#160;xlookup.c']]],
-  ['xlookuptable_111',['XLookupTable',['../structXLookupTable.html',1,'']]],
-  ['xmatchnextid_112',['xmatchnextid',['../xchange_8h.html#a90aae0dafd1d461877eef63c9c730592',1,'xMatchNextID(const char *token, const char *id):&#160;xstruct.c'],['../xstruct_8c.html#a90aae0dafd1d461877eef63c9c730592',1,'xMatchNextID(const char *token, const char *id):&#160;xstruct.c']]],
-  ['xnextidtoken_113',['xnextidtoken',['../xchange_8h.html#af436eb535b32fa88ab4e600c0a37c19d',1,'xNextIDToken(const char *id):&#160;xstruct.c'],['../xstruct_8c.html#af436eb535b32fa88ab4e600c0a37c19d',1,'xNextIDToken(const char *id):&#160;xstruct.c']]],
-  ['xparseboolean_114',['xparseboolean',['../xchange_8c.html#a994ae91adbbffc3b55b47b0219338282',1,'xParseBoolean(char *str, char **end):&#160;xchange.c'],['../xchange_8h.html#a994ae91adbbffc3b55b47b0219338282',1,'xParseBoolean(char *str, char **end):&#160;xchange.c']]],
-  ['xparsedims_115',['xparsedims',['../xchange_8c.html#a309b9ae681c40121517672ca50ba665b',1,'xParseDims(const char *src, int *sizes):&#160;xchange.c'],['../xchange_8h.html#a309b9ae681c40121517672ca50ba665b',1,'xParseDims(const char *src, int *sizes):&#160;xchange.c']]],
-  ['xparsedouble_116',['xparsedouble',['../xchange_8c.html#a7e2e177c11fe7f44ca5ce11f316c0ad9',1,'xParseDouble(const char *str, char **tail):&#160;xchange.c'],['../xchange_8h.html#a7e2e177c11fe7f44ca5ce11f316c0ad9',1,'xParseDouble(const char *str, char **tail):&#160;xchange.c']]],
-  ['xprintdims_117',['xprintdims',['../xchange_8c.html#aced93c2ca8cef260663ff1f9cfc0140e',1,'xPrintDims(char *dst, int ndim, const int *sizes):&#160;xchange.c'],['../xchange_8h.html#aced93c2ca8cef260663ff1f9cfc0140e',1,'xPrintDims(char *dst, int ndim, const int *sizes):&#160;xchange.c']]],
-  ['xprintdouble_118',['xprintdouble',['../xchange_8c.html#a3eb8c827cfc2139687d175649284f7be',1,'xPrintDouble(char *str, double value):&#160;xchange.c'],['../xchange_8h.html#a3eb8c827cfc2139687d175649284f7be',1,'xPrintDouble(char *str, double value):&#160;xchange.c']]],
-  ['xprintfloat_119',['xprintfloat',['../xchange_8c.html#a9ee406a1c0c8d1076620ae4f77695216',1,'xPrintFloat(char *str, float value):&#160;xchange.c'],['../xchange_8h.html#a9ee406a1c0c8d1076620ae4f77695216',1,'xPrintFloat(char *str, float value):&#160;xchange.c']]],
-  ['xreducealldims_120',['xreducealldims',['../xstruct_8c.html#acc31fe75f06a6e0e469fba3a57c4fb25',1,'xReduceAllDims(XStructure *s):&#160;xstruct.c'],['../xchange_8h.html#acc31fe75f06a6e0e469fba3a57c4fb25',1,'xReduceAllDims(XStructure *s):&#160;xstruct.c']]],
-  ['xreducedims_121',['xreducedims',['../xstruct_8c.html#a36fb99b219c5a61db1d1c3d630277987',1,'xReduceDims(int *ndim, int *sizes):&#160;xstruct.c'],['../xchange_8h.html#a36fb99b219c5a61db1d1c3d630277987',1,'xReduceDims(int *ndim, int *sizes):&#160;xstruct.c']]],
-  ['xremovefield_122',['xremovefield',['../xstruct_8c.html#aec9f913cdb79d8653668a5d9bdda6ab1',1,'xRemoveField(XStructure *s, const char *name):&#160;xstruct.c'],['../xchange_8h.html#aec9f913cdb79d8653668a5d9bdda6ab1',1,'xRemoveField(XStructure *s, const char *name):&#160;xstruct.c']]],
-  ['xreversefieldorder_123',['xreversefieldorder',['../xstruct_8c.html#ad32d8a3f211a3b101142879ae31146ec',1,'xReverseFieldOrder(XStructure *s, boolean recursive):&#160;xstruct.c'],['../xchange_8h.html#ad32d8a3f211a3b101142879ae31146ec',1,'xReverseFieldOrder(XStructure *s, boolean recursive):&#160;xstruct.c']]],
-  ['xsetdebug_124',['xsetdebug',['../xchange_8c.html#a6c1304b59a5882b2286e86c6837faead',1,'xSetDebug(boolean value):&#160;xchange.c'],['../xchange_8h.html#a6c1304b59a5882b2286e86c6837faead',1,'xSetDebug(boolean value):&#160;xchange.c']]],
-  ['xsetfield_125',['xsetfield',['../xstruct_8c.html#ab1cb91bd6aa14c0dae9d24bfbe7b76f4',1,'xSetField(XStructure *s, XField *f):&#160;xstruct.c'],['../xchange_8h.html#ab1cb91bd6aa14c0dae9d24bfbe7b76f4',1,'xSetField(XStructure *s, XField *f):&#160;xstruct.c']]],
-  ['xsetsubstruct_126',['xsetsubstruct',['../xstruct_8c.html#ad84cbb4639f2fbfb604b698a86caf944',1,'xSetSubstruct(XStructure *s, const char *name, XStructure *substruct):&#160;xstruct.c'],['../xchange_8h.html#ad84cbb4639f2fbfb604b698a86caf944',1,'xSetSubstruct(XStructure *s, const char *name, XStructure *substruct):&#160;xstruct.c']]],
-  ['xsetverbose_127',['xsetverbose',['../xchange_8c.html#afbe85067ddbc92577cd00ac8f6e3026f',1,'xSetVerbose(boolean value):&#160;xchange.c'],['../xchange_8h.html#afbe85067ddbc92577cd00ac8f6e3026f',1,'xSetVerbose(boolean value):&#160;xchange.c']]],
-  ['xsortfields_128',['xsortfields',['../xstruct_8c.html#aa1d006a2788adeb0fc9b4799297a69ff',1,'xSortFields(XStructure *s, int(*cmp)(const XField **f1, const XField **f2), boolean recursive):&#160;xstruct.c'],['../xchange_8h.html#aa1d006a2788adeb0fc9b4799297a69ff',1,'xSortFields(XStructure *s, int(*cmp)(const XField **f1, const XField **f2), boolean recursive):&#160;xstruct.c']]],
-  ['xsortfieldsbyname_129',['xsortfieldsbyname',['../xstruct_8c.html#a74d1f6b9b92ebe82353e75a3d7e9daae',1,'xSortFieldsByName(XStructure *s, boolean recursive):&#160;xstruct.c'],['../xchange_8h.html#a74d1f6b9b92ebe82353e75a3d7e9daae',1,'xSortFieldsByName(XStructure *s, boolean recursive):&#160;xstruct.c']]],
-  ['xsplitid_130',['xsplitid',['../xstruct_8c.html#acd6af91336f4b5501d0a0e3d5cf88ad3',1,'xSplitID(char *id, char **pKey):&#160;xstruct.c'],['../xchange_8h.html#acd6af91336f4b5501d0a0e3d5cf88ad3',1,'xSplitID(char *id, char **pKey):&#160;xstruct.c']]],
-  ['xstringcopyof_131',['xstringcopyof',['../xchange_8h.html#a01d730a1a98963816de2dd73e72957a5',1,'xStringCopyOf(const char *str):&#160;xchange.c'],['../xchange_8c.html#a01d730a1a98963816de2dd73e72957a5',1,'xStringCopyOf(const char *str):&#160;xchange.c']]],
-  ['xstringelementsizeof_132',['xstringelementsizeof',['../xchange_8c.html#a8816199a4473325a942e14057dcd9ab8',1,'xStringElementSizeOf(XType type):&#160;xchange.c'],['../xchange_8h.html#a8816199a4473325a942e14057dcd9ab8',1,'xStringElementSizeOf(XType type):&#160;xchange.c']]],
-  ['xstruct_2ec_133',['xstruct.c',['../xstruct_8c.html',1,'']]],
-  ['xstructure_134',['XStructure',['../structXStructure.html',1,'']]],
-  ['xtype_135',['XType',['../xchange_8h.html#a1c7e02eda23566a7891310fd09307a70',1,'xchange.h']]],
-  ['xtypechar_136',['xtypechar',['../xchange_8c.html#ae6b0637ea4bc09f522c67e4c49da13ce',1,'xTypeChar(XType type):&#160;xchange.c'],['../xchange_8h.html#ae6b0637ea4bc09f522c67e4c49da13ce',1,'xTypeChar(XType type):&#160;xchange.c']]],
-  ['xverbose_137',['xverbose',['../xchange_8c.html#a363b67b316973290c30c11bea7931c64',1,'xVerbose:&#160;xchange.c'],['../xchange_8h.html#a363b67b316973290c30c11bea7931c64',1,'xVerbose:&#160;xchange.c']]],
-  ['xvprintf_138',['xvprintf',['../xchange_8h.html#a1f038bf7ddb58819805cfc44162cb403',1,'xchange.h']]],
-  ['xzero_139',['xzero',['../xchange_8c.html#a3605bad086ec39e14f97e42e25334227',1,'xZero(void *buf, XType type, int count):&#160;xchange.c'],['../xchange_8h.html#a3605bad086ec39e14f97e42e25334227',1,'xZero(void *buf, XType type, int count):&#160;xchange.c']]]
+  ['xchange_20tt_50',['Linking your application against &lt;tt&gt;xchange&lt;/tt&gt;',['../index.html#autotoc_md9',1,'']]],
+  ['xchange_2ec_51',['xchange.c',['../xchange_8c.html',1,'']]],
+  ['xchange_2eh_52',['xchange.h',['../xchange_8h.html',1,'']]],
+  ['xchange_5fmajor_5fversion_53',['XCHANGE_MAJOR_VERSION',['../xchange_8h.html#a13ea68e798d0cd9cab06667707737055',1,'xchange.h']]],
+  ['xchange_5fminor_5fversion_54',['XCHANGE_MINOR_VERSION',['../xchange_8h.html#a52519844e66bcff3ed17e4feaab76b2f',1,'xchange.h']]],
+  ['xchange_5fpatchlevel_55',['XCHANGE_PATCHLEVEL',['../xchange_8h.html#aef108c611a8388c435502dfd89c41a5f',1,'xchange.h']]],
+  ['xchange_5frelease_5fstring_56',['XCHANGE_RELEASE_STRING',['../xchange_8h.html#a1cda2967190e2d61c5560bf6b43d930d',1,'xchange.h']]],
+  ['xchange_5fversion_5fstring_57',['XCHANGE_VERSION_STRING',['../xchange_8h.html#a2e8ac004db0f6cb82e1b7a13b79380c5',1,'xchange.h']]],
+  ['xclearstruct_58',['xclearstruct',['../xstruct_8c.html#ae45c0a047c30a17aba84d2fc8c08a2dc',1,'xClearStruct(XStructure *s):&#160;xstruct.c'],['../xchange_8h.html#ae45c0a047c30a17aba84d2fc8c08a2dc',1,'xClearStruct(XStructure *s):&#160;xstruct.c']]],
+  ['xcopyidtoken_59',['xcopyidtoken',['../xstruct_8c.html#ab20a0213369a947a7e48ff45aabee3c0',1,'xCopyIDToken(const char *id):&#160;xstruct.c'],['../xchange_8h.html#ab20a0213369a947a7e48ff45aabee3c0',1,'xCopyIDToken(const char *id):&#160;xstruct.c']]],
+  ['xcopyoffield_60',['xcopyoffield',['../xchange_8h.html#afdb31906269568772fdf63adb6685fbc',1,'xCopyOfField(const XField *f):&#160;xstruct.c'],['../xstruct_8c.html#afdb31906269568772fdf63adb6685fbc',1,'xCopyOfField(const XField *f):&#160;xstruct.c']]],
+  ['xcopyofstruct_61',['xcopyofstruct',['../xchange_8h.html#ad78b2fb3d6d1474c8a44c57575a6e13b',1,'xCopyOfStruct(const XStructure *s):&#160;xstruct.c'],['../xstruct_8c.html#ad78b2fb3d6d1474c8a44c57575a6e13b',1,'xCopyOfStruct(const XStructure *s):&#160;xstruct.c']]],
+  ['xcountfields_62',['xcountfields',['../xstruct_8c.html#af7447cdd983402a27a25a70cc7187275',1,'xCountFields(const XStructure *s):&#160;xstruct.c'],['../xchange_8h.html#af7447cdd983402a27a25a70cc7187275',1,'xCountFields(const XStructure *s):&#160;xstruct.c']]],
+  ['xcreate1dfield_63',['xcreate1dfield',['../xstruct_8c.html#a9897f06ef8a22d5ddb8538d5fe223ae2',1,'xCreate1DField(const char *name, XType type, int count, const void *values):&#160;xstruct.c'],['../xchange_8h.html#a9897f06ef8a22d5ddb8538d5fe223ae2',1,'xCreate1DField(const char *name, XType type, int count, const void *values):&#160;xstruct.c']]],
+  ['xcreatebooleanfield_64',['xcreatebooleanfield',['../xstruct_8c.html#ad2fa86a7d296f1efa6b41079bc2a6b65',1,'xCreateBooleanField(const char *name, boolean value):&#160;xstruct.c'],['../xchange_8h.html#ad2fa86a7d296f1efa6b41079bc2a6b65',1,'xCreateBooleanField(const char *name, boolean value):&#160;xstruct.c']]],
+  ['xcreatedoublefield_65',['xcreatedoublefield',['../xstruct_8c.html#ab7ac206d0ec3608a0872f09c7f7bc189',1,'xCreateDoubleField(const char *name, double value):&#160;xstruct.c'],['../xchange_8h.html#ab7ac206d0ec3608a0872f09c7f7bc189',1,'xCreateDoubleField(const char *name, double value):&#160;xstruct.c']]],
+  ['xcreatefield_66',['xcreatefield',['../xstruct_8c.html#a42e4e75cbf8f721ef4b251c692dcd7cb',1,'xCreateField(const char *name, XType type, int ndim, const int *sizes, const void *value):&#160;xstruct.c'],['../xchange_8h.html#a42e4e75cbf8f721ef4b251c692dcd7cb',1,'xCreateField(const char *name, XType type, int ndim, const int *sizes, const void *value):&#160;xstruct.c']]],
+  ['xcreateintfield_67',['xcreateintfield',['../xstruct_8c.html#aa4405d56659397e044b6d4fdda394dfa',1,'xCreateIntField(const char *name, int value):&#160;xstruct.c'],['../xchange_8h.html#aa4405d56659397e044b6d4fdda394dfa',1,'xCreateIntField(const char *name, int value):&#160;xstruct.c']]],
+  ['xcreatelongfield_68',['xcreatelongfield',['../xstruct_8c.html#a4587dcd0157acce30373288e19f1237d',1,'xCreateLongField(const char *name, long long value):&#160;xstruct.c'],['../xchange_8h.html#a4587dcd0157acce30373288e19f1237d',1,'xCreateLongField(const char *name, long long value):&#160;xstruct.c']]],
+  ['xcreatelookup_69',['xcreatelookup',['../xlookup_8c.html#af8bee9eeac947d7e36ea436252e8dc2d',1,'xCreateLookup(const XStructure *s, boolean recursive):&#160;xlookup.c'],['../xchange_8h.html#af8bee9eeac947d7e36ea436252e8dc2d',1,'xCreateLookup(const XStructure *s, boolean recursive):&#160;xlookup.c']]],
+  ['xcreatescalarfield_70',['xcreatescalarfield',['../xstruct_8c.html#a965f7e58fd1c10570c6f6a472599b08f',1,'xCreateScalarField(const char *name, XType type, const void *value):&#160;xstruct.c'],['../xchange_8h.html#a965f7e58fd1c10570c6f6a472599b08f',1,'xCreateScalarField(const char *name, XType type, const void *value):&#160;xstruct.c']]],
+  ['xcreatestringfield_71',['xcreatestringfield',['../xstruct_8c.html#a9dc77bed0d8b738ba615019721a6a2b6',1,'xCreateStringField(const char *name, const char *value):&#160;xstruct.c'],['../xchange_8h.html#a9dc77bed0d8b738ba615019721a6a2b6',1,'xCreateStringField(const char *name, const char *value):&#160;xstruct.c']]],
+  ['xcreatestruct_72',['xcreatestruct',['../xstruct_8c.html#a12112584a34e07f9ef7b08f6ef1bc865',1,'xCreateStruct():&#160;xstruct.c'],['../xchange_8h.html#a12112584a34e07f9ef7b08f6ef1bc865',1,'xCreateStruct():&#160;xstruct.c']]],
+  ['xdebug_73',['xdebug',['../xchange_8c.html#ace21b1dd3eab2ce044a2fea31e393e7b',1,'xDebug:&#160;xchange.c'],['../xchange_8h.html#ace21b1dd3eab2ce044a2fea31e393e7b',1,'xDebug:&#160;xchange.c']]],
+  ['xdeepcountfields_74',['xdeepcountfields',['../xstruct_8c.html#a789489313df89d33aa50de911e1e42ff',1,'xDeepCountFields(const XStructure *s):&#160;xstruct.c'],['../xchange_8h.html#a789489313df89d33aa50de911e1e42ff',1,'xDeepCountFields(const XStructure *s):&#160;xstruct.c']]],
+  ['xdestroyfield_75',['xdestroyfield',['../xstruct_8c.html#ae0ce99c867b11bd14971031eec8ba4ad',1,'xDestroyField(XField *f):&#160;xstruct.c'],['../xchange_8h.html#ae0ce99c867b11bd14971031eec8ba4ad',1,'xDestroyField(XField *f):&#160;xstruct.c']]],
+  ['xdestroylookup_76',['xdestroylookup',['../xlookup_8c.html#a02ea2d67e4c540ad706edcc1b3a0431e',1,'xDestroyLookup(XLookupTable *tab):&#160;xlookup.c'],['../xchange_8h.html#a02ea2d67e4c540ad706edcc1b3a0431e',1,'xDestroyLookup(XLookupTable *tab):&#160;xlookup.c']]],
+  ['xdestroystruct_77',['xdestroystruct',['../xstruct_8c.html#afe3fda2f392bae11e136e8c0c90f086d',1,'xDestroyStruct(XStructure *s):&#160;xstruct.c'],['../xchange_8h.html#afe3fda2f392bae11e136e8c0c90f086d',1,'xDestroyStruct(XStructure *s):&#160;xstruct.c']]],
+  ['xdprintf_78',['xdprintf',['../xchange_8h.html#a2b0edfea798e9e08122f09dba5f189f8',1,'xchange.h']]],
+  ['xelementsizeof_79',['xelementsizeof',['../xchange_8h.html#af5ec26d18b20fc0da9ec9032af73fa9e',1,'xElementSizeOf(XType type):&#160;xchange.c'],['../xchange_8c.html#af5ec26d18b20fc0da9ec9032af73fa9e',1,'xElementSizeOf(XType type):&#160;xchange.c']]],
+  ['xerror_80',['xerror',['../xchange_8c.html#a606c4844e51124bee155e30bac8ca885',1,'xError(const char *fn, int code):&#160;xchange.c'],['../xchange_8h.html#a606c4844e51124bee155e30bac8ca885',1,'xError(const char *fn, int code):&#160;xchange.c']]],
+  ['xerrordescription_81',['xerrordescription',['../xchange_8c.html#acc701c734a3b95d356660ca5ee16a96a',1,'xErrorDescription(int code):&#160;xchange.c'],['../xchange_8h.html#acc701c734a3b95d356660ca5ee16a96a',1,'xErrorDescription(int code):&#160;xchange.c']]],
+  ['xfield_82',['XField',['../structXField.html',1,'']]],
+  ['xgetaggregateid_83',['xgetaggregateid',['../xstruct_8c.html#a2cbbd824406d862b2018e28a466ff318',1,'xGetAggregateID(const char *table, const char *key):&#160;xstruct.c'],['../xchange_8h.html#a32e104d7a23090f8ae0e6ea3cc55a84f',1,'xGetAggregateID(const char *group, const char *key):&#160;xstruct.c']]],
+  ['xgetelementcount_84',['xgetelementcount',['../xchange_8c.html#ad35e0d8c0ebbb4948c233f96c54bd8d6',1,'xGetElementCount(int ndim, const int *sizes):&#160;xchange.c'],['../xchange_8h.html#ad35e0d8c0ebbb4948c233f96c54bd8d6',1,'xGetElementCount(int ndim, const int *sizes):&#160;xchange.c']]],
+  ['xgetfield_85',['xgetfield',['../xstruct_8c.html#a442f155b0c6549549737510ce42bb66d',1,'xGetField(const XStructure *s, const char *id):&#160;xstruct.c'],['../xchange_8h.html#ad3f1d50fc0f1553b806bedbd17d2206e',1,'xGetField(const XStructure *s, const char *name):&#160;xstruct.c']]],
+  ['xgetfieldcount_86',['xgetfieldcount',['../xstruct_8c.html#a1720e156de63fd0585224738ccbb5688',1,'xGetFieldCount(const XField *f):&#160;xstruct.c'],['../xchange_8h.html#a1720e156de63fd0585224738ccbb5688',1,'xGetFieldCount(const XField *f):&#160;xstruct.c']]],
+  ['xgetsubstruct_87',['xgetsubstruct',['../xstruct_8c.html#a97a58e33c4730e272af459dfb7f016f9',1,'xGetSubstruct(const XStructure *s, const char *id):&#160;xstruct.c'],['../xchange_8h.html#a97a58e33c4730e272af459dfb7f016f9',1,'xGetSubstruct(const XStructure *s, const char *id):&#160;xstruct.c']]],
+  ['xinsertfield_88',['xInsertField',['../xstruct_8c.html#ad6249db6da0a1294d5621cd9fd829f7a',1,'xstruct.c']]],
+  ['xischarsequence_89',['xischarsequence',['../xchange_8h.html#adcc86baacb3ddebcc529e269223274b8',1,'xIsCharSequence(XType type):&#160;xchange.c'],['../xchange_8c.html#adcc86baacb3ddebcc529e269223274b8',1,'xIsCharSequence(XType type):&#160;xchange.c']]],
+  ['xisfieldvalid_90',['xisfieldvalid',['../xstruct_8c.html#aec6e78e07733ca246ca485b0fcf02d21',1,'xIsFieldValid(const XField *f):&#160;xstruct.c'],['../xchange_8h.html#aec6e78e07733ca246ca485b0fcf02d21',1,'xIsFieldValid(const XField *f):&#160;xstruct.c']]],
+  ['xisverbose_91',['xisverbose',['../xchange_8c.html#a46a6c2d802ebadd46ffcfdde7fb438b8',1,'xIsVerbose():&#160;xchange.c'],['../xchange_8h.html#a46a6c2d802ebadd46ffcfdde7fb438b8',1,'xIsVerbose():&#160;xchange.c']]],
+  ['xjson_2ec_92',['xjson.c',['../xjson_8c.html',1,'']]],
+  ['xjson_2eh_93',['xjson.h',['../xjson_8h.html',1,'']]],
+  ['xjson_5findent_94',['XJSON_INDENT',['../xjson_8h.html#ab69c52214e2e6daa2626bf8722f2d73e',1,'xjson.h']]],
+  ['xjsonescapestring_95',['xjsonescapestring',['../xjson_8c.html#aad83ebcc397046a875040dfc2297d892',1,'xjsonEscapeString(const char *src, int maxLength):&#160;xjson.c'],['../xjson_8h.html#aad83ebcc397046a875040dfc2297d892',1,'xjsonEscapeString(const char *src, int maxLength):&#160;xjson.c']]],
+  ['xjsongetindent_96',['xjsongetindent',['../xjson_8h.html#a9f11227a58e797a4a335331d94c8e888',1,'xjsonGetIndent():&#160;xjson.c'],['../xjson_8c.html#a9f11227a58e797a4a335331d94c8e888',1,'xjsonGetIndent():&#160;xjson.c']]],
+  ['xjsonparseat_97',['xjsonparseat',['../xjson_8c.html#af180900a4afeef713a3fdaeb77a9cba3',1,'xjsonParseAt(char **pos, int *lineNumber):&#160;xjson.c'],['../xjson_8h.html#acdb7d242c80b4c9dbeedc62b479bfcc7',1,'xjsonParseAt(char **src, int *lineNumber):&#160;xjson.c']]],
+  ['xjsonparsefile_98',['xjsonparsefile',['../xjson_8c.html#a9bdaf6099829f03eb2658342e856f0ad',1,'xjsonParseFile(FILE *fp, size_t length, int *lineNumber):&#160;xjson.c'],['../xjson_8h.html#a5b542fdced2080503cdbf2cf9a071324',1,'xjsonParseFile(FILE *file, size_t length, int *lineNumber):&#160;xjson.c']]],
+  ['xjsonparsefilename_99',['xjsonparsefilename',['../xjson_8c.html#afff9ee9473a0c939d18dba977cfac075',1,'xjsonParseFilename(const char *fileName, int *lineNumber):&#160;xjson.c'],['../xjson_8h.html#afff9ee9473a0c939d18dba977cfac075',1,'xjsonParseFilename(const char *fileName, int *lineNumber):&#160;xjson.c']]],
+  ['xjsonseterrorstream_100',['xjsonseterrorstream',['../xjson_8h.html#a23a7bd364a80bc2bab9ce917ed5f22ea',1,'xjsonSetErrorStream(FILE *fp):&#160;xjson.c'],['../xjson_8c.html#a23a7bd364a80bc2bab9ce917ed5f22ea',1,'xjsonSetErrorStream(FILE *fp):&#160;xjson.c']]],
+  ['xjsonsetindent_101',['xjsonsetindent',['../xjson_8c.html#a1f877c9790a53582cdda10659a3d033a',1,'xjsonSetIndent(int nchars):&#160;xjson.c'],['../xjson_8h.html#a1f877c9790a53582cdda10659a3d033a',1,'xjsonSetIndent(int nchars):&#160;xjson.c']]],
+  ['xjsontostring_102',['xjsontostring',['../xjson_8c.html#a53128045970e973134867c96a6465abc',1,'xjsonToString(const XStructure *s):&#160;xjson.c'],['../xjson_8h.html#a53128045970e973134867c96a6465abc',1,'xjsonToString(const XStructure *s):&#160;xjson.c']]],
+  ['xjsonunescapestring_103',['xjsonunescapestring',['../xjson_8c.html#ae11aed18561818c2e39a5709a8e3374d',1,'xjsonUnescapeString(const char *str):&#160;xjson.c'],['../xjson_8h.html#ad576b96ec3efe2b20bd762de0c5af751',1,'xjsonUnescapeString(const char *json):&#160;xjson.c']]],
+  ['xlastseparator_104',['xlastseparator',['../xstruct_8c.html#ab9a9fbc1235164bfeed5fbba1f7d8692',1,'xLastSeparator(const char *id):&#160;xstruct.c'],['../xchange_8h.html#ab9a9fbc1235164bfeed5fbba1f7d8692',1,'xLastSeparator(const char *id):&#160;xstruct.c']]],
+  ['xlookup_2ec_105',['xlookup.c',['../xlookup_8c.html',1,'']]],
+  ['xlookupcount_106',['xlookupcount',['../xlookup_8c.html#a13e81b8f1bf3e1c3572ca74edb2836fe',1,'xLookupCount(const XLookupTable *tab):&#160;xlookup.c'],['../xchange_8h.html#a13e81b8f1bf3e1c3572ca74edb2836fe',1,'xLookupCount(const XLookupTable *tab):&#160;xlookup.c']]],
+  ['xlookupfield_107',['xlookupfield',['../xlookup_8c.html#a5e3a316b7d0c5c40ed079f3df2d9fcc9',1,'xLookupField(const XLookupTable *tab, const char *id):&#160;xlookup.c'],['../xchange_8h.html#a5e3a316b7d0c5c40ed079f3df2d9fcc9',1,'xLookupField(const XLookupTable *tab, const char *id):&#160;xlookup.c']]],
+  ['xlookupput_108',['xlookupput',['../xlookup_8c.html#a3b423bf135d2ed42319abff99fda78e4',1,'xLookupPut(XLookupTable *tab, const char *prefix, const XField *field, XField **oldValue):&#160;xlookup.c'],['../xchange_8h.html#a3b423bf135d2ed42319abff99fda78e4',1,'xLookupPut(XLookupTable *tab, const char *prefix, const XField *field, XField **oldValue):&#160;xlookup.c']]],
+  ['xlookupputall_109',['xlookupputall',['../xlookup_8c.html#a91a19055586ae79dee6d43c5de0cb32b',1,'xLookupPutAll(XLookupTable *tab, const char *prefix, const XStructure *s, boolean recursive):&#160;xlookup.c'],['../xchange_8h.html#a91a19055586ae79dee6d43c5de0cb32b',1,'xLookupPutAll(XLookupTable *tab, const char *prefix, const XStructure *s, boolean recursive):&#160;xlookup.c']]],
+  ['xlookupremove_110',['xlookupremove',['../xlookup_8c.html#a85f2c5443ebef48499398453a39710da',1,'xLookupRemove(XLookupTable *tab, const char *id):&#160;xlookup.c'],['../xchange_8h.html#a85f2c5443ebef48499398453a39710da',1,'xLookupRemove(XLookupTable *tab, const char *id):&#160;xlookup.c']]],
+  ['xlookupremoveall_111',['xlookupremoveall',['../xlookup_8c.html#add4a6ffa5866d770bd21636d00b9d3d7',1,'xLookupRemoveAll(XLookupTable *tab, const char *prefix, const XStructure *s, boolean recursive):&#160;xlookup.c'],['../xchange_8h.html#add4a6ffa5866d770bd21636d00b9d3d7',1,'xLookupRemoveAll(XLookupTable *tab, const char *prefix, const XStructure *s, boolean recursive):&#160;xlookup.c']]],
+  ['xlookuptable_112',['XLookupTable',['../structXLookupTable.html',1,'']]],
+  ['xmatchnextid_113',['xmatchnextid',['../xstruct_8c.html#a90aae0dafd1d461877eef63c9c730592',1,'xMatchNextID(const char *token, const char *id):&#160;xstruct.c'],['../xchange_8h.html#a90aae0dafd1d461877eef63c9c730592',1,'xMatchNextID(const char *token, const char *id):&#160;xstruct.c']]],
+  ['xnextidtoken_114',['xnextidtoken',['../xchange_8h.html#af436eb535b32fa88ab4e600c0a37c19d',1,'xNextIDToken(const char *id):&#160;xstruct.c'],['../xstruct_8c.html#af436eb535b32fa88ab4e600c0a37c19d',1,'xNextIDToken(const char *id):&#160;xstruct.c']]],
+  ['xparseboolean_115',['xparseboolean',['../xchange_8h.html#a994ae91adbbffc3b55b47b0219338282',1,'xParseBoolean(char *str, char **end):&#160;xchange.c'],['../xchange_8c.html#a994ae91adbbffc3b55b47b0219338282',1,'xParseBoolean(char *str, char **end):&#160;xchange.c']]],
+  ['xparsedims_116',['xparsedims',['../xchange_8h.html#a309b9ae681c40121517672ca50ba665b',1,'xParseDims(const char *src, int *sizes):&#160;xchange.c'],['../xchange_8c.html#a309b9ae681c40121517672ca50ba665b',1,'xParseDims(const char *src, int *sizes):&#160;xchange.c']]],
+  ['xparsedouble_117',['xparsedouble',['../xchange_8h.html#a7e2e177c11fe7f44ca5ce11f316c0ad9',1,'xParseDouble(const char *str, char **tail):&#160;xchange.c'],['../xchange_8c.html#a7e2e177c11fe7f44ca5ce11f316c0ad9',1,'xParseDouble(const char *str, char **tail):&#160;xchange.c']]],
+  ['xprintdims_118',['xprintdims',['../xchange_8h.html#aced93c2ca8cef260663ff1f9cfc0140e',1,'xPrintDims(char *dst, int ndim, const int *sizes):&#160;xchange.c'],['../xchange_8c.html#aced93c2ca8cef260663ff1f9cfc0140e',1,'xPrintDims(char *dst, int ndim, const int *sizes):&#160;xchange.c']]],
+  ['xprintdouble_119',['xprintdouble',['../xchange_8h.html#a3eb8c827cfc2139687d175649284f7be',1,'xPrintDouble(char *str, double value):&#160;xchange.c'],['../xchange_8c.html#a3eb8c827cfc2139687d175649284f7be',1,'xPrintDouble(char *str, double value):&#160;xchange.c']]],
+  ['xprintfloat_120',['xprintfloat',['../xchange_8h.html#a9ee406a1c0c8d1076620ae4f77695216',1,'xPrintFloat(char *str, float value):&#160;xchange.c'],['../xchange_8c.html#a9ee406a1c0c8d1076620ae4f77695216',1,'xPrintFloat(char *str, float value):&#160;xchange.c']]],
+  ['xreducealldims_121',['xreducealldims',['../xchange_8h.html#acc31fe75f06a6e0e469fba3a57c4fb25',1,'xReduceAllDims(XStructure *s):&#160;xstruct.c'],['../xstruct_8c.html#acc31fe75f06a6e0e469fba3a57c4fb25',1,'xReduceAllDims(XStructure *s):&#160;xstruct.c']]],
+  ['xreducedims_122',['xreducedims',['../xchange_8h.html#a36fb99b219c5a61db1d1c3d630277987',1,'xReduceDims(int *ndim, int *sizes):&#160;xstruct.c'],['../xstruct_8c.html#a36fb99b219c5a61db1d1c3d630277987',1,'xReduceDims(int *ndim, int *sizes):&#160;xstruct.c']]],
+  ['xremovefield_123',['xremovefield',['../xchange_8h.html#aec9f913cdb79d8653668a5d9bdda6ab1',1,'xRemoveField(XStructure *s, const char *name):&#160;xstruct.c'],['../xstruct_8c.html#aec9f913cdb79d8653668a5d9bdda6ab1',1,'xRemoveField(XStructure *s, const char *name):&#160;xstruct.c']]],
+  ['xreversefieldorder_124',['xreversefieldorder',['../xchange_8h.html#ad32d8a3f211a3b101142879ae31146ec',1,'xReverseFieldOrder(XStructure *s, boolean recursive):&#160;xstruct.c'],['../xstruct_8c.html#ad32d8a3f211a3b101142879ae31146ec',1,'xReverseFieldOrder(XStructure *s, boolean recursive):&#160;xstruct.c']]],
+  ['xsetdebug_125',['xsetdebug',['../xchange_8c.html#a6c1304b59a5882b2286e86c6837faead',1,'xSetDebug(boolean value):&#160;xchange.c'],['../xchange_8h.html#a6c1304b59a5882b2286e86c6837faead',1,'xSetDebug(boolean value):&#160;xchange.c']]],
+  ['xsetfield_126',['xsetfield',['../xchange_8h.html#ab1cb91bd6aa14c0dae9d24bfbe7b76f4',1,'xSetField(XStructure *s, XField *f):&#160;xstruct.c'],['../xstruct_8c.html#ab1cb91bd6aa14c0dae9d24bfbe7b76f4',1,'xSetField(XStructure *s, XField *f):&#160;xstruct.c']]],
+  ['xsetsubstruct_127',['xsetsubstruct',['../xstruct_8c.html#ad84cbb4639f2fbfb604b698a86caf944',1,'xSetSubstruct(XStructure *s, const char *name, XStructure *substruct):&#160;xstruct.c'],['../xchange_8h.html#ad84cbb4639f2fbfb604b698a86caf944',1,'xSetSubstruct(XStructure *s, const char *name, XStructure *substruct):&#160;xstruct.c']]],
+  ['xsetverbose_128',['xsetverbose',['../xchange_8h.html#afbe85067ddbc92577cd00ac8f6e3026f',1,'xSetVerbose(boolean value):&#160;xchange.c'],['../xchange_8c.html#afbe85067ddbc92577cd00ac8f6e3026f',1,'xSetVerbose(boolean value):&#160;xchange.c']]],
+  ['xsortfields_129',['xsortfields',['../xstruct_8c.html#aa1d006a2788adeb0fc9b4799297a69ff',1,'xSortFields(XStructure *s, int(*cmp)(const XField **f1, const XField **f2), boolean recursive):&#160;xstruct.c'],['../xchange_8h.html#aa1d006a2788adeb0fc9b4799297a69ff',1,'xSortFields(XStructure *s, int(*cmp)(const XField **f1, const XField **f2), boolean recursive):&#160;xstruct.c']]],
+  ['xsortfieldsbyname_130',['xsortfieldsbyname',['../xstruct_8c.html#a74d1f6b9b92ebe82353e75a3d7e9daae',1,'xSortFieldsByName(XStructure *s, boolean recursive):&#160;xstruct.c'],['../xchange_8h.html#a74d1f6b9b92ebe82353e75a3d7e9daae',1,'xSortFieldsByName(XStructure *s, boolean recursive):&#160;xstruct.c']]],
+  ['xsplitid_131',['xsplitid',['../xstruct_8c.html#acd6af91336f4b5501d0a0e3d5cf88ad3',1,'xSplitID(char *id, char **pKey):&#160;xstruct.c'],['../xchange_8h.html#acd6af91336f4b5501d0a0e3d5cf88ad3',1,'xSplitID(char *id, char **pKey):&#160;xstruct.c']]],
+  ['xstringcopyof_132',['xstringcopyof',['../xchange_8h.html#a01d730a1a98963816de2dd73e72957a5',1,'xStringCopyOf(const char *str):&#160;xchange.c'],['../xchange_8c.html#a01d730a1a98963816de2dd73e72957a5',1,'xStringCopyOf(const char *str):&#160;xchange.c']]],
+  ['xstringelementsizeof_133',['xstringelementsizeof',['../xchange_8c.html#a8816199a4473325a942e14057dcd9ab8',1,'xStringElementSizeOf(XType type):&#160;xchange.c'],['../xchange_8h.html#a8816199a4473325a942e14057dcd9ab8',1,'xStringElementSizeOf(XType type):&#160;xchange.c']]],
+  ['xstruct_2ec_134',['xstruct.c',['../xstruct_8c.html',1,'']]],
+  ['xstructure_135',['XStructure',['../structXStructure.html',1,'']]],
+  ['xtype_136',['XType',['../xchange_8h.html#a1c7e02eda23566a7891310fd09307a70',1,'xchange.h']]],
+  ['xtypechar_137',['xtypechar',['../xchange_8c.html#ae6b0637ea4bc09f522c67e4c49da13ce',1,'xTypeChar(XType type):&#160;xchange.c'],['../xchange_8h.html#ae6b0637ea4bc09f522c67e4c49da13ce',1,'xTypeChar(XType type):&#160;xchange.c']]],
+  ['xverbose_138',['xverbose',['../xchange_8c.html#a363b67b316973290c30c11bea7931c64',1,'xVerbose:&#160;xchange.c'],['../xchange_8h.html#a363b67b316973290c30c11bea7931c64',1,'xVerbose:&#160;xchange.c']]],
+  ['xvprintf_139',['xvprintf',['../xchange_8h.html#a1f038bf7ddb58819805cfc44162cb403',1,'xchange.h']]],
+  ['xzero_140',['xzero',['../xchange_8c.html#a3605bad086ec39e14f97e42e25334227',1,'xZero(void *buf, XType type, int count):&#160;xchange.c'],['../xchange_8h.html#a3605bad086ec39e14f97e42e25334227',1,'xZero(void *buf, XType type, int count):&#160;xchange.c']]]
 ];
diff --git a/apidoc/html/search/all_14.js b/apidoc/html/search/all_14.js
index 304da99..021f8c8 100644
--- a/apidoc/html/search/all_14.js
+++ b/apidoc/html/search/all_14.js
@@ -1,29 +1,4 @@
 var searchData=
 [
-  ['r_20a_20and_20declination_0',['A. True apparent R.A. and declination',['../md_LEGACY.html#autotoc_md28',1,'']]],
-  ['r_5fhat_1',['r_hat',['../structsky__pos.html#a5fd669be4d5224aa192afa368a6e3173',1,'sky_pos']]],
-  ['ra_2',['ra',['../structcat__entry.html#a713a0c71a86d92fa6892fdb2cb7c9422',1,'cat_entry::ra'],['../structsky__pos.html#a713a0c71a86d92fa6892fdb2cb7c9422',1,'sky_pos::ra']]],
-  ['ra_5fcio_3',['ra_cio',['../structra__of__cio.html#aba4253d16ca8c644b29da1e727d787aa',1,'ra_of_cio']]],
-  ['ra_5fof_5fcio_4',['ra_of_cio',['../structra__of__cio.html',1,'']]],
-  ['rad2deg_5',['RAD2DEG',['../novas_8h.html#ac5a945020d3528355cda82d383676736',1,'novas.h']]],
-  ['rad_5fvel_6',['rad_vel',['../novas_8c.html#a9f76e2386515e2023172e05891c3fa28',1,'rad_vel(const object *source, const double *pos_src, const double *vel_src, const double *vel_obs, double d_obs_geo, double d_obs_sun, double d_src_sun, double *rv):&#160;novas.c'],['../novas_8h.html#a304b2220e084b4b12e674aad897972bc',1,'rad_vel(const object *source, const double *pos, const double *vel, const double *vel_obs, double d_obs_geo, double d_obs_sun, double d_src_sun, double *rv):&#160;novas.c']]],
-  ['rad_5fvel2_7',['rad_vel2',['../novas_8c.html#a191dcbb360afb9b6bf123d46858156d0',1,'rad_vel2(const object *source, const double *pos_emit, const double *vel_src, const double *pos_det, const double *vel_obs, double d_obs_geo, double d_obs_sun, double d_src_sun):&#160;novas.c'],['../novas_8h.html#a191dcbb360afb9b6bf123d46858156d0',1,'rad_vel2(const object *source, const double *pos_emit, const double *vel_src, const double *pos_det, const double *vel_obs, double d_obs_geo, double d_obs_sun, double d_src_sun):&#160;novas.c']]],
-  ['radec2vector_8',['radec2vector',['../novas_8c.html#acf86ce700b3d3509ebba13e5f16a4327',1,'radec2vector(double ra, double dec, double dist, double *pos):&#160;novas.c'],['../novas_8h.html#acf86ce700b3d3509ebba13e5f16a4327',1,'radec2vector(double ra, double dec, double dist, double *pos):&#160;novas.c']]],
-  ['radec_5fplanet_9',['radec_planet',['../novas_8c.html#a11d3da697a640c39d87cf201ac54ca7c',1,'radec_planet(double jd_tt, const object *ss_body, const observer *obs, double ut1_to_tt, enum novas_reference_system sys, enum novas_accuracy accuracy, double *ra, double *dec, double *dis, double *rv):&#160;novas.c'],['../novas_8h.html#a11d3da697a640c39d87cf201ac54ca7c',1,'radec_planet(double jd_tt, const object *ss_body, const observer *obs, double ut1_to_tt, enum novas_reference_system sys, enum novas_accuracy accuracy, double *ra, double *dec, double *dis, double *rv):&#160;novas.c']]],
-  ['radec_5fstar_10',['radec_star',['../novas_8c.html#aed179ad664f4ff023deb540140f3c2ef',1,'radec_star(double jd_tt, const cat_entry *star, const observer *obs, double ut1_to_tt, enum novas_reference_system sys, enum novas_accuracy accuracy, double *ra, double *dec, double *rv):&#160;novas.c'],['../novas_8h.html#aed179ad664f4ff023deb540140f3c2ef',1,'radec_star(double jd_tt, const cat_entry *star, const observer *obs, double ut1_to_tt, enum novas_reference_system sys, enum novas_accuracy accuracy, double *ra, double *dec, double *rv):&#160;novas.c']]],
-  ['radialvelocity_11',['radialvelocity',['../structcat__entry.html#aa2b5e5ca3a5df1765b49a6c6b110a36a',1,'cat_entry']]],
-  ['readeph_12',['readeph',['../solarsystem_8h.html#abb70fdad016c3a2ea45990eaa16b9245',1,'solarsystem.h']]],
-  ['record_5flength_13',['RECORD_LENGTH',['../eph__manager_8c.html#a56a89d553bafe2d8c4a7e37f2997c300',1,'eph_manager.c']]],
-  ['redshift_5fvrad_14',['redshift_vrad',['../super_8c.html#af56088995d42a0673e03bca1f3891544',1,'redshift_vrad(double vrad, double z):&#160;super.c'],['../novas_8h.html#af56088995d42a0673e03bca1f3891544',1,'redshift_vrad(double vrad, double z):&#160;super.c']]],
-  ['reduced_20accuracy_20shortcuts_15',['Reduced accuracy shortcuts',['../index.html#autotoc_md52',1,'']]],
-  ['refinements_20to_20the_20novas_20c_20api_16',['Refinements to the NOVAS C API',['../index.html#autotoc_md62',1,'']]],
-  ['refract_17',['refract',['../novas_8c.html#a151b74255ea04462abc5503c6afddcae',1,'refract(const on_surface *location, enum novas_refraction_model option, double zd_obs):&#160;novas.c'],['../novas_8h.html#a151b74255ea04462abc5503c6afddcae',1,'refract(const on_surface *location, enum novas_refraction_model option, double zd_obs):&#160;novas.c']]],
-  ['refract_2ec_18',['refract.c',['../refract_8c.html',1,'']]],
-  ['refract_5fastro_19',['refract_astro',['../novas_8c.html#aa41408d8cbbe3cfc12930414a9c79fc7',1,'refract_astro(const on_surface *location, enum novas_refraction_model option, double zd_astro):&#160;novas.c'],['../novas_8h.html#a46d245f56c6eea9b1a7dc32d3feeaeb8',1,'refract_astro(const on_surface *location, enum novas_refraction_model option, double zd_calc):&#160;novas.c']]],
-  ['refractionmodel_20',['RefractionModel',['../novas_8h.html#ad4899a6116cfbbe17400e7ef0c8426a9',1,'novas.h']]],
-  ['release_21',['Release',['../md_RELEASE-HOWTO.html#autotoc_md78',1,'']]],
-  ['release_20checklist_22',['SuperNOVAS release checklist',['../md_RELEASE-HOWTO.html',1,'']]],
-  ['release_20schedule_23',['Release schedule',['../index.html#autotoc_md71',1,'']]],
-  ['rmass_24',['RMASS',['../novascon_8c.html#a19a7c107c3918c90c90cdad5ab310b1a',1,'RMASS:&#160;novascon.c'],['../novascon_8h.html#a19a7c107c3918c90c90cdad5ab310b1a',1,'RMASS:&#160;novascon.c']]],
-  ['rv_25',['rv',['../structsky__pos.html#ad9e8b5daff39072d109a6f4f1fa61f55',1,'sky_pos']]]
+  ['your_20application_20against_20tt_20xchange_20tt_0',['Linking your application against &lt;tt&gt;xchange&lt;/tt&gt;',['../index.html#autotoc_md9',1,'']]]
 ];
diff --git a/apidoc/html/search/all_2.js b/apidoc/html/search/all_2.js
index 44e34af..4e1b131 100644
--- a/apidoc/html/search/all_2.js
+++ b/apidoc/html/search/all_2.js
@@ -1,6 +1,6 @@
 var searchData=
 [
-  ['basic_20data_20types_0',['Basic data types',['../index.html#autotoc_md10',1,'']]],
+  ['basic_20data_20types_0',['Basic data types',['../index.html#autotoc_md12',1,'']]],
   ['boolean_1',['boolean',['../xchange_8h.html#a621c38f1f10a1c565d897e3178b16d6e',1,'xchange.h']]],
   ['building_2',['Building',['../index.html#autotoc_md7',1,'']]]
 ];
diff --git a/apidoc/html/search/all_3.js b/apidoc/html/search/all_3.js
index 1a89848..1be1aaf 100644
--- a/apidoc/html/search/all_3.js
+++ b/apidoc/html/search/all_3.js
@@ -3,5 +3,5 @@ var searchData=
   ['changelog_0',['Changelog',['../md_CHANGELOG.html',1,'']]],
   ['contents_1',['Table of Contents',['../index.html#autotoc_md3',1,'']]],
   ['contributing_20to_20the_20xchange_20library_2',['Contributing to the xchange library',['../md_CONTRIBUTING.html',1,'']]],
-  ['creating_20structure_3',['Creating structure',['../index.html#autotoc_md14',1,'']]]
+  ['creating_20structure_3',['Creating structure',['../index.html#autotoc_md16',1,'']]]
 ];
diff --git a/apidoc/html/search/all_4.js b/apidoc/html/search/all_4.js
index 819bc07..a8bcbca 100644
--- a/apidoc/html/search/all_4.js
+++ b/apidoc/html/search/all_4.js
@@ -1,6 +1,6 @@
 var searchData=
 [
-  ['data_0',['Structured data',['../index.html#autotoc_md9',1,'']]],
-  ['data_20types_1',['Basic data types',['../index.html#autotoc_md10',1,'']]],
-  ['debugging_20support_2',['Debugging support',['../index.html#autotoc_md25',1,'']]]
+  ['data_0',['Structured data',['../index.html#autotoc_md11',1,'']]],
+  ['data_20types_1',['Basic data types',['../index.html#autotoc_md12',1,'']]],
+  ['debugging_20support_2',['Debugging support',['../index.html#autotoc_md27',1,'']]]
 ];
diff --git a/apidoc/html/search/all_5.js b/apidoc/html/search/all_5.js
index 2f5e271..c72e3da 100644
--- a/apidoc/html/search/all_5.js
+++ b/apidoc/html/search/all_5.js
@@ -1,7 +1,7 @@
 var searchData=
 [
   ['eixplicit_5fparse_5fspecial_5fdoubles_0',['EIXPLICIT_PARSE_SPECIAL_DOUBLES',['../xchange_8c.html#acc843123b41c0889b5b328a538b8c6ca',1,'xchange.c']]],
-  ['elements_1',['elements',['../index.html#autotoc_md16',1,'Accessing substructures and elements'],['../index.html#autotoc_md18',1,'Iterating over elements']]],
-  ['emitter_2',['JSON parser and emitter',['../index.html#autotoc_md21',1,'']]],
-  ['error_20handling_3',['Error handling',['../index.html#autotoc_md23',1,'']]]
+  ['elements_1',['elements',['../index.html#autotoc_md18',1,'Accessing substructures and elements'],['../index.html#autotoc_md20',1,'Iterating over elements']]],
+  ['emitter_2',['JSON parser and emitter',['../index.html#autotoc_md23',1,'']]],
+  ['error_20handling_3',['Error handling',['../index.html#autotoc_md25',1,'']]]
 ];
diff --git a/apidoc/html/search/all_6.js b/apidoc/html/search/all_6.js
index 76024dd..5bed941 100644
--- a/apidoc/html/search/all_6.js
+++ b/apidoc/html/search/all_6.js
@@ -1,8 +1,8 @@
 var searchData=
 [
   ['false_0',['false',['../xjson_8c.html#aa93f0eb578d23995850d61f7d61c55c1',1,'FALSE:&#160;xjson.c'],['../xchange_8h.html#aa93f0eb578d23995850d61f7d61c55c1',1,'FALSE:&#160;xchange.h']]],
-  ['fields_1',['Sorting fields',['../index.html#autotoc_md19',1,'']]],
+  ['fields_1',['Sorting fields',['../index.html#autotoc_md21',1,'']]],
   ['firstfield_2',['firstField',['../structXStructure.html#a501ae8af2201d9cfaa60e3af21ff58fc',1,'XStructure']]],
   ['flags_3',['flags',['../structXField.html#ac8bf36fe0577cba66bccda3a6f7e80a4',1,'XField']]],
-  ['future_20plans_4',['Future plans',['../index.html#autotoc_md26',1,'']]]
+  ['future_20plans_4',['Future plans',['../index.html#autotoc_md28',1,'']]]
 ];
diff --git a/apidoc/html/search/all_7.js b/apidoc/html/search/all_7.js
index 0032ec7..623459c 100644
--- a/apidoc/html/search/all_7.js
+++ b/apidoc/html/search/all_7.js
@@ -1,4 +1,4 @@
 var searchData=
 [
-  ['handling_0',['Error handling',['../index.html#autotoc_md23',1,'']]]
+  ['handling_0',['Error handling',['../index.html#autotoc_md25',1,'']]]
 ];
diff --git a/apidoc/html/search/all_8.js b/apidoc/html/search/all_8.js
index af74ae3..2579ba3 100644
--- a/apidoc/html/search/all_8.js
+++ b/apidoc/html/search/all_8.js
@@ -1,7 +1,7 @@
 var searchData=
 [
-  ['ids_0',['Aggregate IDs',['../index.html#autotoc_md15',1,'']]],
+  ['ids_0',['Aggregate IDs',['../index.html#autotoc_md17',1,'']]],
   ['introduction_1',['Introduction',['../index.html#autotoc_md5',1,'']]],
   ['isserialized_2',['isSerialized',['../structXField.html#aaa68a7e140a5370ed0eb52710744c341',1,'XField']]],
-  ['iterating_20over_20elements_3',['Iterating over elements',['../index.html#autotoc_md18',1,'']]]
+  ['iterating_20over_20elements_3',['Iterating over elements',['../index.html#autotoc_md20',1,'']]]
 ];
diff --git a/apidoc/html/search/all_9.js b/apidoc/html/search/all_9.js
index bb19295..f26f1e6 100644
--- a/apidoc/html/search/all_9.js
+++ b/apidoc/html/search/all_9.js
@@ -1,4 +1,4 @@
 var searchData=
 [
-  ['json_20parser_20and_20emitter_0',['JSON parser and emitter',['../index.html#autotoc_md21',1,'']]]
+  ['json_20parser_20and_20emitter_0',['JSON parser and emitter',['../index.html#autotoc_md23',1,'']]]
 ];
diff --git a/apidoc/html/search/all_a.js b/apidoc/html/search/all_a.js
index 5651fa6..c7edaf1 100644
--- a/apidoc/html/search/all_a.js
+++ b/apidoc/html/search/all_a.js
@@ -1,5 +1,6 @@
 var searchData=
 [
-  ['large_20structures_0',['Large structures',['../index.html#autotoc_md17',1,'']]],
-  ['library_1',['Contributing to the xchange library',['../md_CONTRIBUTING.html',1,'']]]
+  ['large_20structures_0',['Large structures',['../index.html#autotoc_md19',1,'']]],
+  ['library_1',['Contributing to the xchange library',['../md_CONTRIBUTING.html',1,'']]],
+  ['linking_20your_20application_20against_20tt_20xchange_20tt_2',['Linking your application against &lt;tt&gt;xchange&lt;/tt&gt;',['../index.html#autotoc_md9',1,'']]]
 ];
diff --git a/apidoc/html/search/all_d.js b/apidoc/html/search/all_d.js
index 22cea00..8f6106b 100644
--- a/apidoc/html/search/all_d.js
+++ b/apidoc/html/search/all_d.js
@@ -1,5 +1,5 @@
 var searchData=
 [
   ['of_20contents_0',['Table of Contents',['../index.html#autotoc_md3',1,'']]],
-  ['over_20elements_1',['Iterating over elements',['../index.html#autotoc_md18',1,'']]]
+  ['over_20elements_1',['Iterating over elements',['../index.html#autotoc_md20',1,'']]]
 ];
diff --git a/apidoc/html/search/all_e.js b/apidoc/html/search/all_e.js
index 2b9bd66..ab8c117 100644
--- a/apidoc/html/search/all_e.js
+++ b/apidoc/html/search/all_e.js
@@ -1,7 +1,7 @@
 var searchData=
 [
   ['parent_0',['parent',['../structXStructure.html#a82ba053944ce97d83d41c05f68ec4f3d',1,'XStructure']]],
-  ['parser_20and_20emitter_1',['JSON parser and emitter',['../index.html#autotoc_md21',1,'']]],
-  ['plans_2',['Future plans',['../index.html#autotoc_md26',1,'']]],
+  ['parser_20and_20emitter_1',['JSON parser and emitter',['../index.html#autotoc_md23',1,'']]],
+  ['plans_2',['Future plans',['../index.html#autotoc_md28',1,'']]],
   ['priv_3',['priv',['../structXLookupTable.html#a8b6505c37d4ff95854b8b00527e4d9fa',1,'XLookupTable']]]
 ];
diff --git a/apidoc/html/search/all_f.js b/apidoc/html/search/all_f.js
index 3e36576..d83655b 100644
--- a/apidoc/html/search/all_f.js
+++ b/apidoc/html/search/all_f.js
@@ -1,14 +1,14 @@
 var searchData=
 [
-  ['scalars_0',['Scalars',['../index.html#autotoc_md12',1,'']]],
+  ['scalars_0',['Scalars',['../index.html#autotoc_md14',1,'']]],
   ['sizes_1',['sizes',['../structXField.html#af743830ee6c7d5e81a0206b07238ca5d',1,'XField']]],
-  ['sorting_20fields_2',['Sorting fields',['../index.html#autotoc_md19',1,'']]],
+  ['sorting_20fields_2',['Sorting fields',['../index.html#autotoc_md21',1,'']]],
   ['str_5f1_3',['str_1',['../xchange_8h.html#a1f298f5039a547cea57a36c2ef616522',1,'xchange.h']]],
   ['str_5f2_4',['str_2',['../xchange_8h.html#a03b3076533e6967aaa48dcccf9ded4a0',1,'xchange.h']]],
-  ['strings_5',['Strings',['../index.html#autotoc_md11',1,'']]],
-  ['structure_6',['Creating structure',['../index.html#autotoc_md14',1,'']]],
-  ['structured_20data_7',['Structured data',['../index.html#autotoc_md9',1,'']]],
-  ['structures_8',['Large structures',['../index.html#autotoc_md17',1,'']]],
-  ['substructures_20and_20elements_9',['Accessing substructures and elements',['../index.html#autotoc_md16',1,'']]],
-  ['support_10',['Debugging support',['../index.html#autotoc_md25',1,'']]]
+  ['strings_5',['Strings',['../index.html#autotoc_md13',1,'']]],
+  ['structure_6',['Creating structure',['../index.html#autotoc_md16',1,'']]],
+  ['structured_20data_7',['Structured data',['../index.html#autotoc_md11',1,'']]],
+  ['structures_8',['Large structures',['../index.html#autotoc_md19',1,'']]],
+  ['substructures_20and_20elements_9',['Accessing substructures and elements',['../index.html#autotoc_md18',1,'']]],
+  ['support_10',['Debugging support',['../index.html#autotoc_md27',1,'']]]
 ];
diff --git a/apidoc/html/search/searchdata.js b/apidoc/html/search/searchdata.js
index 10ca2b6..d9e788a 100644
--- a/apidoc/html/search/searchdata.js
+++ b/apidoc/html/search/searchdata.js
@@ -1,6 +1,6 @@
 var indexSectionsWithContent =
 {
-  0: "_abcdefhijlmnopstuvx",
+  0: "_abcdefhijlmnopstuvxy",
   1: "x",
   2: "x",
   3: "x",
diff --git a/apidoc/html/toc.xml b/apidoc/html/toc.xml
index 5b8f681..fe63cc5 100644
--- a/apidoc/html/toc.xml
+++ b/apidoc/html/toc.xml
@@ -2,23 +2,24 @@
     <topic label="Table of Contents" href="index.html#autotoc_md3"/>
     <topic label="Introduction" href="index.html#autotoc_md5"/>
     <topic label="Building" href="index.html#autotoc_md7"/>
-    <topic label="Structured data" href="index.html#autotoc_md9">
-      <topic label="Basic data types" href="index.html#autotoc_md10">
-        <topic label="Strings" href="index.html#autotoc_md11"/>
-      <topic label="Scalars" href="index.html#autotoc_md12"/>
-      <topic label="Arrays" href="index.html#autotoc_md13"/>
-      <topic label="Creating structure" href="index.html#autotoc_md14"/>
-      <topic label="Aggregate IDs" href="index.html#autotoc_md15"/>
-      <topic label="Accessing substructures and elements" href="index.html#autotoc_md16">
-        <topic label="Large structures" href="index.html#autotoc_md17"/>
-        <topic label="Iterating over elements" href="index.html#autotoc_md18"/>
+    <topic label="Linking your application against &lt;tt&gt;xchange&lt;/tt&gt;" href="index.html#autotoc_md9"/>
+    <topic label="Structured data" href="index.html#autotoc_md11">
+      <topic label="Basic data types" href="index.html#autotoc_md12">
+        <topic label="Strings" href="index.html#autotoc_md13"/>
+      <topic label="Scalars" href="index.html#autotoc_md14"/>
+      <topic label="Arrays" href="index.html#autotoc_md15"/>
+      <topic label="Creating structure" href="index.html#autotoc_md16"/>
+      <topic label="Aggregate IDs" href="index.html#autotoc_md17"/>
+      <topic label="Accessing substructures and elements" href="index.html#autotoc_md18">
+        <topic label="Large structures" href="index.html#autotoc_md19"/>
+        <topic label="Iterating over elements" href="index.html#autotoc_md20"/>
       </topic>
-      <topic label="Sorting fields" href="index.html#autotoc_md19"/>
+      <topic label="Sorting fields" href="index.html#autotoc_md21"/>
     </topic>
-    <topic label="JSON parser and emitter" href="index.html#autotoc_md21"/>
-    <topic label="Error handling" href="index.html#autotoc_md23"/>
-    <topic label="Debugging support" href="index.html#autotoc_md25"/>
-    <topic label="Future plans" href="index.html#autotoc_md26"/>
+    <topic label="JSON parser and emitter" href="index.html#autotoc_md23"/>
+    <topic label="Error handling" href="index.html#autotoc_md25"/>
+    <topic label="Debugging support" href="index.html#autotoc_md27"/>
+    <topic label="Future plans" href="index.html#autotoc_md28"/>
   </topic>
   <topic label="Changelog" href="md_CHANGELOG.html">
     <topic label="[Unreleased]" href="md_CHANGELOG.html#autotoc_md1"/>
diff --git a/apidoc/xchange.tag b/apidoc/xchange.tag
index 6f141ab..bc89834 100644
--- a/apidoc/xchange.tag
+++ b/apidoc/xchange.tag
@@ -1670,6 +1670,7 @@
     <docanchor file="index.html">md_README-xchange</docanchor>
     <docanchor file="index.html">introduction</docanchor>
     <docanchor file="index.html">building</docanchor>
+    <docanchor file="index.html">linking</docanchor>
     <docanchor file="index.html">structured-data</docanchor>
     <docanchor file="index.html">data-types</docanchor>
     <docanchor file="index.html">strings</docanchor>
diff --git a/doc/README.md b/doc/README.md
index abea0b2..a8d5dba 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -13,6 +13,7 @@ Last Updated: 18 September 2024
 
  - [Introduction](#introduction)
  - [Building](#building)
+ - [Linking your application against `xchange`](#linking)
  - [Structured data](#structured-data)
  - [JSON parser and emitter](#json-interchange)
  - [Error handling](#error-handling)
@@ -74,6 +75,24 @@ analysis via the `check` target. Or, you may build just the components you are i
 desired `make` target(s). (You can use `make help` to get a summary of the available `make` targets). 
 
 
+-----------------------------------------------------------------------------
+
+<a name="linking"></a>
+## Linking your application against `xchange`
+
+Provided you have installed the shared (`libxchange.so`) or static (`libxchange.a`) library in a location that is
+in your `LD_LIBRARY_PATH` (e.g. in `/usr/lib` or `/usr/local/lib`) you can simply link your program using the 
+`-lxchange` flag. Your `Makefile` may look like: 
+
+```make
+myprog: ...
+	cc -o $@ $^ $(LDFLAGS) -lxchange 
+```
+
+(Or, you might simply add `-lxchange` to `LDFLAGS` and use a more standard recipe.) And, in if you installed the 
+__xchange__ library elsewhere, you can simply add the location to `LD_LIBRARY_PATH` prior to linking.
+
+
 -----------------------------------------------------------------------------
 
 <a name="structured-data"></a>