feat(java): add @return.inner & @return.outer text objects

[gbroques]

The query handles methods with a typical return as you'd expect.

class Example {
  private String example() {
    return "example";
  }
}

I made the wildcard child node optional (_)? in the query so @return.outer matches void returns:

class Example {
  private void example() {
    return;
  }
}

[gbroques]

I think the same commit can be applied to the main branch.

I'm happy to submit another PR for that, or leave that to the maintainers. (@kiyoon @clason)

[kiyoon]

Is this a feature or a fix?

[kiyoon]

Please do not modify the Readme yourself. It's automatic.

[gbroques]

@kiyoon Thank you for your prompt response, and comments.

Is this a feature or a fix?

I consider it a feature since it's adding functionality that wasn't there.

@return.* text objects aren't documented as supported by Java in the README, so I wouldn't consider adding support a "fix".

I'm happy to change my commit to a "fix" if you think it's more appropriate though.

Please do not modify the Readme yourself. It's automatic.

Thanks! I didn't realize that. I amended my commit to remove the README change.

[kiyoon]

Ok, I thought you made some node optional but it was a confusion on my end. That's a feature indeed.

[gbroques]

Ok, I thought you made some node optional but it was a confusion on my end. That's a feature indeed.

@kiyoon Awesome, well let me know if there's anything else I can do.

It looks like certain checks are failing for reasons not introduced by this change.

I update the original PR description so it's hopefully more clear to anyone in the future.

Thanks again!