#16715: Remove "nonbreaking spaces" from .rst files
-----------------------------+----------------------------
   Reporter:  strogdon       |            Owner:
       Type:  defect         |           Status:  new
   Priority:  major          |        Milestone:  sage-6.3
  Component:  PLEASE CHANGE  |         Keywords:
  Merged in:                 |          Authors:
  Reviewers:                 |  Report Upstream:  N/A
Work issues:                 |           Branch:
     Commit:                 |     Dependencies:
   Stopgaps:                 |
-----------------------------+----------------------------
 For reference see sage-devel comment:

 https://groups.google.com/forum/#!topic/sage-devel/W-fPceNbp0w

 Certain .rst files (src/doc/fr/tour_coercion.rst in particular) contain
 nonbreaking spaces that can cause docutils to fail when generating html
 docs. Failures are known to be present with docutils-0.11. An octal dump
 (od -c) of tour_coercion.rst reveals the spaces:
 {{{
 0013340   n   n   e   a   u   ,       e   l   l   e   s       n   e
 0013360   s   o   n   t       p   a   s       d   e       t   y   p   e
 0013400       `   `   R   i   n   g   E   l   e   m   e   n   t   `   `
 0013420 302 240   :  \n  \n   :   :  \n  \n                   s   a   g
 0013440   e   :       M       =       M   a   t   r   i   x   (   Z   Z
 0013460   ,   2   ,   2   )   ;       M  \n                   [   0
 0013500   0   ]  \n                   [   0       0   ]  \n
 0013520       s   a   g   e   :       i   s   i   n   s   t   a   n   c
 }}}

 The 302 is octal for a "circumflex capital A" and the 240 is octal for a
 "nonbreaking space" and it is these characters that cause docutils-0.11 to
 fail. With docutils-0.11 the failure presents as
 {{{
 $ rst2html.py src/doc/fr/tutorial/tour_coercion.rst > /dev/null
 src/doc/fr/tutorial/tour_coercion.rst:149: (WARNING/2) Inline literal
 start-string without end-string.
 }}}
 From a unicode compliant terminal line 149 starts as
 {{{
 Le type ``RingElement`` ne correspond pas parfaitement à la notion
 mathématique d'élément d'anneau. Par exemple, bien que les matrices
 carrées
 appartiennent à un anneau, elles ne sont pas de type ``RingElement`` :
 }}}
 where the nonbreaking space appears between the {{{``}}} and {{{:}}}.

--
Ticket URL: <http://trac.sagemath.org/ticket/16715>
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 http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.

Reply via email to