cap14: paginação

Author: ramalho

online/cap08.adoc

@@ -15,7 +15,7 @@ Dicas de tipo((("functions, type hints in",
 foram a maior mudança na história de Python desde
 https://fpy.li/descr101[a unificação de tipos e classes]
 no Python 2.2, lançado em 2001.
-Entretanto, as dicas de tipo não beneficiam igualmente a todos as pessoas que usam Python.
+Entretanto, as dicas de tipo não beneficiam igualmente todas as pessoas que usam Python.
 Por isso deverão ser sempre opcionais.
 
 A

online/cap14.adoc

@@ -680,8 +680,8 @@ caso contrário os métodos chamados seriam os de `UserDict`.
 a sintaxe da instrução `class`, que precisa ter um corpo.
 
 
-Aqui estão alguns doctests de
-https://fpy.li/14-11[_uppermixin.py_], para `UpperDict`:
+Aqui estão alguns doctests de `UpperDict`, do módulo
+https://fpy.li/14-11[_uppermixin.py_]:
 
 [source, python]
 ----
@@ -739,14 +739,14 @@ mencionado, o Java 8 permite que interfaces também forneçam implementações d
 métodos. Esse novo recurso é chamado https://fpy.li/14-12[_Default Methods_]
 (Métodos Default) no Tutorial oficial de Java.]
 
-A documentação oficial de Python para
+A documentação oficial do pacote
 https://fpy.li/6z[`collections.abc`]
-usa o termo _mixin method_ (método mixin) para os métodos concretos
-implementados em muitas das coleções nas ABCs. As ABCs que oferecem métodos
+chama de _mixin methods_ (métodos mixin) os métodos concretos
+implementados nas ABCs de coleções. As ABCs que oferecem métodos
 mixin cumprem dois papéis: elas são definições de interfaces e também classes
 mixin. Por exemplo, a
-https://fpy.li/14-14[implementação de `collections.UserDict`] recorre a
-vários dos métodos mixim fornecidos por `collections.abc.MutableMapping`.
+https://fpy.li/14-14[«implementação»] de `collections.UserDict` aproveita
+vários dos métodos mixin fornecidos por `collections.abc.MutableMapping`.
 
 ==== ThreadingMixIn e ForkingMixIn
 
@@ -901,8 +901,9 @@ então ela implementa apenas `get`. Se uma requisição HTTP `POST` é enviada p
 uma `TemplateView`, o método herdado `View.dispatch` verifica que não há um
 método de tratamento para `post`, e produz uma resposta HTTP `405 Method Not
 Allowed`.footnote:[Se você gosta de padrões de projetos, note que o mecanismo de
-despacho do Django é uma variação dinâmica do padrão https://fpy.li/75[Template
-Method (_Método Template_]. Ele é dinâmico porque a classe `View` não obriga
+despacho do Django é uma variação dinâmica do padrão
+https://fpy.li/75[_Template Method_] (Método Template).
+Ele é dinâmico porque a classe `View` não obriga
 subclasses a implementarem todos os métodos de tratamento, mas `dispatch`
 verifica, durante a execução, se um método de tratamento concreto está
 disponível para cada requisição específica.]
@@ -970,7 +971,7 @@ próxima seção.
 
 Usei parte da
 hierarquia de componentes do Tkinter para ilustrar a MRO na
-<<tkwidgets_mro_uml>>. A <<tkinter_uml>> mostra todos as classes de componentes
+<<tkwidgets_mro_uml>>. A <<tkinter_uml>> mostra todas as classes de componentes
 no pacote base `tkinter` (há mais componentes gráficos no subpacote
 https://fpy.li/77[`tkinter.ttk`]).
 

vol2/README.md

@@ -15,5 +15,5 @@ e faço as demais tarefas nestas cópias especiais para impressão.
 |✅ |✅ |✅ |✅ |✅ |✅ |✅ |✅ |`/vol2`| refazer referências entre volumes|
 |✅ |✅ |✅ |✅ |✅ |✅ |✅ |✅ |`/vol2`| encurtar links entre volumes |
 |✅ |✅ |✅ |✅ |✅ |✅ |✅ |✅ |`/vol2`| exibir capítulo alvo em xrefs para exemplos de outros capítulos |
-|✅ |✅ |✅ |✅ |✅ |   |   |   |`/vol2`| rever paginação   |
+|✅ |✅ |✅ |✅ |✅ |✅ |   |   |`/vol2`| rever paginação   |
 

vol2/cap13.adoc

@@ -1693,8 +1693,8 @@ possíveis.footnote:[Concordo que `double()` não é muito útil, exceto como um
 Mas a biblioteca padrão de Python tem muitas funções que não poderiam ser
 anotadas de modo apropriado antes dos protocolos estáticos serem adicionados, no
 Python 3.8. Ajudei a corrigir alguns bugs no _typeshed_ acrescentando dicas de
-tipo com protocolos. Por exemplo, no _pull request_ que consertou
-https://fpy.li/shed4051[_Should Mypy warn about potential invalid arguments to`max`?_]
+tipo com protocolos. Por exemplo, no _pull request_ onde consertei
+https://fpy.li/shed4051[_Should Mypy warn about potential invalid arguments to `+max+`?_]
 (Deveria o Mypy avisar sobre argumentos potencialmente inválidos passados a `max`?)
 defini um protocolo `_SupportsLessThan`, que usei para melhorar
 as anotações de `max`, `min`, `sorted`, e `list.sort`.]
@@ -2012,7 +2012,7 @@ para a presença ou ausência de métodos, sem checar sequer suas assinaturas,
 muito menos suas anotações de tipo. E isso não vai mudar tão cedo, porque este
 tipo de checagem de tipos durante a execução traria um custo de processamento
 inaceitável.footnote:[Agradeço a Ivan Levkivskyi, co-autor da
-https://fpy.li/pep544[PEP 544] (sobre protocolos), por apontar que checagem de
+https://fpy.li/pep544[«PEP 544 (sobre protocolos)»], por apontar que checagem de
 tipo não é apenas uma questão de checar se o tipo de `x` é `T`: é sobre
 determinar que o tipo de `x` é _consistente-com_ `T`, o que pode ser custoso.
 Não é de se espantar que o Mypy leve alguns segundos para fazer uma checagem
@@ -2722,7 +2722,7 @@ certeza de que um objeto `str` terá sempre os mesmos métodos. Esta limitação
 a chance de bibliotecas aplicarem correções conflitantes quando importadas em
 seu projeto.
 
-**Metáforas e idiomas em interfaces**
+**Metáforas e _idioms_ em interfaces**
 
 Uma((("Soapbox sidebars", "interfaces"))) metáfora promove o entendimento
 tornando restrições e acessos visíveis. Esse é o valor das palavras _stack_
@@ -2752,11 +2752,17 @@ lugar "interfaces idiomáticas", foi a lição mais valiosa que aprendi com o
 trabalho de Cooper.
 
 Em _About Face_, Cooper não lida com APIs, mas quanto mais penso em suas ideias,
-mais vejo como se aplicam ao Python. Os protocolos fundamentais da linguagem são
-o que Cooper chama de "idiomas." Uma vez que aprendemos o que é uma "sequência",
-podemos aplicar esse conhecimento em diferentes contextos. Esse é o tema
-principal de _Python Fluente_: ressaltar os idiomas fundamentais da linguagem,
-para que o seu código seja conciso, efetivo e legível para um pythonista
+mais vejo como se aplicam ao Python. Cada protocolo fundamental da linguagem é
+o que Cooper chama de _idiom_ (idiomatismo).footnote:[Neste contexto,
+a tradução correta de _idiom_ não é "idioma", mas sim "idiomatismo" que é uma
+"construção ou locução peculiar a uma língua".
+Cooper defende que uma GUI
+é uma linguagem com locuções peculiares, como menus e caixas de diálogo.]
+
+Uma vez que aprendemos o que é uma "sequência",
+podemos aplicar este conhecimento em diferentes contextos. Este é o tema
+principal de _Python Fluente_: ressaltar os idiomatismos fundamentais da linguagem,
+para que o seu código seja conciso, eficaz e legível para um pythonista
 fluente.((("", startref="ABCsoap13")))((("", startref="Psoap13")))((("",
 startref="Isoap13")))