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/rcup.1 | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 man/rcup.1 (limited to 'man/rcup.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) -- cgit v1.2.3