Updated descriptions

docs/README.cn.md

@@ -234,19 +234,19 @@ pyxel copy_examples
 </tr>
 </table>
 
-运行例程，可以使用以下命令：
+这些示例可以通过以下命令执行：
 
 ```sh
 cd pyxel_examples
 pyxel run 01_hello_pyxel.py
 pyxel play 30sec_of_daylight.pyxapp
 ```
 
-## 使用教程
+## 使用方法
 
-### 创建应用
+### 创建应用程序
 
-在 python 文件中导入 Pyxel 包后，首先使用`init`函数指定窗口大小，然后使用`run`函数启动 Pyxel 应用。
+在您的 Python 脚本中，导入 Pyxel 模块，通过 `init` 函数指定窗口大小，然后使用 `run` 函数启动 Pyxel 应用程序。
 
 ```python
 import pyxel
@@ -264,9 +264,9 @@ def draw():
 pyxel.run(update, draw)
 ```
 
-`run`函数的两个参数`update`函数和`draw`函数分别用来在需要时更新帧和绘制画面。
+`run` 函数的参数是处理帧更新的 `update` 函数和处理屏幕绘制的 `draw` 函数。
 
-实际应用中，建议将 pyxel 代码封装成如下类：
+在实际应用中，建议将 Pyxel 代码封装在类中，如下所示：
 
 ```python
 import pyxel
@@ -287,7 +287,7 @@ class App:
 App()
 ```
 
-当创建没有动画的简单图形时，可以使用`show`函数来使代码更加简洁。
+要创建没有动画的简单图形，您可以使用 `show` 函数来简化代码。
 
 ```python
 import pyxel
@@ -298,27 +298,27 @@ pyxel.circb(60, 60, 40, 7)
 pyxel.show()
 ```
 
-### 运行应用
+### 运行应用程序
 
-创建的 Python 脚本可使用`python`命令执行：
+创建的脚本可以使用 `python` 命令执行：
 
 ```sh
 python PYTHON_SCRIPT_FILE
 ```
 
-也可以使用`pyxel run`命令运行：
+它也可以使用 `pyxel run` 命令运行：
 
 ```sh
 pyxel run PYTHON_SCRIPT_FILE
 ```
 
-此外，`pyxel watch`命令可以监控指定目录中的变化，并在检测到变化时自动重新运行程序：
+此外，`pyxel watch` 命令监视指定目录中的更改，并在检测到更改时自动重新运行程序：
 
 ```sh
 pyxel watch WATCH_DIR PYTHON_SCRIPT_FILE
 ```
 
-按`Ctrl(Command)+C`键可停止目录监控。
+可以通过按 `Ctrl(Command)+C` 停止目录监视。
 
 ### 特殊键操作
 

docs/README.de.md

@@ -234,7 +234,7 @@ Die folgenden Beispiele werden in Ihr aktuelles Verzeichnis kopiert:
 </tr>
 </table>
 
-Führe eines der Beispiele mit folgendem Befehl aus:
+Die Beispiele können mit den folgenden Befehlen ausgeführt werden:
 
 ```sh
 cd pyxel_examples
@@ -244,9 +244,9 @@ pyxel play 30sec_of_daylight.pyxapp
 
 ## Verwendung
 
-### Eine Anwendung erstellen
+### Anwendung erstellen
 
-Nachdem du das Pyxel-Modul in Ihr Python-Skript importiert hast, gib zunächst die Fenstergröße mit der Funktion `init` an und starten dann die Pyxel-Anwendung mit der Funktion `run`.
+Importieren Sie das Pyxel-Modul in Ihr Python-Skript, geben Sie die Fenstergröße mit der `init`-Funktion an und starten Sie die Pyxel-Anwendung mit der `run`-Funktion.
 
 ```python
 import pyxel
