Browse Source

Fix the readme

Nicolas Petton 3 years ago
Signed by: nico GPG Key ID: 233587A47C207910
2 changed files with 1 additions and 62 deletions
  1. +0
  2. +1

+ 0
- 1
README View File

@ -1 +0,0 @@
My Emacs config

+ 1
- 61 View File

@ -1,61 +1 @@
Assimilate Emacs packages as Git submodules
*For more information see the [announcement][init] and the [manual].*
About `borg.el`
[Borg][repo] is a bare-bones package manager for Emacs packages. It
provides only a few essential features and should be combined with
other tools such as Magit, `epkg`, `use-package`, and `auto-compile`.
Borg assimilates packages into the `~/.emacs.d` repository as Git
submodules. An assimilated package is called a drone and a borg-based
`~/.emacs.d` repository is called a collective.
About this collective
This particular collective is intended to be used to bootstrap private
configurations. Fork your own copy and then start assimilating as you
If you wish you can later merge changes from the upstream repository,
to get updates for the drones that have been assimilated in the base
configuration. Very rarely additional drones might be assimilated or
the configuration of existing drones might be tweaked.
Or you can just update and further configure these drones as you would
update the drones you have assimilated yourself.
If you do base your own configuration on this collective and make it
publically available as source of inspiration for others, then please
do so by forking the upstream repository, which is available from
[Github][gh-this], [Gitlab][gl-this], and [Bitbucket][bb-this].
You might also want to adjust this description.
Other collectives
It is also possible to create collectives that can be shared between
and worked on by many Emacs users, i.e. borg-based starter-kits.
Check out alternative collectives by browsing the repositories owned
by the `emacscollective` organisation/group/team, which is available
on [Github][gh-all], [Gitlab][gl-all], and [Bitbucket][bb-all].
Another alternative is the `bootstrap` collective. It assimilates a
single drone, `borg` itself, and is intended for users for whom even
the `emacs.g` collective is to opinionated.
My Emacs config