Skip to content

Commit

Permalink
Partial sync yaml docs with EN
Browse files Browse the repository at this point in the history
  • Loading branch information
Girgias committed Nov 30, 2023
1 parent 17571b9 commit 14579d3
Show file tree
Hide file tree
Showing 6 changed files with 39 additions and 46 deletions.
12 changes: 6 additions & 6 deletions reference/yaml/book.xml
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: chuso Status: ready -->
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: chuso Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->

<book xml:id="book.yaml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="pecl" ?>
<title>Serialización de datos YAML</title>
<titleabbrev>Yaml</titleabbrev>
<titleabbrev>Yaml</titleabbrev>

<!-- {{{ preface -->
<preface xml:id="intro.yaml">
&reftitle.intro;
Expand All @@ -18,13 +18,13 @@
</para>
</preface>
<!-- }}} -->

&reference.yaml.setup;
&reference.yaml.constants;
&reference.yaml.examples;
&reference.yaml.callbacks;
&reference.yaml.reference;

</book>

<!-- Keep this comment at the end of the file
Expand Down
9 changes: 4 additions & 5 deletions reference/yaml/callbacks.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 18046e022443b3e8a21088f7a2c850158d03f510 Maintainer: edwincartagenah Status: ready -->
<!-- EN-Revision: 80872147aa52367137bd3d168412f70cbe2ddf9c Maintainer: edwincartagenah Status: ready -->
<!-- Reviewed: yes -->

<chapter xml:id="yaml.callbacks" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
Expand All @@ -9,11 +8,11 @@
<section xml:id="yaml.callbacks.parse">
<title>Análisis de callbacks</title>
<para>
Los análisis de <type>callbacks</type> son invocados por las funciones
Los análisis de <type>callable</type>s son invocados por las funciones
<function>yaml_parse</function>, <function>yaml_parse_file</function> o
<function>yaml_parse_url</function> cuando encuentran una etiqueta YAML
<function>yaml_parse_url</function> cuando encuentran una etiqueta YAML
registrada. Al callback se le pasa el valor de la entidad de la etiqueta, la etiqueta,
y los flags que indican el estilo escalar de la entidad. El callback debe
y los flags que indican el estilo escalar de la entidad. El callback debe
devolver los datos que el convertidor YAML debe emitir para esta entidad.
</para>
<example>
Expand Down
41 changes: 20 additions & 21 deletions reference/yaml/constants.xml
Original file line number Diff line number Diff line change
@@ -1,21 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4de5cce5d886bf7ea08db8583141ff9715b47073 Maintainer: julionc Status: ready -->
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: julionc Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->

<appendix xml:id="yaml.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&extension.constants;
<para>
</para>

<variablelist xml:id="yaml.constants.style">
<title>Estilos de entidad escalar utilizables por los métodos
de retrollamada de <function>yaml_parse</function></title>
<varlistentry xml:id="constant.yaml-any-scalar-style">
<term>
<constant>YAML_ANY_SCALAR_STYLE</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -25,7 +24,7 @@
<varlistentry xml:id="constant.yaml-plain-scalar-style">
<term>
<constant>YAML_PLAIN_SCALAR_STYLE</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -35,7 +34,7 @@
<varlistentry xml:id="constant.yaml-single-quoted-scalar-style">
<term>
<constant>YAML_SINGLE_QUOTED_SCALAR_STYLE</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -45,7 +44,7 @@
<varlistentry xml:id="constant.yaml-double-quoted-scalar-style">
<term>
<constant>YAML_DOUBLE_QUOTED_SCALAR_STYLE</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -55,7 +54,7 @@
<varlistentry xml:id="constant.yaml-literal-scalar-style">
<term>
<constant>YAML_LITERAL_SCALAR_STYLE</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -65,15 +64,15 @@
<varlistentry xml:id="constant.yaml-folded-scalar-style">
<term>
<constant>YAML_FOLDED_SCALAR_STYLE</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>

<variablelist xml:id="yaml.constants.tag">
<title>Etiquetas comunes utilizables por los métodos
de retrollamada de <function>yaml_parse</function>.</title>
Expand Down Expand Up @@ -177,13 +176,13 @@
</listitem>
</varlistentry>
</variablelist>