@@ -264,9 +264,9 @@ def draw():
 pyxel.run(update, draw)
 ```
 
-Die Argumente der Funktion `run` sind die `update` Funktion, um jedes Bild zu aktualisieren, und die Funktion `draw`, um den Bildschirm bei Bedarf zu zeichnen.
+Die Argumente der `run`-Funktion sind die `update`-Funktion, die die Frame-Aktualisierungen verarbeitet, und die `draw`-Funktion, die das Zeichnen auf dem Bildschirm übernimmt.
 
-In einer tatsächlichen Anwendung ist es empfehlenswert, den Pyxel-Code in eine Klasse zu verpacken, wie unten dargestellt:
+In einer tatsächlichen Anwendung wird empfohlen, den Pyxel-Code in einer Klasse zu kapseln, wie im Folgenden gezeigt:
 
 ```python
 import pyxel
@@ -287,7 +287,7 @@ class App:
 App()
 ```
 
-Bei der Erstellung einfacher Grafiken ohne Animation kann die Funktion `show` verwendet werden, um den Code übersichtlicher zu gestalten.
+Um einfache Grafiken ohne Animation zu erstellen, können Sie die `show`-Funktion verwenden, um Ihren Code zu vereinfachen.
 
 ```python
 import pyxel
@@ -300,25 +300,25 @@ pyxel.show()
 
 ### Anwendung ausführen
 
-Ein erstelltes Python-Skript kann mit dem Befehl `python` ausgeführt werden:
+Ein erstelltes Skript kann mit dem `python`-Befehl ausgeführt werden:
 
 ```sh
 python PYTHON_SCRIPT_FILE
 ```
 
-Es kann auch mit dem Befehl `pyxel run` ausgeführt werden:
+Es kann auch mit dem `pyxel run`-Befehl ausgeführt werden:
 
 ```sh
 pyxel run PYTHON_SCRIPT_FILE
 ```
 
-Darüber hinaus ermöglicht der Befehl `pyxel watch` die Überwachung von Änderungen in einem bestimmten Verzeichnis und führt das Programm automatisch erneut aus, wenn Änderungen festgestellt werden:
+Darüber hinaus überwacht der Befehl `pyxel watch` Änderungen in einem angegebenen Verzeichnis und führt das Programm automatisch erneut aus, wenn Änderungen erkannt werden:
 
 ```sh
 pyxel watch WATCH_DIR PYTHON_SCRIPT_FILE
 ```
 
-Die Verzeichnisüberwachung kann durch Drücken der Tastenkombination `Ctrl(Command)+C` beendet werden.
+Die Überwachung des Verzeichnisses kann durch Drücken von `Ctrl(Command)+C` gestoppt werden.
 
 ### Sondertastenoperationen
 

docs/README.es.md

@@ -234,19 +234,19 @@ Los siguientes ejemplos serán copiados a tu directorio actual:
 </tr>
 </table>
 
-Los ejemplos se pueden ejecutar con el siguiente comando:
+Los ejemplos se pueden ejecutar con los siguientes comandos:
 
 ```sh
 cd pyxel_examples
 pyxel run 01_hello_pyxel.py
 pyxel play 30sec_of_daylight.pyxapp
 ```
 
-## Cómo utilizarlo
+## Cómo usar
 
-### Crear una aplicación
+### Crear aplicación
 
-Tras importar el módulo Pyxel en el código de Python, especifique la dimensión de la ventana con la función `init`, luego, inicie la aplicación con la función `run`.
+En su script de Python, importe el módulo Pyxel, especifique el tamaño de la ventana con la función `init` y luego inicie la aplicación Pyxel con la función `run`.
 
 ```python
 import pyxel
@@ -264,9 +264,9 @@ def draw():
 pyxel.run(update, draw)
 ```
 
-Los argumentos de la función `run` son la función `update` para actualizar cada fotograma y la función `draw` para dibujar la pantalla cuando sea necesario.
+Los argumentos de la función `run` son la función `update`, que procesa las actualizaciones de los fotogramas, y la función `draw`, que maneja el dibujo en la pantalla.
 
