Re: fcitx-pinyin should be automatically replaced by fcitx-chinese-addons

On 22/06/02 09:52AM, Stuart Henderson wrote:
> On 2022/06/02 08:13, Yifei Zhan wrote:
> > On 22/06/02 08:03AM, Stuart Henderson wrote:
> > > Perhaps it makes sense to add RUN_DEPENDS=inputmethods/fcitx-table-extra to
> > > fcitx-chinese-addons?
> > >
> >
> > I don't really like this idea because then everyone who uses
> > fcitx-chinese-addons will also have to install all the tables even
> > after the fcitx4 -> 5 transitional period.
> >
> > Maybe we should display a message asking the users to read the new
> > README and reconfigure fcitx -- manual reconfigure is required anyway.
>
> In that case probably the best way is to add something to faq/current.html
> so it makes it into upgrade notes. The number of times I've had to point
> people at the pkg-readme (which pkg_add already tells them to read) I think
> these are usually ignored. Whereas people do seem better at finding things
> in current.html/the upgrade notes (as long as there aren't _too_ many of them).
>

How about this? feel free to tweak/reword it :)

diff --git a/faq/current.html b/faq/current.html
index 49e65ecc6..e576dbe87 100644
--- a/faq/current.html
+++ b/faq/current.html
@@ -149,6 +149,48 @@ the relevant files from /usr/local/share/vim/vim82/colors/legacy to
~/.vim/colors which take priority.


+<h3 id="r20220603">2022/06/03 - [packages] Fcitx update requires manual reconfigure</h3>
+
+Fcitx splits some input methods into different packages and requires manual
+reconfiguration after upgrade.
+
+Notably:
+<ul>
+<li><b>Fcitx no longer bundles PinYin, you will need to install
+fcitx-chinese-addons to use PinYin.</b></li>
+
+<li><b>Methods previously provided by the fcitx-table package are split into two
+packages:</b></li>
+
+<p>For CangJie / ShuangPin / WuBi / ErBi / ZiRanMa, install
+fcitx-chinese-addons.
+
+<p>For ZhengMa / Boshiamy / Quick and other WuBi / CangJie tables,
+install fcitx-table-extra.<p>
+
+<li>If you are starting fcitx from <tt>.xsession</tt>, update it with the following:</li>
+
+<blockquote><pre>
+<b>export XMODIFIERS=@im=fcitx</b>
+<b>export GTK_IM_MODULE=fcitx</b>
+<b>export QT_IM_MODULE=fcitx</b>
+<b>/usr/local/bin/fcitx5 &</b>
+</pre></blockquote>
+
+<li><b>You might need to re-run <tt>fcitx5-configtool</tt>
+to reconfigure your input method</b></li>
+
+To setup an input engine, run <tt>fcitx5-configtool</tt> after starting fcitx5,
+then select and add your preferred input method from the Avaliable
+Input Method panel. You might need to uncheck 'Only Show Current
+Language' to find your preferred input method.
+
+After restarting with the updated configuration, fcitx should be usable, refers
+to <tt>/usr/local/share/doc/pkg-readmes/fcitx</tt> in case something doesn't
+work or you need to troubleshoot.
+</ul>
+
+
<!--
Two blank lines before new sections.
New sentences start on new lines.