Skip to content

Docs migrated to initial version#13

Merged
sunxiaoguang merged 3 commits intosun/raw_kv_initial_versionfrom
docs-rebase
Dec 31, 2018
Merged

Docs migrated to initial version#13
sunxiaoguang merged 3 commits intosun/raw_kv_initial_versionfrom
docs-rebase

Conversation

@Hoverbear
Copy link
Copy Markdown
Contributor

@sunxiaoguang PTAL and merge freely, this isn't going to master, but your branch. :)

Signed-off-by: Hoverbear <operator@hoverbear.org>
Signed-off-by: Hoverbear <operator@hoverbear.org>
Signed-off-by: Hoverbear <operator@hoverbear.org>
Copy link
Copy Markdown
Member

@sunxiaoguang sunxiaoguang left a comment

Choose a reason for hiding this comment

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

@Hoverbear It's amazing you have done all these documentation in such short time. Great!.

Comment thread src/errors.rs
/// for errors. *This may change in future versions.*
#[derive(Debug)]
pub enum Error {
/// Wraps a a `std::io::Error`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Wraps a std::io::Error.

Comment thread src/errors.rs
description("store not match")
display("requesting store '{}' when actual store is '{}'. {}", request_store_id, actual_store_id, message)
}
/// The given key is not eithin the given region.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

eithin -> within?

Comment thread src/lib.rs
/// In TiKV, keys are an ordered sequence of bytes. This has an advantage over choosing `String` as valid `UTF-8` is not required. This means that the user is permitted to store any data they wish,
/// as long as it can be represented by bytes. (Which is to say, pretty much anything!)
///
/// This is a *wrapper type* that implements `Deref<Target=Vec<u8>>` so it can be used like one transparently.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I forgot we haven't decided yet before changed Deref<Target=Vec> to Deref<Target=[u8]> per @sticnarf 's suggestion. Do you have comment on this change? #12

Comment thread src/raw.rs
/// let connect = Client::new(&Config::default());
/// let client = connect.wait();
/// ```
#[cfg_attr(feature = "cargo-clippy", allow(clippy::new_ret_no_self))]
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I guess feature = "cargo-chippy" can be removed now?

Comment thread src/raw.rs
///
/// Once resolved this request will result in a scanner over the given keys.
///
/// If not passed a `limit` parameter, it will default to `u32::MAX`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Shell we put a rational limit on this? Like what Go client does.

Comment thread src/raw.rs
///
/// Once resolved this request will result in the deletion of all keys over the given range.
///
/// If not passed a `limit` parameter, it will default to `u32::MAX`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

DeleteRange has no number of pairs limit, so we can remove this line.

@sunxiaoguang sunxiaoguang merged commit 3bc1bf2 into sun/raw_kv_initial_version Dec 31, 2018
@Hoverbear Hoverbear mentioned this pull request Dec 31, 2018
@sticnarf sticnarf deleted the docs-rebase branch April 7, 2020 03:56
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.

2 participants