-En una aplicación, es recomendable envolver el código de pyxel en una clase como la siguiente:
+En una aplicación real, se recomienda encapsular el código de Pyxel en una clase, como se muestra a continuación:
 
 ```python
 import pyxel
@@ -287,7 +287,7 @@ class App:
 App()
 ```
 
-Cuando se crean gráficos simples sin animación, se puede utilizar la función `show` para hacer el código más conciso.
+Para crear gráficos simples sin animación, puede usar la función `show` para simplificar su código.
 
 ```python
 import pyxel
@@ -298,27 +298,27 @@ pyxel.circb(60, 60, 40, 7)
 pyxel.show()
 ```
 
-### Correr aplicaciones
+### Ejecutar aplicación
 
-Un script Python creado puede ejecutarse utilizando el comando `python`:
+Un script creado se puede ejecutar utilizando el comando `python`:
 
 ```sh
 python PYTHON_SCRIPT_FILE
 ```
 
-También puede ejecutarse con el comando `pyxel run`:
+También se puede ejecutar con el comando `pyxel run`:
 
 ```sh
 pyxel run PYTHON_SCRIPT_FILE
 ```
 
-Además, el comando `pyxel watch` permite monitorizar los cambios en un directorio especificado, reejecutando automáticamente el programa cuando se detectan cambios:
+Además, el comando `pyxel watch` supervisa los cambios en un directorio especificado y vuelve a ejecutar automáticamente el programa cuando se detectan cambios:
 
 ```sh
 pyxel watch WATCH_DIR PYTHON_SCRIPT_FILE
 ```
 
-La monitorización de directorios puede detenerse pulsando `Ctrl(Command)+C`.
+La supervisión del directorio se puede detener presionando `Ctrl(Command)+C`.
 
 ### Operaciones de teclas especiales
 

docs/README.fr.md

@@ -234,7 +234,7 @@ Les exemples suivants seront copiés dans votre répertoire actuel :
 </tr>
 </table>
 
-Les exemples peuvent être lancés avec les commandes suivantes :
+Les exemples peuvent être exécutés avec les commandes suivantes :
 
 ```sh
 cd pyxel_examples
@@ -246,7 +246,7 @@ pyxel play 30sec_of_daylight.pyxapp
 
 ### Créer une application
 
-Après avoir importé le module Pyxel dans votre script Python, spécifiez d’abord la taille de la fenêtre avec la fonction `init`, puis lancez l’application Pyxel avec la fonction `run`.
+Dans votre script Python, importez le module Pyxel, spécifiez la taille de la fenêtre avec la fonction `init`, puis démarrez l'application Pyxel avec la fonction `run`.
 
 ```python
 import pyxel
@@ -264,9 +264,9 @@ def draw():
 pyxel.run(update, draw)
 ```
 
-Les arguments de la fonction `run` sont la fonction `update` pour mettre à jour chaque frame et la fonction `draw` pour dessiner sur l’écran quand c’est nécessaire.
+Les arguments de la fonction `run` sont la fonction `update`, qui traite les mises à jour de trames, et la fonction `draw`, qui gère le dessin à l'écran.
 
-Dans une vraie application, il est recommandé de mettre le code Pyxel dans une classe comme ci-dessous :
+Dans une application réelle, il est recommandé d'encapsuler le code Pyxel dans une classe, comme montré ci-dessous :
 
 ```python
 import pyxel
@@ -287,7 +287,7 @@ class App:
 App()
 ```
 
-Lors de la création de graphiques simples sans animation, la fonction `show` peut être utilisée pour rendre le code plus concis.
+Pour créer des graphiques simples sans animation, vous pouvez utiliser la fonction `show` pour simplifier votre code.
 
 ```python
 import pyxel
@@ -298,9 +298,9 @@ pyxel.circb(60, 60, 40, 7)
 pyxel.show()
 ```
 
-### Lancer une application
+### Exécuter l'application
 
-Un script Python créé peut être exécuté à l'aide de la commande `python` :
+Un script créé peut être exécuté en utilisant la commande `python` :
 
 ```sh
 python PYTHON_SCRIPT_FILE
