Documentation?
adnelson opened this issue · comments
I'm trying to find information on how to configure FinalTerm. It looks like a very promising product, but I just can't seem to find any documentation on how to use it. After some poking around, I found a settings menu which was very anemic but at least allowed me to change my font. It also allowed me to change the color scheme, but I couldn't modify the color schemes. I can't modify any keybindings -- indeed, I don't even know what key bindings there are by default, because I can't find any documentation. I can't get it to not show the menu bar at the top (with the FinalTerm button). I can't get it to start up with my default shell (zsh). The web site talks about many features that FinalTerm has, but nowhere that I can see does it link to pages explaining how to use this functionality: for example, binding functions is "as simple as editing a text file". Ok, which text file? How do I add those bindings?
Neither the web site (that I can tell), the README on github, nor the man page, seem to contain any documentation, let alone thorough documentation. FinalTerm seems really great, but either the documentation needs to be written, or it needs to be easier to find.
Want to back this issue? Post a bounty on it! We accept bounties via Bountysource.
I agree, the documentation is lacking. As for where the files are that you need to edit, check out /usr/share/finalterm/ for the system configuration files (if you installed finalterm); e.g., edit /usr/share/finalterm/KeyBindings/default.ftkeys to modify the keybindings or edit /usr/share/finalterm/ColorSchemes/default.ftcolors to change the default color scheme.
If you are compiling from source, you can edit the same files in finalterm_directory/data before compiling and then installing them with sudo make install
One of the things in my "todo" list is to improve the settings menu and make it more clear as to where these files are located.
@nashley: There are two things that I expect would make fine-tuning easier:
- Rather than
/usr/share//usr/local/share, Final Term should use the current user's dotfiles (e.g.~/.config/finalterm) - There should be menu items that directly open the various configuration files in a text editor (this idea is basically stolen from Sublime Text)
That way, each user can edit his own configuration without requiring root access, and every configuration file is just a click away.
