summaryrefslogtreecommitdiff
path: root/man/pyreverse.1
diff options
context:
space:
mode:
authorEmile Anclin <emile.anclin@logilab.fr>2008-08-18 18:34:27 +0200
committerEmile Anclin <emile.anclin@logilab.fr>2008-08-18 18:34:27 +0200
commitf34fb20342f8ed26c93151d1e43b9bf8cf9a093c (patch)
tree11c4696ebf7ff691cad85ed9ac312893e267c18f /man/pyreverse.1
parent298eca7a8cc8b8d9457e51241e8e687dcc36a19f (diff)
downloadpylint-f34fb20342f8ed26c93151d1e43b9bf8cf9a093c.tar.gz
first pyreverse manpage sketch
Diffstat (limited to 'man/pyreverse.1')
-rw-r--r--man/pyreverse.178
1 files changed, 78 insertions, 0 deletions
diff --git a/man/pyreverse.1 b/man/pyreverse.1
new file mode 100644
index 0000000..4068ca2
--- /dev/null
+++ b/man/pyreverse.1
@@ -0,0 +1,78 @@
+.TH PYREVERSE 1 "August 18, 2008" pyreverse "User's Manual"
+.SH NAME
+pyreverse \- parse python sources files and extract diagrams from
+them.
+
+.SH SYNOPSIS
+.B pyreverse
+.I {dot|tests|vcg|xmi}
+.I [options]
+<modules>
+
+.SH DESCRIPTION
+.B pyreverse
+is a python source analyzer. It can parse a python package and produce UML
+diagrams in different output formats. (dot, all formats available for dot, vcg and xmi).
+(For now, the 'xmi' and 'tests' commands are not under developpement.)
+
+With different options, you can have fine tuning on what and how modules, classes
+and attributes will be shown in the diagram.
+
+.SH COMMON OPTIONS
+
+.IP "-h, --help"
+show this help message and exit
+.IP "-p<name>, --project=<name>"
+set project name to <name> if not using -c option. (default:'No Name')
+.IP "-i<file>, --ignore=<file>"
+add <file> (may be a directory) to the black list (not parsed)
+.IP "-f<mode>, --filter-mode=<mode>"
+filter attributes and functions according to <mode>. You can combine multiple
+mode using '+' like 'SPECIAL+OTHER'. Correct modes are :
+ 'PUB_ONLY' filter all non public attributes (default)
+ 'ALL' no filter
+ 'SPECIAL' filter Python special functions except constructor
+ 'OTHER' filter protected and private attributes
+
+.IP "-d<file>, --diadefs=<file>"
+ create diagram according to the diagrams definitions in <file>
+.IP "-c <class>, --class=<class>"
+ create a class diagram with all classes related to <class> [current: none]
+ the class must be in the file <modules>.
+.IP "--search-level=<depth>"
+limit depth of search for associated classes [default: not limited]
+.IP "-m [yn], --module-names=[yn]"
+ include module name in representation of classes
+ [current: none]
+.IP "-b [yn], --builtin=[yn]"
+ include builtin objects in representation of classes
+ [current: none]
+
+.SH DOT, VCG OPTIONS
+If no -c and no --diadefs option specified, pyreverse {dot|vcg} will create
+ \- a diagram 'classes_<name>.{dot|vcg}' for the classes in <modules> and
+ \- a diagram 'packages_<name>.{dot|vcg}' for the packages in <modules>.
+
+
+.SH DOT OPTIONS
+creates a dot diagram for packages and a dot file for classes.
+.IP "-o <format>, --output=<format>"
+create an additionnal *.<format> output file if format available
+[default: None]
+
+.SH VCG OPTIONS
+.IP "-u, --uml"
+make a UML like diagram [default: no]
+
+.SH REQUIRES
+Python
+
+.SH "SEE ALSO"
+.B dot(1), pylint(1)
+
+.I http://www.logilab.org/pyreverse
+
+.SH AUTHORS
+Sylvain Thenault, Emile Anclin
+
+This manpage was written by Emile Anclin <emile.anclin@logilab.fr>