{"action":"created","issue":{"url":"https://api.github.com/repos/cmacmackin/ford/issues/233","repository_url":"https://api.github.com/repos/cmacmackin/ford","labels_url":"https://api.github.com/repos/cmacmackin/ford/issues/233/labels{/name}","comments_url":"https://api.github.com/repos/cmacmackin/ford/issues/233/comments","events_url":"https://api.github.com/repos/cmacmackin/ford/issues/233/events","html_url":"https://github.com/cmacmackin/ford/issues/233","id":309764970,"number":233,"title":"Comments in an interface defining a constructor are ignored","user":{"login":"leonfoks","id":15173535,"avatar_url":"https://avatars0.githubusercontent.com/u/15173535?v=4","gravatar_id":"","url":"https://api.github.com/users/leonfoks","html_url":"https://github.com/leonfoks","followers_url":"https://api.github.com/users/leonfoks/followers","following_url":"https://api.github.com/users/leonfoks/following{/other_user}","gists_url":"https://api.github.com/users/leonfoks/gists{/gist_id}","starred_url":"https://api.github.com/users/leonfoks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/leonfoks/subscriptions","organizations_url":"https://api.github.com/users/leonfoks/orgs","repos_url":"https://api.github.com/users/leonfoks/repos","events_url":"https://api.github.com/users/leonfoks/events{/privacy}","received_events_url":"https://api.github.com/users/leonfoks/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":3,"created_at":"2018-03-29T13:56:58Z","updated_at":"2018-04-02T13:31:32Z","closed_at":null,"author_association":"NONE","body":"Pretty minor issue here, but for completeness thought I should bring it up.\r\n\r\nWhen I document an interface for a type constructor, the comments in the interface are ignored. If the implementation(s) within the interface are private they now show up thanks to your fix of #215.\r\n\r\nMy style is to put \"overloaded by interface aType()\" as the comment in the private implementation, so would like to document the interface instead. I usually have multiple ways to construct a type, so if I can write the docs for that constructor once that would be great (rather than repeat the information in each private implementation).\r\n\r\nSee below for minimal example.\r\n\r\nThank you!\r\n\r\n```fortran\r\nmodule test\r\nimplicit none\r\n\r\nprivate\r\n\r\npublic :: aType\r\n\r\ntype aType\r\n  !! description of aType\r\n  real :: a\r\n    !! real number\r\n  int :: b\r\n    !! integer number\r\nend type\r\n\r\ninterface aType\r\n  !! I want this text to appear in the constructor information, \r\n  !! before the private implementations are shown.\r\n  !! Right now I think it is ignored?\r\n  procedure :: init_aType_r1i1\r\nend interface\r\n\r\ncontains\r\n\r\nsubroutine init_aType_r1i1(this, a, b)\r\n  !! Overloaded by interface aType()\r\n  !! This shows up as a private function now thanks to #215. (Thanks for that fix)\r\n  class(aType) :: this\r\n  real :: a\r\n    !! real number\r\n  integer :: b\r\n    !! integer number \r\nend subroutine\r\n\r\nend module\r\n```"},"comment":{"url":"https://api.github.com/repos/cmacmackin/ford/issues/comments/377929604","html_url":"https://github.com/cmacmackin/ford/issues/233#issuecomment-377929604","issue_url":"https://api.github.com/repos/cmacmackin/ford/issues/233","id":377929604,"user":{"login":"zbeekman","id":279612,"avatar_url":"https://avatars3.githubusercontent.com/u/279612?v=4","gravatar_id":"","url":"https://api.github.com/users/zbeekman","html_url":"https://github.com/zbeekman","followers_url":"https://api.github.com/users/zbeekman/followers","following_url":"https://api.github.com/users/zbeekman/following{/other_user}","gists_url":"https://api.github.com/users/zbeekman/gists{/gist_id}","starred_url":"https://api.github.com/users/zbeekman/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zbeekman/subscriptions","organizations_url":"https://api.github.com/users/zbeekman/orgs","repos_url":"https://api.github.com/users/zbeekman/repos","events_url":"https://api.github.com/users/zbeekman/events{/privacy}","received_events_url":"https://api.github.com/users/zbeekman/received_events","type":"User","site_admin":false},"created_at":"2018-04-02T13:31:32Z","updated_at":"2018-04-02T13:31:32Z","author_association":"CONTRIBUTOR","body":"I'd also love to know the best/easiest way to use/install the development version. I always install via PIP/homebrew and my attempts in the past to get the latest development version were unsuccessful, but, TBH, I haven't tried in a while and I probably know at least a little bit more about what I'm doing regarding Python packages"}}
{"actor":{"display_login":"zbeekman"}}