From 688e073486606908a5df3ad659bdc40ee9508f2b Mon Sep 17 00:00:00 2001
From: Wolfgang Müller
Date: Sun, 24 Feb 2019 02:08:41 +0100
Subject: Initial commit

---
 rolectl.1 | 73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 rolectl.1

(limited to 'rolectl.1')

diff --git a/rolectl.1 b/rolectl.1
new file mode 100644
index 0000000..2efc2a5
--- /dev/null
+++ b/rolectl.1
@@ -0,0 +1,73 @@
+.Dd February 24, 2019
+.Dt ROLECTL 1
+.Os
+.Sh NAME
+.Nm rolectl
+.Nd manage portage roles with stow
+.Sh SYNOPSIS
+.Nm
+.Op Ar command
+.Sh DESCRIPTION
+.Nm
+is a program to add, remove, and list portage roles.
+.Pp
+A
+.Dq role
+is a directory comprised of a set of portage configuration files
+pertaining to a specific service, usage, et cetera.
+Roles are placed into
+.Em /etc/portage/stow .
+.Pp
+.Nm
+uses
+.Xr stow 1
+to build a full set of portage configuration files in
+.Em /etc/portage .
+It does so by creating symlinks in
+.Em /etc/portage
+that point back to the actual files in the role directories.
+.Pp
+The commands are as follows:
+.Bl -tag -width Ds
+.It Sy add Em role
+Activates the given role on the system.
+.It Sy flush
+Deactivates all actives roles on the system.
+.It Sy list [ Em type ]
+Lists roles of the given type.
+If no type is given, list roles of the
+.Dq active
+type.
+The types are as follows:
+.Bl -tag -width Ds
+.It Sy active
+Lists roles that are active on the system.
+.It Sy all
+Lists all roles.
+.It Sy available
+Lists roles that not active on the system.
+.El
+.It Sy rebuild
+Deactivates all active roles and then activates them again.
+This is used to incorporate files that have been added to an already
+active role.
+.It Sy remove Em role
+Deactivates the given role on the system.
+.El
+.Pp
+If no command is given,
+.Nm
+will list active roles.
+.Sh FILES
+.Bl -tag -width Ds
+.It Em /etc/portage/stow
+The base directory containing all portage roles.
+.El
+.Sh SEE ALSO
+.Xr stow 1 ,
+.Xr portage 5
+.Sh AUTHORS
+.An -nosplit
+.Nm
+was written by
+.An Wolfgang Müller Aq Mt vehk@vehk.de
-- 
cgit v1.2.3-2-gb3c3