Skip to content

Commit 2b43b28

Browse files
d-e-s-odanielocfb
authored andcommitted
Introduce dedicated README files for the two crates
Our README is not particularly telling in its current form and it being shared between libbpf-rs and libbpf-cargo does not help. As a first step towards improving the situation, this change introduces separate README files for the two crates. We keep the "landing page" README, but basically just make it point to the individual crates to aid in discoverability. Signed-off-by: Daniel Müller <[email protected]>
1 parent b78f827 commit 2b43b28

File tree

5 files changed

+60
-43
lines changed

5 files changed

+60
-43
lines changed

README.md

+4-39
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,7 @@
1-
![CI](https://github.com/libbpf/libbpf-rs/workflows/Rust/badge.svg?branch=master)
2-
[![rustc](https://img.shields.io/badge/rustc-1.63+-blue.svg)](https://blog.rust-lang.org/2022/08/11/Rust-1.63.0.html)
1+
## [libbpf-rs](libbpf-rs)
32

4-
WARNING: The API is not stable and is subject to breakage. Any breakage will
5-
include a minor version bump pre-1.0 and a major version bump post-1.0.
6-
[Semantic versioning](https://semver.org/) will be followed post-1.0 release.
3+
Idiomatic Rust wrapper around [libbpf](https://github.com/libbpf/libbpf).
74

8-
# libbpf-rs
5+
## [libbpf-cargo](libbpf-cargo)
96

10-
[![crates.io badge](https://img.shields.io/crates/v/libbpf-rs.svg)](https://crates.io/crates/libbpf-rs)
11-
12-
Idiomatic rust wrapper around
13-
[libbpf](https://github.com/libbpf/libbpf)
14-
15-
To use in your project, add into your `Cargo.toml`:
16-
17-
```toml
18-
[dependencies]
19-
libbpf-rs = "0.20"
20-
```
21-
22-
See [full documentation here](https://docs.rs/libbpf-rs).
23-
24-
# libbpf-cargo
25-
26-
[![crates.io badge](https://img.shields.io/crates/v/libbpf-cargo.svg)](https://crates.io/crates/libbpf-cargo)
27-
28-
Helps you build and develop eBPF programs with standard rust tooling
29-
30-
To use in your project, add into your `Cargo.toml`:
31-
32-
```toml
33-
[build-dependencies]
34-
libbpf-cargo = "0.20"
35-
```
36-
37-
See [full documentation here](https://docs.rs/libbpf-cargo).
38-
39-
## Contributing
40-
41-
We welcome all contributions! Please see the [contributor's
42-
guide](CONTRIBUTING.md) for more information.
7+
Helps you build and develop BPF programs with standard Rust tooling.

libbpf-cargo/Cargo.toml

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description = "Cargo plugin to build bpf programs"
44
repository = "https://github.com/libbpf/libbpf-rs"
55
homepage = "https://github.com/libbpf/libbpf-rs"
66
documentation = "https://docs.rs/crate/libbpf-cargo"
7-
readme = "../README.md"
7+
readme = "README.md"
88
version = "0.20.0"
99
authors = ["Daniel Xu <[email protected]>", "Daniel Müller <[email protected]>"]
1010
edition = "2021"

libbpf-cargo/README.md

-1
This file was deleted.

libbpf-cargo/README.md

+27
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
![CI](https://github.com/libbpf/libbpf-rs/workflows/Rust/badge.svg?branch=master)
2+
[![rustc](https://img.shields.io/badge/rustc-1.63+-blue.svg)](https://blog.rust-lang.org/2022/08/11/Rust-1.63.0.html)
3+
4+
WARNING: The API is not stable and is subject to breakage. Any breakage will
5+
include a minor version bump pre-1.0 and a major version bump post-1.0.
6+
[Semantic versioning](https://semver.org/) will be followed post-1.0 release.
7+
8+
# libbpf-cargo
9+
10+
[![crates.io badge](https://img.shields.io/crates/v/libbpf-cargo.svg)](https://crates.io/crates/libbpf-cargo)
11+
12+
Helps you build and develop BPF programs with standard Rust tooling.
13+
14+
- [Changelog](CHANGELOG.md)
15+
16+
To use in your project, add into your `Cargo.toml`:
17+
```toml
18+
[build-dependencies]
19+
libbpf-cargo = "0.20"
20+
```
21+
22+
See [full documentation here](https://docs.rs/libbpf-cargo).
23+
24+
## Contributing
25+
26+
We welcome all contributions! Please see the [contributor's
27+
guide](../CONTRIBUTING.md) for more information.

libbpf-rs/Cargo.toml

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ name = "libbpf-rs"
33
description = "libbpf-rs is a safe, idiomatic, and opinionated wrapper around libbpf-sys"
44
repository = "https://github.com/libbpf/libbpf-rs"
55
homepage = "https://github.com/libbpf/libbpf-rs"
6-
readme = "../README.md"
6+
readme = "README.md"
77
version = "0.20.0"
88
authors = ["Daniel Xu <[email protected]>", "Daniel Müller <[email protected]>"]
99
edition = "2021"

libbpf-rs/README.md

-1
This file was deleted.

libbpf-rs/README.md

+27
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
![CI](https://github.com/libbpf/libbpf-rs/workflows/Rust/badge.svg?branch=master)
2+
[![rustc](https://img.shields.io/badge/rustc-1.63+-blue.svg)](https://blog.rust-lang.org/2022/08/11/Rust-1.63.0.html)
3+
4+
WARNING: The API is not stable and is subject to breakage. Any breakage will
5+
include a minor version bump pre-1.0 and a major version bump post-1.0.
6+
[Semantic versioning](https://semver.org/) will be followed post-1.0 release.
7+
8+
# libbpf-rs
9+
10+
[![crates.io badge](https://img.shields.io/crates/v/libbpf-rs.svg)](https://crates.io/crates/libbpf-rs)
11+
12+
Idiomatic Rust wrapper around [libbpf](https://github.com/libbpf/libbpf).
13+
14+
- [Changelog](CHANGELOG.md)
15+
16+
To use in your project, add into your `Cargo.toml`:
17+
```toml
18+
[dependencies]
19+
libbpf-rs = "0.20"
20+
```
21+
22+
See [full documentation here](https://docs.rs/libbpf-rs).
23+
24+
## Contributing
25+
26+
We welcome all contributions! Please see the [contributor's
27+
guide](../CONTRIBUTING.md) for more information.

0 commit comments

Comments
 (0)