Tutorial Python - Starship

Aceste funcţii sunt restrânse sintactic la o singură expresie:
>>> def make_incrementor(n):
... return lambda x, incr=n: x+incr
...
>>> f = make_incrementor(42)
>>> f(0)
42
>>> f(1)
43
>>>
4.7.6 Şirurile de documentaţie
Există anumite convenţii privind conţinutul şi formatarea şirurilor de documentaţie.
Prima linie ar trebui să fie scurtă şi foarte concisă. Pentru concizie nu ar trebui precizat numele obiectivului sau
tipul, acestea fiind subînţelese. Această linie trebuie să înceapă cu literă mare şi să se termine cu virgulă.
Dacă există mai multe linii, cea de-a doua ar trebui să fie vidă, pentru a separa descrierea scurtă de cea amănunţită.
Următoarele linii ar trebui să descrie mai pe larg obiectul, semnificaţia parametrilor, etc.
Interpretorul Python ia în consideraţie spaţiile din şirurile de caractere împărţite pe mai multe linii, din această
cauză pentru a avea o documentaţie aranjată ”frumos” trebuie să vă folosiţi de un mic ”truc” la fel ca în exemplul
următor:
>>> def my_function():
... " " "Nu face decat documentarea.
...
... Chiar nu face nimic!
... " " "
... pass
...
>>> print my_function.__doc__
Nu face decat documentarea.
Chiar nu face nimic!
26 Capitolul 4. Structuri de control