This file is indexed.

/usr/share/doc/python-webob-doc/whatsnew-1.5.html is in python-webob-doc 1:1.6.2-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>What’s New in WebOb 1.5 &#8212; WebOb 1.6.2 documentation</title>
    
    <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '1.6.2',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="search.html" />
    <link rel="top" title="WebOb 1.6.2 documentation" href="index.html" />
    <link rel="next" title="What’s New in WebOb 1.6" href="whatsnew-1.6.html" />
    <link rel="prev" title="Another Do-It-Yourself Framework" href="do-it-yourself.html" />
   
  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
  
  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />

  </head>
  <body role="document">
  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <div class="section" id="what-s-new-in-webob-1-5">
<h1>What&#8217;s New in WebOb 1.5<a class="headerlink" href="#what-s-new-in-webob-1-5" title="Permalink to this headline"></a></h1>
<div class="section" id="backwards-incompatibilities">
<h2>Backwards Incompatibilities<a class="headerlink" href="#backwards-incompatibilities" title="Permalink to this headline"></a></h2>
<ul>
<li><p class="first"><code class="docutils literal"><span class="pre">Response.set_cookie</span></code> renamed the only required parameter from &#8220;key&#8221; to
&#8220;name&#8221;. The code will now still accept &#8220;key&#8221; as a keyword argument, and will
issue a DeprecationWarning until WebOb 1.7.</p>
</li>
<li><p class="first">The <code class="docutils literal"><span class="pre">status</span></code> attribute of a <code class="docutils literal"><span class="pre">Response</span></code> object no longer takes a string
like <code class="docutils literal"><span class="pre">None</span> <span class="pre">None</span></code> and allows that to be set as the status. It now has to at
least match the pattern of <code class="docutils literal"><span class="pre">&lt;integer</span> <span class="pre">status</span> <span class="pre">code&gt;</span> <span class="pre">&lt;explenation</span> <span class="pre">of</span> <span class="pre">status</span>
<span class="pre">code&gt;</span></code>. Invalid status strings will now raise a <code class="docutils literal"><span class="pre">ValueError</span></code>.</p>
</li>
<li><p class="first"><code class="docutils literal"><span class="pre">Morsel</span></code> will no longer accept a cookie value that does not meet RFC6265&#8217;s
cookie-octet specification. Upon calling <code class="docutils literal"><span class="pre">Morsel.serialize</span></code> a warning will
be issued, in the future this will raise a <code class="docutils literal"><span class="pre">ValueError</span></code>, please update your
cookie handling code. See <a class="reference external" href="https://github.com/Pylons/webob/pull/172">https://github.com/Pylons/webob/pull/172</a></p>
<p>The cookie-octet specification in RFC6265 states the following characters are
valid in a cookie value:</p>
<table border="1" class="docutils">
<colgroup>
<col width="28%" />
<col width="72%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Hex Range</th>
<th class="head">Actual Characters</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td><code class="docutils literal"><span class="pre">[0x21</span>&#160;&#160;&#160;&#160; <span class="pre">]</span></code></td>
<td><code class="docutils literal"><span class="pre">!</span></code></td>
</tr>
<tr class="row-odd"><td><code class="docutils literal"><span class="pre">[0x25-0x2B]</span></code></td>
<td><code class="docutils literal"><span class="pre">#$%&amp;'()*+</span></code></td>
</tr>
<tr class="row-even"><td><code class="docutils literal"><span class="pre">[0x2D-0x3A]</span></code></td>
<td><code class="docutils literal"><span class="pre">-./0123456789:</span></code></td>
</tr>
<tr class="row-odd"><td><code class="docutils literal"><span class="pre">[0x3C-0x5B]</span></code></td>
<td><code class="docutils literal"><span class="pre">&lt;=&gt;?&#64;ABCDEFGHIJKLMNOPQRSTUVWXYZ[</span></code></td>
</tr>
<tr class="row-even"><td><code class="docutils literal"><span class="pre">[0x5D-0x7E]</span></code></td>
<td><code class="docutils literal"><span class="pre">]^_`abcdefghijklmnopqrstuvwxyz{|}~</span></code></td>
</tr>
</tbody>
</table>
<p>RFC6265 suggests using base 64 to serialize data before storing data in a
cookie.</p>
<p>Cookies that meet the RFC6265 standard will no longer be quoted, as this is
unnecessary. This is a no-op as far as browsers and cookie storage is
concerned.</p>
</li>
<li><p class="first"><code class="docutils literal"><span class="pre">Response.set_cookie</span></code> now uses the internal <code class="docutils literal"><span class="pre">make_cookie</span></code> API, which will
issue warnings if cookies are set with invalid bytes. See
<a class="reference external" href="https://github.com/Pylons/webob/pull/172">https://github.com/Pylons/webob/pull/172</a></p>
</li>
</ul>
</div>
<div class="section" id="features">
<h2>Features<a class="headerlink" href="#features" title="Permalink to this headline"></a></h2>
<ul class="simple">
<li>Add support for some new caching headers, stale-while-revalidate and
stale-if-error that can be used by reverse proxies to cache stale responses
temporarily if the backend disappears. From RFC5861. See
<a class="reference external" href="https://github.com/Pylons/webob/pull/189">https://github.com/Pylons/webob/pull/189</a></li>
</ul>
</div>
<div class="section" id="bug-fixes">
<h2>Bug Fixes<a class="headerlink" href="#bug-fixes" title="Permalink to this headline"></a></h2>
<ul class="simple">
<li>Response.status now uses duck-typing for integers, and has also learned to
raise a ValueError if the status isn&#8217;t an integer followed by a space, and
then the reason. See <a class="reference external" href="https://github.com/Pylons/webob/pull/191">https://github.com/Pylons/webob/pull/191</a></li>
<li>Fixed a bug in <code class="docutils literal"><span class="pre">webob.multidict.GetDict</span></code> which resulted in the
QUERY_STRING not being updated when changes were made to query
params using <code class="docutils literal"><span class="pre">Request.GET.extend()</span></code>.</li>
<li>Read the body of a request if we think it might have a body. This fixes PATCH
to support bodies. See <a class="reference external" href="https://github.com/Pylons/webob/pull/184">https://github.com/Pylons/webob/pull/184</a></li>
<li>Response.from_file returns HTTP headers as latin1 rather than UTF-8, this
fixes the usage on Google AppEngine. See
<a class="reference external" href="https://github.com/Pylons/webob/issues/99">https://github.com/Pylons/webob/issues/99</a> and
<a class="reference external" href="https://github.com/Pylons/webob/pull/150">https://github.com/Pylons/webob/pull/150</a></li>
<li>Fix a bug in parsing the auth parameters that contained bad white space. This
makes the parsing fall in line with what&#8217;s required in RFC7235. See
<a class="reference external" href="https://github.com/Pylons/webob/issues/158">https://github.com/Pylons/webob/issues/158</a></li>
<li>Use &#8216;rn&#8217; line endings in <code class="docutils literal"><span class="pre">Response.__str__</span></code>. See:
<a class="reference external" href="https://github.com/Pylons/webob/pull/146">https://github.com/Pylons/webob/pull/146</a></li>
</ul>
</div>
<div class="section" id="documentation-changes">
<h2>Documentation Changes<a class="headerlink" href="#documentation-changes" title="Permalink to this headline"></a></h2>
<ul class="simple">
<li><code class="docutils literal"><span class="pre">response.set_cookie</span></code> now has proper documentation for <code class="docutils literal"><span class="pre">max_age</span></code> and
<code class="docutils literal"><span class="pre">expires</span></code>. The code has also been refactored to use <code class="docutils literal"><span class="pre">cookies.make_cookie</span></code>
instead of duplicating the code. This fixes
<a class="reference external" href="https://github.com/Pylons/webob/issues/166">https://github.com/Pylons/webob/issues/166</a> and
<a class="reference external" href="https://github.com/Pylons/webob/issues/171">https://github.com/Pylons/webob/issues/171</a></li>
<li>Documentation didn&#8217;t match the actual code for the wsgify function signature.
See <a class="reference external" href="https://github.com/Pylons/webob/pull/167">https://github.com/Pylons/webob/pull/167</a></li>
<li>Remove the WebDAV only from certain HTTP Exceptions, these exceptions may
also be used by REST services for example.</li>
</ul>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">What&#8217;s New in WebOb 1.5</a><ul>
<li><a class="reference internal" href="#backwards-incompatibilities">Backwards Incompatibilities</a></li>
<li><a class="reference internal" href="#features">Features</a></li>
<li><a class="reference internal" href="#bug-fixes">Bug Fixes</a></li>
<li><a class="reference internal" href="#documentation-changes">Documentation Changes</a></li>
</ul>
</li>
</ul>
<div class="relations">
<h3>Related Topics</h3>
<ul>
  <li><a href="index.html">Documentation overview</a><ul>
      <li>Previous: <a href="do-it-yourself.html" title="previous chapter">Another Do-It-Yourself Framework</a></li>
      <li>Next: <a href="whatsnew-1.6.html" title="next chapter">What&#8217;s New in WebOb 1.6</a></li>
  </ul></li>
</ul>
</div>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="_sources/whatsnew-1.5.txt"
            rel="nofollow">Show Source</a></li>
    </ul>
   </div>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <div><input type="text" name="q" /></div>
      <div><input type="submit" value="Go" /></div>
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="footer">
      &copy;2017, Ian Bicking and contributors.
      
      |
      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.9</a>
      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.8</a>
      
      |
      <a href="_sources/whatsnew-1.5.txt"
          rel="nofollow">Page source</a>
    </div>

    

    
  </body>
</html>