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

Add support for ignoring/deleting generated links #41

Merged
merged 3 commits into from
May 11, 2023
Merged

Conversation

gagbo
Copy link
Member

@gagbo gagbo commented May 9, 2023

The generator takes an extra argument, through command-line or
environment variable, that allows to opt-out of documentation
generation. There is also the possibility to opt-in this deactivation on
a per-function basis, using the --no-doc argument on the directive.

This also changes the name of the directive, from autometrics:doc to
autometrics:inst, as now the directive doesn't always add
documentation to the functions it instruments. For backwards
compatibility, the doc attribute is still accepted, and will be
removed in a later version.

Closes #38

The generator takes an extra argument, through command-line or
environment variable, that allows to opt-out of documentation
generation. There is also the possibility to opt-in this deactivation on
a per-function basis, using the `--no-doc` argument on the directive.

This also changes the name of the directive, from `autometrics:doc` to
`autometrics:inst`, as now the directive doesn't always add
documentation to the functions it instruments. For backwards
compatibility, the `doc` attribute is still accepted, and will be
removed in a later version.

Closes #38
@gagbo
Copy link
Member Author

gagbo commented May 9, 2023

For the time being, the flag is --no-doc and the environment variable is AM_NO_DOCGEN (I used the AM_ prefix for the configuration of the prometheus URL already)

@arendjr @emschwartz Are there implementations that already use different names for those? That's probably a good time to change those names, in the Go implementation at least, to be uniform if that's important

Also, this PR probably needs to be merged after #40, and at that point I'll also add the changelog modifications to the PR here

@gagbo gagbo merged commit d9c5dc4 into main May 11, 2023
@gagbo gagbo deleted the no_doc_argument branch May 11, 2023 13:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Support --no-docs-gen argument
2 participants