From d8de44bcb44141760c1f205772aa798989615aa3 Mon Sep 17 00:00:00 2001 From: Emile Anclin Date: Mon, 13 Oct 2008 16:43:58 +0200 Subject: use new generated doc and man --- man/pylint.1 | 117 +++++++++++++++++++++++++++++------------------------------ 1 file changed, 58 insertions(+), 59 deletions(-) (limited to 'man') diff --git a/man/pylint.1 b/man/pylint.1 index f053332..5a7696b 100644 --- a/man/pylint.1 +++ b/man/pylint.1 @@ -1,4 +1,4 @@ -.TH pylint 1 "2008-2-7" pylint +.TH pylint 1 "2008-10-13" pylint .SH NAME .B pylint \- python code static checker @@ -62,11 +62,11 @@ Generate a sample configuration file according to the current configuration. You .IP "--generate-man" Generate pylint's man page. -.SH MESSAGE CONTROL +.SH MESSAGES CONTROL .IP "--enable-checker=" -Enable only checker(s) with the given id(s). This option conflicts with the disable-checker option +Enable only checker(s) with the given id(s). This option conflicts with the disable-checker option .IP "--disable-checker=" -Enable all checker(s) except those with the given id(s). This option conflicts with the enable-checker option +Enable all checker(s) except those with the given id(s). This option conflicts with the enable-checker option .IP "--enable-msg-cat=" Enable all messages in the listed categories. .IP "--disable-msg-cat=" @@ -78,7 +78,7 @@ Disable the message(s) with the given id(s). .SH REPORTS .IP "--output-format=, -f " -Set the output format. Available formats are text, parseable, colorized, msvs (visual studio) and html [current: text] +Set the output format. Available formats are text, parseable, colorized, msvs (visual studio) and html [current: text] .IP "--include-ids=, -i " Include message's id in output [current: no] .IP "--files-output=" @@ -86,7 +86,7 @@ Put messages in a separate file for each module / package specified on the comma .IP "--reports=, -r " Tells wether to display a full report or only the messages [current: yes] .IP "--evaluation=" -Python expression which should return a note less than 10 (10 is the highest note). You have access to the variables errors warning, statement which respectivly contain the number of errors / warnings messages and the total number of statements analyzed. This is used by the global evaluation report (R0004). [current: 10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)] +Python expression which should return a note less than 10 (10 is the highest note). You have access to the variables errors warning, statement which respectivly contain the number of errors / warnings messages and the total number of statements analyzed. This is used by the global evaluation report (R0004). [current: 10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)] .IP "--comment=" Add a comment according to your evaluation note. This is used by the global evaluation report (R0004). [current: no] .IP "--enable-report=" @@ -94,42 +94,6 @@ Enable the report(s) with the given id(s). .IP "--disable-report=" Disable the report(s) with the given id(s). -.SH BASIC -.IP "--required-attributes=" -Required attributes for module, separated by a comma [current: none] -.IP "--no-docstring-rgx=" -Regular expression which should only match functions or classes name which do not require a docstring [current: __.*__] -.IP "--module-rgx=" -Regular expression which should only match correct module names [current: (([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$] -.IP "--const-rgx=" -Regular expression which should only match correct module level names [current: (([A-Z_][A-Z0-9_]*)|(__.*__))$] -.IP "--class-rgx=" -Regular expression which should only match correct class names [current: [A-Z_][a-zA-Z0-9]+$] -.IP "--function-rgx=" -Regular expression which should only match correct function names [current: [a-z_][a-z0-9_]{2,30}$] -.IP "--method-rgx=" -Regular expression which should only match correct method names [current: [a-z_][a-z0-9_]{2,30}$] -.IP "--attr-rgx=" -Regular expression which should only match correct instance attribute names [current: [a-z_][a-z0-9_]{2,30}$] -.IP "--argument-rgx=" -Regular expression which should only match correct argument names [current: [a-z_][a-z0-9_]{2,30}] -.IP "--variable-rgx=" -Regular expression which should only match correct variable names [current: [a-z_][a-z0-9_]{2,30}$] -.IP "--inlinevar-rgx=" -Regular expression which should only match correct list comprehension / generator expression variable names [current: [A-Za-z_][A-Za-z0-9_]*$] -.IP "--good-names=" -Good variable names which should always be accepted, separated by a comma [current: i,j,k,ex,Run,_] -.IP "--bad-names=" -Bad variable names which should always be refused, separated by a comma [current: foo,bar,baz,toto,tutu,tata ] -.IP "--bad-functions=" -List of builtins function names that should not be used, separated by a comma [current: map,filter,apply,input] - -.SH CLASSES -.IP "--ignore-iface-methods=" -List of interface methods to ignore, separated by a comma. This is used for instance to not check methods defines in Zope's Interface base class. [current: isIm plementedBy,deferred,extends,names,namesAndDescription s,queryDescriptionFor,getBases,getDescriptionFor,getDo c,getName,getTaggedValue,getTaggedValueTags,isEqualOrE xtendedBy,setTaggedValue,isImplementedByInstancesOf,ad aptWith,is_implemented_by] -.IP "--defining-attr-methods=" -List of method names used to declare (i.e. assign) instance attributes. [current: __init__,__new__,setUp] - .SH DESIGN .IP "--max-args=" Maximum number of arguments for function / method [current: 5] @@ -150,14 +114,11 @@ Minimum number of public methods for a class (see R0903). [current: 2] .IP "--max-public-methods=" Maximum number of public methods for a class (see R0904). [current: 20] -.SH FORMAT -.IP "--max-line-length=" -Maximum number of characters on a single line. [current: 80] -.IP "--max-module-lines=" -Maximum number of lines in a module [current: 1000] -.IP "--indent-string=" -String used as indentation unit. This is usually " " (4 spaces) or "\t" (1 tab). - [current: " "] +.SH CLASSES +.IP "--ignore-iface-methods=" +List of interface methods to ignore, separated by a comma. This is used for instance to not check methods defines in Zope's Interface base class. [current: isImplementedBy,deferred,extends,names,namesAndDescriptions,queryDescriptionFor,getBases,getDescriptionFor,getDoc,getName,getTaggedValue,getTaggedValueTags,isEqualOrExtendedBy,setTaggedValue,isImplementedByInstancesOf,adaptWith,is_implemented_by] +.IP "--defining-attr-methods=" +List of method names used to declare (i.e. assign) instance attributes. [current: __init__,__new__,setUp] .SH IMPORTS .IP "--deprecated-modules=" @@ -169,9 +130,13 @@ Create a graph of external dependencies in the given file (report R0402 must not .IP "--int-import-graph=" Create a graph of internal dependencies in the given file (report R0402 must not be disabled) [current: none] -.SH MISCELLANEOUS -.IP "--notes=" -List of note tags to take in consideration, separated by a comma. [current: FIXME,TODO,XXX] +.SH FORMAT +.IP "--max-line-length=" +Maximum number of characters on a single line. [current: 80] +.IP "--max-module-lines=" +Maximum number of lines in a module [current: 1000] +.IP "--indent-string=" +String used as indentation unit. This is usually " " (4 spaces) or "\t" (1 tab). [current: ' '] .SH SIMILARITIES .IP "--min-similarity-lines=" @@ -184,12 +149,12 @@ Ignore docstrings when computing similarities. [current: yes] .SH TYPECHECK .IP "--ignore-mixin-members=" Tells wether missing members accessed in mixin class should be ignored. A mixin class is detected if its name ends with "mixin" (case insensitive). [current: yes] -.IP "--ignored-classes=" -List of class names for which member attributes should not be checked (useful for classes with attributes dynamicaly set). [current: SQLObject] +.IP "--ignored-classes=" +List of classes names for which member attributes should not be checked (useful for classes with attributes dynamicaly set). [current: SQLObject] .IP "--zope=" -When zope mode is activated, consider the acquired-members option to ignore access to some undefined attributes. [current: no] -.IP "--generated-members=" -List of members which are usually get through zope's acquisition mecanism and so shouldn't trigger E0201 when accessed (need zope=yes to be considered). [current: REQUEST,acl_users,aq_parent] +When zope mode is activated, add a predefined set of Zope acquired attributes to generated-members. [current: no] +.IP "--generated-members=" +List of members which are set dynamically and missed by pylint inference system, and so shouldn't trigger E0201 when accessed. [current: REQUEST,acl_users,aq_parent] .SH VARIABLES .IP "--init-import=" @@ -199,13 +164,47 @@ A regular expression matching names used for dummy variables (i .IP "--additional-builtins=" List of additional names supposed to be defined in builtins. Remember that you should avoid to define new builtins when possible. [current: none] +.SH MISCELLANEOUS +.IP "--notes=" +List of note tags to take in consideration, separated by a comma. [current: FIXME,XXX,TODO] + +.SH BASIC +.IP "--required-attributes=" +Required attributes for module, separated by a comma [current: none] +.IP "--no-docstring-rgx=" +Regular expression which should only match functions or classes name which do not require a docstring [current: __.*__] +.IP "--module-rgx=" +Regular expression which should only match correct module names [current: (([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$] +.IP "--const-rgx=" +Regular expression which should only match correct module level names [current: (([A-Z_][A-Z0-9_]*)|(__.*__))$] +.IP "--class-rgx=" +Regular expression which should only match correct class names [current: [A-Z_][a-zA-Z0-9]+$] +.IP "--function-rgx=" +Regular expression which should only match correct function names [current: [a-z_][a-z0-9_]{2,30}$] +.IP "--method-rgx=" +Regular expression which should only match correct method names [current: [a-z_][a-z0-9_]{2,30}$] +.IP "--attr-rgx=" +Regular expression which should only match correct instance attribute names [current: [a-z_][a-z0-9_]{2,30}$] +.IP "--argument-rgx=" +Regular expression which should only match correct argument names [current: [a-z_][a-z0-9_]{2,30}$] +.IP "--variable-rgx=" +Regular expression which should only match correct variable names [current: [a-z_][a-z0-9_]{2,30}$] +.IP "--inlinevar-rgx=" +Regular expression which should only match correct list comprehension / generator expression variable names [current: [A-Za-z_][A-Za-z0-9_]*$] +.IP "--good-names=" +Good variable names which should always be accepted, separated by a comma [current: i,j,k,ex,Run,_] +.IP "--bad-names=" +Bad variable names which should always be refused, separated by a comma [current: foo,bar,baz,toto,tutu,tata] +.IP "--bad-functions=" +List of builtins function names that should not be used, separated by a comma [current: map,filter,apply,input] + .SH ENVIRONMENT VARIABLES The following environment variables are used : * PYLINTHOME path to the directory where data of persistent run will be stored. If not found, it defaults to ~/.pylint.d/ or .pylint.d (in the current working -directory) . The current PYLINTHOME is /home/syt/.pylint.d. +directory) . The current PYLINTHOME is ~/.pylint.d. * PYLINTRC path to the configuration file. If not found, it will use the first existant file in ~/.pylintrc, /etc/pylintrc. The current PYLINTRC is -- cgit v1.2.1