Deploying to gh-pages from @ 8b19f6c 🚀

Author: colinkiama

.doctrees/developer-guides/bindings/writing-a-vapi-manually/05-00-fundamentals-of-binding-a-c-function/05-01-out-and-reference-parameters-and-return-values.doctree

@@ -51,10 +51,10 @@ Returning structs is rather different. Because struct's memory is allocated by t
 
 .. code-block:: vala
 
-   public struct Foo { … }
+   public struct Foo { /* … */ }
    public Foo get_foo (int x);
    public void get_foo2 (int x, out Foo f);
-   
+
 .. code-block:: c
 
    void get_foo(int x, foo *ret);
@@ -73,4 +73,3 @@ To return a struct directly, the question mark operator will box it, and make it
    int make_foo(int y, foo **f);
 
 The ownership rules in :doc:`05-02-ownership` apply.
-

.doctrees/developer-guides/bindings/writing-a-vapi-manually/06-00-adding-vala-friendly-semantics/06-03-collections.doctree

@@ -77,11 +77,11 @@ For container-like instances, Vala provides syntactic sugar to convert certain o
 
 .. code-block:: vala
 
-   x in a → a.contains (x)
-   a[x, y] → a.get (x, y)
-   a[x, y] = z → a.set (x, y, z);
-   foreach (var x in a) { … } → var x; var i = a.iterator (); while ((x = i.next_value ()) != null) {...}
-   foreach (var x in a) { … } → var i = a.iterator (); while (i.next ()) { var x = i.get (); … }
+   x in a // → a.contains (x)
+   a[x, y] // → a.get (x, y)
+   a[x, y] = z // → a.set (x, y, z);
+   foreach (var x in a) { /* … */ } // → var x; var i = a.iterator (); while ((x = i.next_value ()) != null) { /* … */ }
+   foreach (var x in a) { /* … */ } // → var i = a.iterator (); while (i.next ()) { var x = i.get (); /* … */ }
 
 If appropriate, providing methods that match these prototypes will allow use of the sugar.
 
@@ -90,4 +90,3 @@ If appropriate, providing methods that match these prototypes will allow use of
 Iterators require an intermediate object to be the holder of the iteration state. That class must implement a next_value function that returns the next value or null if iteration is to stop or it may have a next method with signature ``bool next ()`` that moves to the next element and returns true if there is one and a method ``T get ()`` to retrieve the current value of the iterator. It is rare for a C program to have the interface needed to do this.
 
 Use your best judgement in deciding whether or not to use these conventions. This is modifying the interface, but it does tend to make the resulting interface easier to use.
-

.doctrees/environment.pickle

@@ -41,7 +41,7 @@ example:
 
    async void display_jpeg(string fnam) {
        // Load JPEG in a background thread and display it when loaded
-       [...]
+       // [...]
    }
 
 
@@ -52,7 +52,7 @@ or:
    async int fetch_webpage(string url, out string text) throws IOError {
        // Fetch a webpage asynchronously and when ready return the
        // HTTP status code and put the page contents in 'text'
-       [...]
+       // [...]
        text = result;
        return status;
    }
@@ -115,7 +115,7 @@ other code to use to resume the method's execution:
 .. code-block:: vala
 
    SourceFunc callback = fetch_webpage.callback;
-   [... store 'callback' somewhere ...]
+   /* … store 'callback' somewhere … */
    yield;
 
 Some code elsewhere must now call the stored ``SourceFunc`` in order for
@@ -169,4 +169,3 @@ Examples
 --------
 
 See `Async Method Samples <https://wiki.gnome.org/Projects/Vala/AsyncSamples>`_ for examples of different ways that async may be used.
-

.doctrees/tutorials/programming-language/main/04-00-advanced-features/04-08-asynchronous-methods.doctree

@@ -520,9 +520,9 @@ <h1><span class="section-number">5.1. </span>Out and Reference Parameters and Re
 </div>
 <p>Note that when you think of an “out array” what you may actually want is just a buffer. If the caller allocates the memory, you want a buffer, not an out array.</p>
 <p>Returning structs is rather different. Because struct’s memory is allocated by the caller, an out parameter for a struct is indistinguishable from a regular pointer. Moreover, returning a struct actually means including a hidden out parameter.</p>
-<div class="highlight-vala notranslate"><div class="highlight"><pre><span></span>public struct Foo { … }
-public Foo get_foo (int x);
-public void get_foo2 (int x, out Foo f);
+<div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="kd">public</span><span class="w"> </span><span class="kd">struct</span><span class="w"> </span><span class="nc">Foo</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="cm">/* … */</span><span class="w"> </span><span class="p">}</span>
+<span class="kd">public</span><span class="w"> </span><span class="n">Foo</span><span class="w"> </span><span class="n">get_foo</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">x</span><span class="p">);</span>
+<span class="kd">public</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">get_foo2</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="k">out</span><span class="w"> </span><span class="n">Foo</span><span class="w"> </span><span class="n">f</span><span class="p">);</span>
 </pre></div>
 </div>
 <div class="highlight-c notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">get_foo</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">foo</span><span class="w"> </span><span class="o">*</span><span class="n">ret</span><span class="p">);</span>

