<p dir="ltr"><br>
On Sep 13, 2013 2:31 PM, "Frankie Onuonga" <<a href="mailto:frankie.onuonga@gmail.com">frankie.onuonga@gmail.com</a>> wrote:<br>
><br>
><br>
><br>
><br>
> On Thu, Sep 12, 2013 at 10:29 AM, Miroslav Suchý <<a href="mailto:msuchy@redhat.com">msuchy@redhat.com</a>> wrote:<br>
>><br>
>> On 09/12/2013 11:04 AM, Pierre-Yves Chibon wrote:<br>
>>>><br>
>>>> 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>
>>><br>
>>> If I like having lines below 80 characters, I disagree with the use of '\' in<br>
>>> documentation.<br>
><br>
> I had used multilines cause of coding standards at pep8. I think not more than 75 characters a line.<br>
> Kindly do advice on what rule of thumb we should follow for us.<br>
> I am not too sure what to use instead of the "\" . Kindly do advice on that.<br>
><br>
> Also thank you so much for being such a great team. </p>
<p dir="ltr">Ah, I see what the misunderstanding is. Breaking lines at 79 chars is good. How to break the lines is the only objection here. In python, triple quotes start a multiline string. So there's no need to have backslashes for continuation. You can just do this:</p>
<p dir="ltr"> """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>
[...]<br>
"""</p>
<p dir="ltr">-Toshio<br>
</p>