diff --git a/reference/enchant/entities.ent b/reference/enchant/entities.ent new file mode 100644 index 000000000..07170354d --- /dev/null +++ b/reference/enchant/entities.ent @@ -0,0 +1,31 @@ + + + + + + + + + Lanza un ValueError si + broker no es utilizable, por ejemplo si no está + inicializado o ya ha sido liberado con + enchant_broker_free. + + + + + + Lanza un ValueError si + dictionary no es utilizable, por ejemplo si no está + inicializado o ya ha sido liberado con + enchant_broker_free_dict. + + + + diff --git a/reference/enchant/functions/enchant-dict-add-to-session.xml b/reference/enchant/functions/enchant-dict-add-to-session.xml index cd8c79288..390d64a97 100644 --- a/reference/enchant/functions/enchant-dict-add-to-session.xml +++ b/reference/enchant/functions/enchant-dict-add-to-session.xml @@ -1,6 +1,6 @@ - + @@ -42,6 +42,11 @@ + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-dict-add.xml b/reference/enchant/functions/enchant-dict-add.xml index 5161f1678..44e61d98f 100644 --- a/reference/enchant/functions/enchant-dict-add.xml +++ b/reference/enchant/functions/enchant-dict-add.xml @@ -1,5 +1,5 @@ - + @@ -34,10 +34,15 @@ &reftitle.returnvalues; - &return.success; + &return.void; + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-dict-check.xml b/reference/enchant/functions/enchant-dict-check.xml index 26304bfc9..8e261d323 100644 --- a/reference/enchant/functions/enchant-dict-check.xml +++ b/reference/enchant/functions/enchant-dict-check.xml @@ -1,6 +1,6 @@ - + @@ -41,6 +41,11 @@ + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-dict-describe.xml b/reference/enchant/functions/enchant-dict-describe.xml index 15b460e06..725ca1f4a 100644 --- a/reference/enchant/functions/enchant-dict-describe.xml +++ b/reference/enchant/functions/enchant-dict-describe.xml @@ -1,5 +1,5 @@ - + @@ -27,10 +27,17 @@ &reftitle.returnvalues; - &return.success; + Devuelve un array que describe el diccionario, con las claves + lang, name, desc + y file. + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-dict-get-error.xml b/reference/enchant/functions/enchant-dict-get-error.xml index d7d8ad828..4963ee013 100644 --- a/reference/enchant/functions/enchant-dict-get-error.xml +++ b/reference/enchant/functions/enchant-dict-get-error.xml @@ -1,6 +1,6 @@ - + @@ -28,10 +28,15 @@ &reftitle.returnvalues; Devuelve el mensaje de error en forma de string, - o &false; en caso de error. + o &false; si no se produjo ningún error. + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-dict-is-added.xml b/reference/enchant/functions/enchant-dict-is-added.xml index a4d2cf0d1..a63abc464 100644 --- a/reference/enchant/functions/enchant-dict-is-added.xml +++ b/reference/enchant/functions/enchant-dict-is-added.xml @@ -1,6 +1,6 @@ - + @@ -39,6 +39,11 @@ + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-dict-quick-check.xml b/reference/enchant/functions/enchant-dict-quick-check.xml index b1d720850..6d683a217 100644 --- a/reference/enchant/functions/enchant-dict-quick-check.xml +++ b/reference/enchant/functions/enchant-dict-quick-check.xml @@ -1,6 +1,6 @@ - + @@ -16,8 +16,8 @@ arraysuggestions&null; - Devuelve &true; si la palabra está correctamente escrita, &false; si la variable de sugerencias es proporcionada, - y la llena con las sugerencias posibles. + Devuelve &true; si la palabra está correctamente escrita, &false; en caso contrario. + Si se proporciona la variable de sugerencias, se rellena con alternativas ortográficas. @@ -50,6 +50,11 @@ + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-dict-remove-from-session.xml b/reference/enchant/functions/enchant-dict-remove-from-session.xml new file mode 100644 index 000000000..2c2c3c042 --- /dev/null +++ b/reference/enchant/functions/enchant-dict-remove-from-session.xml @@ -0,0 +1,79 @@ + + + + + + + enchant_dict_remove_from_session + Elimina una palabra del diccionario de la sesión + + + &reftitle.description; + + voidenchant_dict_remove_from_session + EnchantDictionarydictionary + stringword + + + Elimina una palabra que había sido añadida previamente a la sesión actual + de corrección ortográfica mediante + enchant_dict_add_to_session. + + + + + &reftitle.parameters; + + &enchant.param.dictionary; + + word + + + La palabra a eliminar de la sesión. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + + + &reftitle.seealso; + + enchant_dict_add_to_session + enchant_dict_remove + enchant_dict_is_added_to_session + + + + diff --git a/reference/enchant/functions/enchant-dict-remove.xml b/reference/enchant/functions/enchant-dict-remove.xml new file mode 100644 index 000000000..84a06d34c --- /dev/null +++ b/reference/enchant/functions/enchant-dict-remove.xml @@ -0,0 +1,79 @@ + + + + + + + enchant_dict_remove + Añade una palabra a la lista de exclusión y la elimina del diccionario personal + + + &reftitle.description; + + voidenchant_dict_remove + EnchantDictionarydictionary + stringword + + + Añade una palabra a la lista de exclusión del diccionario dado, impidiendo + que sea aceptada como correctamente escrita. Si la palabra había sido + añadida previamente al diccionario personal, también se elimina de este. + + + + + &reftitle.parameters; + + &enchant.param.dictionary; + + word + + + La palabra a excluir. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + + + &reftitle.seealso; + + enchant_dict_add + enchant_dict_remove_from_session + enchant_dict_is_added + + + + diff --git a/reference/enchant/functions/enchant-dict-store-replacement.xml b/reference/enchant/functions/enchant-dict-store-replacement.xml index 9f93caa42..e4540574a 100644 --- a/reference/enchant/functions/enchant-dict-store-replacement.xml +++ b/reference/enchant/functions/enchant-dict-store-replacement.xml @@ -1,5 +1,5 @@ - + @@ -17,7 +17,7 @@ Añade una ortografía para misspelled utilizando correct. Tenga en cuenta que si se reemplaza @mis por @cor, entonces es probable que las futuras ocurrencias - de @mis sean reemplazadas por @cor. Así, @cor será añadido a la lista de sugerencias. + de @mis sean reemplazadas por @cor. Así, @cor podría subir de posición en la lista de sugerencias. @@ -45,10 +45,15 @@ &reftitle.returnvalues; - &return.success; + &return.void; + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-dict-suggest.xml b/reference/enchant/functions/enchant-dict-suggest.xml index 33a360b4f..5cc419a09 100644 --- a/reference/enchant/functions/enchant-dict-suggest.xml +++ b/reference/enchant/functions/enchant-dict-suggest.xml @@ -1,5 +1,5 @@ - + enchant_dict_suggest @@ -36,6 +36,11 @@ + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/session/functions/session-write-close.xml b/reference/session/functions/session-write-close.xml index f6158b716..22ae23292 100644 --- a/reference/session/functions/session-write-close.xml +++ b/reference/session/functions/session-write-close.xml @@ -1,6 +1,6 @@ - + @@ -38,9 +38,11 @@ &reftitle.returnvalues; - - &return.success; - + + Devuelve &false; si no hay ninguna sesión activa, &true; en caso contrario. + También se devuelve &true; si el gestor de almacenamiento no logra escribir + los datos de sesión. + diff --git a/reference/sockets/examples.xml b/reference/sockets/examples.xml index 0e5bb3bcf..9f37188bf 100644 --- a/reference/sockets/examples.xml +++ b/reference/sockets/examples.xml @@ -1,6 +1,6 @@ - + &reftitle.examples; @@ -46,7 +46,7 @@ if (socket_listen($sock, 5) === false) { do { if (($msgsock = socket_accept($sock)) === false) { - echo "socket_accept() falló: razón: " . socket_strerror(socket_last_error($sock)) . "\n"; + echo "socket_accept() falló: razón: " . socket_strerror(socket_last_error()) . "\n"; break; } /* Enviar instrucciones. */ diff --git a/reference/sockets/functions/socket-accept.xml b/reference/sockets/functions/socket-accept.xml index 5b42669dc..a52683644 100644 --- a/reference/sockets/functions/socket-accept.xml +++ b/reference/sockets/functions/socket-accept.xml @@ -1,6 +1,6 @@ - + @@ -14,7 +14,7 @@ Socketfalsesocket_accept Socketsocket - + Una vez que el socket socket ha sido creado con la función socket_create, vinculado a un nombre con la función socket_bind, y puesto en espera de conexión con la @@ -25,10 +25,10 @@ Si hay varias conexiones en espera, se utilizará la primera. Si no hay conexiones en espera, socket_accept se bloqueará hasta que se presente una conexión. Si - socket ha sido configurado como no bloqueante, gracias a - socket_set_blocking o - socket_set_nonblock, se devolverá &false;. - + socket ha sido configurado como no bloqueante mediante + socket_set_nonblock y no hay conexiones en espera, + se devolverá &false; sin emitir una advertencia. + La instancia de Socket devuelta por socket_accept no debe ser utilizada @@ -56,13 +56,14 @@ &reftitle.returnvalues; - + Devuelve una nueva instancia de Socket en caso de éxito o &false; en caso de error. El código de error generado puede ser obtenido llamando a la función - socket_last_error. Este código de error puede ser pasado a + socket_last_error sin ningún argumento, ya que el error + no se almacena en socket. Este código de error puede ser pasado a la función socket_strerror para obtener un mensaje de error legible por humanos. - + diff --git a/reference/sqlite3/sqlite3/busyTimeout.xml b/reference/sqlite3/sqlite3/busyTimeout.xml index f7032b776..372dadb32 100644 --- a/reference/sqlite3/sqlite3/busyTimeout.xml +++ b/reference/sqlite3/sqlite3/busyTimeout.xml @@ -1,5 +1,5 @@ - + @@ -17,6 +17,26 @@ Define el gestor de espera que aguardará hasta que la base de datos no esté bloqueada o hasta que se alcance el tiempo límite. + + El gestor de espera está integrado en SQLite, por lo que no es necesario + proporcionar ninguna retrollamada. Cuando una sentencia encuentra la base de + datos bloqueada por otra conexión, SQLite sigue reintentando durante un + máximo de milliseconds. Si la base de datos sigue + bloqueada pasado ese tiempo, la sentencia falla con un error + database is locked (SQLITE_BUSY). + + + La forma en que se manifiesta ese fallo depende de + SQLite3::enableExceptions. Si las excepciones están + habilitadas, se lanza una SQLite3Exception. + En caso contrario, se emite un E_WARNING y el método + que ejecutó la sentencia, como SQLite3::exec o + SQLite3::query, devuelve &false;. + + + Por defecto no se define ningún gestor de espera, por lo que una sentencia + falla de inmediato si la base de datos está bloqueada. + @@ -26,10 +46,11 @@ milliseconds - - Los milisegundos a esperar. Establecer este valor a cero o a un valor - inferior desactivará un gestor de espera previamente definido. - + + El número máximo de milisegundos a esperar un bloqueo. Establecer este + valor a cero o a un valor inferior desactivará un gestor de espera + previamente definido. + @@ -38,9 +59,11 @@ &reftitle.returnvalues; - - Devuelve &true; en caso de éxito, &return.falseforfailure;. - + + Devuelve &true; si se definió el tiempo de espera, &return.falseforfailure;. + El valor devuelto solo indica si se definió el tiempo de espera. No significa + que las sentencias posteriores obtengan el bloqueo a tiempo. +