xrefs wip

Author: ramalho

print/xrefs/formatos.adoc

@@ -0,0 +1,65 @@
+== Formatos de xref
+
+=== Xrefs dentro do volume
+
+==== Alvo: capítulo
+
+Ex cap01:
+
+[source, asciidoctor]
+----
+<<ch_sequences>>
+----
+
+Saída:
+
+Capítulo 2
+
+==== Alvo: seção
+
+Ex cap02:
+
+[source, asciidoctor]
+----
+<<sequence_patterns_sec>>
+----
+
+Saída:
+
+Seção 2.6
+
+=== Xrefs outro volume
+
+==== Alvo: capítulo
+
+Ex cap.1, l.745:
+
+[source, asciidoctor]
+----
+<<ch_seq_methods>>
+----
+
+Saída:
+
+Capítulo 12 [vol.2, fpy.li/xyz]
+
+Onde fpy.li/xyz direciona para:
+
+https://pythonfluente.com/2/#ch_seq_methods
+
+==== Alvo: seção
+
+Ex. cap05, l.42
+
+[source, asciidoctor]
+----
+Veremos mais sobre isso na <<typeddict_sec>> (<<ch_more_types>>).
+----
+
+Saída:
+
+Veremos mais sobre isso na Seção 15.3 [vol.2, fpy.li/xyz].
+
+Onde fpy.li/xyz direciona para:
+
+https://pythonfluente.com/2/#typeddict_sec

print/xrefs/invalid-xrefs.txt

@@ -1,7 +1,5 @@
 asciidoctor: INFO: possible invalid reference: ch_ifaces_prot_abc
 asciidoctor: INFO: possible invalid reference: ch_ifaces_prot_abc
-asciidoctor: INFO: possible invalid reference: iter_closer_look_sec
-asciidoctor: INFO: possible invalid reference: ch_generators
 asciidoctor: INFO: possible invalid reference: ch_op_overload
 asciidoctor: INFO: possible invalid reference: ch_generators
 asciidoctor: INFO: possible invalid reference: ch_generators
@@ -54,6 +52,7 @@ asciidoctor: INFO: possible invalid reference: ch_more_types
 asciidoctor: INFO: possible invalid reference: ch_descriptors
 asciidoctor: INFO: possible invalid reference: ch_inheritance
 asciidoctor: INFO: possible invalid reference: ch_inheritance
+asciidoctor: INFO: possible invalid reference: ch_inheritance
 asciidoctor: INFO: possible invalid reference: positional_pattern_implement_sec
 asciidoctor: INFO: possible invalid reference: ch_async
 asciidoctor: INFO: possible invalid reference: runtime_annot_sec

vol1/cap02.adoc

@@ -55,7 +55,7 @@ sequências, contrastando contêineres e sequências planas.
 
 * Ressalvas sobre tuplas com elementos mutáveis, e como detectá-los se necessário.
 
-Movi a discussão sobre tuplas nomeadas para a <<classic_named_tuples_sec>> (<<ch_dataclass>>),
+Movi a discussão sobre tuplas nomeadas para a <<classic_named_tuples_sec>>,
 onde elas são comparadas com `typing.NamedTuple` e `@dataclass`.
 
 [NOTE]

vol1/cap08.adoc

@@ -2064,7 +2064,7 @@ Apesar de `int` ser _subtipo-de_ `float`, no `Callable` parametrizado a relaçã
 `Callable[[float], None]` é _subtipo-de_ `Callable[[int], None]`.
 Assim dizemos que aquele `Callable` é _contravariante_ a respeito dos tipos de parâmetros declarados.
 
-A <<variance_sec>> no <<ch_more_types>> explica variância em mais detalhes e
+A <<variance_sec>> explica variância em mais detalhes e
 com exemplos de tipos invariantes, covariantes e contravariantes.
 
 [TIP]