mirror of
https://github.com/alrayyes/wiki.git
synced 2024-12-01 15:26:23 +00:00
38 lines
700 B
Markdown
38 lines
700 B
Markdown
|
---
|
||
|
|
id: f878143f-448c-4a1a-9a6e-7d2bf5a174ca
|
||
|
|
title: rustdoc
|
||
|
|
---
|
||
|
|
|
||
|
|
# Description
|
||
|
|
|
||
|
|
Rustdoc[^1] is the built in library documentation tool included in the
|
||
|
|
Rust distribution and allows you to write documentation in Markdown[^2].
|
||
|
|
|
||
|
|
# Syntax
|
||
|
|
|
||
|
|
``` rust
|
||
|
|
pub mod foo {
|
||
|
|
/// Some docs for `Foo`
|
||
|
|
///
|
||
|
|
/// You may want to use `Foo` with [`Bar`].
|
||
|
|
///
|
||
|
|
/// [`Bar`]: ../bar/struct.Bar.html
|
||
|
|
pub struct Foo;
|
||
|
|
}
|
||
|
|
|
||
|
|
pub mod bar {
|
||
|
|
/// Some docs for `Bar`
|
||
|
|
///
|
||
|
|
/// You may want to use `Bar` with [`Foo`].
|
||
|
|
///
|
||
|
|
/// [`Foo`]: ../foo/struct.Foo.html
|
||
|
|
pub struct Bar;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
# Footnotes
|
||
|
|
|
||
|
|
[^1]: <https://doc.rust-lang.org/rustdoc/index.html>
|
||
|
|
|
||
|
|
[^2]: <https://en.wikipedia.org/wiki/Markdown>
|