<div dir="ltr"><div><br></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Sep 12, 2013 at 10:29 AM, Miroslav Suchý <span dir="ltr"><<a href="mailto:msuchy@redhat.com" target="_blank">msuchy@redhat.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div class="im">On 09/12/2013 11:04 AM, Pierre-Yves Chibon wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
class ProductionConfig(Config):<br>
>- """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"""<br>
>+ """Production Environment: The environmental values which are set for a\<br>
>+ machine that is being used in production. \<br>
>+ This disables the machine from displaying errors and warnings. \<br>
>+ Secret keys, backend passwords and the path or location to the \<br>
>+ database is also set here"""<br>
</blockquote>
If I like having lines below 80 characters, I disagree with the use of '\' in<br>
documentation.<br></blockquote></div></blockquote>I had used multilines cause of coding standards at pep8. I think not more than 75 characters a line.<div>Kindly do advice on what rule of thumb we should follow for us.</div>
<div>I am not too sure what to use instead of the "\" . Kindly do advice on that.</div><div><br></div><div>Also thank you so much for being such a great team. </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div class="im"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
When generating the documentation using sphinx or something else, they will most<br>
likely appear and they just decrease the readibility (at least imo).<br>
</blockquote>
<br></div>
Agree. Multiline docstring count with multilines, so there is no need to put backslash at the end.<div class=""><div class="h5"><br>
<br>
-- <br>
Miroslav Suchy, RHCE, RHCDS<br>
Red Hat, Software Engineer, #brno, #devexp, #fedora-buildsys<br>
______________________________<u></u>_________________<br>
copr-devel mailing list<br>
<a href="mailto:copr-devel@lists.fedorahosted.org" target="_blank">copr-devel@lists.fedorahosted.<u></u>org</a><br>
<a href="https://lists.fedorahosted.org/mailman/listinfo/copr-devel" target="_blank">https://lists.fedorahosted.<u></u>org/mailman/listinfo/copr-<u></u>devel</a><br>
</div></div></blockquote></div><br></div></div>