Skip to content
This repository has been archived by the owner on Mar 8, 2020. It is now read-only.

Javadoc fragment are not exposed as Comments #86

Closed
dpordomingo opened this issue Sep 18, 2018 · 0 comments
Closed

Javadoc fragment are not exposed as Comments #86

dpordomingo opened this issue Sep 18, 2018 · 0 comments

Comments

@dpordomingo
Copy link
Member

dpordomingo commented Sep 18, 2018

Parsing javadocs the comments are not parsed as in other languages, where docs are retrieved as a roleComment node with a token attribute containing the content of the comment itself

/** 
 * documentation for java class
 * multiline documentation here
 */
class HelloWorldApp {}

image

An alternative could be to parse docs in the same way in the other languages
Here is an example in php, where the documentation structure is different compared with java, but consistent with comments in all the languages.

<?php
    class Deposit {

        /**
         * the deposit ownner.
         *
         * @var string witout info
         */
        private $_owner;
    }

image

addendum:
This issue might be related to these similar ones in other languages drivers:
bblfsh/javascript-driver#36 bblfsh/go-driver#28 bblfsh/python-driver#167

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant