#19858: Reproducible documentation build
-------------------------------------+-------------------------------------
       Reporter:  jdemeyer           |        Owner:
           Type:  enhancement        |       Status:  needs_review
       Priority:  major              |    Milestone:  sage-7.0
      Component:  documentation      |   Resolution:
       Keywords:                     |    Merged in:
        Authors:  Jeroen Demeyer     |    Reviewers:
Report Upstream:  N/A                |  Work issues:
         Branch:                     |       Commit:
  u/jdemeyer/reproducible_documentation_build|  
941a0f22b93594f96c3b243542e6288756c751bd
   Dependencies:                     |     Stopgaps:
-------------------------------------+-------------------------------------
Description changed by jdemeyer:

Old description:

> Building twice the documentation from the same sources should produce the
> exact same result, byte for byte.  The main current caveat is that the
> representation of default arguments sometimes contain session-dependent
> information like memory addresses for lambda functions.
>
> This will make it easier to diff docs to review doc-related tickets.

New description:

 Building twice the documentation from the same sources should produce the
 exact same result, byte for byte.  This requires removing hexadecimal
 addresses like `function <lambda> at 0xdeadbeef`.

 This will make it easier to diff docs to review doc-related tickets.

 With the branch applied, the only source of non-reproducibility is this
 one:
 {{{
 #!diff
 diff -ru html1/en/reference/finance/sage/finance/stock.html
 html2/en/reference/finance/sage/finance/stock.html
 --- html1/en/reference/finance/sage/finance/stock.html  2016-01-14
 23:06:42.738032047 +0100
 +++ html2/en/reference/finance/sage/finance/stock.html  2016-01-15
 07:25:57.041963861 +0100
 @@ -271,7 +271,7 @@

  <dl class="method">
  <dt id="sage.finance.stock.Stock.history">
 -<tt class="descname">history</tt><big>(</big><em>startdate='Jan+1</em>,
 <em>+1900'</em>, <em>enddate='Jan+14</em>, <em>+2016'</em>,
 <em>histperiod='daily'</em><big>)</big><a class="headerlink"
 href="#sage.finance.stock.Stock.history" title="Permalink to this
 definition">¶</a></dt>
 +<tt class="descname">history</tt><big>(</big><em>startdate='Jan+1</em>,
 <em>+1900'</em>, <em>enddate='Jan+15</em>, <em>+2016'</em>,
 <em>histperiod='daily'</em><big>)</big><a class="headerlink"
 href="#sage.finance.stock.Stock.history" title="Permalink to this
 definition">¶</a></dt>
  <dd><p>Return an immutable sequence of historical price data
  for this stock, obtained from Google. OHLC data is stored
  internally as well. By default, returns the past year&#8217;s daily
 }}}

--

--
Ticket URL: <http://trac.sagemath.org/ticket/19858#comment:3>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica, 
and MATLAB

-- 
You received this message because you are subscribed to the Google Groups 
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.

Reply via email to