= howto (1)
Relearn Roaming Communities
:release-version: 1.0.0
:doctype: manpage
:manmanual: Relearn Roaming Server Howto
:mansource: Relearn Roaming Server Howto {release-version}

== NAME

howto - the short story about how we propose to relearn the shell environment.

== RELEARNING THE SHELL ENVIRONMENT

In order to provide a more friendly and expressive shell environment for the
users of this feminist server, we propose to intervene within the workings of
Bash.

Bash loads the /etc/profile fill everytime it is invoked. This provides a way
for us to intervene. Every time a user enters the server via the SSH command, a
Bash session is invoked.

We therefore create two pads:

  http://relearn.local/etherdump/publish/bash-pre-exec
  http://relearn.local/etherdump/publish/hooks

We include the "__PUBLISH__" keyword on these pads which triggers
the Etherdump program which converts the pad to multiple formats and
stores them in the /var/www/html/etherdump/publish/.

The "bash-pre-exec" pad allows Bash to load our interventions which are described
in the "hooks" pad. We then load these within the default /etc/profile file with:

  cp /var/www/html/etherdump/publish/hooks /opt/hooks
  cp /var/www/html/etherdump/publish/bash-pre-exec /opt/hooks/bash-pre-exec
  source /opt/hooks/bash-pre-exec
  source /opt/hooks/hooks

At this point, the interventions that we define within the "hooks" pad, will be
invoked in the Bash session of every user on the system. This provides a new
way to relearn the shell environment.

== ETHERDUMP

This pad is locally available at the following pad:

    http://relearn.local:9001/p/howto

We use the following "Magic Word" to publish this pad with etherdump:

// __PUBLISH__