From ca7b0cd7961e87bb618a4c8376f87253ffd894f2 Mon Sep 17 00:00:00 2001 From: Mike Burns Date: Sat, 27 Jul 2013 00:32:03 -0400 Subject: Flatten man and share directories The `man` and `share` directories in this project had an unnecessarily deeply nested structure. Flatten it. --- man/lsrc.1 | 50 ++++++++++++++++++++++++++++++++++++++++ man/man1/lsrc.1 | 50 ---------------------------------------- man/man1/mkrc.1 | 45 ------------------------------------ man/man1/rcup.1 | 70 -------------------------------------------------------- man/man5/rcrc.5 | 40 -------------------------------- man/mkrc.1 | 45 ++++++++++++++++++++++++++++++++++++ man/rcrc.5 | 40 ++++++++++++++++++++++++++++++++ man/rcup.1 | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ share/rcm.sh | 11 +++++++++ share/rcm/rcm.sh | 11 --------- 10 files changed, 216 insertions(+), 216 deletions(-) create mode 100644 man/lsrc.1 delete mode 100644 man/man1/lsrc.1 delete mode 100644 man/man1/mkrc.1 delete mode 100644 man/man1/rcup.1 delete mode 100644 man/man5/rcrc.5 create mode 100644 man/mkrc.1 create mode 100644 man/rcrc.5 create mode 100644 man/rcup.1 create mode 100644 share/rcm.sh delete mode 100644 share/rcm/rcm.sh diff --git a/man/lsrc.1 b/man/lsrc.1 new file mode 100644 index 0000000..50642a6 --- /dev/null +++ b/man/lsrc.1 @@ -0,0 +1,50 @@ +.TH lsrc "1" "July 2013" "rcm" + +.SH NAME +lsrc \- show configuration files + +.SH SYNOPSIS +.B lsrc [-v] [-q] [-t \fItag\fR] [-d \fIdir\fR] [\fIfiles...\fR] + +.SH DESCRIPTION + +This program lists all configuration files, both the sources in the +dotfiles directories and the destinations in your home directory. + +See \fIrcup\fR\|(1), the \fBDIRECTORY LAYOUT\fR section, for details on +the directory layout. + +It supports these options: + +.TP +\fB-v\fR +increase verbosity. This can be repeated for extra verbosity. + +.TP +\fB-q\fR +decrease verbosity + +.TP +\fB-t\fR \fITAG\fR +list dotfiles according to TAG + +.TP +\fB-d\fR \fIDIR\fR +list dotfiles from the DIR. This can be specified multiple times. + +.TP +\fIfiles...\fR +only list the specified file(s) + + +.SH AUTHOR + +Written by Mike Burns. + +.SH FILES +.I ~/.dotfiles +.I ~/.rcrc + +.SH SEE ALSO + +\&\fIrcrc\fR\|(5), \fImkrc\fR\|(1), \fIrcup\fR\|(1) diff --git a/man/man1/lsrc.1 b/man/man1/lsrc.1 deleted file mode 100644 index 50642a6..0000000 --- a/man/man1/lsrc.1 +++ /dev/null @@ -1,50 +0,0 @@ -.TH lsrc "1" "July 2013" "rcm" - -.SH NAME -lsrc \- show configuration files - -.SH SYNOPSIS -.B lsrc [-v] [-q] [-t \fItag\fR] [-d \fIdir\fR] [\fIfiles...\fR] - -.SH DESCRIPTION - -This program lists all configuration files, both the sources in the -dotfiles directories and the destinations in your home directory. - -See \fIrcup\fR\|(1), the \fBDIRECTORY LAYOUT\fR section, for details on -the directory layout. - -It supports these options: - -.TP -\fB-v\fR -increase verbosity. This can be repeated for extra verbosity. - -.TP -\fB-q\fR -decrease verbosity - -.TP -\fB-t\fR \fITAG\fR -list dotfiles according to TAG - -.TP -\fB-d\fR \fIDIR\fR -list dotfiles from the DIR. This can be specified multiple times. - -.TP -\fIfiles...\fR -only list the specified file(s) - - -.SH AUTHOR - -Written by Mike Burns. - -.SH FILES -.I ~/.dotfiles -.I ~/.rcrc - -.SH SEE ALSO - -\&\fIrcrc\fR\|(5), \fImkrc\fR\|(1), \fIrcup\fR\|(1) diff --git a/man/man1/mkrc.1 b/man/man1/mkrc.1 deleted file mode 100644 index b8b555f..0000000 --- a/man/man1/mkrc.1 +++ /dev/null @@ -1,45 +0,0 @@ -.TH mkrc "1" "June 2013" "rcm" - -.SH NAME -mkrc \- bless files into a dotfile - -.SH SYNOPSIS -.B mkrc [-v] [-q] [-t \fItag\fR] [-d \fIdir\fR] \fIfiles...\fR - -.SH DESCRIPTION - -This program adds files to your dotfiles directory then installs it -back into your home directory. It can install files under a tag or -different source directory. - -It supports these options: - -.TP -\fB-v\fR -increase verbosity. This can be repeated for extra verbosity. - -.TP -\fB-q\fR -decrease verbosity - -.TP -\fB-t\fR \fITAG\fR -install dotfiles according to tag - -.TP -\fB-d\fR \fIDIR\fR -install dotfiles under the specified directory. This can be specified -multiple times. - -.SH AUTHOR - -Written by Mike Burns. - -.SH FILES - -.I ~/.dotfiles -.I ~/.rcrc - -.SH SEE ALSO - -\&\fIrcrc\fR\|(5), \fIrcup\fR\|(1), \fIlsrc\fR\|(1) diff --git a/man/man1/rcup.1 b/man/man1/rcup.1 deleted file mode 100644 index c24753c..0000000 --- a/man/man1/rcup.1 +++ /dev/null @@ -1,70 +0,0 @@ -.TH rcup "1" "June 2013" "rcm" - -.SH NAME -rcup \- update and install dotfiles - -.SH SYNOPSIS -.B rcup [-v] [-q] [-t \fItag\fR] [-d \fIdir\fR] [\fIfiles...\fR] - -.SH DESCRIPTION - -This is a program to update and install personal dotfiles. These -dotfiles are managed in a separate directory. Use \fBrcup\fR to install -files from your dotfiles directories or from host- or tag-specific -directories within. - -See \fBDIRECTORY LAYOUT\fR for details on the directory layout. - -It supports these options: - -.TP -\fB-v\fR -increase verbosity. This can be repeated for extra verbosity. - -.TP -\fB-q\fR -decrease verbosity - -.TP -\fB-t\fR \fITAG\fR -install dotfiles according to TAG - -.TP -\fB-d\fR \fIDIR\fR -install dotfiles from the DIR. This can be specified multiple times. - -.TP -\fIfiles...\fR -only install the specified file(s) - -.SH DIRECTORY LAYOUT - -Any non-dot non-meta file or directory under your dotfiles directory will be -installed as a dotfile. For example, \fI.dotfiles/zshrc\fR will be -installed into \fI~/.zshrc\fR\|. - -Files are installed as symlinks. Directories are installed by making -directories. - -Two meta files are supported: host-specific files and tagged files. - -Host-specific files go in a directory named for the host, prefixed with -\fIhost-\fR\|. For example, \fI.dotfiles/host-scarlett\fR contains files -specific to the computer with hostname \fIscarlett\fR\|, and these files -will only be installed on the computer with hostname \fIscarlett\fR\|. - -Tagged files go in a directory named for the tag, prefixed with -\fItag-\fR\|. Files under \fI.dotfiles/tag-git\fR are only installed -when installing using the \fIgit\fR tag. - -.SH AUTHOR - -Written by Mike Burns. - -.SH FILES -.I ~/.dotfiles -.I ~/.rcrc - -.SH SEE ALSO - -\&\fIrcrc\fR\|(5), \fImkrc\fR\|(1), \fIlsrc\fR\|(1) diff --git a/man/man5/rcrc.5 b/man/man5/rcrc.5 deleted file mode 100644 index 6f28e06..0000000 --- a/man/man5/rcrc.5 +++ /dev/null @@ -1,40 +0,0 @@ -.TH rcrc "5" "June 2013" "rcm" - -.SH NAME -rcrc \- configuration for rcm - - -.SH DESCRIPTION - -The rcm dotfile manager can be configured using a \fI.rcrc\fR file in -your home directory. The format is POSIX shell, and it is sourced in by -the \fBrcup\fR and \fBmkrc\fR programs. - -It supports these variables: - -.TP -\fBTAGS\fR -the default tags used by \fBrcup\fR\|. - -.TP -\fBDOTFILES_DIRS\fR -the source directories for dotfiles. The first in the list is the -canonical source. The default value is \fI~/.dotfiles\fR\|. - -.SH EXAMPLES - -\&\fBTAGS="freebsd development email git laptop gmail notmuch"\fR -\&\fBDOTFILES_DIRS="/home/mike/.dotfiles /usr/share/dotfiles"\fR - -.SH AUTHOR - -Written by Mike Burns. - -.SH FILES - -.I ~/.rcrc -.I ~/.dotfiles - -.SH SEE ALSO - -\&\fImkrc\fR\|(5), \fIrcup\fR\|(1), \fIlsrc\fR\|(1) diff --git a/man/mkrc.1 b/man/mkrc.1 new file mode 100644 index 0000000..b8b555f --- /dev/null +++ b/man/mkrc.1 @@ -0,0 +1,45 @@ +.TH mkrc "1" "June 2013" "rcm" + +.SH NAME +mkrc \- bless files into a dotfile + +.SH SYNOPSIS +.B mkrc [-v] [-q] [-t \fItag\fR] [-d \fIdir\fR] \fIfiles...\fR + +.SH DESCRIPTION + +This program adds files to your dotfiles directory then installs it +back into your home directory. It can install files under a tag or +different source directory. + +It supports these options: + +.TP +\fB-v\fR +increase verbosity. This can be repeated for extra verbosity. + +.TP +\fB-q\fR +decrease verbosity + +.TP +\fB-t\fR \fITAG\fR +install dotfiles according to tag + +.TP +\fB-d\fR \fIDIR\fR +install dotfiles under the specified directory. This can be specified +multiple times. + +.SH AUTHOR + +Written by Mike Burns. + +.SH FILES + +.I ~/.dotfiles +.I ~/.rcrc + +.SH SEE ALSO + +\&\fIrcrc\fR\|(5), \fIrcup\fR\|(1), \fIlsrc\fR\|(1) diff --git a/man/rcrc.5 b/man/rcrc.5 new file mode 100644 index 0000000..6f28e06 --- /dev/null +++ b/man/rcrc.5 @@ -0,0 +1,40 @@ +.TH rcrc "5" "June 2013" "rcm" + +.SH NAME +rcrc \- configuration for rcm + + +.SH DESCRIPTION + +The rcm dotfile manager can be configured using a \fI.rcrc\fR file in +your home directory. The format is POSIX shell, and it is sourced in by +the \fBrcup\fR and \fBmkrc\fR programs. + +It supports these variables: + +.TP +\fBTAGS\fR +the default tags used by \fBrcup\fR\|. + +.TP +\fBDOTFILES_DIRS\fR +the source directories for dotfiles. The first in the list is the +canonical source. The default value is \fI~/.dotfiles\fR\|. + +.SH EXAMPLES + +\&\fBTAGS="freebsd development email git laptop gmail notmuch"\fR +\&\fBDOTFILES_DIRS="/home/mike/.dotfiles /usr/share/dotfiles"\fR + +.SH AUTHOR + +Written by Mike Burns. + +.SH FILES + +.I ~/.rcrc +.I ~/.dotfiles + +.SH SEE ALSO + +\&\fImkrc\fR\|(5), \fIrcup\fR\|(1), \fIlsrc\fR\|(1) diff --git a/man/rcup.1 b/man/rcup.1 new file mode 100644 index 0000000..c24753c --- /dev/null +++ b/man/rcup.1 @@ -0,0 +1,70 @@ +.TH rcup "1" "June 2013" "rcm" + +.SH NAME +rcup \- update and install dotfiles + +.SH SYNOPSIS +.B rcup [-v] [-q] [-t \fItag\fR] [-d \fIdir\fR] [\fIfiles...\fR] + +.SH DESCRIPTION + +This is a program to update and install personal dotfiles. These +dotfiles are managed in a separate directory. Use \fBrcup\fR to install +files from your dotfiles directories or from host- or tag-specific +directories within. + +See \fBDIRECTORY LAYOUT\fR for details on the directory layout. + +It supports these options: + +.TP +\fB-v\fR +increase verbosity. This can be repeated for extra verbosity. + +.TP +\fB-q\fR +decrease verbosity + +.TP +\fB-t\fR \fITAG\fR +install dotfiles according to TAG + +.TP +\fB-d\fR \fIDIR\fR +install dotfiles from the DIR. This can be specified multiple times. + +.TP +\fIfiles...\fR +only install the specified file(s) + +.SH DIRECTORY LAYOUT + +Any non-dot non-meta file or directory under your dotfiles directory will be +installed as a dotfile. For example, \fI.dotfiles/zshrc\fR will be +installed into \fI~/.zshrc\fR\|. + +Files are installed as symlinks. Directories are installed by making +directories. + +Two meta files are supported: host-specific files and tagged files. + +Host-specific files go in a directory named for the host, prefixed with +\fIhost-\fR\|. For example, \fI.dotfiles/host-scarlett\fR contains files +specific to the computer with hostname \fIscarlett\fR\|, and these files +will only be installed on the computer with hostname \fIscarlett\fR\|. + +Tagged files go in a directory named for the tag, prefixed with +\fItag-\fR\|. Files under \fI.dotfiles/tag-git\fR are only installed +when installing using the \fIgit\fR tag. + +.SH AUTHOR + +Written by Mike Burns. + +.SH FILES +.I ~/.dotfiles +.I ~/.rcrc + +.SH SEE ALSO + +\&\fIrcrc\fR\|(5), \fImkrc\fR\|(1), \fIlsrc\fR\|(1) diff --git a/share/rcm.sh b/share/rcm.sh new file mode 100644 index 0000000..54bdb07 --- /dev/null +++ b/share/rcm.sh @@ -0,0 +1,11 @@ +VERSION="0.0.2" + +version() { + cat << EOV +$1 (rcm) $VERSION +Copyright (C) 2013 Mike Burns +License BSD: BSD 3-clause license + +Written by Mike Burns. +EOV +} diff --git a/share/rcm/rcm.sh b/share/rcm/rcm.sh deleted file mode 100644 index 54bdb07..0000000 --- a/share/rcm/rcm.sh +++ /dev/null @@ -1,11 +0,0 @@ -VERSION="0.0.2" - -version() { - cat << EOV -$1 (rcm) $VERSION -Copyright (C) 2013 Mike Burns -License BSD: BSD 3-clause license - -Written by Mike Burns. -EOV -} -- cgit v1.2.3