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

document pg_guard to the best of my abilities #1729

Merged
merged 10 commits into from
Jun 3, 2024

Conversation

eeeebbbbrrrr
Copy link
Contributor

Closes #1406

docs/src/ffi-error-handling.md Outdated Show resolved Hide resolved
Comment on lines +13 to +14
Code execution then finds its way to `errfinish()` where, finally, `siglongjmp()` is called to instantly move the stack
back to the frame where Postgres began the current transaction (where it previously created a `sigsetjmp()` point).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm. This should probably clarify that it moves the state to that exact point-in-time of the sigsetjmp, "right after" it was called.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I understand what you mean, but I'm not quite sure of the words you'd want to explain it. I'll let you add this point. ;)

docs/src/ffi-error-handling.md Outdated Show resolved Hide resolved
docs/src/ffi-error-handling.md Outdated Show resolved Hide resolved
docs/src/ffi-error-handling.md Outdated Show resolved Hide resolved
docs/src/ffi-error-handling.md Outdated Show resolved Hide resolved
docs/src/ffi-error-handling.md Outdated Show resolved Hide resolved
docs/src/ffi-error-handling.md Outdated Show resolved Hide resolved
docs/src/ffi-error-handling.md Outdated Show resolved Hide resolved
docs/src/ffi-error-handling.md Show resolved Hide resolved
@eeeebbbbrrrr
Copy link
Contributor Author

@workingjubilee I think this is good enough.

I left #1729 (comment) for you. As I said, I'm not quite sure how you'd want that to be explained.

Copy link
Member

@workingjubilee workingjubilee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cool. Thanks! I'll take a look at poking the last thing I mentioned later.

@workingjubilee workingjubilee merged commit d8288d9 into pgcentralfoundation:develop Jun 3, 2024
12 checks passed
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.

Give directions on correct usage of pg_guard and similar
2 participants