Skip to content

Commit

Permalink
formatting
Browse files Browse the repository at this point in the history
  • Loading branch information
chrjabs committed Jan 11, 2024
1 parent 9bb2daa commit a9c2bb2
Show file tree
Hide file tree
Showing 6 changed files with 39 additions and 39 deletions.
14 changes: 7 additions & 7 deletions cadical/src/lib.rs
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
//! # rustsat-cadical - Interface to the CaDiCaL SAT Solver for RustSAT
//!
//!
//! Armin Biere's SAT solver [CaDiCaL](https://github.com/arminbiere/cadical) to be used with the [RustSAT](https://github.com/chrjabs/rustsat) library.
//!
//!
//! **Note**: at the moment this crate is known to not work on Windows since CaDiCaL is non-trivial to get to work on Windows.
//!
//!
//! ## Features
//!
//!
//! - `debug`: if this feature is enables, the C++ library will be built with debug and check functionality if the Rust project is built in debug mode
//! - `safe`: disable writing through 'popen' for more safe usage of the library in applications
//! - `quiet`: exclude message and profiling code (logging too)
//! - `logging`: include logging code (but disabled by default)
//!
//!
//! ## CaDiCaL Versions
//!
//!
//! CaDiCaL versions can be selected via cargo crate features.
//! All CaDiCaL versions up to [Version 1.9.4](https://github.com/arminbiere/cadical/releases/tag/rel-1.9.4) are available.
//! For the full list of versions and the changelog see [the CaDiCaL releases](https://github.com/arminbiere/cadical/releases).
//!
//!
//! Without any features selected, the newest version will be used.
//! If conflicting CaDiCaL versions are requested, the newest requested version will be selected.

Expand Down
10 changes: 5 additions & 5 deletions glucose/src/lib.rs
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
//! # rustsat-glucose - Interface to the Glucose SAT Solver for RustSAT
//!
//!
//! The Glucose SAT solver to be used with the [RustSAT](https://github.com/chrjabs/rustsat) library.
//!
//!
//! ## Features
//!
//!
//! - `debug`: if this feature is enables, the C++ library will be built with debug and check functionality if the Rust project is built in debug mode
//!
//!
//! ## Glucose Version
//!
//!
//! The version of Glucose in this crate is Version 4.2.1.
//! The used C++ source repository can be found [here](https://github.com/chrjabs/glucose4).

Expand Down
14 changes: 7 additions & 7 deletions kissat/src/lib.rs
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
//! # rustsat-kissat - Interface to the kissat SAT Solver for RustSAT
//!
//!
//! Armin Biere's SAT solver [Kissat](https://github.com/arminbiere/kissat) to be used with the [RustSAT](https://github.com/chrjabs/rustsat) library.
//!
//!
//! **Note**: at the moment this crate is known to not work on Windows since Kissat is non-trivial to get to work on Windows.
//!
//!
//! ## Features
//!
//!
//! - `debug`: if this feature is enables, the C library will be built with debug functionality if the Rust project is built in debug mode
//! - `safe`: disable writing through 'popen' for more safe usage of the library in applications
//! - `quiet`: exclude message and profiling code (logging too)
//!
//!
//! ## Kissat Versions
//!
//!
//! Kissat versions can be selected via cargo crate features.
//! The following Kissat versions are available:
//! - `v3-1-0`: [Version 3.1.0](https://github.com/arminbiere/kissat/releases/tag/rel-3.1.0)
//! - `v3-0-0`: [Version 3.0.0](https://github.com/arminbiere/kissat/releases/tag/rel-3.0.0)
//! - `sc2022-light`: [SAT Competition 2022 Light](https://github.com/arminbiere/kissat/releases/tag/sc2022-light)
//! - `sc2022-hyper`: [SAT Competition 2022 Hyper](https://github.com/arminbiere/kissat/releases/tag/sc2022-hyper)
//! - `sc2022-bulky`: [SAT Competition 2022 Bulky](https://github.com/arminbiere/kissat/releases/tag/sc2022-bulky)
//!
//!
//! Without any features selected, the newest version will be used.
//! If conflicting Kissat versions are requested, the newest requested version will be selected.

