cap17: revisão de estilo até linha 869

Author: ramalho

online/cap17.adoc

@@ -308,7 +308,10 @@ após ser exaurido. Para recomeçar, é necessário reconstruir o iterador,
 invocando novamente `iter()`.
 
 A https://docs.python.org/pt-br/3.10/library/functions.html#iter[documentação de
-`iter`] inclui a seguinte explicação e código de exemplo:
+`iter`] inclui a seguinte explicação e código de exemplo:footnote:[NT:
+Mudei um pouco a tradução, e
+https://github.com/python/python-docs-pt-br/issues/290[«sugeri a melhoria»] no
+repositório oficial da tradução PT-BR da documentação do Python.]
 
 [quote]
 ____
@@ -330,7 +333,7 @@ with open('mydata.db', 'rb') as f:
         process_block(block)
 ----
 
-Para deixar o código mais claro, adicionei a atribuição `read_block`, que não está no
+Para deixar o código mais fácil de ler, adicionei a atribuição `read_block`, que não está no
 https://docs.python.org/pt-br/3.10/library/functions.html#iter[«exemplo original»].
 A função `partial()` é necessária porque o invocável passado a
 `iter()` não pode requerer argumentos. No exemplo, um objeto `bytes` vazio é a
@@ -469,10 +472,10 @@ O código-fonte do módulo https://fpy.li/17-6[_Lib/types.py_] no Python 3.9 tem
 um comentário dizendo:
 
 ----
-# Iteradores no Python não são uma questão de tipo, mas sim de protocolo. Um número
-# grande e variável de tipos embutidos implementa *alguma* forma de
-# iterador.  Não verifique o tipo! Em vez disso, use `hasattr` para
-# checar [a existência] de ambos os atributos "__iter__" e "__next__".
+# Iteradores no Python não são uma questão de tipo, mas sim de protocolo.
+# Um número grande e variável de tipos embutidos implementa *alguma* forma
+# de iterador.  Não verifique o tipo! Em vez disso, use `hasattr` para
+# detectar os atributos "__iter__" e "__next__".
 ----
 
 E de fato, é exatamente o que o método `+__subclasshook__+` da ABC
@@ -853,12 +856,18 @@ virtude, pelo menos em linguagens de programação e APIs. Uma implementação
 preguiçosa adia a produção de valores até o último momento possível. Isso
 economiza memória e também pode evitar o desperdício de ciclos de CPU.
 
-Vamos criar a seguir classes `Sentence` preguiçosas.((("", startref="ITsentence17")))((("", startref="iter17")))((("", startref="sentclass17")))((("", startref="genex17")))((("", startref="yielda17")))((("", startref="Kyielda17")))
+A seguir, criaremos classes `Sentence` preguiçosas.((("",
+startref="ITsentence17")))((("", startref="iter17")))((("",
+startref="sentclass17")))((("", startref="genex17")))((("",
+startref="yielda17")))((("", startref="Kyielda17")))
 
 
 === Sentenças preguiçosas
 
-As((("iterators", "lazy sentences", id="Ilazy17")))((("generators", "lazy generators", id="Glazy17")))((("lazy sentences", id="lazysen17"))) últimas variações de `Sentence` são preguiçosas, se valendo de um função preguiçosa do módulo `re`.
+As((("iterators", "lazy sentences", id="Ilazy17")))((("generators",
+"lazy generators", id="Glazy17")))((("lazy sentences", id="lazysen17")))
+últimas variações de `Sentence` são preguiçosas, valendo-se de um
+função geradora do módulo `re`.
 
 
 ==== Sentence versão #4: um gerador preguiçoso