Documentation in Julia reference for "surface" not complete

The description of how surface work is incomplete:

Especially what type z should be is unclear.