-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 16.10.2010 21:41, schrieb Vinay Sajip:
> Is there an easy way to have these styled differently, so it's more
> obvious what the keyword parameters are? Especially when the method
> signature uses **kwargs.
> 
> Is there a particular reason why the distinction is there? Is the fact
> that param, parameter, arg, argument, key, keyword are all offered
> just to accommodate the preferences of different users?

Yes, and different names used by different documentation tools.

> If would be neater if instead of <strong>param_name</strong>, the
> output markup was something like
> 
> <span class="positional-param">param_name</span>
> 
> and
> 
> <span class="keyword-param">param_name</span>

They would still all be in one list, so how would you style them
differently (without confusing the user)?

Georg
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.16 (GNU/Linux)

iEYEARECAAYFAk0o7SMACgkQN9GcIYhpnLDLBwCeJtekepWCk9AAsRl0ORo2gJDq
PkkAnjCjYIWpPHNxctkpbeUNmlcUBWEp
=9wHv
-----END PGP SIGNATURE-----

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-...@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to