diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/de/weechat_user.de.adoc | 142 | ||||
| -rw-r--r-- | doc/en/weechat_user.en.adoc | 142 | ||||
| -rw-r--r-- | doc/fr/weechat_user.fr.adoc | 146 | ||||
| -rw-r--r-- | doc/it/weechat_user.it.adoc | 148 | ||||
| -rw-r--r-- | doc/ja/weechat_user.ja.adoc | 148 | ||||
| -rw-r--r-- | doc/pl/weechat_user.pl.adoc | 144 | ||||
| -rw-r--r-- | doc/sr/weechat_user.sr.adoc | 108 |
7 files changed, 489 insertions, 489 deletions
diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index 3df744a6a..74af3d791 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -529,77 +529,6 @@ Sollte WeeChat abgestürzt sein, muss der Befehl `bt full` genutzt werden: (gdb) bt full ---- -[[upgrade]] -== Upgrade - -Wenn eine neue stabile Version von WeeChat veröffentlicht wird, ist es Zeit -auf diese neue Version zu wechseln. - -Zunächst müssen Sie die neue WeeChat Version als Binärdatei installieren. -Entweder installieren Sie WeeChat mittels Ihrem Paketmanager oder Sie -kompilieren WeeChat selber. Dadurch befindet sich die `weechat`-Binärdatei -und alle erforderlichen Dateien in den selben Pfaden. + -Diese Installation kann durchgeführt werden, während WeeChat ausgeführt wird. - -[[upgrade_command]] -=== Upgrade Befehl - -WeeChat kann die neue Binärdatei mit Hilfe des <<command_weechat_upgrade,/upgrade>> -Befehls starten: der Bufferinhalt und nicht-SSL Verbindungen bleiben dabei erhalten. + -Eine SSL-Verbindung wird während des Upgrades getrennt und wird automatisch, -nach dem Beenden des Upgrades, wiederhergestellt (das aufrechterhalten einer -SSL-Sitzungen ist derzeit, mit GnuTLS, nicht möglich). - -Der Befehl kann auch verwendet werden, wenn Sie den Computer neu starten müssen, -z.B. um den Kernel zu aktualisieren oder WeeChat auf einen anderen Computer zu verschieben: - ----- -/upgrade -quit ----- - -Dies speichert den aktuellen Status in `*.upgrade`-Dateien. Sie können dann entweder -die gesamten WeeChat-Verzeichnisse (Konfiguration, Daten, Cache) neu starten oder auf -einen anderen Computer verschieben und WeeChat später mit diesem Befehl neu starten: - ----- -$ weechat --upgrade ----- - -[[restart_after_upgrade]] -=== Neustart nach Upgrade - -[[restart_release_notes]] -==== Versionshinweise - -Nach einem Upgrade wird *dringend empfohlen* die, -https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[Versionshinweise ^↗^,window=_blank] -zu lesen, denn dort sind wichtige Informationen zu Änderungen enthalten und ob -eventuell ein manuelles Eingreifen erforderlich sein könnte. - -Sie müssen die Versionshinweise aller Versionen zwischen Ihrer alten (abgelaufenen) -und Ihrer neuen Version (enthalten) lesen. + -Wenn Sie beispielsweise von Version 3.0 auf 3.2 wechseln, müssen Sie die Versionshinweise -der Versionen 3.1 und 3.2 lesen. - -[[restart_configuration_upgrade]] -==== Konfigurations-Upgrade - -WeeChat hat ein automatisches Upgrade für Konfigurationsdateien (`*.conf`): - -* Neue Optionen werden stillschweigend mit dem Standardwert hinzugefügt -* Veraltete Optionen werden automatisch verworfen. WeeChat zeigt eine Warnung, - mit dem Wert der eingestellt war, im Core-Buffer, an. - -Beispiel für eine Warnung, wenn eine Option entfernt wurde: - ----- -=!= Warnung: /home/user/.config/weechat/sec.conf, Zeile 15: unbekannte Einstellung für Sektion "crypt": passphrase_file = "" ----- - -Das bedeutet, dass die Option "sec.crypt.passphrase_file" entfernt wurde und der -Wert für diese Option eine leere Zeichenkette war. Dies war der Standardwert in -der vorherigen Version (in diesem Fall ist kein manuelles Eingreifen erforderlich). - [[running_weechat]] == WeeChat starten @@ -792,6 +721,77 @@ bevor man diese ggf. gesichert hat <<command_weechat_save,/save>>). + Man sollte immer den <<command_weechat_set,/set>> Befehl nutzen, da der Befehl die Eingabe prüft und Änderungen sofort wirksam werden. +[[upgrade]] +== Upgrade + +Wenn eine neue stabile Version von WeeChat veröffentlicht wird, ist es Zeit +auf diese neue Version zu wechseln. + +Zunächst müssen Sie die neue WeeChat Version als Binärdatei installieren. +Entweder installieren Sie WeeChat mittels Ihrem Paketmanager oder Sie +kompilieren WeeChat selber. Dadurch befindet sich die `weechat`-Binärdatei +und alle erforderlichen Dateien in den selben Pfaden. + +Diese Installation kann durchgeführt werden, während WeeChat ausgeführt wird. + +[[upgrade_command]] +=== Upgrade Befehl + +WeeChat kann die neue Binärdatei mit Hilfe des <<command_weechat_upgrade,/upgrade>> +Befehls starten: der Bufferinhalt und nicht-SSL Verbindungen bleiben dabei erhalten. + +Eine SSL-Verbindung wird während des Upgrades getrennt und wird automatisch, +nach dem Beenden des Upgrades, wiederhergestellt (das aufrechterhalten einer +SSL-Sitzungen ist derzeit, mit GnuTLS, nicht möglich). + +Der Befehl kann auch verwendet werden, wenn Sie den Computer neu starten müssen, +z.B. um den Kernel zu aktualisieren oder WeeChat auf einen anderen Computer zu verschieben: + +---- +/upgrade -quit +---- + +Dies speichert den aktuellen Status in `*.upgrade`-Dateien. Sie können dann entweder +die gesamten WeeChat-Verzeichnisse (Konfiguration, Daten, Cache) neu starten oder auf +einen anderen Computer verschieben und WeeChat später mit diesem Befehl neu starten: + +---- +$ weechat --upgrade +---- + +[[restart_after_upgrade]] +=== Neustart nach Upgrade + +[[restart_release_notes]] +==== Versionshinweise + +Nach einem Upgrade wird *dringend empfohlen* die, +https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[Versionshinweise ^↗^,window=_blank] +zu lesen, denn dort sind wichtige Informationen zu Änderungen enthalten und ob +eventuell ein manuelles Eingreifen erforderlich sein könnte. + +Sie müssen die Versionshinweise aller Versionen zwischen Ihrer alten (abgelaufenen) +und Ihrer neuen Version (enthalten) lesen. + +Wenn Sie beispielsweise von Version 3.0 auf 3.2 wechseln, müssen Sie die Versionshinweise +der Versionen 3.1 und 3.2 lesen. + +[[restart_configuration_upgrade]] +==== Konfigurations-Upgrade + +WeeChat hat ein automatisches Upgrade für Konfigurationsdateien (`*.conf`): + +* Neue Optionen werden stillschweigend mit dem Standardwert hinzugefügt +* Veraltete Optionen werden automatisch verworfen. WeeChat zeigt eine Warnung, + mit dem Wert der eingestellt war, im Core-Buffer, an. + +Beispiel für eine Warnung, wenn eine Option entfernt wurde: + +---- +=!= Warnung: /home/user/.config/weechat/sec.conf, Zeile 15: unbekannte Einstellung für Sektion "crypt": passphrase_file = "" +---- + +Das bedeutet, dass die Option "sec.crypt.passphrase_file" entfernt wurde und der +Wert für diese Option eine leere Zeichenkette war. Dies war der Standardwert in +der vorherigen Version (in diesem Fall ist kein manuelles Eingreifen erforderlich). + [[interface]] == Schnittstelle diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index cfde49a00..e8c1d75d8 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -520,77 +520,6 @@ Then like for a crash, use command `bt full`: (gdb) bt full ---- -[[upgrade]] -== Upgrade - -If a new stable version of WeeChat is released, this is time for you to -switch to this version. - -First of all, you must install the new version of WeeChat, either with your -package manager or by compiling yourself, so that the `weechat` binary and all -required files are in the same paths. + -This can be done while WeeChat is running. - -[[upgrade_command]] -=== Upgrade command - -WeeChat can restart the new binary, in place, using the -<<command_weechat_upgrade,/upgrade>> command: the buffer contents and non-SSL -connections are preserved. + -The SSL connections are lost during upgrade and are restored automatically -after the upgrade (reload of SSL sessions is currently not possible -with GnuTLS). - -The command can also be used if you have to restart the machine, for example -to upgrade the kernel or to move your WeeChat to another machine: - ----- -/upgrade -quit ----- - -This saves the current state in `*.upgrade` files. You can then either reboot -or move the whole WeeChat directories (config, data, cache) to another machine, -and restart WeeChat later with this command: - ----- -$ weechat --upgrade ----- - -[[restart_after_upgrade]] -=== Restart after upgrade - -[[restart_release_notes]] -==== Release notes - -After an upgrade, it is *strongly recommended* to read the -https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes ^↗^,window=_blank] -which contain important information about breaking changes and some -manual actions that could be required. - -You must read the release notes of all versions between your old (excluded) and -your new version (included). + -For example if you switch from version 3.0 to 3.2, you must read release notes -of versions 3.1 and 3.2. - -[[restart_configuration_upgrade]] -==== Configuration upgrade - -WeeChat has an automatic upgrade of configuration files (`*.conf`): - -* new options are silently added with default value -* obsolete options are automatically discarded and WeeChat displays a warning - with the value read from file. - -Example of warning when an option has been removed: - ----- -=!= Warning: /home/user/.config/weechat/sec.conf, line 15: unknown option for section "crypt": passphrase_file = "" ----- - -That means the option `sec.crypt.passphrase_file` has been removed, and you -had value set to empty string, which was the default value in the previous version -(in this case no manual action is required). - [[running_weechat]] == Running WeeChat @@ -781,6 +710,77 @@ and after any change you must run the command <<command_weechat_reload,/reload>> You can use the command <<command_weechat_set,/set>>, which checks the value and applies immediately the changes. +[[upgrade]] +== Upgrade + +If a new stable version of WeeChat is released, this is time for you to +switch to this version. + +First of all, you must install the new version of WeeChat, either with your +package manager or by compiling yourself, so that the `weechat` binary and all +required files are in the same paths. + +This can be done while WeeChat is running. + +[[upgrade_command]] +=== Upgrade command + +WeeChat can restart the new binary, in place, using the +<<command_weechat_upgrade,/upgrade>> command: the buffer contents and non-SSL +connections are preserved. + +The SSL connections are lost during upgrade and are restored automatically +after the upgrade (reload of SSL sessions is currently not possible +with GnuTLS). + +The command can also be used if you have to restart the machine, for example +to upgrade the kernel or to move your WeeChat to another machine: + +---- +/upgrade -quit +---- + +This saves the current state in `*.upgrade` files. You can then either reboot +or move the whole WeeChat directories (config, data, cache) to another machine, +and restart WeeChat later with this command: + +---- +$ weechat --upgrade +---- + +[[restart_after_upgrade]] +=== Restart after upgrade + +[[restart_release_notes]] +==== Release notes + +After an upgrade, it is *strongly recommended* to read the +https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes ^↗^,window=_blank] +which contain important information about breaking changes and some +manual actions that could be required. + +You must read the release notes of all versions between your old (excluded) and +your new version (included). + +For example if you switch from version 3.0 to 3.2, you must read release notes +of versions 3.1 and 3.2. + +[[restart_configuration_upgrade]] +==== Configuration upgrade + +WeeChat has an automatic upgrade of configuration files (`*.conf`): + +* new options are silently added with default value +* obsolete options are automatically discarded and WeeChat displays a warning + with the value read from file. + +Example of warning when an option has been removed: + +---- +=!= Warning: /home/user/.config/weechat/sec.conf, line 15: unknown option for section "crypt": passphrase_file = "" +---- + +That means the option `sec.crypt.passphrase_file` has been removed, and you +had value set to empty string, which was the default value in the previous version +(in this case no manual action is required). + [[interface]] == Interface diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index b95477644..bd7a492e2 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -525,79 +525,6 @@ Ensuite comme pour un crash, utilisez la commande `bt full` : (gdb) bt full ---- -[[upgrade]] -== Mise à jour - -Si une nouvelle version stable de WeeChat est disponible, il est temps pour vous -de passer à cette version. - -Avant toute chose, vous devez installer la nouvelle version de WeeChat, soit -via votre gestionnaire de paquets ou en le compilant vous-même, de telle sorte -que le nouveau binaire `weechat` et tous les fichiers requis sont dans les mêmes -répertoires. + -Cela peut être fait pendant que WeeChat tourne. - -[[upgrade_command]] -=== Commande de mise à jour - -WeeChat peut redémarrer le nouveau binaire avec la commande -<<command_weechat_upgrade,/upgrade>> : le contenu des tampons et les connexions -non SSL sont préservées. + -Les connexions SSL sont perdues pendant la mise à jour et sont automatiquement -rétablies après la mise à jour (le rechargement des sessions SSL n'est pas -possible actuellement avec GnuTLS). - -La commande peut aussi être utilisée si vous devez redémarrer la machine, par -exemple pour mettre à jour le noyau ou déplacer WeeChat vers une autre machine : - ----- -/upgrade -quit ----- - -Cela sauvegarde l'état actuel dans des fichiers `*.upgrade`. Vous pouvez soit -rebooter ou déplacer les répertoires WeeChat (config, data, cache) vers une -autre machine, et redémarrer WeeChat plus tard avec cette commande : - ----- -$ weechat --upgrade ----- - -[[restart_after_upgrade]] -=== Redémarrage après mise à jour - -[[restart_release_notes]] -==== Notes de version - -Après une mise à jour, il est *fortement recommandé* de lire les -https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[notes de version ^↗^,window=_blank] -qui contiennent des informations importantes sur les changements majeurs et -quelques actions manuelles qui pourraient être nécessaires. - -Vous devez lire les notes des versions entre votre version ancienne (exclue) -et votre nouvelle version (incluse). + -Par exemple si vous passez de la version 3.0 à 3.2, vous devez lire les notes -des versions 3.1 et 3.2. - -[[restart_configuration_upgrade]] -==== Mise à jour de la configuration - -WeeChat a un système de mise à jour automatique des fichiers de configuration -(`*.conf`) : - -* les nouvelles options sont silencieusement ajoutées avec la valeur par défaut -* les options obsolètes sont automatiquement supprimées et WeeChat affiche un - avertissement avec la valeur lue dans le fichier. - -Exemple d'avertissement lorsqu'une option a été supprimée : - ----- -=!= Attention : /home/user/.config/weechat/sec.conf, ligne 15 : option inconnue pour la section "crypt" : passphrase_file = "" ----- - -Cela signifie que l'option `sec.crypt.passphrase_file` a été supprimée, et vous -aviez la valeur définie à une chaîne vide, ce qui était la valeur par défaut -dans la version précédente (dans ce cas aucune action manuelle n'est nécessaire). - [[running_weechat]] == Lancement de WeeChat @@ -795,6 +722,79 @@ changements qui n'auraient pas été sauvés avec <<command_weechat_save,/save>> Vous pouvez utiliser la commande <<command_weechat_set,/set>>, qui vérifie la valeur et applique les changements immédiatement. +[[upgrade]] +== Mise à jour + +Si une nouvelle version stable de WeeChat est disponible, il est temps pour vous +de passer à cette version. + +Avant toute chose, vous devez installer la nouvelle version de WeeChat, soit +via votre gestionnaire de paquets ou en le compilant vous-même, de telle sorte +que le nouveau binaire `weechat` et tous les fichiers requis sont dans les mêmes +répertoires. + +Cela peut être fait pendant que WeeChat tourne. + +[[upgrade_command]] +=== Commande de mise à jour + +WeeChat peut redémarrer le nouveau binaire avec la commande +<<command_weechat_upgrade,/upgrade>> : le contenu des tampons et les connexions +non SSL sont préservées. + +Les connexions SSL sont perdues pendant la mise à jour et sont automatiquement +rétablies après la mise à jour (le rechargement des sessions SSL n'est pas +possible actuellement avec GnuTLS). + +La commande peut aussi être utilisée si vous devez redémarrer la machine, par +exemple pour mettre à jour le noyau ou déplacer WeeChat vers une autre machine : + +---- +/upgrade -quit +---- + +Cela sauvegarde l'état actuel dans des fichiers `*.upgrade`. Vous pouvez soit +rebooter ou déplacer les répertoires WeeChat (config, data, cache) vers une +autre machine, et redémarrer WeeChat plus tard avec cette commande : + +---- +$ weechat --upgrade +---- + +[[restart_after_upgrade]] +=== Redémarrage après mise à jour + +[[restart_release_notes]] +==== Notes de version + +Après une mise à jour, il est *fortement recommandé* de lire les +https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[notes de version ^↗^,window=_blank] +qui contiennent des informations importantes sur les changements majeurs et +quelques actions manuelles qui pourraient être nécessaires. + +Vous devez lire les notes des versions entre votre version ancienne (exclue) +et votre nouvelle version (incluse). + +Par exemple si vous passez de la version 3.0 à 3.2, vous devez lire les notes +des versions 3.1 et 3.2. + +[[restart_configuration_upgrade]] +==== Mise à jour de la configuration + +WeeChat a un système de mise à jour automatique des fichiers de configuration +(`*.conf`) : + +* les nouvelles options sont silencieusement ajoutées avec la valeur par défaut +* les options obsolètes sont automatiquement supprimées et WeeChat affiche un + avertissement avec la valeur lue dans le fichier. + +Exemple d'avertissement lorsqu'une option a été supprimée : + +---- +=!= Attention : /home/user/.config/weechat/sec.conf, ligne 15 : option inconnue pour la section "crypt" : passphrase_file = "" +---- + +Cela signifie que l'option `sec.crypt.passphrase_file` a été supprimée, et vous +aviez la valeur définie à une chaîne vide, ce qui était la valeur par défaut +dans la version précédente (dans ce cas aucune action manuelle n'est nécessaire). + [[interface]] == Interface diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index e15f9b9bd..ac62414de 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -585,80 +585,6 @@ Poi, come per un crash, usare il comando `bt full`: (gdb) bt full ---- -// TRANSLATION MISSING -[[upgrade]] -== Upgrade - -If a new stable version of WeeChat is released, this is time for you to -switch to this version. - -First of all, you must install the new version of WeeChat, either with your -package manager or by compiling yourself, so that the `weechat` binary and all -required files are in the same paths. + -This can be done while WeeChat is running. - -// TRANSLATION MISSING -[[upgrade_command]] -=== Upgrade command - -WeeChat can restart the new binary, in place, using the -<<command_weechat_upgrade,/upgrade>> command: the buffer contents and non-SSL -connections are preserved. + -The SSL connections are lost during upgrade and are restored automatically -after the upgrade (reload of SSL sessions is currently not possible -with GnuTLS). - -The command can also be used if you have to restart the machine, for example -to upgrade the kernel or to move your WeeChat to another machine: - ----- -/upgrade -quit ----- - -This saves the current state in `*.upgrade` files. You can then either reboot -or move the whole WeeChat directories (config, data, cache) to another machine, -and restart WeeChat later with this command: - ----- -$ weechat --upgrade ----- - -// TRANSLATION MISSING -[[restart_after_upgrade]] -=== Restart after upgrade - -[[restart_release_notes]] -==== Release notes - -After an upgrade, it is *strongly recommended* to read the -https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes ^↗^,window=_blank] -which contain important information about breaking changes and some -manual actions that could be required. - -You must read the release notes of all versions between your old (excluded) and -your new version (included). + -For example if you switch from version 3.0 to 3.2, you must read release notes -of versions 3.1 and 3.2. - -[[restart_configuration_upgrade]] -==== Configuration upgrade - -WeeChat has an automatic upgrade of configuration files (`*.conf`): - -* new options are silently added with default value -* obsolete options are automatically discarded and WeeChat displays a warning - with the value read from file. - -Example of warning when an option has been removed: - ----- -=!= Attenzione: /home/user/.config/weechat/sec.conf, riga 15: opzione sconosciuta per la sezione "crypt": passphrase_file = "" ----- - -That means the option `sec.crypt.passphrase_file` has been removed, and you -had value set to empty string, which was the default value in the previous version -(in this case no manual action is required). - [[running_weechat]] == Esecuzione di WeeChat @@ -862,6 +788,80 @@ You can use the command <<command_weechat_set,/set>>, which checks the value and applies immediately the changes. // TRANSLATION MISSING +[[upgrade]] +== Upgrade + +If a new stable version of WeeChat is released, this is time for you to +switch to this version. + +First of all, you must install the new version of WeeChat, either with your +package manager or by compiling yourself, so that the `weechat` binary and all +required files are in the same paths. + +This can be done while WeeChat is running. + +// TRANSLATION MISSING +[[upgrade_command]] +=== Upgrade command + +WeeChat can restart the new binary, in place, using the +<<command_weechat_upgrade,/upgrade>> command: the buffer contents and non-SSL +connections are preserved. + +The SSL connections are lost during upgrade and are restored automatically +after the upgrade (reload of SSL sessions is currently not possible +with GnuTLS). + +The command can also be used if you have to restart the machine, for example +to upgrade the kernel or to move your WeeChat to another machine: + +---- +/upgrade -quit +---- + +This saves the current state in `*.upgrade` files. You can then either reboot +or move the whole WeeChat directories (config, data, cache) to another machine, +and restart WeeChat later with this command: + +---- +$ weechat --upgrade +---- + +// TRANSLATION MISSING +[[restart_after_upgrade]] +=== Restart after upgrade + +[[restart_release_notes]] +==== Release notes + +After an upgrade, it is *strongly recommended* to read the +https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes ^↗^,window=_blank] +which contain important information about breaking changes and some +manual actions that could be required. + +You must read the release notes of all versions between your old (excluded) and +your new version (included). + +For example if you switch from version 3.0 to 3.2, you must read release notes +of versions 3.1 and 3.2. + +[[restart_configuration_upgrade]] +==== Configuration upgrade + +WeeChat has an automatic upgrade of configuration files (`*.conf`): + +* new options are silently added with default value +* obsolete options are automatically discarded and WeeChat displays a warning + with the value read from file. + +Example of warning when an option has been removed: + +---- +=!= Attenzione: /home/user/.config/weechat/sec.conf, riga 15: opzione sconosciuta per la sezione "crypt": passphrase_file = "" +---- + +That means the option `sec.crypt.passphrase_file` has been removed, and you +had value set to empty string, which was the default value in the previous version +(in this case no manual action is required). + +// TRANSLATION MISSING [[interface]] == Interface diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index 55351d49d..7f8b5b09a 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -553,80 +553,6 @@ gdb /usr/bin/weechat 12345 (gdb) bt full ---- -// TRANSLATION MISSING -[[upgrade]] -== Upgrade - -If a new stable version of WeeChat is released, this is time for you to -switch to this version. - -First of all, you must install the new version of WeeChat, either with your -package manager or by compiling yourself, so that the `weechat` binary and all -required files are in the same paths. + -This can be done while WeeChat is running. - -// TRANSLATION MISSING -[[upgrade_command]] -=== Upgrade command - -WeeChat can restart the new binary, in place, using the -<<command_weechat_upgrade,/upgrade>> command: the buffer contents and non-SSL -connections are preserved. + -The SSL connections are lost during upgrade and are restored automatically -after the upgrade (reload of SSL sessions is currently not possible -with GnuTLS). - -The command can also be used if you have to restart the machine, for example -to upgrade the kernel or to move your WeeChat to another machine: - ----- -/upgrade -quit ----- - -This saves the current state in `*.upgrade` files. You can then either reboot -or move the whole WeeChat directories (config, data, cache) to another machine, -and restart WeeChat later with this command: - ----- -$ weechat --upgrade ----- - -// TRANSLATION MISSING -[[restart_after_upgrade]] -=== Restart after upgrade - -[[restart_release_notes]] -==== Release notes - -After an upgrade, it is *strongly recommended* to read the -https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes ^↗^,window=_blank] -which contain important information about breaking changes and some -manual actions that could be required. - -You must read the release notes of all versions between your old (excluded) and -your new version (included). + -For example if you switch from version 3.0 to 3.2, you must read release notes -of versions 3.1 and 3.2. - -[[restart_configuration_upgrade]] -==== Configuration upgrade - -WeeChat has an automatic upgrade of configuration files (`*.conf`): - -* new options are silently added with default value -* obsolete options are automatically discarded and WeeChat displays a warning - with the value read from file. - -Example of warning when an option has been removed: - ----- -=!= 警告: /home/user/.config/weechat/sec.conf, 行 15: セクション "crypt" の無効なオプション: passphrase_file = "" ----- - -That means the option `sec.crypt.passphrase_file` has been removed, and you -had value set to empty string, which was the default value in the previous version -(in this case no manual action is required). - [[running_weechat]] == WeeChat の起動 @@ -832,6 +758,80 @@ WeeChat は常時 (例えば <<command_weechat_quit,/quit>> コマンドの実 コマンドを使ってください。これは値を検査し、設定の変更をすぐに適用します。 // TRANSLATION MISSING +[[upgrade]] +== Upgrade + +If a new stable version of WeeChat is released, this is time for you to +switch to this version. + +First of all, you must install the new version of WeeChat, either with your +package manager or by compiling yourself, so that the `weechat` binary and all +required files are in the same paths. + +This can be done while WeeChat is running. + +// TRANSLATION MISSING +[[upgrade_command]] +=== Upgrade command + +WeeChat can restart the new binary, in place, using the +<<command_weechat_upgrade,/upgrade>> command: the buffer contents and non-SSL +connections are preserved. + +The SSL connections are lost during upgrade and are restored automatically +after the upgrade (reload of SSL sessions is currently not possible +with GnuTLS). + +The command can also be used if you have to restart the machine, for example +to upgrade the kernel or to move your WeeChat to another machine: + +---- +/upgrade -quit +---- + +This saves the current state in `*.upgrade` files. You can then either reboot +or move the whole WeeChat directories (config, data, cache) to another machine, +and restart WeeChat later with this command: + +---- +$ weechat --upgrade +---- + +// TRANSLATION MISSING +[[restart_after_upgrade]] +=== Restart after upgrade + +[[restart_release_notes]] +==== Release notes + +After an upgrade, it is *strongly recommended* to read the +https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes ^↗^,window=_blank] +which contain important information about breaking changes and some +manual actions that could be required. + +You must read the release notes of all versions between your old (excluded) and +your new version (included). + +For example if you switch from version 3.0 to 3.2, you must read release notes +of versions 3.1 and 3.2. + +[[restart_configuration_upgrade]] +==== Configuration upgrade + +WeeChat has an automatic upgrade of configuration files (`*.conf`): + +* new options are silently added with default value +* obsolete options are automatically discarded and WeeChat displays a warning + with the value read from file. + +Example of warning when an option has been removed: + +---- +=!= 警告: /home/user/.config/weechat/sec.conf, 行 15: セクション "crypt" の無効なオプション: passphrase_file = "" +---- + +That means the option `sec.crypt.passphrase_file` has been removed, and you +had value set to empty string, which was the default value in the previous version +(in this case no manual action is required). + +// TRANSLATION MISSING [[interface]] == Interface diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index e94bad872..b353be519 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -529,78 +529,6 @@ Następnie jak w przypadku awarii, użyj polecenia `bt full`: (gdb) bt full ---- -[[upgrade]] -== Aktualizacja - -Jeśli zostanie wydana nowa stabilna wersja WeeChat należy zaktualizować -się do tej wersji. - -Na samym początku musisz zainstalować nową wersje WeeChat albo za pomocą -managera pakietów albo kompilując ją samemu, w taki sposób żeby plik -wykonywalny `weechat` i wszystke wymagane pliki znajdowały się w tych samych -ścieżkach. + -Można to zrobić podczas działania WeeChat. - -[[upgrade_command]] -=== Komenda aktualizacji - -WeeChat może zostać ponownie uruchomiony z nowego pliku binarnego bez potrzeby -jego wyłączania za pomocą komendy <<command_weechat_upgrade,/upgrade>>: -zawartości buforów i połączenia nie SSL zostają zachowane. + -Połączenia SSL są przerywane podczas aktualizacji i są automatycznie -przywracane po jej zakończeniu (przeładowanie sesji SSL jest obecnie -niemożliwe z użyciem GnuTLS). - -Komenda ta może zostać użyta również w momencie restartu maszyny, na przykład -w celu aktualizacji kernela albo przeniesienia WeeChat na nową maszynę: - ----- -/upgrade -quit ----- - -Zapisuje to obecny stan w plikach `*.upgrade`. Możesz następnie wykonać restart -lub przenieść cały katalog WeeChat (konfiguracja, dane, cache) na inną maszynę, -następnie uruchomić WeeChat za pomocą polecenia: - ----- -$ weechat --upgrade ----- - -[[restart_after_upgrade]] -=== Restart po aktualizacji - -[[restart_release_notes]] -==== Informacje o wydaniu - -Po aktualizacji *zaleca się* przeczytanie -https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[informacji o wydaniu ^↗^,window=_blank], -które zawierają ważne informacje o przełomowych zmianach i do zrobienia jakie mogą -być wymagane. - -Powinieneś przeczytać informacje o zmianach dla wyszystkich wersji pomiędzy obecną -a tą, do której aktualizujesz. + -Na przykład aktualizując z wersji 3.0 do 3.2, musisz przeczytać informacje dla wersj -3.1 i 3.2. - -[[restart_configuration_upgrade]] -==== Aktualizacja konfiguracji - -WeeChat potrafi automatycznie aktualizować pliki konfiguracyjne (`*.conf`): - -* nowe opcje są dodawane z domyślnymi wartościami -* niepotrzebne już opcje są automatycznie kasowane i WeeChat wyświetla ostrzeżenie - z wartościami odczytanymi z pliku. - -Przykład ostrzeżenia o usuwanej opcji: - ----- -=!= Ostrzeżenie: /home/user/.config/weechat/sec.conf, linia 15: nieznana opcja dla sekcji "crypt": passphrase_file = "" ----- - -Oznaza to, że opcja `sec.crypt.passphrase_file` została usunięta i jej wartość była -ustawiona na pusty ciąg, który był domyślną wartością w poprzednej wersji -(w tym przypadku żadna dodatkowa akcja nie jest wymagana). - [[running_weechat]] == Uruchamianie WeeChat @@ -791,6 +719,78 @@ oraz po wprowadzeniu ręcznie zmian należy użyć komendy <<command_weechat_rel Możesz użyć komendy <<command_weechat_set,/set>>, która sprawdza ustawianą wartość i od razu wprowadza zmiany. +[[upgrade]] +== Aktualizacja + +Jeśli zostanie wydana nowa stabilna wersja WeeChat należy zaktualizować +się do tej wersji. + +Na samym początku musisz zainstalować nową wersje WeeChat albo za pomocą +managera pakietów albo kompilując ją samemu, w taki sposób żeby plik +wykonywalny `weechat` i wszystke wymagane pliki znajdowały się w tych samych +ścieżkach. + +Można to zrobić podczas działania WeeChat. + +[[upgrade_command]] +=== Komenda aktualizacji + +WeeChat może zostać ponownie uruchomiony z nowego pliku binarnego bez potrzeby +jego wyłączania za pomocą komendy <<command_weechat_upgrade,/upgrade>>: +zawartości buforów i połączenia nie SSL zostają zachowane. + +Połączenia SSL są przerywane podczas aktualizacji i są automatycznie +przywracane po jej zakończeniu (przeładowanie sesji SSL jest obecnie +niemożliwe z użyciem GnuTLS). + +Komenda ta może zostać użyta również w momencie restartu maszyny, na przykład +w celu aktualizacji kernela albo przeniesienia WeeChat na nową maszynę: + +---- +/upgrade -quit +---- + +Zapisuje to obecny stan w plikach `*.upgrade`. Możesz następnie wykonać restart +lub przenieść cały katalog WeeChat (konfiguracja, dane, cache) na inną maszynę, +następnie uruchomić WeeChat za pomocą polecenia: + +---- +$ weechat --upgrade +---- + +[[restart_after_upgrade]] +=== Restart po aktualizacji + +[[restart_release_notes]] +==== Informacje o wydaniu + +Po aktualizacji *zaleca się* przeczytanie +https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[informacji o wydaniu ^↗^,window=_blank], +które zawierają ważne informacje o przełomowych zmianach i do zrobienia jakie mogą +być wymagane. + +Powinieneś przeczytać informacje o zmianach dla wyszystkich wersji pomiędzy obecną +a tą, do której aktualizujesz. + +Na przykład aktualizując z wersji 3.0 do 3.2, musisz przeczytać informacje dla wersj +3.1 i 3.2. + +[[restart_configuration_upgrade]] +==== Aktualizacja konfiguracji + +WeeChat potrafi automatycznie aktualizować pliki konfiguracyjne (`*.conf`): + +* nowe opcje są dodawane z domyślnymi wartościami +* niepotrzebne już opcje są automatycznie kasowane i WeeChat wyświetla ostrzeżenie + z wartościami odczytanymi z pliku. + +Przykład ostrzeżenia o usuwanej opcji: + +---- +=!= Ostrzeżenie: /home/user/.config/weechat/sec.conf, linia 15: nieznana opcja dla sekcji "crypt": passphrase_file = "" +---- + +Oznaza to, że opcja `sec.crypt.passphrase_file` została usunięta i jej wartość była +ustawiona na pusty ciąg, który był domyślną wartością w poprzednej wersji +(w tym przypadku żadna dodatkowa akcja nie jest wymagana). + [[interface]] == Interfejs diff --git a/doc/sr/weechat_user.sr.adoc b/doc/sr/weechat_user.sr.adoc index bdf13bcc2..6ba5addf2 100644 --- a/doc/sr/weechat_user.sr.adoc +++ b/doc/sr/weechat_user.sr.adoc @@ -498,60 +498,6 @@ gdb /usr/bin/weechat 12345 (gdb) bt full ---- -[[upgrade]] -== Ажурирање - -Ако се објави нова стабилна верзија програма WeeChat, онда је време да пређете на ту верзију. - -Најпре морате инсталирати нову верзију програма WeeChat, или менаџером пакета, или тако што ћете га сами компајлирати, тако да су `weechat` бинарни фајл и све потребни фајлови на истим путањама. + -Ово може да се уради и док се програм WeeChat извршава. - -[[upgrade_command]] -=== Команда upgrade - -Програм WeeChat у месту може да поново покрене нови бинарни фајл, употребом команде <<command_weechat_upgrade,/upgrade>>: садржаји бафера и не-SSL везе се задржавају. + -Током процеса ажурирња, SSL конекције се губе и аутоматски се обнављају -након ажурирања (са GnuTLS тренутно није могуће поновно учитавање SSL сесија). - -Команда такође може да се употреби и када морате поново да покренете машину, на пример, да бисте ажурирали кернел или да преместите свој WeeChat на другу машину: - ----- -/upgrade -quit ----- - -Ово чува тренутно стање у `*.upgrade` фајлове. Након тога можете или да поново покренете машину, или да комплетне WeeChat директоријуме (config, data, cache) преместите на неку другу машину и касније покренете програм WeeChat следећом командом: - ----- -$ weechat --upgrade ----- - -[[restart_after_upgrade]] -=== Поновно покретање након ажурирања - -[[restart_release_notes]] -==== Напомене о издању - -Након ажурирања, *снажно се препоручује* да прочитате https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[напомене о издању ^↗^,window=_blank] које садржи важне информације о променама које прекидају раније понашање програма, као и ручне акције које су због тога можда неопходне. - -Морате прочитати све напомене о издању издате између ваше старе (без ње) и ваше нове верзије (укључујући и њу). + -На пример, ако пређете са верзије 3.0 на 3.2, морате да прочитате напомене о издању за верзије 3.1 и 3.2. - -[[restart_configuration_upgrade]] -==== Ажурирање конфигурације - -Програм WeeChat врши аутоматско ажурирање конфигурационих фајлова (`*.conf`): - -* нове опције се без најаве додају са својим подразумеваним вредностима -* застареле опције се аутоматски одбацују и програм WeeChat приказује упозорење које садржи вредност прочитану из фајла. - -Пример упозорења када се опција уклања: - ----- -=!= Упозорење: /home/user/.config/weechat/sec.conf, линија 15: непозната опција за одељак "crypt": passphrase_file = "" ----- - -Ово значи да је опција `sec.crypt.passphrase_file` уклоњена и да је њена вредност била постављена на празан стринг, што је и подразумевана вредност у претходној верзији (у овом случају нема потребе за ручном акцијом). - [[running_weechat]] == Покретање програма WeeChat @@ -727,6 +673,60 @@ WeeChat подразумевано користи XDG директоријуме *Не препоручује се* ручно уређивање конфигурационих фајлова јер програм WeeChat може да их упише у било које време (на пример приликом команде <<command_weechat_quit,/quit>>) и јер након сваке измене морате да извршите команду <<command_weechat_reload,/reload>> (уз ризик губитка осталих измена које још увек нисте сачували командом <<command_weechat_save,/save>>). + Можете да употребљавате команду <<command_weechat_set,/set>>, која врши проверу вредности и тренутно примењује измене. +[[upgrade]] +== Ажурирање + +Ако се објави нова стабилна верзија програма WeeChat, онда је време да пређете на ту верзију. + +Најпре морате инсталирати нову верзију програма WeeChat, или менаџером пакета, или тако што ћете га сами компајлирати, тако да су `weechat` бинарни фајл и све потребни фајлови на истим путањама. + +Ово може да се уради и док се програм WeeChat извршава. + +[[upgrade_command]] +=== Команда upgrade + +Програм WeeChat у месту може да поново покрене нови бинарни фајл, употребом команде <<command_weechat_upgrade,/upgrade>>: садржаји бафера и не-SSL везе се задржавају. + +Током процеса ажурирња, SSL конекције се губе и аутоматски се обнављају +након ажурирања (са GnuTLS тренутно није могуће поновно учитавање SSL сесија). + +Команда такође може да се употреби и када морате поново да покренете машину, на пример, да бисте ажурирали кернел или да преместите свој WeeChat на другу машину: + +---- +/upgrade -quit +---- + +Ово чува тренутно стање у `*.upgrade` фајлове. Након тога можете или да поново покренете машину, или да комплетне WeeChat директоријуме (config, data, cache) преместите на неку другу машину и касније покренете програм WeeChat следећом командом: + +---- +$ weechat --upgrade +---- + +[[restart_after_upgrade]] +=== Поновно покретање након ажурирања + +[[restart_release_notes]] +==== Напомене о издању + +Након ажурирања, *снажно се препоручује* да прочитате https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[напомене о издању ^↗^,window=_blank] које садржи важне информације о променама које прекидају раније понашање програма, као и ручне акције које су због тога можда неопходне. + +Морате прочитати све напомене о издању издате између ваше старе (без ње) и ваше нове верзије (укључујући и њу). + +На пример, ако пређете са верзије 3.0 на 3.2, морате да прочитате напомене о издању за верзије 3.1 и 3.2. + +[[restart_configuration_upgrade]] +==== Ажурирање конфигурације + +Програм WeeChat врши аутоматско ажурирање конфигурационих фајлова (`*.conf`): + +* нове опције се без најаве додају са својим подразумеваним вредностима +* застареле опције се аутоматски одбацују и програм WeeChat приказује упозорење које садржи вредност прочитану из фајла. + +Пример упозорења када се опција уклања: + +---- +=!= Упозорење: /home/user/.config/weechat/sec.conf, линија 15: непозната опција за одељак "crypt": passphrase_file = "" +---- + +Ово значи да је опција `sec.crypt.passphrase_file` уклоњена и да је њена вредност била постављена на празан стринг, што је и подразумевана вредност у претходној верзији (у овом случају нема потребе за ручном акцијом). + [[interface]] == Интерфејс |