[pkg-d-commits] [dustmite] 02/05: Add manpage for Dustmite

[Matthias Klumpp]

This is an automated email from the git hooks/post-receive script.

mak pushed a commit to branch master
in repository dustmite.

commit 7268fa38e85e0f3a3f182e0f2ad09f1ddff9edc7
Author: Matthias Klumpp <mak at debian.org>
Date:   Thu Dec 22 19:42:52 2016 +0100

    Add manpage for Dustmite
---
 debian/dustmite.1        | 82 ++++++++++++++++++++++++++++++++++++++++++++++++
 debian/dustmite.manpages |  1 +
 2 files changed, 83 insertions(+)

diff --git a/debian/dustmite.1 b/debian/dustmite.1
new file mode 100644
index 0000000..41a82da
--- /dev/null
+++ b/debian/dustmite.1
@@ -0,0 +1,82 @@
+.TH dustmite "1" "December 2016" "Dustmite" "User Commands"
+.SH NAME
+dustmite \- a tool for minimizing D source code.
+.SH SYNOPSIS
+.B dustmite
+[\fI\,OPTION\/\fR]... \fI\,PATH TESTER\/\fR
+.SH DESCRIPTION
+DustMite is a tool for minimizing D source code.
+Reducing C++ code also works quite well via --split *.{c,cpp,h,hpp}:d.
+.TP
+DustMite will parse the source code into a simple hierarchy, and attempt to shrink it by deleting fragments iteratively, as long as the result satisfies a user-specified condition.
+.TP
+PATH should be a directory containing a clean copy of the file\-set to reduce.
+A file path can also be specified. NAME.EXT will be treated like NAME/NAME.EXT. TESTER should be a shell command which returns 0 for a correct reduction, and anything else otherwise.
+.SH OPTIONS
+.TP
+\fB\-\-force\fR
+Force reduction of unusual files
+.TP
+\fB\-\-reduce\-only\fR MASK Only reduce paths glob\-matching MASK
+(may be used multiple times)
+.TP
+\fB\-\-no\-remove\fR REGEXP Do not reduce blocks containing REGEXP
+(may be used multiple times)
+.TP
+\fB\-\-strip\-comments\fR
+Attempt to remove comments from source code.
+.TP
+\fB\-\-coverage\fR DIR
+Load .lst files corresponding to source files from DIR
+.TP
+\fB\-\-obfuscate\fR
+Instead of reducing, obfuscate the input by replacing
+words with random substitutions
+.TP
+\fB\-\-keep\-length\fR
+Preserve word length when obfuscating
+.TP
+\fB\-\-split\fR MASK:MODE
+Parse and reduce files specified by MASK using the given
+splitter. Can be repeated. MODE must be one of:
+files, lines, words, d
+.TP
+\fB\-\-no\-redirect\fR
+Don't redirect stdout/stderr streams of test command.
+.TP
+\fB\-j[N]\fR
+Use N look\-ahead processes (8 by default)
+.TP
+\fB\-\-help\fR
+Show this message
+.SS "Less interesting options:"
+.TP
+\fB\-\-strategy\fR STRAT
+Set strategy (careful/lookback/pingpong/indepth/inbreadth)
+.TP
+\fB\-\-dump\fR
+Dump parsed tree to DIR.dump file
+.TP
+\fB\-\-dump\-html\fR
+Dump parsed tree to DIR.html file
+.TP
+\fB\-\-times\fR
+Display verbose spent time breakdown
+.TP
+\fB\-\-cache\fR DIR
+Use DIR as persistent disk cache
+(in addition to memory cache)
+.TP
+\fB\-\-trace\fR
+Save all attempted reductions to DIR.trace
+.TP
+\fB\-\-no\-save\fR
+Disable saving in\-progress results
+.TP
+\fB\-\-no\-optimize\fR
+Disable tree optimization step
+(may be useful with \fB\-\-dump\fR)
+.SH "SEE ALSO"
+The full documentation for
+.B dustmite
+can be found on the GitHub wiki: https://github.com/CyberShadow/DustMite/wiki
diff --git a/debian/dustmite.manpages b/debian/dustmite.manpages
new file mode 100644
index 0000000..1b43c87
--- /dev/null
+++ b/debian/dustmite.manpages
@@ -0,0 +1 @@
+debian/dustmite.1

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-d/dustmite.git