Wikiの情報が古いのかすぐ使えないものが多い(特にhtmlfileサブコマンド) about bitclust HOT 3 OPEN

そうなんですよね。
私も以前，るりまの修正に参加していましたが，先日，久しぶりにやろうとするとうまくいかなくて，当時どうやっていたのか思い出せず止まっています（←イマココ）

マニュアル全体のビルドはできますし，文章のタイポ修正くらいなら GitHub 上でやれるのですが，フォーマットが問題になるような修正は htmlfile サブコマンドを使う必要があり，それができなくて困っています。
Wiki を見れば誰でもやれるようになっているといいですね。
記述が古い，もしくは少し間違っている（？）のに加え，複数ページに似た記述があって，どこをみたらいいのか，久々に読もうとするとよく分からないです。

るりまの編集に参加していた頃，一度 Wiki を分かりやすく書き直そうと思ったのですが，それができる程度に bitclust を理解することができず，断念した覚えもあります。

from bitclust.

特にhtmlfileサブコマンドについて、使いやすくあって欲しいです。

私も Wiki に bitclust htmlfile でどういう場合に使えるかという説明があると嬉しいです。
個人的に、GitHub の Wiki は更新しても誰にも通知が飛ばないことと、レビューされないまま更新できてしまうのが好きではなくて修正するハードルが高いです。気にせず更新していってしまったほうがいいんですかねえ

--forceオプションは存在するようですが動かないし、

--force オプションが動かなかった場合が分からなかったのですが、特定の場合には動きます。例えば、https://github.com/rurema/doctree/blob/master/refm/doc/symref.rd のようなそのままでは途中で落ちて出力できないファイルを --force で出力させることができます。

$ bitclust htmlfile refm/doc/symref.rd > /tmp/tmp.html # 失敗する
$ bitclust htmlfile --force refm/doc/symref.rd > /tmp/tmp.html # 出力できる

from bitclust.

--force オプションが動かなかった場合が分からなかったのですが、特定の場合には動きます。

これ動くんですね〜！

bitclust htmlfile refm/api/src/_builtin/Array > /tmp/tmp.html 
bitclust htmlfile --force refm/api/src/_builtin/Array > /tmp/tmp.html

何のオプションなのかよくわからず試してましたが、
自分が試したのは--forceつけると逆にエラーになるので動かないオプションなのかと思ってしまいました、

from bitclust.