Improve patch release support

[brodycj]

Platforms affected

All

What does this PR do?

Updates to improve support for patch releases:

• prepare-platform-release-branch add options:

  • [-b <platform branch name>]
  • [-js <cordova-js branch or tag name>]

• copy-js add option:

  • [-js <cordova-js branch or tag name>]

Enables the following:

• mark platform version in non-master patch branch, without extremely ugly workaround solution
• use exact cordova-js version at every point so that the developer can control exactly which version of cordova-js is used by copy-js and coho prepare-platform-release-branch, without extremely ugly workaround solution

Other changes included:

• fix usage messages
• prepare iOS CDVAvailability.h after updating JS in git (more sensical order)
• do not update iOS CDVAvailability.h if version number ends with non-numerical character, needed to avoid build error in case of marking -dev version
• workaround for local grunt issue in cordova-js from PR WORKAROUND SOLUTION for local grunt issue in cordova-js #174 (hope to look into a more "real" solution, someday, will probably comment more in WORKAROUND SOLUTION for local grunt issue in cordova-js #174)

What testing has been done on this change?

Tested on 4.5.x branch in my fork of cordova-ios, results in cb-4.5.x-coho-patch-update-test tree of my fork of cordova-ios:

• ./cordova-coho/coho prepare-platform-release-branch -r ios --version 4.5.5-dev -b 4.5.x --js 4.2.3 resulted in the following changes (without unwanted change to CDVAvailability.h):
  • Update JS snapshot without additional cordova.js changes (brodycj/cordova-ios@d475103)
  • set VERSION to 4.5.5-dev via coho (brodycj/cordova-ios@c961d77)
• ./cordova-coho/coho copy-js -r ios --js 4.2.4 copies the actual update to cordova.js (brodycj/cordova-ios@4e53cd2)
• ./cordova-coho/coho prepare-platform-release-branch -r ios --version 4.5.5 -b 4.5.x --js 4.2.4 results in the following changes for 4.5.5 release (no not a real release):
  • Update JS snapshot for version 4.5.5 from cordova-js@4.2.4 (brodycj/cordova-ios@df8d7f3)
  • Update CDVAvailability.h for 4.5.5 (brodycj/cordova-ios@e134907)
  • Set VERSION to 4.5.5 via coho (brodycj/cordova-ios@795e09e)

TODO items:

• feedback would be appreciated
• validate with a few real master and non-master patch releases
• look into a more "real" solution to the grunt issue (WORKAROUND SOLUTION for local grunt issue in cordova-js #174), will probably discuss in WORKAROUND SOLUTION for local grunt issue in cordova-js #174
• fix eslint issues instead of workaround in .eslintrc.yml
• resolve & cleanup eslint comments in the source
• apply patch release doc updates to tools-release-process.md

Checklist

• Reported an issue in the JIRA database
• Commit message follows the format: "CB-3232: (android) Fix bug with resolving file paths", where CB-xxxx is the JIRA ID & "android" is the platform affected.
• Added automated test coverage as appropriate for this change.

[brodycj]

Added --tag-only option to prepare-platform-release-branch command since I would rather push the changes myself. Also rebased the changes on master.

[janpio]

Is this PR ready to be reviewed? If not, please prefix the PR title with [WIP]. Thank you.

[janpio]

In general it would be beneficial if the different changes (new options, usage messages/docs, CDVAvailability.h, workarounds) were in clean, separate PRs.

[brodycj]

Closing in favor of changes in #188 which is in WIP state.