gh-140505: Correct "parameters" to "arguments" in MultiCall doc

[7576457]

• issue: argument vs parameter confusion in XMLRPC client documentation #140505

📚 Documentation preview 📚: https://cpython-previews--140512.org.readthedocs.build/en/140512/library/xmlrpc.client.html#multicall-objects

[python-cla-bot]

All commit authors signed the Contributor License Agreement.

[serhiy-storchaka]

I think this should be changed in more places.

[7576457]

I think this should be changed in more places.

Yes, you’re right -- I found one more place where the term should be updated. Everything else seems fine

[serhiy-storchaka]

I think there are more:

This method takes one parameter,

Signatures themselves are restricted to the top level parameters expected by a
method. For instance if a method expects one array of structs as a parameter,

And most likely:

a client can call methods with parameters

Method has parameters, but it expects and takes arguments.

[7576457]

I think there are more:

This method takes one parameter,

Signatures themselves are restricted to the top level parameters expected by a
method. For instance if a method expects one array of structs as a parameter,

And most likely:

a client can call methods with parameters

Method has parameters, but it expects and takes arguments.

done. thank you

[serhiy-storchaka]

Suggested change

	method. For instance if a method expects one array of structs as a argument,
	method. For instance if a method expects one array of structs as an argument,

[serhiy-storchaka]

I would write something like "Note that a signature does not give details of a complex type; it just gives the basic XML-RPC type -- array or structure." (see https://xmlrpc-c.sourceforge.io/introspection.html).

This is applied not only to the types of parameters, but to the return type too.

[serhiy-storchaka]

Since this is applied to the return type too, I suggest to use this in the example.

Suggested change

	three integers and returns a string, its signature is "string, int, int, int".
	three integers and returns an array of strings, its signature is "array, int, int, int".

[7576457]

I’ve made the changes you suggested. The section now makes it clear that a signature only shows the top-level XML-RPC type (array or structure) for arguments and return values. Added a couple of examples to make it easier to understand

[hugovk]

In June, the editorial board recommended not to make similar changes:

#135160 (comment)