box_add_description() should be box_file_update()

[ijlyttle]

The Box API offers a lot of things with their file-update endpoint - I think this function could be expanded and renamed.

To be clear, I am not suggesting we do this on this (Aug. 2020) release, but perhaps soon thereafter.

[ijlyttle]

We have a lot of open issues that seem to hit the same API endpoint: File Update:

• this one, concerning the description
• Lock Files #182 to lock files
• Feature request: Add boxr::box_copy() to the list of existing boxr functions #167 to copy files

We already have an internal function box_file_update() - used by box_ul()

We also have an incidental issue, #174 on file metadata, potentially related, as it concerns the Box API file object.

Not considering immediate action other than possibly closing #182 and #167, combining them into this issue.

[nathancday]

I've personally never used the boxr_add_description() once I found out it wasn't a comment, non-API users could see. It does feel like we are missing some functionality and agree about expanding to support the lock/copy/link/move behaviors.

[ijlyttle]

closing in favor of #208