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

Clean up documentation of the SAT API #1020

Merged
merged 2 commits into from
Jan 3, 2024

Conversation

Halbaroth
Copy link
Collaborator

@Halbaroth Halbaroth commented Jan 3, 2024

The documentation of the SAT API was a bit outdated and don't use some tags of odoc.

I also merge empty and empty_with_inst into a single function. Currently, the second function is only used by the JS worker.
The argument of this constructor is supposed to filter ground facts generated by the instantiation engine but the JS worker uses it only to register all these facts.

Copy link
Collaborator

@bclement-ocp bclement-ocp left a comment

Choose a reason for hiding this comment

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

The doc for unsat seems outdated (but now with odoc markers), otherwise looks good 👍

val optimize : t -> is_max:bool -> Expr.t -> unit
(** [optimize env ~is_max o] registers the expression [o] as an objective
function.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Should briefly mention the meaning of is_max (maximize vs minimize).

val unsat : t -> Expr.gformula -> Explanation.t
(** [unsat env f size] checks the unsatisfiability of [f] in [env].
Copy link
Collaborator

Choose a reason for hiding this comment

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

There is no size argument? unsat has only two arguments; this seems outdated.

@Halbaroth Halbaroth enabled auto-merge (squash) January 3, 2024 11:22
@Halbaroth Halbaroth merged commit 1e5754f into OCamlPro:next Jan 3, 2024
13 checks passed
@bclement-ocp bclement-ocp added this to the 2.6.0 milestone Jul 11, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants