Document function initialization parameters

[rwst]

The classes in symbolic/function.pyx need better docs, esp. the parameters.

Component: documentation

Author: Ralf Stephan

Branch/Commit: 469d0e2

Reviewer: Markus Wageringel, Dima Pasechnik

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

[rwst]

Description changed:

--- 
+++ 
@@ -1 +1 @@
-The classes in `symbolic/function.pyx` need better docs, esp. the parameters. Make sure it is referenced in what the user gets with `function??`.
+The classes in `symbolic/function.pyx` need better docs, esp. the parameters. Make sure it is referenced in what the user gets with `function??`. The problem is this comes from `calculus/var/function()` and is very incomplete, leading to much confusion.

[rwst]

Branch: u/rws/document_function_initialization_parameters

[rwst]

Description changed:

--- 
+++ 
@@ -1 +1 @@
-The classes in `symbolic/function.pyx` need better docs, esp. the parameters. Make sure it is referenced in what the user gets with `function??`. The problem is this comes from `calculus/var/function()` and is very incomplete, leading to much confusion.
+The classes in `symbolic/function.pyx` need better docs, esp. the parameters. 

[rwst]

New commits:

d8ae5e2

24398: Document function initialization parameters

[rwst]

Author: Ralf Stephan

[rwst]

Commit: d8ae5e2

[sagetrac-git]

Changed commit from d8ae5e2 to 3cd27de

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

3cd27de

24398: remove include of other documents

[bryangingechen]

comment:6

This documentation is really helpful!

Suggestions:

• In src/doc/en/reference/functions/index.rst, add a link to src/sage/symbolic/function.pyx
• Presumably you meant to remove the fragment at the end of this line

+ * :class:`BuiltinFunction`: the code of these functions is written in Python; many special functions are of this type, see :doc

This may be out-of-scope for this ticket but it's so trivial that I must point it out:

• There is a formatting error in the docstring for sage.symbolic.function.get_sfunction_from_serial, there should be double backticks around sage.symbolic.function.sfunction_serial_dict