aboutsummaryrefslogtreecommitdiff
path: root/README.mdwn
diff options
context:
space:
mode:
authorSilvio Rhatto <rhatto@riseup.net>2013-12-27 14:47:22 -0200
committerSilvio Rhatto <rhatto@riseup.net>2013-12-27 14:47:22 -0200
commite95b8dbe6be571feb2691e838c340059d1401ab8 (patch)
tree3a30b4981521cf416a7dcaaa57bfcacf9f2b563a /README.mdwn
parent03fdeb451b3bf1c63e3f2a725bf9bdb8e137f0a7 (diff)
downloaddotfiles-e95b8dbe6be571feb2691e838c340059d1401ab8.tar.gz
dotfiles-e95b8dbe6be571feb2691e838c340059d1401ab8.tar.bz2
Cleaning up metadot code
Diffstat (limited to 'README.mdwn')
-rw-r--r--README.mdwn97
1 files changed, 4 insertions, 93 deletions
diff --git a/README.mdwn b/README.mdwn
index 901c8be..9d4cb0a 100644
--- a/README.mdwn
+++ b/README.mdwn
@@ -1,94 +1,5 @@
-Metadot: modular dotfile management system
-==========================================
+Rhatto's dotfiles bundle
+========================
-Metadot allows you to easilly manage and reuse existing dotfiles repositories
-by simply cloning then to your `~/.dotfiles/modules` and renaming a few files.
-
-By being modular, it's possible to create modules for specific applications
-(vim, mutt, emcas, git, etc). By using git submodules, one can even create her
-own dotfile bundle.
-
-Inspired by [holman does dotfiles](https://github.com/holman/dotfiles) and many
-other initiatives but with a modular design to ease dotfile sharing as the
-`metadot` code is split from the dotfile folder.
-
-Instalation
------------
-
-Get the code:
-
- git clone --recursive git://git.sarava.org/metadot.git
-
-Save the metadot repository anywhere but make sure it's available in your `$PATH`.
-Then get some modules. You can get the whole standard module bundle with:
-
- git clone --recursive git://git.sarava.org/rhatto/dotfiles.git ~/.dotfiles
-
-This bundle will hardly suit all your needs. You can fetch individual modules or even
-start your own bundle:
-
- mkdir -p ~/.dotfiles/modules
- git clone --recursive git://git.sarava.org/rhatto/dotfiles/vim.git ~/.dotfiles/modules/vim
-
-Usage
------
-
-List existing modules:
-
- metadot ls
-
-Load a module:
-
- metadot load <module>
-
-Load all modules:
-
- metadot load --all
-
-Update a module bundle:
-
- metadot update
-
-Backups are made whenever a module is loaded.
-
-Layout
-------
-
-- ~/.dotfiles: where all dotfiles modules are stored
-- ~/.backups: backups of old config files
-- ~/.custom: some modules use this folder where custom configuration can override default parameters
-
-Module format
--------------
-
-Modules rest at ~/.dotfiles/modules and can be git submodules. File format is:
-
- [path/]<name>[.dot][.link]
-
-Which means files
-
-- with a .link extension are linked at $HOME.
-- with a .dot.link extension are converted to a dotfile: vimrc.dot.link is linked as ~/.vimrc.
-- with other extensions are ignored.
-
-Also,
-
-- file structure is preserved: file apps/scripts.link is linked as $HOME/apps/scripts.
-- nested structures are allowed: config.dot/awesome.link is linked as $HOME/.config/awesome
-
-TODO
-----
-
-- Split: metadot, dotfiles and modules should be separate repositories.
-- Profile: automatic $PATH inclusion for installed script repositories.
-- Check if module is correctly installed.
-- Track loaded modules.
-- Module descriptions and dependencies.
-- Module unloading and restoration.
-- Integration with scripts project.
-- More file types:
- - .sample: copied if no origin file exists
- - .sh: added to the profile
- - .mkdir: are simply created
- - .cp: are copied
- - .template: are copied and transformed according to environment or config variables
+This is the bundle repository for rhatto's dotfiles.
+More information at https://git.sarava.org/?p=metadot.git