<variablelist xml:id="yaml.constants.encoding">
<title>Tipos de codificación para <function>yaml_emit</function></title>
<varlistentry xml:id="constant.yaml-any-encoding">
<term>
<constant>YAML_ANY_ENCODING</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -194,7 +193,7 @@
<varlistentry xml:id="constant.yaml-utf8-encoding">
<term>
<constant>YAML_UTF8_ENCODING</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -205,7 +204,7 @@
<varlistentry xml:id="constant.yaml-utf16le-encoding">
<term>
<constant>YAML_UTF16LE_ENCODING</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -216,7 +215,7 @@
<varlistentry xml:id="constant.yaml-utf16be-encoding">
<term>
<constant>YAML_UTF16BE_ENCODING</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -225,13 +224,13 @@
</listitem>
</varlistentry>
</variablelist>

<variablelist xml:id="yaml.constants.break">
<title>Tipos de saltos de línea para <function>yaml_emit</function></title>
<varlistentry xml:id="constant.yaml-any-break">
<term>
<constant>YAML_ANY_BREAK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -242,7 +241,7 @@
<varlistentry xml:id="constant.yaml-cr-break">
<term>
<constant>YAML_CR_BREAK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -253,7 +252,7 @@
<varlistentry xml:id="constant.yaml-ln-break">
<term>
<constant>YAML_LN_BREAK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -264,7 +263,7 @@
<varlistentry xml:id="constant.yaml-crln-break">
<term>
<constant>YAML_CRLN_BREAK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -273,7 +272,7 @@
</listitem>
</varlistentry>
</variablelist>

</appendix>

<!-- Keep this comment at the end of the file
Expand Down
5 changes: 2 additions & 3 deletions reference/yaml/functions/yaml-emit-file.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: andresdzphp Status: ready -->
<!-- EN-Revision: af5f2f87b3b0bb9ee0f83ccb787a4e7db1eb6bd4 Maintainer: andresdzphp Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->

<refentry xml:id="function.yaml-emit-file" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
Expand Down Expand Up @@ -105,7 +104,7 @@
</thead>
<tbody>
<row>
<entry>1.1.0</entry>
<entry>PECL yaml 1.1.0</entry>
<entry>
El parámetro <parameter>callbacks</parameter> fue añadido.
</entry>
Expand Down
7 changes: 3 additions & 4 deletions reference/yaml/functions/yaml-emit.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: julionc Status: ready -->
<!-- EN-Revision: af5f2f87b3b0bb9ee0f83ccb787a4e7db1eb6bd4 Maintainer: julionc Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->

<refentry xml:id="function.yaml-emit" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
Expand Down Expand Up @@ -81,7 +80,7 @@
Devuelve un <type>string</type> de YAML codificado si es correcto.
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
Expand All @@ -95,7 +94,7 @@
</thead>
<tbody>
<row>
<entry>1.1.0</entry>
<entry>PECL yaml 1.1.0</entry>
<entry>
Se añadió el parámetro <parameter>callbacks</parameter>.
</entry>
Expand Down
11 changes: 4 additions & 7 deletions reference/yaml/setup.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: julionc Status: ready -->
<!-- EN-Revision: ebf03a722429cb7b3836c80ce5046f5acc91d2da Maintainer: julionc Status: ready -->
<!-- Reviewed: no -->

<chapter xml:id="yaml.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
Expand All @@ -9,7 +9,7 @@
&reftitle.required;
<para>
Esta extensión requiere la <link xlink:href="&url.yaml.libyaml;">LibYAML C
library</link> versión 0.1.0 o superior instalada.
library</link> versión 0.1.0 o superior instalada.
</para>
</section>

Expand All @@ -20,10 +20,7 @@
</para>
<para>
&pecl.info;
<link xlink:href="&url.pecl.package;yaml">&url.pecl.package;yaml</link>.
</para>
<para>
&pecl.windows.download;
<link xlink:href="&url.pecl.package;yaml">&url.pecl.package;yaml</link>.
</para>
</section>

Expand Down

0 comments on commit 14579d3

Please sign in to comment.