desantbucie / korny

[pd/m/o]ksh[93] plugin. Coloring built in.

korny

Something like plugin manager for kornshell

Requirements

• git (avoid apple crappy one, install one from nix or brew¹)
• ksh93 (Best option), pdksh or mksh(with limitations²).
• printf built-in to shell, or as external program

Tested OSes

• macOS
• SunOS
• FreeBSD and OpenBSD
• Linux should also work
• even Android

Installation

1. Change default shell to kornshell(if you have to):

   • which ksh - output will be path to ksh

   • Make sure that ksh is in /etc/shells, if there isn't, enter full path

   • chsh -s <PATH TO KSH>

2. Run: ksh -c "$(curl -fsSL https://raw.githubusercontent.com/DesantBucie/korny/master/bin/install.ksh)"

3. Only ksh93u+m supports autocd, so note that.

4. Some systems may require setting export ENV=$HOME/.kshrc³ in ~/.profile or /etc/profile(don't forget to reboot).

Also mksh use .mkshrc, so you either rename .kshrc to .mkshrc, or use step above

Change prompt

Change line named PROMPT in ~/.kshrc to filename without extension i.e ibsd

Load plugins

By default you will load git_aliases and android plugins(plus base plugins starting with. _). Plugins with .ksh93, are for ksh93 only. To add plugin, just edit ~/.kshrc, enter it's filename

set -A plugins_array -- \
android git_aliases #Load plugins
load_plugs 

To see all plugins, check plugin folder.

Load completion

Completion works only in oksh, it is forked from ohmyksh

You load it the same way as plugins, in ~/.kshrc but istead of plugins-array load it in completion_array just below

Note that not all completions are crossplatform(i.e openbsd)

Update

Type: korn u or korn update

Uninstall

Type: korn rm or korn remove

Footnotes

1. This is why. ↩

2. As I tested it on NetBSD, there were problems with prompt loading if there were too many lines in PS1 variable. It cannot be fixed from this level most likely. ↩

3. You can set any path(and copy .kshrc there), for example i have it under export ENV="$HOME/.config/ksh/rc" ↩

korny's Issues

Make plugin that would make making prompts easier.

Using ibsd(255colors) prompt crashes netbsd9.2(amd64).

Basic 8 color prompt works ok, but switching to ibsd will crash netbsd xorg along with system. If you already face this problem before you log in switch tty(ctrl +f2) and change prompt to Otto_colori.

When using git init, error occurs.

fatal: ambiguous argument 'HEAD': unknown revision or path not in the working tree.

Error stops after first commit obviously.

Implement autocd

Compatibility between OpenBSD's ksh and AT&T ksh

Todo, i have no idea how yet.

Question: why avoid apple git?

In your readme, you have,

git (avoid apple crappy one, install one from nix or brew)

This is the first time I've been advised to avoid Apple git. I'm curious, why should I avoid it?

When in / directory, {$PWD##*/ } doesn't print it.