taxonomy_vocabulary_save doc needs more detail

Thanks for reporting! We fix in 8.x then port back to 7.x

You've reported about a dozen issues today. Would you consider making patches for some of them? Thanks.

Also, if you could consider when you make an issue report:
- Change the version to 8.x, rather than changing it to a specific 7.x version as you did on all the issues you filed.
- Change the title to something meaningful.
Both of these would save me having to do them for you. Thanks!

I followed the term summary linked in the issue summary as a guide. I'm unsure about the following: module (when would it ever be anything but taxonomy), weight (why are vocabularies weighted?), return.

I should have re-read that patch one more time.

Looks pretty good, a few changes:

a) First line: Save -> Saves.

b) This line needs to end in :
+ * A vocabulary object with the following properties.

c) This line might be clearer if it said the "human-readable" name:
+ * - name: The name of the vocabulary.

d)
+ * - weight: The weight of the vocabulary in relation to other vocabularies
+ * within the same taxonomy.

I think "within the same taxonomy" should be omitted.

e) Looking at the code in the function, there are a couple of other components, such as ->original, which aren't mentioned. You might scan and see what else is there, and make sure they're all documented.

This looks great! The only thing that should be fixed is line wrapping. One of these two lines must be wrong (either the first line is > 80 or the 2nd needs to have a word or two moved up from the 3rd):

+ *   - weight: The weight of this vocabulary in relation to other vocabularies.
+ *   - original: The original vocabulary object before any changes
+ *     are applied.

Also, did you check the code and make sure 'original' was the only other component missing?

Yes, I missed old_machine_name too.

Looks good to me, thanks! D8/7.

Committed and pushed to 8.x and 7.x. Thanks!