#rustdoc #doc #strip #tool

bin+lib rustdoc-stripper

A tool to manipulate rustdoc comments

10 releases

0.1.9 Jun 24, 2019
0.1.8 Jun 23, 2019
0.1.5 Sep 14, 2017
0.1.4 Jul 10, 2017
0.1.1 Mar 31, 2016

#7 in #tool

Download history 345/week @ 2019-04-14 158/week @ 2019-04-21 63/week @ 2019-04-28 248/week @ 2019-05-05 378/week @ 2019-05-12 244/week @ 2019-05-19 164/week @ 2019-05-26 315/week @ 2019-06-02 476/week @ 2019-06-09 674/week @ 2019-06-16 327/week @ 2019-06-23 414/week @ 2019-06-30 275/week @ 2019-07-07 166/week @ 2019-07-14 127/week @ 2019-07-21

1,073 downloads per month
Used in 26 crates (17 directly)

Apache-2.0

68KB
1.5K SLoC

rustdoc-stripper Build Status

rustdoc-stripper is a tool used to remove rustdoc comments from your code and save them in a comments.cmts file if you want to regenerate them.

###Options

Available options for rustdoc-stripper are:

  • -h | --help : Displays this help
  • -s | --strip : Strips the current folder files and create a file with rustdoc information (comments.cmts by default)
  • -g | --regenerate : Recreate files with rustdoc comments from reading rustdoc information file (comments.cmts by default)
  • -n | --no-file-output : Display rustdoc information directly on stdout
  • -i | --ignore [filename]: Ignore the specified file, can be repeated as much as needed, only used when stripping files, ignored otherwise
  • -d | --dir [directory] : Specify a directory path to work on, optional
  • -v | --verbose : Activate verbose mode
  • -f | --force : Remove confirmation demands
  • -m | --ignore-macros : macros in hierarchy will be ignored (so only macros with doc comments will appear in the comments file)
  • -o | --comment-file : specify the file within you want to save rustdoc information

By default, rustdoc is run with -s option:

./rustdoc-stripper -s

IMPORTANT: Only files ending with '.rs' will be stripped/regenerated.

No runtime deps