aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/planned.html8
-rw-r--r--doc/plock.168
-rw-r--r--doc/plock.planned.189
3 files changed, 165 insertions, 0 deletions
diff --git a/doc/planned.html b/doc/planned.html
new file mode 100644
index 0000000..5a9cbdd
--- /dev/null
+++ b/doc/planned.html
@@ -0,0 +1,8 @@
+<h1>Tervezett funkciók</h1>
+<strong>1. Generátorok</strong>
+<p>Lehetne random generátort is használni az alapértelmezett helyett.</p>
+<strong>2. filterek</strong>
+<p>Lehetővé teszik a szűrést a generált minták között. Állapottal rendelkeznek, tehát az, hogy eddig milyen mintákat generáltunk, hatással lehet arra, hogy később miket enged át a filter. Ez lehetővé tenné az <em>egyedi</em> szűrőt, ami csak azokat a mintákat engedné át, amik még nem szerepeltek. Hasznos lenne a random generátornál.</p>
+<p>Több filtert is lehetne alkalmazni egyszerre, adott precedenciával.</p>
+<strong>3. Tömörítés</strong>
+<p>Megmondja egy mintáról, hogy ha az összes mintát kigenerálnánk, akkor ez hányadik lenne.</p>
diff --git a/doc/plock.1 b/doc/plock.1
new file mode 100644
index 0000000..a8a29b3
--- /dev/null
+++ b/doc/plock.1
@@ -0,0 +1,68 @@
+.TH PLOCK 1
+.SH NAME
+plock - a command for generating android patterns
+.SH SYNOPSIS
+.B plock
+.RB [ \-p
+.IR print_type ]
+.SH DESCRIPTION
+plock is a command line tool for generating android lock-patterns.
+
+.SH OPTIONS
+
+.TP
+.BR \-n ", " \-\-number=\fInum\fR
+.PD
+It tells the program to generate \fInum\fR amount of patterns. If \fInum\fR is negative, there will be maximum amount of patterns generated.
+
+.TP
+.BR \-p ", " \-\-print=\fItype\fR
+.PD
+Sets the type of print wich the program should use. \fItype\fR can be: text or svg.
+
+.TP
+.BR \-o ", " \-\-output=\fIpath\fR
+.PD
+Sets the path of the output file.
+
+.TP
+.BR \-os ", " \-\-outputs=\fIpath\fR
+.PD
+Sets the pattern of path of the output files. A possible pattern could be pattern_%d.svg where %d will be the number of the pattern. %d can only be at the name of the file, since plock is not capable of creating directories.
+
+.TP
+.BR \-fn ", " \-\-from-num=\fInumber\fR
+.PD
+Starts from number \fInumber\fR. If it's zero, it has no effect.
+
+.TP
+.BR \-tn ", " \-\-to-num=\fInumber\fR
+.PD
+Stops at number \fInumber\fR. If it's zero, it has no effect.
+
+.TP
+.BR \-w ", " \-\-wait
+.PD
+Makes the program wait until a char is given on stdin after each pattern generation.
+
+.SH EXIT STATUS
+Plock may return one of several error codes if it encounters problems.
+
+.ie n .IP "0" 4
+.el .IP "\f(CW0\fR" 4
+.IX Item "0"
+No problems occurred.
+
+.ie n .IP "1" 4
+.el .IP "\f(CW0\fR" 4
+.IX Item "1"
+Args error.
+
+.ie n .IP "2" 4
+.el .IP "\f(CW0\fR" 4
+.IX Item "2"
+IO error.
+
+.SH AUTHOR
+Sopár Adrián <\fIdev.adrian.sopar@protonmail.com\fR> <\fIhttps://adriansopar.hu\fR>
+
diff --git a/doc/plock.planned.1 b/doc/plock.planned.1
new file mode 100644
index 0000000..d50bd8c
--- /dev/null
+++ b/doc/plock.planned.1
@@ -0,0 +1,89 @@
+.TH PLOCK 1
+.SH NAME
+plock - a command for generating android patterns
+.SH SYNOPSIS
+.B plock
+.RB [ \-p
+.IR print_type ]
+.SH DESCRIPTION
+plock is a command line tool for generating android lock-patterns.
+
+It can also transform patterns given in text format into images.
+.SH OPTIONS
+
+.TP
+.BR \-s ", " \-\-size=\fIsize\fR
+.PD
+It sets the size of the pattern grid to \fIsize\fR. \fIsize\fR can be two integers separated by an x sign. In this case the first integer is the width and the second is the height. Or it can be only a single integer in wich case the integer is also the width and the height.
+
+.TP
+.BR \-p ", " \-\-pattern=\fIpattern\fR
+.PD
+Sets the pattern to \fIpattern\fR. The syntax of pattern is: integer sequence separated by commas. For example 0,1,2 could be a \fIpattern\fR.
+
+.TP
+.BR \-n ", " \-\-number=\fInum\fR
+.PD
+It tells the program to generate \fInum\fR amount of patterns. If \fInum\fR is negative, there will be maximum amount of patterns generated.
+
+.TP
+.BR \-g ", " \-\-gen=\fItype\fR
+.PD
+Sets the type of generation wich the program should use. \fItype\fR can be: rand or next.
+
+.TP
+.BR \-p ", " \-\-print=\fItype\fR
+.PD
+Sets the type of print wich the program should use. \fItype\fR can be: text or svg.
+
+.TP
+.BR \-o ", " \-\-output=\fIpath\fR
+.PD
+Sets the path of the output file.
+
+.TP
+.BR \-os ", " \-\-outputs=\fIpath\fR
+.PD
+Sets the pattern of path of the output files. A possible pattern could be pattern_%d.svg where %d will be the number of the pattern. %d can only be at the name of the file, since plock is not capable of creating directories.
+
+.TP
+.BR \-fn ", " \-\-from-num=\fInumber\fR
+.PD
+Starts from number \fInumber\fR. If it's zero, it has no effect.
+
+.TP
+.BR \-tn ", " \-\-to-num=\fInumber\fR
+.PD
+Stops at number \fInumber\fR. If it's zero, it has no effect.
+
+.TP
+.BR \-w ", " \-\-wait
+.PD
+Makes the program wait until a char is given on stdin after each pattern generation.
+
+.TP
+.BR \-u ", " \-\-uniq
+.PD
+The generated patterns will be unique.
+
+.SH EXIT STATUS
+Plock may return one of several error codes if it encounters problems.
+
+.ie n .IP "0" 4
+.el .IP "\f(CW0\fR" 4
+.IX Item "0"
+No problems occurred.
+
+.ie n .IP "1" 4
+.el .IP "\f(CW0\fR" 4
+.IX Item "1"
+Args error.
+
+.ie n .IP "2" 4
+.el .IP "\f(CW0\fR" 4
+.IX Item "2"
+IO error.
+
+.SH AUTHOR
+Sopár Adrián <\fIdev.adrian.sopar@protonmail.com\fR> <\fIhttps://adriansopar.hu\fR>
+