improve introspection of Macaulay2 interface

[mwageringel]

This ticket improves the introspection for the Macaulay2 interface:

• help is now called with a Macaulay2 string instead of a symbol, as this works in more generality, for example for global variables:

sage: macaulay2.errorDepth?

• The class Macaulay2FunctionElement of functions with applied first argument is implemented. This allows to make the help and source code more specific by taking into account the first argument. For example the following only shows the relevant output for Ideal, but not for Matrix or Module.

sage: I = macaulay2('ideal 4')
sage: I.resolution?
sage: I.resolution??

The __getattr__ of Macaulay2 is removed as it is not needed anymore since _function_class is implemented.

• The _sage_src_ of Macaulay2Function is simplified. This also fixes an issue where all the lines are shown with a special end character ^M when inspecting Macaulay2 source code as in:

sage: macaulay2.matrix??
code(methods matrix)^M
^M
o1000000008 = -- code for method: matrix(List)^M
...

• The nodetex and noreplace directives for Sage documentation are added to avoid reformatting of the Macaulay2 documentation. Previously one would get

sage: macaulay2.matrix?
...
+------------------------------+
| i1 : matrix{{1,2,3},{4,5,6}} |
| o1 = | 1 2 3 | 4 5 6 |  2    |
| 3  o1 : Matrix ZZ  <--- ZZ   |
+------------------------------+
...

instead of

+----------------------------+
|i1 : matrix{{1,2,3},{4,5,6}}|
|                            |
|o1 = | 1 2 3 |              |
|     | 4 5 6 |              |
|                            |
|              2        3    |
|o1 : Matrix ZZ  <--- ZZ     |
+----------------------------+

CC: @saliola @dimpase @antonleykin

Component: interfaces: optional

Keywords: macaulay2, IMA Coding Sprint

Author: Markus Wageringel

Branch/Commit: 4ae76ef

Reviewer: Franco Saliola

Issue created by migration from https://trac.sagemath.org/ticket/28565

[mwageringel]

New commits:

dc7922f

28565: improve macaulay2 introspection

[mwageringel]

Commit: dc7922f

[mwageringel]

Branch: u/gh-mwageringel/28565

[mwageringel]

Author: Markus Wageringel

[mwageringel]

Changed keywords from macaulay2 to macaulay2, IMA Coding Sprint

[saliola]

Changed branch from u/gh-mwageringel/28565 to public/interfaces/m2/28565

[saliola]

Changed commit from dc7922f to 4ae76ef

[saliola]

New commits:

4ae76ef

Merge branch 'develop' into u/gh-mwageringel/28565

[saliola]

Reviewer: Franco Saliola

[vbraun]

Changed branch from public/interfaces/m2/28565 to 4ae76ef