Re: [misc] documentation

On Mon, 22 Oct 2018 at 10:41:38, Marco van Hulten wrote:
> In another version, I get the expected online help page.  There «:help
> edit» works, as does «:help s».  However, when I type «:help q» I get a
> section on «Generic key bindings» instead of on quitting the program.

That is because q is a generic key binding.

> When typing «:help :w», or «:help :q» or «:help quit» shows «Help topic
> does not exist: ...».

That is because this help topic does not (yet) exist.

> Besides this help, there are the manual page and the HTML
> documentation, both on https://calcurse.org/support/ .  In neither of
> those resources the generic command (:) is documented as far as I can
> see.  The HTML page is more exhaustive than the manual page.  I presume
> that their contents are manually synchronised when there is an update
> in one or the other.

We try to keep them in sync but we could definitely do a better job
here. Patches welcome!

> Finally, I found the online help in the repository in doc/.  The
> directories of different language code contain only English text, e.g.
> «diff doc/pipe.txt doc/ru/pipe.txt» returns zero lines.  Is this work
> to be done?

Yes, only few help texts are translated so far.

Best regards,
Lukas

Links