.sh

[sh] Multi-shell dotfiles manager
git clone https://git.torresjrjr.com/.sh.git
Log | Files | Refs | README | LICENSE

README.md (1143B)


      1 dotshell
      2 ========
      3 
      4 Syncs the dotfiles of multiple shells from one repository to $HOME.
      5 Provides multi-machine and user-local configuration.
      6 
      7 
      8 Install
      9 -------
     10 
     11 	$ cd $HOME
     12 	$ git clone https://git.sr.ht/~torresjrjr/.sh
     13 
     14 
     15 Usage
     16 -----
     17 
     18 dotshell provides the `dotshell` command, which syncs shell dotfiles
     19 stored in `$DOTSHELL` to `$HOME` with symbolic links.
     20 
     21 The `$DOTSHELL` variable is set to `$HOME/.sh` by default.  
     22 The `dotshell` command is located at `$DOTSHELL/bin/dotshell`.  
     23 Run `dotshell {shell}...` to sync the dotfiles of `{shell}...`.  
     24 
     25 	$ dotshell sh    # syncs `~/.profile`
     26 	$ dotshell bash  # syncs `~/.bash_profile` & `~/.bashrc`
     27 	$ dotshell zsh   # syncs `~/.zshenv`
     28 
     29 Shell dotfiles in the home directory can be removed safetly.  
     30 For all shell profiles to take effect, logout and login again.  
     31 For all shell rc-files to take effect, source the files.  
     32 
     33 Local-specific configuration can be achieved by writing dotfiles in
     34 `$DOTSHELL/local/` with their respective filenames.
     35 
     36 
     37 Contribute
     38 ----------
     39 
     40 Send patches and questions to <~torresjrjr/public-inbox@lists.sr.ht>
     41 (see [git-send-email.io](https://git-send-email.io/)).