I had used multilines cause of coding standards at pep8. I think not more than 75 characters a line.On 09/12/2013 11:04 AM, Pierre-Yves Chibon wrote:
class ProductionConfig(Config):If I like having lines below 80 characters, I disagree with the use of '\' in
>- """Production Environment: The environmental values which are set for a machine that is being used in production. This disables the machine from displaying errors and warnings. Secret keys, backend passwords and the path/location to the database is also set here"""
>+ """Production Environment: The environmental values which are set for a\
>+ machine that is being used in production. \
>+ This disables the machine from displaying errors and warnings. \
>+ Secret keys, backend passwords and the path or location to the \
>+ database is also set here"""
documentation.
Agree. Multiline docstring count with multilines, so there is no need to put backslash at the end.When generating the documentation using sphinx or something else, they will most
likely appear and they just decrease the readibility (at least imo).
--
Miroslav Suchy, RHCE, RHCDS
Red Hat, Software Engineer, #brno, #devexp, #fedora-buildsys
_______________________________________________
copr-devel mailing list
copr-devel@lists.fedorahosted.org
https://lists.fedorahosted.org/mailman/listinfo/copr-devel