documenting deprecation syntax more clearly