Config file and package tracking utility
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

75 lines
1.8 KiB

#+TITLE: Manafiles
#+AUTHOR: Riyyi
#+LANGUAGE: en
#+OPTIONS: toc:nil
3 years ago
Config file and package tracking utility.
3 years ago
- Manage dotfiles and system config files.
- Selectively comment and uncomment depending on machine configuration.
- Store a list of all installed packages.
- Install packages from a stored list.
** Installation
This package is available through the AUR, linked here [[https://aur.archlinux.org/packages/manafiles-git/][manafiles-git]].
** Building
*** Build requirements
+ ~gcc-libs~
+ (make) ~cmake~
+ (make) ~git~
+ (make) ~gzip~
+ (optional) ~grep~
+ (optional) ~pacman-contrib~
+ (optional) ~apt-cache~, ~apt-mark~, ~dpkg-query~
The optional requirements are for the package tracking functionality.
*** Build instructions
#+BEGIN_SRC shell-script
$ mkdir build
$ cd build
$ cmake ..
$ make
#+END_SRC
3 years ago
*** Build installation
3 years ago
#+BEGIN_SRC shell-script
$ sudo make install
#+END_SRC
3 years ago
** Usage
3 years ago
*** Selectively comment and uncomment
3 years ago
Config files can be pushed from the working directory to the system like so:
3 years ago
#+BEGIN_SRC shell-script
$ manafiles -Fs
3 years ago
#+END_SRC
When pushing files to the system, manafiles recognizes special blocks and comments
or uncomments them depending on the machine's configuration. Such a block looks
like this:
3 years ago
#+BEGIN_SRC shell-script
# >>> distro=arch hostname=arch-desktop user=anon
export PATH="$PATH:$HOME/.local/bin"
# <<<
3 years ago
#+END_SRC
This block uses all of the supported configurations, ~distro~, ~hostname~ and
~user~. These can be used in any combination and order.
If *all* of the given configurations match, manafiles will make sure that the
contents of the block are uncommented. If *any* of them do *not* match, then
manafiles will make sure that the contents of the block are commented.
*** COMMENT System config files
*** COMMENT Exclude paths