aboutsummaryrefslogtreecommitdiff
path: root/man/cpt-alternatives.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/cpt-alternatives.1')
-rw-r--r--man/cpt-alternatives.1101
1 files changed, 58 insertions, 43 deletions
diff --git a/man/cpt-alternatives.1 b/man/cpt-alternatives.1
index 8ae073d..8196b40 100644
--- a/man/cpt-alternatives.1
+++ b/man/cpt-alternatives.1
@@ -1,44 +1,59 @@
-.TH "cpt-alternatives" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
-.SH NAME
-cpt-alternatives
-.SH DESCRIPTION
-List and swap to alternatives
-.PP
-.SH SYNOPSIS
-\fBcpt-alternatives\fR [-] [pkg file]
-
-.SH USAGE
-cpt-alternatives can be used to list alternatives (when run without arguments).
-It can read from standard input if ('-' is given as an argument). If you want to
-otherwise
-
-.SH EXAMPLES
-.nf
-+-----------------------------------------------------------------------+
-| List alternatives |
-+-----------------------------------------------------------------------+
-| |
-| $ cpt-alternatives |
-| ncurses /usr/bin/clear |
-| ncurses /usr/bin/reset |
-| |
-+-----------------------------------------------------------------------+
-| Swap to 'clear' from ncurses. |
-+-----------------------------------------------------------------------+
-| |
-| $ cpt-alternatives ncurses /usr/bin/clear |
-| -> Swapping '/usr/bin/clear' from 'busybox' to 'ncurses' |
-| |
-+-----------------------------------------------------------------------+
-| Swap in bulk (all of sbase). |
-+-----------------------------------------------------------------------+
-| |
-| $ cpt-alternatives | grep ^sbase | cpt-alternatives - |
-| |
-+-----------------------------------------------------------------------+
-.fi
-
-.SH LICENSE
+.Dd Feb 25, 2021
+.Dt cpt-alternatives 1
+.Sh NAME
+.Nm cpt-alternatives
+.Nd List and swap to alternatives
+.Sh SYNOPSIS
+.Nm cpt-alternatives
+.Op Ar -
+.Op Ar package file
+.Sh USAGE
+.Nm
+can be used to either list or swap to alternatives, depending on the given
+arguments:
+.Bl -tag -offset indent -width 12n
+.It Sy -
+Swap to alternatives given on the standard input.
+.It Sy none
+List alternatives.
+.It Sy pkg file
+Swap to the alternative
+.Sy file
+from
+.Sy pkg
+.El
+.Sh EXAMPLES
+.Pp
+Here are some sample commands to make it easier to understand how
+.Nm
+works.
+.Ss LISTING ALTERNATIVES
+.Pp
+Calling
+.Nm
+without any arguments will print all available alternatives on your system.
+.Bd -literal -offset indent
+$ cpt-alternatives
+ncurses /usr/bin/clear
+ncurses /usr/bin/reset
+.Ed
+.Ss SWITCHING ALTERNATIVES
+You can simply switch between alternatives by giving the name of the package and
+the file as arguments.
+.Bd -literal -offset indent
+$ cpt-alternatives ncurses /usr/bin/clear
+-> Swapping '/usr/bin/clear' from 'busybox' to 'ncurses'
+.Ed
+.Ss SWITCHING ALTERNATIVES IN BULK
+There may be times where you want to change multiple alternatives at once. Here
+is an example for using all alternatives from the package
+.Sy sbase .
+.Bd -literal -offset indent
+$ cpt-alternatives | grep ^sbase | cpt-alternatives -
+.Ed
+.Sh AUTHOR
+.An Cem Keylan Aq Mt cem@ckyln.com
+.Sh LICENSE
See LICENSE for copyright information.
-.SH SEE ALSO
-cpt(1)
+.Sh SEE ALSO
+.Xr cpt 1