It seems this parameter name comes from the internal parameter being set, e.g. leg.get_frame().set_alpha(0.5), but it seems like it would make much more sense from an API perspective if one could simply use the argument alpha, i.e.

plt.legend(alpha=0.5) instead of plt.legend(framealpha=0.5).