Update of "ShellPAK"

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview

Artifact ID: 3371966580ad7f6ff5d15b15a38593c2d9e8ea9f
Page Name:ShellPAK
Date: 2014-07-31 04:43:47
Original User: cfuhrman
Mimetype:text/x-markdown
Parent: b284732749130ad72c3a30ae1b75e556f7bcb4fb (diff)
Next 93df20a4b4efd0d16fb0d220de5a89d5ff6df7c8
Content

Overview

Provides a general overview of ShellPAK as well as instructions for installing and removing ShellPAK.

Description

ShellPAK allows for the automatic installation and configuration of my personal GNU Bash shell environment as well as the configuration of the following programs:

Requirements

  • GNU Bash version 3.2 or greater
  • rsync

Supported Platforms

The following operating systems are known to be supported:

  • Mac OS X 10.9 (Darwin)
  • NetBSD 6.1.x
  • OpenBSD 5.4
  • CentOS 6.5
  • Debian 7 (Wheezy) and derivatives
  • SunOS solaris 5.10
  • AIX 1 7

In addition, ShellPAK has been known to run on OpenSuSE, SuSE Enterprise Linux, Ubuntu, FreeBSD, and Cygwin.

Obtaining ShellPAK

As of <2014-07-30 Wed>, ShellPAK is managed by the Fossil distributed version control system. To check out a repository:

# Clone the repository
$ fossil clone https://www.fuhrwerks.com/fossil/shellpak ~/shellpak.fossil

# Check out the repository
$ mkdir shellpak
$ cd shellpak
$ fossil open ~/shellpak.fossil

Installation

Assuming you have a version of Shellpak checked out already:

# Install ShellPAK
$ ./setup.sh

# Perform a dry-run
$ ./setup.sh -r

# Install into another directory
$ ./setup.sh -d /path/to/directory

# Do not automatically link files during installation
$ ./setup.sh -n

# Remove ShellPAK
$ ./setup.sh -u

# Change backup directory
$ ./setup.sh -b /path/to/directory

# List runtime options
$ ./setup.sh -h

Note that during installation, ShellPAK will store dot-files (e.g., bashrc, bash_profile, etc) in ~/Backup/shell (or whatever is specified by the -b flag). These files will be restored during un-installation.