mirror of
https://github.com/appium/appium.git
synced 2026-10-29 04:36:39 +08:00
If a command is not documented with a `@returns` tag, but a builtin method _does_ have this tag (e.g., `ExternalDriver.createSession()`), then the plugin will use the tag from the builtin. If a command _does_ have a `@returns` tag, but it provides no description, then the plugin will use the original `@returns` tag (which may have a type) and combine it with the content/description from the builtin (if any). This requires further inspection of `SignatureReflection` data, which needed a new set of "comment finders", which prompted me to refactor the comment finders into their own files (because it was becoming unwieldy). The call to `deriveComment` happens in the static `BaseCommandData.rewriteSignature()` method (whereas before it was just a straightforward clone operation). - Fixed the block tag aggregation to prefer contentful over contentless tags in all cases. - Modified the `@returns` tag of `FakeDriver.createSession()` for testing - Moved some types around that were used outside of their sibling modules (e.g. `CommentSource` which used to be called `CommentSourceType`) - pruned dead imports