capped_cylinder API is confusing

[hweom]

Documentation says:

f = capped_cylinder(-Z, Z, 0.5)

But what are the first and the second arguments? I assume Z is an axis designator? Why does it need to be passed twice with opposite signs?

[nobodyinperson]

It's the start and end point of the cylinder.

[hweom]

Yeah, I eventually figured Z should be a unit vector for Z axis, although it's not explained anywhere.

It would be nice if the APIs for 3D primitives are normalized. For example, rounded_cylinder takes two radii and a height...