Skip to content

Commit 2449dd4

Browse files
committed
docs(README): Improve clarity of purpose of program
1 parent 6a7244f commit 2449dd4

File tree

2 files changed

+14
-6
lines changed

2 files changed

+14
-6
lines changed

README.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,14 @@
22

33
## BashDoc
44

5-
A tool for generating documentation/help menu for user defined bash functions.
5+
A tool for generating documentation/help menu for ~~user defined bash functions~~ any folder or file with 6 generic delimiters defined.
66

77
### Syntax
88

99
#### Example
1010

11+
Using syntax similar to below
12+
1113
```bash
1214
#;
1315
# cd()
@@ -20,14 +22,16 @@ cd() {
2022
}
2123
```
2224

23-
Outputs
25+
on my `zshrc` Outputs
2426

2527
![](https://github.com/dustinknopoff/bashdoc/raw/master/example/zshrc.png)
2628

2729
with lots of color!
2830

2931
#### Global Delimiters
3032

33+
The default delimiters to use are as follows:
34+
3135
`START_DELIM = #;`
3236

3337
`END_DELIM = #"`
@@ -64,7 +68,6 @@ cargo install --path . --force
6468

6569
```bash
6670
bashdoc 0.4.7
67-
Dustin Knopoff <dustinknopoff@gmail.com>
6871
Creates a "javadoc" like structure for bash. See github repo github.com/dustinknopoff/bashdoc for information on
6972
formatting.
7073

@@ -102,5 +105,6 @@ See the [changelog](https://github.com/dustinknopoff/bashdoc/blob/master/CHANGEL
102105
- v.0.4.5 - Fix error where bashdoc would not function for users without a `~/.bashdocrc`
103106
- v.0.4.6 - Improved Error handling, `--html` argument removed replaced with `--location`, `--template` argument added for supplying custom `.hbs`
104107
- v0.4.7 - Fix required location for all inputs and not exclusive to `--location`
108+
- v0.4.8 - Clearer README, link to docs.rs documentation
105109

106110
License: MIT

src/main.rs

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
//!# BashDoc
22
//!
3-
//!A tool for generating documentation/help menu for user defined bash functions.
3+
//!A tool for generating documentation/help menu for ~~user defined bash functions~~ any folder or file with 6 generic delimiters defined.
44
//!
55
//!## Syntax
66
//!
77
//!### Example
88
//!
9+
//! Using syntax similar to below
10+
//!
911
//!```bash
1012
//!#;
1113
//!# cd()
@@ -18,14 +20,16 @@
1820
//!}
1921
//!```
2022
//!
21-
//!Outputs
23+
//!on my `zshrc` Outputs
2224
//!
2325
//!![](https://github.com/dustinknopoff/bashdoc/raw/master/example/zshrc.png)
2426
//!
2527
//!with lots of color!
2628
//!
2729
//!### Global Delimiters
2830
//!
31+
//! The default delimiters to use are as follows:
32+
//!
2933
//!`START_DELIM = #;`
3034
//!
3135
//!`END_DELIM = #"`
@@ -62,7 +66,6 @@
6266
//!
6367
//!```bash
6468
//!bashdoc 0.4.7
65-
//!Dustin Knopoff <dustinknopoff@gmail.com>
6669
//!Creates a "javadoc" like structure for bash. See github repo github.com/dustinknopoff/bashdoc for information on
6770
//!formatting.
6871
//!
@@ -100,6 +103,7 @@
100103
//!- v.0.4.5 - Fix error where bashdoc would not function for users without a `~/.bashdocrc`
101104
//!- v.0.4.6 - Improved Error handling, `--html` argument removed replaced with `--location`, `--template` argument added for supplying custom `.hbs`
102105
//!- v0.4.7 - Fix required location for all inputs and not exclusive to `--location`
106+
//!- v0.4.8 - Clearer README, link to docs.rs documentation
103107
mod docs;
104108
use crate::docs::runners::*;
105109
use clap::{load_yaml, App};

0 commit comments

Comments
 (0)