Skip to content

Commit

Permalink
Sync part of POSIX docs with EN to improve build situation
Browse files Browse the repository at this point in the history
  • Loading branch information
Girgias committed Nov 8, 2024
1 parent c23a64f commit 0854cf0
Show file tree
Hide file tree
Showing 33 changed files with 328 additions and 329 deletions.
9 changes: 4 additions & 5 deletions reference/posix/configure.xml
Original file line number Diff line number Diff line change
@@ -1,12 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: lboshell Status: ready -->
<!-- EN-Revision: a7d56396b4b04d83871e084371cd6c6fecdafaa8 Maintainer: lboshell Status: ready -->
<!-- Reviewed: yes -->
<section xml:id="posix.installation" xmlns="http://docbook.org/ns/docbook">
&reftitle.install;
<para>
Las funciones POSIX son habilitadas por defecto. Puede deshabilitar
las funciones tipo POSIX con <option
role="configure">--disable-posix</option>.
&installation.enabled.disable;
<option role="configure">--disable-posix</option>
</para>
</section>

Expand Down
16 changes: 5 additions & 11 deletions reference/posix/functions/posix-access.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: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: 8d417bd83842efbde90dbb51c31f99f474437ce4 Maintainer: yago Status: ready -->
<refentry xml:id="function.posix-access" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>posix_access</refname>
Expand All @@ -12,8 +11,8 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>posix_access</methodname>
<methodparam><type>string</type><parameter>file</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>POSIX_F_OK</initializer></methodparam>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<function>posix_access</function> verifica el permiso del usuario sobre un archivo.
Expand All @@ -25,15 +24,15 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>file</parameter></term>
<term><parameter>filename</parameter></term>
<listitem>
<para>
El nombre del archivo a ser probado.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<term><parameter>flags</parameter></term>
<listitem>
<para>
Una máscara consistente de uno o más de los valores <constant>POSIX_F_OK</constant>,
Expand Down Expand Up @@ -91,10 +90,6 @@ if (posix_access($archivo, POSIX_R_OK | POSIX_W_OK)) {
</para>
</refsect1>

<refsect1 role="notes">
&reftitle.notes;
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand All @@ -106,7 +101,6 @@ if (posix_access($archivo, POSIX_R_OK | POSIX_W_OK)) {
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
21 changes: 12 additions & 9 deletions reference/posix/functions/posix-ctermid.xml
Original file line number Diff line number Diff line change
@@ -1,26 +1,30 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<!-- EN-Revision: f8854f6a6a7907720ed8ec8657a2f466a82c0394 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.posix-ctermid" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>posix_ctermid</refname>
<refpurpose>Obtener el nombre de la ruta del terminal controlador</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>posix_ctermid</methodname>
<type class="union"><type>string</type><type>false</type></type><methodname>posix_ctermid</methodname>
<void/>
</methodsynopsis>
<para>
Genera un <type>string</type> que es el nombre de la ruta del terminal
controlador actual para el proceso. En caso de error se establecerá a errno,
controlador actual para el proceso. En caso de error se establecerá a errno,
que puede ser comprobado usando <function>posix_get_last_error</function>
</para>
</refsect1>


<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Expand All @@ -29,7 +33,7 @@
errno, que puede ser comprobado con <function>posix_get_last_error</function>.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand All @@ -48,7 +52,7 @@ echo "Esto ejecutándome desde ".posix_ctermid();
</example>
</para>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand All @@ -59,7 +63,6 @@ echo "Esto ejecutándome desde ".posix_ctermid();
</para>
</refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
8 changes: 6 additions & 2 deletions reference/posix/functions/posix-get-last-error.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: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: f8854f6a6a7907720ed8ec8657a2f466a82c0394 Maintainer: yago Status: ready -->
<refentry xml:id="function.posix-get-last-error" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>posix_get_last_error</refname>
Expand All @@ -20,6 +19,11 @@
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Expand Down
17 changes: 10 additions & 7 deletions reference/posix/functions/posix-getcwd.xml
Original file line number Diff line number Diff line change
@@ -1,17 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<!-- EN-Revision: f8854f6a6a7907720ed8ec8657a2f466a82c0394 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.posix-getcwd" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>posix_getcwd</refname>
<refpurpose>Nombre de la ruta del directorio actual</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>posix_getcwd</methodname>
<type class="union"><type>string</type><type>false</type></type><methodname>posix_getcwd</methodname>
<void/>
</methodsynopsis>
<para>
Expand All @@ -21,6 +20,11 @@
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Expand Down Expand Up @@ -49,7 +53,7 @@ echo 'Mi directorio actual de trabajo es '.posix_getcwd();
</example>
</para>
</refsect1>

<refsect1 role="notes">
&reftitle.notes;
<note>
Expand All @@ -62,13 +66,12 @@ echo 'Mi directorio actual de trabajo es '.posix_getcwd();
<listitem>
<simpara>El nombre de la ruta ya no existe</simpara>
</listitem>
</itemizedlist>
</itemizedlist>
</para>
</note>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
22 changes: 13 additions & 9 deletions reference/posix/functions/posix-getegid.xml
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<!-- EN-Revision: f8854f6a6a7907720ed8ec8657a2f466a82c0394 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.posix-getegid" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>posix_getegid</refname>
<refpurpose>Devuelve el ID efectivo de grupo del proceso actual</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
Expand All @@ -18,14 +17,19 @@
Devuelve el ID efectivo de grupo efectivo numérico del proceso actual.
</para>
</refsect1>


<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un <type>integer</type> del ID del grupo efectivo.
Devuelve un <type>int</type> del ID del grupo efectivo.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand All @@ -48,7 +52,7 @@ echo 'Mi id del grupo efectivo es '.posix_getegid(); //40
</example>
</para>
</refsect1>

<refsect1 role="notes">
&reftitle.notes;
<para>
Expand All @@ -57,7 +61,7 @@ echo 'Mi id del grupo efectivo es '.posix_getegid(); //40
una llamada al proceso usando <function>posix_setegid</function>.
</para>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand All @@ -68,7 +72,7 @@ echo 'Mi id del grupo efectivo es '.posix_getegid(); //40
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Expand Down
18 changes: 11 additions & 7 deletions reference/posix/functions/posix-geteuid.xml
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<!-- EN-Revision: f8854f6a6a7907720ed8ec8657a2f466a82c0394 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.posix-geteuid" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>posix_geteuid</refname>
<refpurpose>Devolver el ID efectivo de usuario del proceso actual</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
Expand All @@ -20,14 +19,19 @@
convertirlo en un nombre de usuario utilizable.
</para>
</refsect1>


<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el id de usuario, como un valor de tipo <type>integer</type>
Devuelve el id de usuario, como un valor de tipo <type>int</type>
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand All @@ -51,7 +55,7 @@ echo posix_geteuid()."\n"; //10000
</example>
</para>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand Down
20 changes: 12 additions & 8 deletions reference/posix/functions/posix-getgid.xml
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<!-- EN-Revision: f8854f6a6a7907720ed8ec8657a2f466a82c0394 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.posix-getgid" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>posix_getgid</refname>
<refpurpose>Devuelve el ID real de grupo del proceso actual</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
Expand All @@ -18,14 +17,19 @@
Devuelve el ID real numérico de grupo del proceso actual.
</para>
</refsect1>


<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el id real de grupo, como un valor de tipo <type>integer</type>.
Devuelve el id real de grupo, como un valor de tipo <type>int</type>.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand All @@ -48,7 +52,7 @@ echo 'Mi id efectivo de grupo es '.posix_getegid(); //40
</example>
</para>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand All @@ -60,7 +64,7 @@ echo 'Mi id efectivo de grupo es '.posix_getegid(); //40
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Expand Down
Loading

0 comments on commit 0854cf0

Please sign in to comment.