Skip to content

Commit

Permalink
Small doc fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
balat committed Jun 25, 2024
1 parent 22ad022 commit ed259ed
Show file tree
Hide file tree
Showing 3 changed files with 3 additions and 3 deletions.
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>REF (ocsipersist-lib.Ocsipersist_lib.Sigs.REF)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.2"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../../index.html">ocsipersist-lib</a> &#x00BB; <a href="../../index.html">Ocsipersist_lib</a> &#x00BB; <a href="../index.html">Sigs</a> &#x00BB; REF</nav><header class="odoc-preamble"><h1>Module type <code><span>Sigs.REF</span></code></h1><p>Persistent references for OCaml</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> <span>'a t</span></span></code></div><div class="spec-doc"><p>The type of (persistent or not) references</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-ref"><a href="#val-ref" class="anchor"></a><code><span><span class="keyword">val</span> ref : <span><span class="optlabel">?persistent</span>:string <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <a href="#type-t">t</a></span></span></code></div><div class="spec-doc"><p><code>ref ?persistent default</code> creates a reference. If optional parameter <code>?persistent</code> is absent,</p><ol><li>the reference will not be persistent (implemented using OCaml references).</li><li>Otherwise, the value of <code>persistent</code> will be used as key for the</li><li>value in the persistent reference table. If the reference already exists, the current value is kept.</li><li>Be careful to change this name every time you change the type of the</li><li>value.</li></ol></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-get"><a href="#val-get" class="anchor"></a><code><span><span class="keyword">val</span> get : <span><span><span class="type-var">'a</span> <a href="#type-t">t</a></span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="xref-unresolved">Lwt</span>.t</span></span></code></div><div class="spec-doc"><p>Get the value of a reference</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-set"><a href="#val-set" class="anchor"></a><code><span><span class="keyword">val</span> set : <span><span><span class="type-var">'a</span> <a href="#type-t">t</a></span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="arrow">&#45;&gt;</span></span> <span>unit <span class="xref-unresolved">Lwt</span>.t</span></span></code></div><div class="spec-doc"><p>Set the value of a reference</p></div></div></div></body></html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>REF (ocsipersist-lib.Ocsipersist_lib.Sigs.REF)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.2"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../../index.html">ocsipersist-lib</a> &#x00BB; <a href="../../index.html">Ocsipersist_lib</a> &#x00BB; <a href="../index.html">Sigs</a> &#x00BB; REF</nav><header class="odoc-preamble"><h1>Module type <code><span>Sigs.REF</span></code></h1><p>Persistent references for OCaml</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> <span>'a t</span></span></code></div><div class="spec-doc"><p>The type of (persistent or not) references</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-ref"><a href="#val-ref" class="anchor"></a><code><span><span class="keyword">val</span> ref : <span><span class="optlabel">?persistent</span>:string <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <a href="#type-t">t</a></span></span></code></div><div class="spec-doc"><p><code>ref ?persistent default</code> creates a reference. If optional parameter <code>?persistent</code> is absent, the reference will not be persistent (implemented using OCaml references). Otherwise, the value of <code>persistent</code> will be used as key for the value in the persistent reference table. If the reference already exists, the current value is kept. Be careful to change this name every time you change the type of the value.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-get"><a href="#val-get" class="anchor"></a><code><span><span class="keyword">val</span> get : <span><span><span class="type-var">'a</span> <a href="#type-t">t</a></span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="xref-unresolved">Lwt</span>.t</span></span></code></div><div class="spec-doc"><p>Get the value of a reference</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-set"><a href="#val-set" class="anchor"></a><code><span><span class="keyword">val</span> set : <span><span><span class="type-var">'a</span> <a href="#type-t">t</a></span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="arrow">&#45;&gt;</span></span> <span>unit <span class="xref-unresolved">Lwt</span>.t</span></span></code></div><div class="spec-doc"><p>Set the value of a reference</p></div></div></div></body></html>
2 changes: 1 addition & 1 deletion ocsipersist/Ocsipersist/Ref/index.html
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Ref (ocsipersist.Ocsipersist.Ref)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.2"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">ocsipersist</a> &#x00BB; <a href="../index.html">Ocsipersist</a> &#x00BB; Ref</nav><header class="odoc-preamble"><h1>Module <code><span>Ocsipersist.Ref</span></code></h1><p>Simple interface for persistent references. Relies on <code>Stdlib.Marshal</code> for (de)serialisation, which entails the same limitations as for the <a href="../Polymorphic/index.html"><code>Polymorphic</code></a> frontend. If this is an issue you can rely on <a href="../Functorial/index.html"><code>Functorial</code></a> frontend instead (see <a href="../../../ocsipersist-lib/Ocsipersist_lib/Sigs/module-type-TABLE/Variable/index.html"><code>TABLE.Variable</code></a>).</p><p>Persistent references for OCaml</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> <span>'a t</span></span></code></div><div class="spec-doc"><p>The type of (persistent or not) references</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-ref"><a href="#val-ref" class="anchor"></a><code><span><span class="keyword">val</span> ref : <span><span class="optlabel">?persistent</span>:string <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <a href="#type-t">t</a></span></span></code></div><div class="spec-doc"><p><code>ref ?persistent default</code> creates a reference. If optional parameter <code>?persistent</code> is absent,</p><ol><li>the reference will not be persistent (implemented using OCaml references).</li><li>Otherwise, the value of <code>persistent</code> will be used as key for the</li><li>value in the persistent reference table. If the reference already exists, the current value is kept.</li><li>Be careful to change this name every time you change the type of the</li><li>value.</li></ol></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-get"><a href="#val-get" class="anchor"></a><code><span><span class="keyword">val</span> get : <span><span><span class="type-var">'a</span> <a href="#type-t">t</a></span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="xref-unresolved">Lwt</span>.t</span></span></code></div><div class="spec-doc"><p>Get the value of a reference</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-set"><a href="#val-set" class="anchor"></a><code><span><span class="keyword">val</span> set : <span><span><span class="type-var">'a</span> <a href="#type-t">t</a></span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="arrow">&#45;&gt;</span></span> <span>unit <span class="xref-unresolved">Lwt</span>.t</span></span></code></div><div class="spec-doc"><p>Set the value of a reference</p></div></div></div></body></html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Ref (ocsipersist.Ocsipersist.Ref)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.2"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">ocsipersist</a> &#x00BB; <a href="../index.html">Ocsipersist</a> &#x00BB; Ref</nav><header class="odoc-preamble"><h1>Module <code><span>Ocsipersist.Ref</span></code></h1><p>Simple interface for persistent references. Relies on <code>Stdlib.Marshal</code> for (de)serialisation, which entails the same limitations as for the <a href="../Polymorphic/index.html"><code>Polymorphic</code></a> frontend. If this is an issue you can rely on <a href="../Functorial/index.html"><code>Functorial</code></a> frontend instead (see <a href="../../../ocsipersist-lib/Ocsipersist_lib/Sigs/module-type-TABLE/Variable/index.html"><code>TABLE.Variable</code></a>).</p><p>Persistent references for OCaml</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> <span>'a t</span></span></code></div><div class="spec-doc"><p>The type of (persistent or not) references</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-ref"><a href="#val-ref" class="anchor"></a><code><span><span class="keyword">val</span> ref : <span><span class="optlabel">?persistent</span>:string <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <a href="#type-t">t</a></span></span></code></div><div class="spec-doc"><p><code>ref ?persistent default</code> creates a reference. If optional parameter <code>?persistent</code> is absent, the reference will not be persistent (implemented using OCaml references). Otherwise, the value of <code>persistent</code> will be used as key for the value in the persistent reference table. If the reference already exists, the current value is kept. Be careful to change this name every time you change the type of the value.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-get"><a href="#val-get" class="anchor"></a><code><span><span class="keyword">val</span> get : <span><span><span class="type-var">'a</span> <a href="#type-t">t</a></span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="xref-unresolved">Lwt</span>.t</span></span></code></div><div class="spec-doc"><p>Get the value of a reference</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-set"><a href="#val-set" class="anchor"></a><code><span><span class="keyword">val</span> set : <span><span><span class="type-var">'a</span> <a href="#type-t">t</a></span> <span class="arrow">&#45;&gt;</span></span> <span><span class="type-var">'a</span> <span class="arrow">&#45;&gt;</span></span> <span>unit <span class="xref-unresolved">Lwt</span>.t</span></span></code></div><div class="spec-doc"><p>Set the value of a reference</p></div></div></div></body></html>
2 changes: 1 addition & 1 deletion ocsipersist/Ocsipersist/index.html
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Ocsipersist (ocsipersist.Ocsipersist)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.2"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../index.html">ocsipersist</a> &#x00BB; Ocsipersist</nav><header class="odoc-preamble"><h1>Module <code><span>Ocsipersist</span></code></h1><p>Persistent key-value store interface for OCaml. This is an virtual library defining a unified frontend for a number of key-value storage implementations. Implementations of the following backends currently exist: SQLite, DBM, PostgreSQL. You can choose the backend you prefer by installing packages <code>ocsipersist-sqlite</code>, <code>ocsipersist-dbm</code> or <code>ocsipersist-pgsql</code>.</p><p>Library <code>Ocsipersist_settings</code>, provided by each of the backends, contain the configuration options for your stores.</p><p>Packages <code>ocsipersist-sqlite-config</code>, <code>ocsipersist-dbm-config</code> and <code>ocsipersist-pgsql-config</code> add the possibility to configure the corresponding backends from Ocsigen Server's configuration file.</p><p>Ocsipersist is used by Eliom for persistent session storages and references.</p><p>Ocsipersist defines several interfaces:</p><ul><li><code>Ref</code> is the simpler the use: it provides persistent references</li><li><code>Store</code> is a lower level interface for persistent values</li><li><code>Polymorphic</code> is a polymorphic table, using Mahshal</li><li><code>Functorial</code> is a typed interface for your own data type</li></ul><p>Example of use from the toplevel:</p><pre class="language-ocaml"><code># #require &quot;lwt_ppx&quot;;;
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Ocsipersist (ocsipersist.Ocsipersist)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.2"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../index.html">ocsipersist</a> &#x00BB; Ocsipersist</nav><header class="odoc-preamble"><h1>Module <code><span>Ocsipersist</span></code></h1><p>Persistent key-value store interface for OCaml. This is a virtual library defining a unified frontend for a number of key-value storage implementations. Implementations of the following backends currently exist: SQLite, DBM, PostgreSQL. You can choose the backend you prefer by installing packages <code>ocsipersist-sqlite</code>, <code>ocsipersist-dbm</code> or <code>ocsipersist-pgsql</code>.</p><p>Library <code>Ocsipersist_settings</code>, provided by each of the backends, contain the configuration options for your stores.</p><p>Packages <code>ocsipersist-sqlite-config</code>, <code>ocsipersist-dbm-config</code> and <code>ocsipersist-pgsql-config</code> add the possibility to configure the corresponding backends from Ocsigen Server's configuration file.</p><p>Ocsipersist is used by Eliom for persistent session storages and references.</p><p>Ocsipersist defines several interfaces:</p><ul><li><code>Ref</code> is the simpler the use: it provides persistent references</li><li><code>Store</code> is a lower level interface for persistent values</li><li><code>Polymorphic</code> is a polymorphic table, using Mahshal</li><li><code>Functorial</code> is a typed interface for your own data type</li></ul><p>Example of use from the toplevel:</p><pre class="language-ocaml"><code># #require &quot;lwt_ppx&quot;;;
(* #thread;; if you are using OCaml &lt; 5.0.0 *)
# #require &quot;ocsipersist-sqlite&quot;;;
# Ocsipersist.init ();;
Expand Down

0 comments on commit ed259ed

Please sign in to comment.