summaryrefslogtreecommitdiffstats
path: root/vendor/quick-error-1.2.3/README.rst
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 12:02:58 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 12:02:58 +0000
commit698f8c2f01ea549d77d7dc3338a12e04c11057b9 (patch)
tree173a775858bd501c378080a10dca74132f05bc50 /vendor/quick-error-1.2.3/README.rst
parentInitial commit. (diff)
downloadrustc-698f8c2f01ea549d77d7dc3338a12e04c11057b9.tar.xz
rustc-698f8c2f01ea549d77d7dc3338a12e04c11057b9.zip
Adding upstream version 1.64.0+dfsg1.upstream/1.64.0+dfsg1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'vendor/quick-error-1.2.3/README.rst')
-rw-r--r--vendor/quick-error-1.2.3/README.rst66
1 files changed, 66 insertions, 0 deletions
diff --git a/vendor/quick-error-1.2.3/README.rst b/vendor/quick-error-1.2.3/README.rst
new file mode 100644
index 000000000..e54c055c4
--- /dev/null
+++ b/vendor/quick-error-1.2.3/README.rst
@@ -0,0 +1,66 @@
+===========
+Quick Error
+===========
+
+:Status: production-ready
+:Documentation: http://tailhook.github.io/quick-error/
+
+A macro which makes error types pleasant to write.
+
+Features:
+
+* Define enum type with arbitrary parameters
+* Concise notation of ``Display`` and ``Error`` traits
+* Full control of ``Display`` and ``Error`` trait implementation
+* Any number of ``From`` traits
+* Support for all enum-variants ``Unit``, ``Tuple`` and ``Struct``
+
+Here is the comprehensive example:
+
+.. code-block:: rust
+
+ quick_error! {
+ #[derive(Debug)]
+ pub enum IoWrapper {
+ Io(err: io::Error) {
+ from()
+ display("I/O error: {}", err)
+ cause(err)
+ }
+ Other(descr: &'static str) {
+ display("Error {}", descr)
+ }
+ IoAt { place: &'static str, err: io::Error } {
+ cause(err)
+ display(me) -> ("io error at {}: {}", place, err)
+ from(s: String) -> {
+ place: "some string",
+ err: io::Error::new(io::ErrorKind::Other, s)
+ }
+ }
+ Discard {
+ from(&'static str)
+ }
+ }
+ }
+
+=======
+License
+=======
+
+Licensed under either of
+
+ * Apache License, Version 2.0, (./LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
+ * MIT license (./LICENSE-MIT or http://opensource.org/licenses/MIT)
+
+at your option.
+
+------------
+Contribution
+------------
+
+Unless you explicitly state otherwise, any contribution intentionally
+submitted for inclusion in the work by you, as defined in the Apache-2.0
+license, shall be dual licensed as above, without any additional terms or
+conditions.
+