1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-12 14:14:48 +02:00

doc/user: move "Upgrade" chapter after "Running WeeChat"

This commit is contained in:
Sébastien Helleu
2023-02-10 19:00:01 +01:00
parent 46935b859c
commit 3466c716ae
7 changed files with 489 additions and 489 deletions
+71 -71
View File
@@ -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
+71 -71
View File
@@ -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
+73 -73
View File
@@ -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
+74 -74
View File
@@ -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
@@ -861,6 +787,80 @@ 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.
// 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
+74 -74
View File
@@ -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 の起動
@@ -831,6 +757,80 @@ WeeChat は常時 (例えば <<command_weechat_quit,/quit>> コマンドの実
設定を編集するには <<command_weechat_set,/set>>
コマンドを使ってください。これは値を検査し、設定の変更をすぐに適用します。
// 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
+72 -72
View File
@@ -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
+54 -54
View File
@@ -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]]
== Интерфејс