Expand Down
10 changes: 5 additions & 5 deletions minisat/src/lib.rs
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
//! # rustsat-minisat - Interface to the Minisat SAT Solver for RustSAT
//!
//!
//! The Minisat SAT solver to be used with the [RustSAT](https://github.com/chrjabs/rustsat) library.
//!
//!
//! ## Features
//!
//!
//! - `debug`: if this feature is enables, the C++ library will be built with debug and check functionality if the Rust project is built in debug mode
//!
//!
//! ## Minisat Version
//!
//!
//! The version of minisat in this crate is Version 2.2.0.
//! The used C++ source repository can be found [here](https://github.com/chrjabs/minisat).

Expand Down
28 changes: 14 additions & 14 deletions rustsat/src/lib.rs
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
//! # rustsat - A Comprehensive SAT Library for Rust
//!
//!
//! `rustsat` is a collection of interfaces and utilities for working with the boolean satisfiability problem in Rust.
//! This library aims to provide implementations of elements commonly used in the development of software in the area of satisfiability solving.
//! The focus of the library is to provide as much ease of use without giving up on performance.
//!
//!
//! ## Example
//!
//!
//! ```
//! # use rustsat::{instances::SatInstance, solvers::{Solve, SolverResult}, types::TernaryVal};
//! let mut instance: SatInstance = SatInstance::new();
Expand All @@ -22,28 +22,28 @@
//! assert_eq!(sol[l1.var()], TernaryVal::True);
//! assert_eq!(sol[l2.var()], TernaryVal::True);
//! ```
//!
//!
//! ## Crates
//!
//!
//! The RustSAT project is split up into multiple crates that are all contained in [this repository](https://github.com/chrjabs/rustsat/).
//! These are the crates the project consists of:
//!
//!
//! | Crate | Description |
//! | --- | --- |
//! | `rustsat` | The main library, containing basic types, traits, encodings, parsers, and more. |
//! | `rustsat-tools` | A collection of small helpful tools based on RustSAT that can be installed as binaries. For a list of available tools, see [this directory](https://github.com/chrjabs/rustsat/tree/main/tools/src/bin) with short descriptions of the tools in the headers of the files. |
//! | `rustsat-<satsolver>` | Interfaces to SAT solvers that can be used alongside `rustsat`. Currently interfaces are available for `cadical`, `kissat`, `glucose`, and `minisat`. |
//!
//!
//! ## Installation
//!
//!
//! To use the RustSAT library as a dependency in your project, simply run `cargo add rustsat`.
//! To use an SAT solver interface in your project, run `cargo add rustsat-<satsolver>`.
//! Typically, the version of the SAT solver can be selected via crate features, refer to the documentation of the respective SAT solver crate for details.
//!
//!
//! To install the binary tools in `rustsat-tools` run `cargo install rustsat-tools`.
//!
//!
//! ## Features
//!
//!
//! | Feature name | Description |
//! | --- | --- |
//! | `internals` | Make some internal data structures for e.g. encodings public. This is useful when basing a more complex encoding on the `rustsat` implementation of another encoding. Note that the internal API might change between releases. |
Expand All @@ -54,14 +54,14 @@
//! | `compression` | Enable parsing and writing compressed input. |
//! | `bench` | Enable benchmark tests. Behind feature flag since it requires unstable Rust. |
//! | `rand` | Enable randomization features. (Shuffling clauses etc.) |
//!
//!
//! ## Examples
//!
//!
//! For example usage refer to the small example tools in the [`rustsat-tools`
//! crate](https://crates.io/crates/rustsat_tools) at `tools/src/bin`. For a bigger
//! example you can look at this [multi-objective optimization
//! solver](https://github.com/chrjabs/scuttle).
//!
//!
//! For an example of how to use the C-API, see `rustsat/examples/capi*.cpp`.
//! Similarly, for an example of using the Python API, see `rustsat/examples/pyapi*.py`.

Expand Down
2 changes: 1 addition & 1 deletion tools/src/lib.rs
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//! # rustsat-tools - Tools for and with the RustSAT Library
//!
//!
//! This crate contains tools for and built on the RustSAT library.

pub mod utils;
Expand Down

0 comments on commit a9c2bb2

Please sign in to comment.