_sources/developer-guides/bindings/writing-a-vapi-manually/05-00-fundamentals-of-binding-a-c-function/05-01-out-and-reference-parameters-and-return-values.rst.txt

@@ -539,11 +539,11 @@ <h1><span class="section-number">6.3. </span>Collections<a class="headerlink" hr
 </pre></div>
 </div>
 <p>For container-like instances, Vala provides syntactic sugar to convert certain operations into method calls:</p>
-<div class="highlight-vala notranslate"><div class="highlight"><pre><span></span>x in a → a.contains (x)
-a[x, y] → a.get (x, y)
-a[x, y] = z → a.set (x, y, z);
-foreach (var x in a) { … } → var x; var i = a.iterator (); while ((x = i.next_value ()) != null) {...}
-foreach (var x in a) { … } → var i = a.iterator (); while (i.next ()) { var x = i.get (); … }
+<div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="n">x</span><span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="n">a</span><span class="w"> </span><span class="c1">// → a.contains (x)</span>
+<span class="n">a</span><span class="p">[</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">y</span><span class="p">]</span><span class="w"> </span><span class="c1">// → a.get (x, y)</span>
+<span class="n">a</span><span class="p">[</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">y</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">z</span><span class="w"> </span><span class="c1">// → a.set (x, y, z);</span>
+<span class="k">foreach</span><span class="w"> </span><span class="p">(</span><span class="kd">var</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="n">a</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="cm">/* … */</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">// → var x; var i = a.iterator (); while ((x = i.next_value ()) != null) { /* … */ }</span>
+<span class="k">foreach</span><span class="w"> </span><span class="p">(</span><span class="kd">var</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="n">a</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="cm">/* … */</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">// → var i = a.iterator (); while (i.next ()) { var x = i.get (); /* … */ }</span>
 </pre></div>
 </div>
 <p>If appropriate, providing methods that match these prototypes will allow use of the sugar.</p>

_sources/developer-guides/bindings/writing-a-vapi-manually/06-00-adding-vala-friendly-semantics/06-03-collections.rst.txt

@@ -520,15 +520,15 @@ <h1><span class="section-number">4.8. </span>Asynchronous Methods<a class="heade
 example:</p>
 <div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="n">async</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">display_jpeg</span><span class="p">(</span><span class="kt">string</span><span class="w"> </span><span class="n">fnam</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
 <span class="w">    </span><span class="c1">// Load JPEG in a background thread and display it when loaded</span>
-<span class="w">    </span><span class="p">[...]</span>
+<span class="w">    </span><span class="c1">// [...]</span>
 <span class="p">}</span>
 </pre></div>
 </div>
 <p>or:</p>
 <div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="n">async</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">fetch_webpage</span><span class="p">(</span><span class="kt">string</span><span class="w"> </span><span class="n">url</span><span class="p">,</span><span class="w"> </span><span class="k">out</span><span class="w"> </span><span class="kt">string</span><span class="w"> </span><span class="n">text</span><span class="p">)</span><span class="w"> </span><span class="kd">throws</span><span class="w"> </span><span class="n">IOError</span><span class="w"> </span><span class="p">{</span>
 <span class="w">    </span><span class="c1">// Fetch a webpage asynchronously and when ready return the</span>
 <span class="w">    </span><span class="c1">// HTTP status code and put the page contents in &#39;text&#39;</span>
-<span class="w">    </span><span class="p">[...]</span>
+<span class="w">    </span><span class="c1">// [...]</span>
 <span class="w">    </span><span class="n">text</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">result</span><span class="p">;</span>
 <span class="w">    </span><span class="k">return</span><span class="w"> </span><span class="n">status</span><span class="p">;</span>
 <span class="p">}</span>
@@ -579,9 +579,9 @@ <h1><span class="section-number">4.8. </span>Asynchronous Methods<a class="heade
 </div>
 <p>This form gives up control, and stores the callback details for some
 other code to use to resume the method’s execution:</p>
-<div class="highlight-vala notranslate"><div class="highlight"><pre><span></span>SourceFunc callback = fetch_webpage.callback;
-[... store &#39;callback&#39; somewhere ...]
-yield;
+<div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="n">SourceFunc</span><span class="w"> </span><span class="n">callback</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">fetch_webpage</span><span class="p">.</span><span class="n">callback</span><span class="p">;</span>
+<span class="cm">/* … store &#39;callback&#39; somewhere … */</span>
+<span class="k">yield</span><span class="p">;</span>
 </pre></div>
 </div>
 <p>Some code elsewhere must now call the stored <code class="docutils literal notranslate"><span class="pre">SourceFunc</span></code> in order for