Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Top level documentation mentions function cobfl_c() but hyperlink is not working #479

Open
edwardhartnett opened this issue May 3, 2023 · 3 comments
Labels
documentation Improvements or additions to documentation

Comments

@edwardhartnett
Copy link
Contributor

image

@edwardhartnett edwardhartnett added the documentation Improvements or additions to documentation label May 3, 2023
@edwardhartnett
Copy link
Contributor Author

Well I cannot see why this is not working. I'll take another look and see what I can figure out...

@jbathegit
Copy link
Collaborator

Well I cannot see why this is not working. I'll take another look and see what I can figure out...

Maybe because it (and crbmg_c, cwbmg_c, and ccbfl_c too) are all interfaces defined inside of a module in bufr_interface.F90, and each of them in turn binds to a C function of the same name (minus the _c)?

In other words, cobfl_c is an interface which binds to the C function cobfl, crbmg_c is an interface which binds to the C function crbmg, etc.

I agree though, I'm not sure why Doxygen is apparently confused by this.

@jbathegit
Copy link
Collaborator

It definitely seems like this has something to do with the fact that these are all defined as interfaces rather than as actual functions, but I still can't figure out what exactly is missing here.

Over the past couple of days I've tried playing around with variations of the Doxygen fn directives in bufr_interface.F90 (see #618 and #619), but I still haven't had any luck in getting any of them to pass the developer CI test. And if we can't pass the developer CI test, then we have no new Doxygen artifact to look at to see if it now contains these hyperlinks.

So we're still a bit stuck here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
2 participants