added a comment explaining the behaviour when cookbook_name is nil

This comment together with the somewhat unstraightforward behaviour
should go away once every cookbook is using the new API and we can
remove the cookbook_name=nil default.