Add # optional

Author: Matthias Koeppe

src/sage/typeset/ascii_art.py

@@ -232,21 +232,21 @@ def ascii_art(*obj, **kwds):
     We can specify a separator object::
 
         sage: ident = lambda n: identity_matrix(ZZ, n)
-        sage: ascii_art(ident(1), ident(2), ident(3), sep=' : ')
+        sage: ascii_art(ident(1), ident(2), ident(3), sep=' : ')                        # optional - sage.modules
                       [1 0 0]
               [1 0]   [0 1 0]
         [1] : [0 1] : [0 0 1]
 
     We can specify the baseline::
 
-        sage: ascii_art(ident(2), baseline=-1) + ascii_art(ident(3))
+        sage: ascii_art(ident(2), baseline=-1) + ascii_art(ident(3))                    # optional - sage.modules
         [1 0][1 0 0]
         [0 1][0 1 0]
              [0 0 1]
 
     We can determine the baseline of the separator::
 
-        sage: ascii_art(ident(1), ident(2), ident(3), sep=' -- ', sep_baseline=-1)
+        sage: ascii_art(ident(1), ident(2), ident(3), sep=' -- ', sep_baseline=-1)      # optional - sage.modules
                         [1 0 0]
             -- [1 0] -- [0 1 0]
         [1]    [0 1]    [0 0 1]

src/sage/typeset/character_art.py

@@ -161,10 +161,10 @@ def __format__(self, fmt):
 
         EXAMPLES::
 
-            sage: M = matrix([[1,2],[3,4]])
-            sage: format(ascii_art(M))
+            sage: M = matrix([[1,2],[3,4]])                                             # optional - sage.matrix
+            sage: format(ascii_art(M))                                                  # optional - sage.matrix
             '[1 2]\n[3 4]'
-            sage: format(unicode_art(M))
+            sage: format(unicode_art(M))                                                # optional - sage.matrix
             '\u239b1 2\u239e\n\u239d3 4\u23a0'
         """
         return format(self._string_type(self), fmt)

src/sage/typeset/unicode_art.py

@@ -98,7 +98,7 @@ def unicode_art(*obj, **kwds):
             ⎮ x + π
             ⌡
         sage: ident = lambda n: identity_matrix(ZZ, n)
-        sage: unicode_art(ident(1), ident(2), ident(3), sep=' : ')
+        sage: unicode_art(ident(1), ident(2), ident(3), sep=' : ')                      # optional - sage.modules
                       ⎛1 0 0⎞
               ⎛1 0⎞   ⎜0 1 0⎟
         (1) : ⎝0 1⎠ : ⎝0 0 1⎠
@@ -107,7 +107,7 @@ def unicode_art(*obj, **kwds):
     an unicode art separator::
 
         sage: sep_line = unicode_art('\n'.join(' ⎟ ' for _ in range(5)), baseline=5)
-        sage: unicode_art(*AlternatingSignMatrices(3),                                  # optional - sage.combinat
+        sage: unicode_art(*AlternatingSignMatrices(3),                                  # optional - sage.combinat sage.modules
         ....:             separator=sep_line, sep_baseline=1)
                 ⎟         ⎟         ⎟            ⎟         ⎟         ⎟
         ⎛1 0 0⎞ ⎟ ⎛0 1 0⎞ ⎟ ⎛1 0 0⎞ ⎟ ⎛ 0  1  0⎞ ⎟ ⎛0 0 1⎞ ⎟ ⎛0 1 0⎞ ⎟ ⎛0 0 1⎞