@@ -312,13 +312,13 @@ Il peut également être exécuté avec la commande `pyxel run` :
 pyxel run PYTHON_SCRIPT_FILE
 ```
 
-De plus, la commande `pyxel watch` permet de surveiller les changements dans un répertoire spécifié, et de relancer automatiquement le programme lorsque des changements sont détectés :
+De plus, la commande `pyxel watch` surveille les modifications dans un répertoire spécifié et relance automatiquement le programme lorsque des changements sont détectés :
 
 ```sh
 pyxel watch WATCH_DIR PYTHON_SCRIPT_FILE
 ```
 
-La surveillance des répertoires peut être arrêtée en appuyant sur `Ctrl(Command)+C`.
+La surveillance du répertoire peut être arrêtée en appuyant sur `Ctrl(Command)+C`.
 
 ### Opérations de touches spéciales
 

docs/README.it.md

@@ -234,7 +234,7 @@ I seguenti esempi saranno copiati nella tua directory corrente:
 </tr>
 </table>
 
-Un esempio può essere eseguito con i seguenti comandi:
+Gli esempi possono essere eseguiti con i seguenti comandi:
 
 ```sh
 cd pyxel_examples
@@ -246,7 +246,7 @@ pyxel play 30sec_of_daylight.pyxapp
 
 ### Creare un'applicazione
 
-Dopo aver importato il modulo Pyxel nel tuo script Python, prima specifica la dimensione della finestra con la funzione `init`, dopodichè lancia l'applicazione Pyxel con la funzione `run`.
+Nel tuo script Python, importa il modulo Pyxel, specifica le dimensioni della finestra con la funzione `init`, e poi avvia l'applicazione Pyxel con la funzione `run`.
 
 ```python
 import pyxel
@@ -264,9 +264,9 @@ def draw():
 pyxel.run(update, draw)
 ```
 
-I parametri della funzione `run` sono passati alla funzione `update` per aggiornare ogni frame e alla funzione `draw` per disegnare lo schermo quando necessario.
+Gli argomenti della funzione `run` sono la funzione `update`, che gestisce gli aggiornamenti dei fotogrammi, e la funzione `draw`, che gestisce il disegno sullo schermo.
 
-In un'applicazione reale, è consigliato includere il codice Pyxel in una classe come qui sotto:
+In un'applicazione reale, è consigliabile incapsulare il codice Pyxel in una classe, come mostrato di seguito:
 
 ```python
 import pyxel
@@ -287,7 +287,7 @@ class App:
 App()
 ```
 
-Quando si creano grafici semplici senza animazione, si può usare la funzione `show` per rendere il codice più conciso.
+Per creare grafica semplice senza animazione, puoi utilizzare la funzione `show` per semplificare il tuo codice.
 
 ```python
 import pyxel
@@ -298,9 +298,9 @@ pyxel.circb(60, 60, 40, 7)
 pyxel.show()
 ```
 
-### Eseguire un'applicazione
+### Eseguire l'applicazione
 
-Uno script Python creato può essere eseguito con il comando `python`:
+Uno script creato può essere eseguito utilizzando il comando `python`:
 
 ```sh
 python PYTHON_SCRIPT_FILE
@@ -312,7 +312,7 @@ Può anche essere eseguito con il comando `pyxel run`:
 pyxel run PYTHON_SCRIPT_FILE
 ```
 
-Inoltre, il comando `pyxel watch` consente di monitorare i cambiamenti in una directory specificata, eseguendo automaticamente il programma quando vengono rilevati cambiamenti:
+Inoltre, il comando `pyxel watch` monitora le modifiche in una directory specificata e ri-esegue automaticamente il programma quando vengono rilevati cambiamenti:
 
 ```sh
 pyxel watch WATCH_DIR PYTHON_SCRIPT_FILE