Add kontext1.0.0

1 files changed, 54 insertions, 0 deletions

diff --git a/kontext.1 b/kontext.1
new file mode 100644
index 0000000..2b1bc40
--- /dev/null
+++ b/kontext.1
@@ -0,0 +1,54 @@
+.Dd May 21, 2023
+.Dt KONTEXT 1
+.Os
+.
+.Sh NAME
+.Nm kontext
+.Nd per shell Kubernetes contexts
+.
+.Sh SYNOPSIS
+.Nm
+.Op Fl h
+.Op Fl n Ar namespace
+.Ar context 
+.
+.Sh DESCRIPTION
+
+The
+.Nm
+program sets per shell Kubernetes contexts
+to allow power users to work on multiple
+clusters at the same time.
+.Pp
+Note that
+.Nm
+is distributed as a shell fragment
+that must be sourced. In order to
+use it, add the following alias
+to your shell:
+.Bl -tag -width Ds
+.It kontext="source kontext"
+.El
+.
+.Pp
+The arguments are as follows:
+.Bl -tag -width Ds
+.It Fl n | -namespace Ar namespace
+Switch to
+.Ar namespace . The default
+namespace is 'default'.
+.It Fl h | -help
+Shows a short help message.
+.It Ar context
+The context name to use.
+.El
+.
+.Sh EXAMPLES
+.Bd -literal -offset indent
+$ kontext -n kube-system foo
+$ kontext foo
+$ kontext -n kube-system
+.Ed
+.
+.Sh AUTHORS
+.An Christian Segundo Aq Mt christian@segundo.io