# HG changeset patch
# User J. H. Palmieri <palmieri@math.washington.edu>
# Date 1304448621 25200
# Node ID fe1695ce44d965db8a5bd645c4824a063933a6c8
# Parent e3adfff0a7a838976d5231de6cfe3b825da673fc
#11263: reword the changes to the developer's guide
also add an example of ".. linkall"
diff git a/doc/en/developer/conventions.rst b/doc/en/developer/conventions.rst
a

b

environments, use the ``.. link`` commen 
867  867  sage: 1 + a 
868  868  2 
869  869  
870   If you want to link all the verbatim environments together, you can put a 
871   ``.. linkall`` anywhere in the file. ``sage t`` will act as if there were a 
872   ``.. link`` before each verbatim environments. 
 870  If you want to link all the verbatim environments together, you can 
 871  put ``.. linkall`` anywhere in the file, on a line by itself. (For 
 872  clarity, it might be best to put it near the top of the file.) Then 
 873  ``sage t`` will act as if there were a ``.. link`` before each 
 874  verbatim environment. The file 
 875  ``SAGE_ROOT/devel/sage/doc/en/tutorial/interfaces.rst`` contains a 
 876  ``.. linkall`` directive, for example. 
873  877  
874  878  You can also put ``.. skip`` right before a verbatim environment to 
875   have that example skipped when testing the file. This goes right in 
 879  have that example skipped when testing the file. This goes in 
876  880  the same place as the ``.. link`` in the previous example. 
877  881  
878  882  See the files in ``SAGE_ROOT/devel/sage/doc/en/tutorial/`` for many 
diff git a/doc/en/tutorial/interfaces.rst b/doc/en/tutorial/interfaces.rst
a

b


 1  .. linkall 
 2  
1  3  ********** 
2  4  Interfaces 
3  5  ********** 
… 
… 
Every PARI object is of type ``py_pari.g 
104  106  underlying object can be obtained using the ``type`` member 
105  107  function. 
106  108  
107   .. link 
108   
109  109  :: 
110  110  
111  111  sage: v.type() 
… 
… 
In PARI, to create an elliptic curve we 
116  116  method that can be called on any PARI object, e.g., our 
117  117  ``t\_VEC v``. 
118  118  
119   .. link 
120   
121  119  :: 
122  120  
123  121  sage: e = v.ellinit() 
… 
… 
method that can be called on any PARI ob 
129  127  Now that we have an elliptic curve object, we can compute some 
130  128  things about it. 
131  129  
132   .. link 
133   
134  130  :: 
135  131  
136  132  sage: e.elltors() 
… 
… 
Singular (do not type the ``...``): 
216  212  
217  213  Now that we have defined :math:`f`, we print it and factor. 
218  214  
219   .. link 
220   
221  215  :: 
222  216  
223  217  sage: f 