Skip to content

Commit 102b612

Browse files
committed
doc: adapt README to crates.io
At this moment bmap-rs and bmap-parser share the same README. This is problematic because in crates.io once published bmap-parser contains references to bmap-rs while if should be independent from it. Fix the original README file. Add a new README file for bmap-parser. Signed-off-by: Rafael Garcia Ruiz <rafael.garcia@collabora.com>
1 parent fd8700e commit 102b612

File tree

3 files changed

+28
-4
lines changed

3 files changed

+28
-4
lines changed

README.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,25 @@ The bmap-rs project aims to implement tools related to bmap. The project is writ
44
rust. The inspiration for it is an existing project that is written in python called
55
[bmap-tools](https://salsa.debian.org/debian/bmap-tools).
66

7-
Right now the implemented function is copying system images files using bmap, which is
8-
safer and faster than regular cp ro dd. That can be used to flash images into block
7+
Right now, the implemented function is copying system images files using bmap, which is
8+
safer and faster than regular cp or dd. That can be used to flash images into block
99
devices.
1010

11+
## Installation
12+
```
13+
cargo install bmap-rs
14+
```
15+
1116
## Usage
1217
bmap-rs supports 1 subcommand:
1318
- "copy" - copy a file to another file using a bmap file.
1419
```bash
15-
bmap-rs copy <SOURCE_PATH> <TARGET_PATH>
20+
bmap-rs copy <SOURCE_PATH>/<SOURCE_URL> <TARGET_PATH>
1621
```
1722

1823
The bmap file is automatically searched in the source directory. The recommendation is
1924
to name it as the source but with bmap extension.
25+
If the file is remote, the bmap is also searched remotely.
2026

2127
## License
2228
bmap-rs is licensed under dual Apache-2.0 and MIT licenses.

bmap-parser/Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ edition = "2018"
66
license = "MIT AND Apache-2.0"
77
description = "bmap-parser is a library for Rust that allows you to copy files or flash block devices safely"
88
repository = "https://github.com/collabora/bmap-rs"
9-
readme = "../README.md"
9+
readme = "README.md"
1010

1111
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
1212

bmap-parser/README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# bmap-parser
2+
3+
The bmap-parser crate aims to implement tools related to bmap. The inspiration for it
4+
is an existing project that is written in python called [bmap-tools](https://salsa.debian.org/debian/bmap-tools).
5+
6+
Right now, the implemented function is copying system images files using bmap, which is
7+
safer and faster than regular cp or dd. That can be used to flash images into block
8+
devices.
9+
10+
## Usage
11+
```
12+
use bmap-parser::*;
13+
```
14+
There is a `copy` function that uses bmap file as reference, and a `copy_async` for the
15+
process to work in an asynchronous context.
16+
17+
## License
18+
bmap-rs is licensed under dual Apache-2.0 and MIT licenses.

0 commit comments

Comments
 (0)