Skip to content

Commit

Permalink
Sync more part of documentation with EN
Browse files Browse the repository at this point in the history
  • Loading branch information
Girgias committed Oct 24, 2024
1 parent 3f1a443 commit 8399348
Show file tree
Hide file tree
Showing 27 changed files with 232 additions and 219 deletions.
5 changes: 3 additions & 2 deletions language/context/parameters.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5faa7a6747bca628b3bdcc9f93aec5603b65581f Maintainer: cucinato Status: ready -->
<!-- EN-Revision: 8bc832a464e33122e8129f5a623bd845b69fa7e0 Maintainer: cucinato Status: ready -->

<refentry xml:id="context.params" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">
<refnamediv>
Expand Down Expand Up @@ -29,7 +29,8 @@
Una funzione <type>callable</type> chiamata quando un evento si manifesta in uno stream.
</para>
<para>
Vedere <function>stream_notification_callback</function> per maggiori informazioni.
Vedere <link linkend="function.stream-notification-callback">
stream_notification_callback</link> per maggiori informazioni.
</para>
</listitem>
</varlistentry>
Expand Down
4 changes: 2 additions & 2 deletions language/types/float.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d494ffa4d9f83b60fe66972ec2c0cf0301513b4a Maintainer: pastore Status: ready -->
<!-- EN-Revision: a1e3d629b4f01ee41bd38391cd5c6ae5ee894cb3 Maintainer: pastore Status: ready -->
<!-- CREDITS: SvenHolmgren -->
<sect1 xml:id="language.types.float" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Numeri floating point</title>
Expand Down Expand Up @@ -30,7 +30,7 @@ $d = 1_234.567; // a partire da PHP 7.4.0
<programlisting>
<![CDATA[
LNUM [0-9]+(_[0-9]+)*
DNUM ([0-9]*(_[0-9]+)*[\.]{LNUM}) | ({LNUM}[\.][0-9]*(_[0-9]+)*)
DNUM ({LNUM}?"."{LNUM}) | ({LNUM}"."{LNUM}?)
EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM})
]]>
</programlisting>
Expand Down
4 changes: 2 additions & 2 deletions reference/dbase/functions/dbase-open.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: pastore Status: ready -->
<!-- EN-Revision: 0545e305cf06937b14b3f0694d6e716c9881ffd7 Maintainer: pastore Status: ready -->
<!-- CREDITS: calandra, fernando -->
<refentry xml:id="function.dbase-open" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -77,7 +77,7 @@
</thead>
<tbody>
<row>
<entry>dbase 7.0.0</entry>
<entry>PECL dbase 7.0.0</entry>
<entry>
Il valore restituito è ora una <type>resource</type> invece di un
<type>int</type>.
Expand Down
7 changes: 3 additions & 4 deletions reference/filesystem/functions/chgrp.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dec1f8445ab2af7fbafef012fb7907ab2cd349b5 Maintainer: pastore Status: ready -->
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: pastore Status: ready -->
<!-- CREDITS: cortesi,fernando -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.chgrp">
<refentry xml:id="function.chgrp" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>chgrp</refname>
<refpurpose>Cambia il gruppo del file</refpurpose>
Expand All @@ -12,7 +12,7 @@
<methodsynopsis>
<type>bool</type><methodname>chgrp</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam><type>mixed</type><parameter>group</parameter></methodparam>
<methodparam><type class="union"><type>string</type><type>int</type></type><parameter>group</parameter></methodparam>
</methodsynopsis>
<para>
Tenta di cambiare il gruppo del file <parameter>filename</parameter>
Expand Down Expand Up @@ -97,7 +97,6 @@ printf($format, $filename, date('r'), filegroup($filename));
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
14 changes: 7 additions & 7 deletions reference/filesystem/functions/fread.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: c4c0f7fc58a2d5d5f892bc03f2e9f5db7dbfc63a Maintainer: fernando Status: working -->
<!-- EN-Revision: ae5b5761e220b355014d0845e060ea1669befe7a Maintainer: fernando Status: working -->
<refentry xml:id="function.fread" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>fread</refname>
Expand All @@ -9,14 +9,14 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>fread</methodname>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<type class="union"><type>string</type><type>false</type></type><methodname>fread</methodname>
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
<methodparam><type>int</type><parameter>length</parameter></methodparam>
</methodsynopsis>
<para>
<function>fread</function> legge fino a
<parameter>length</parameter> byte dal puntatore al file
indicato da <parameter>handle</parameter>. La lettura finisce quando una
indicato da <parameter>stream</parameter>. La lettura finisce quando una
delle seguenti condizioni è raggiunta:
<itemizedlist>
<listitem>
Expand Down Expand Up @@ -52,7 +52,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>handle</parameter></term>
<term><parameter>stream</parameter></term>
<listitem>
&fs.file.pointer;
</listitem>
Expand Down Expand Up @@ -132,7 +132,6 @@ fclose($handle);
<programlisting role="php">
<![CDATA[
<?php
// For PHP 5 and up
$handle = fopen("http://www.example.com/", "rb");
$contents = stream_get_contents($handle);
fclose($handle);
Expand Down Expand Up @@ -192,13 +191,14 @@ fclose($handle);
<member><function>fscanf</function></member>
<member><function>file</function></member>
<member><function>fpassthru</function></member>
<member><function>fseek</function></member>
<member><function>ftell</function></member>
<member><function>rewind</function></member>
<member><function>unpack</function></member>
</simplelist>
</para>
</refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
12 changes: 6 additions & 6 deletions reference/filesystem/functions/is-dir.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dec1f8445ab2af7fbafef012fb7907ab2cd349b5 Maintainer: cucinato Status: ready -->
<!-- EN-Revision: 871a231f4a1caa5fb258ae53b1bb7d1fb2a0f949 Maintainer: cucinato Status: ready -->
<!-- Credits: cortesi -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-dir">
<refnamediv>
Expand Down Expand Up @@ -47,6 +47,11 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&fs.emits.warning.on.failure;
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down Expand Up @@ -74,11 +79,6 @@ bool(true)
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&fs.emits.warning.on.failure;
</refsect1>

<refsect1 role="notes">
&reftitle.notes;
&note.clearstatcache;
Expand Down
25 changes: 12 additions & 13 deletions reference/filesystem/functions/move-uploaded-file.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dec1f8445ab2af7fbafef012fb7907ab2cd349b5 Maintainer: pastore Status: ready -->
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: pastore Status: ready -->
<!-- CREDITS: cortesi -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.move-uploaded-file">
<refentry xml:id="function.move-uploaded-file" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>move_uploaded_file</refname>
<refpurpose>Sposta un file caricato in una nuova posizione</refpurpose>
Expand All @@ -11,15 +11,15 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>move_uploaded_file</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam><type>string</type><parameter>destination</parameter></methodparam>
<methodparam><type>string</type><parameter>from</parameter></methodparam>
<methodparam><type>string</type><parameter>to</parameter></methodparam>
</methodsynopsis>
<para>
Questa funzione verifica che il file indicato da
<parameter>filename</parameter> sia un file caricato correttamente (nel senso
<parameter>from</parameter> sia un file caricato correttamente (nel senso
che è stato caricato attraverso il meccanismo di caricamento HTTP POST di PHP). Se
il file è valido, verrà spostato nel file dato da
<parameter>destination</parameter>.
<parameter>to</parameter>.
</para>
<para>
Questo tipo di verifica è particolarmente importante se sussiste la possibilità
Expand All @@ -34,15 +34,15 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<term><parameter>from</parameter></term>
<listitem>
<para>
Il nome del file caricato.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>destination</parameter></term>
<term><parameter>to</parameter></term>
<listitem>
<para>
La destinazione del file spostato.
Expand All @@ -59,13 +59,13 @@
Restituisce &true; in caso di successo.
</para>
<para>
Se <parameter>filename</parameter> non è un file caricato valido,
Se <parameter>from</parameter> non è un file caricato valido,
allora non verrà compiuta alcuna azione e
<function>move_uploaded_file</function> restituirà
&false;.
</para>
<para>
Se <parameter>filename</parameter> è un file caricato valido, ma
Se <parameter>from</parameter> è un file caricato valido, ma
non può essere spostato per qualche ragione, non verrà compiuto alcunchè e
<function>move_uploaded_file</function> restituirà
&false;. In più verrà emesso un avviso.
Expand Down Expand Up @@ -104,8 +104,8 @@ foreach ($_FILES["pictures"]["error"] as $key => $error) {
<function>move_uploaded_file</function> prende in considerazione
<link linkend="ini.open-basedir">open_basedir</link>.
Tuttavia, le restrizioni sono poste solo sul
percorso definito da <parameter>destination</parameter> per consentire lo spostamento
dei file caricati in cui <parameter>filename</parameter> potrebbe entrare in conflitto
percorso definito da <parameter>to</parameter> per consentire lo spostamento
dei file caricati in cui <parameter>from</parameter> potrebbe entrare in conflitto
con tali restrizioni. <function>move_uploaded_file</function> garantisce
la sicurezza di questa operazione consentendo lo spostamento solo dei file
caricati tramite PHP.
Expand All @@ -129,7 +129,6 @@ foreach ($_FILES["pictures"]["error"] as $key => $error) {
</para>
</refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
7 changes: 3 additions & 4 deletions reference/filesystem/functions/popen.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5222a1c1ed96c34b5cfe00b2e5af451fcd587ef2 Maintainer: pastore Status: ready -->
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: pastore Status: ready -->
<!-- CREDITS: cortesi, fernando -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.popen">
<refentry xml:id="function.popen" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>popen</refname>
<refpurpose>Apre un puntatore ad un file di processo</refpurpose>
Expand All @@ -10,7 +10,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>popen</methodname>
<type class="union"><type>resource</type><type>false</type></type><methodname>popen</methodname>
<methodparam><type>string</type><parameter>command</parameter></methodparam>
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
Expand Down Expand Up @@ -129,7 +129,6 @@ pclose($handle);
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
10 changes: 5 additions & 5 deletions reference/filesystem/functions/rmdir.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dec1f8445ab2af7fbafef012fb7907ab2cd349b5 Maintainer: pastore Status: ready -->
<!-- EN-Revision: ea62fb83196997032641b50fe44420305466195e Maintainer: pastore Status: ready -->
<!-- CREDITS: cortesi -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.rmdir">
<refnamediv>
Expand All @@ -11,11 +11,11 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>rmdir</methodname>
<methodparam><type>string</type><parameter>dirname</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Tenta di rimuovere la directory denominata <parameter>dirname</parameter>.
Tenta di rimuovere la directory denominata <parameter>directory</parameter>.
La directory deve essere vuota e le relative autorizzazioni devono consentirlo.
In caso di errore, verrà generato un errore di livello <constant>E_WARNING</constant>.
</para>
Expand All @@ -26,7 +26,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>dirname</parameter></term>
<term><parameter>directory</parameter></term>
<listitem>
<para>
Percorso della directory.
Expand Down
4 changes: 2 additions & 2 deletions reference/filesystem/ini.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: pastore Status: ready -->
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: pastore Status: ready -->
<!-- CREDITS: cucinato -->
<section xml:id="filesystem.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
Expand Down Expand Up @@ -51,7 +51,7 @@
<entry><link linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link></entry>
<entry>"0"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
<entry>Deprecato a partire da PHP 8.1.0.</entry>
</row>
<row>
<entry><link linkend="ini.sys-temp-dir">sys_temp_dir</link></entry>
Expand Down
9 changes: 7 additions & 2 deletions reference/info/functions/get-magic-quotes-gpc.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5e6356373cdbfcefcbecddf3cfd7e61a2159153e Maintainer: pastore Status: ready -->
<!-- EN-Revision: 62aa2694baf7fe904744a9b0f8a2a26e7fc3cf12 Maintainer: pastore Status: ready -->
<!-- CREDITS: darvina -->
<refentry xml:id="function.get-magic-quotes-gpc" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -14,14 +14,19 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>get_magic_quotes_gpc</methodname>
<type>false</type><methodname>get_magic_quotes_gpc</methodname>
<void/>
</methodsynopsis>
<para>
Restituisce sempre &false;.
</para>
</refsect1>

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

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Expand Down
Loading

0 comments on commit 8399348

Please sign in to comment.