Commit graph

741 commits

Author SHA1 Message Date
Nikolai Myllymäki
c5a6006563
Direct font installation link to the right section 2017-01-04 20:27:45 +02:00
Nikolai Myllymäki
2dd0befc6a
Add Spacemacs ABC and Gitter chat to further info 2017-01-04 20:27:40 +02:00
Nikolai Myllymäki
4de3611648
Improved link formatting, minor text edits
Also fixed a broken link
2017-01-04 20:27:30 +02:00
Leandro Lisboa Penz
998f5dcf9a
Fix a link on beginner's tutorial 2017-01-04 20:26:17 +02:00
syl20bnr
74fdbb6795 Refactor and simplify company backends declaration
Enabling a company backend for a specific mode was a tedious tasks with code
scattered at different locations, one for local variable definitions, one for
company hook function definitions and another where the backends were pushed to
the local variables (which was problematic, since we ended up pushing the same
backends over and over again with `SPC f e R`, pushes have been replaced by
add-to-list calls in the new macro).

All these steps are now put together at one place with the new macro
spacemacs|add-company-backends, check its docstring for more info on its
arguments.

This macro also allows to define arbitrary buffer local variables to tune
company for specific modes (similar to layer variables via a keyword :variables)

The code related to company backends management has been moved to the
auto-completion layer in the funcs.el file. A nice side effect of this move is
that it enforces correct encapsulation of company backends related code. We can
now easily detect if there is some configuration leakage when the
auto-completion layer is not used. But we loose macro expansion at file loading
time (not sue it is a big concern though).

The function spacemacs|enable-auto-complete was never used so it has been
deleted which led to the deletion of the now empty file core-auto-completion.el.

The example in LAYERS.org regarding auto-completion is now out of date and has
been deleted. An example to setup auto-completion is provided in the README.org
file of the auto-completion layer.
2017-01-02 00:39:04 -05:00
John Stevenson
8840c94448 evil-escape documentation link update
Updated the FAQ evil-escape documentation link to point to the "14.1.1 Escaping" section of the documentation, where the evil-escape function is described.

Currently the FAQ evil-escape documentation link points to http://spacemacs.org/doc/DOCUMENTATION.html#orgheadline78, which takes you to the "13.1 Layouts" section of the documentation.
2016-12-27 19:20:00 +00:00
Adel Qalieh
8e7fe6e1f2
Add keybinding for spacemacs/alternate-window
spacemacs/alternate-window was suggested to switch between the last selected
window, or the window-analog of SPC TAB (spacemacs/alternate-buffer). This is
part of a larger family of functions, such as spacemacs/jump-to-last-layout on
SPC l TAB and eyebrowse-last-window-config on SPC l w TAB.

Resolves #7845
2016-12-27 09:50:10 +02:00
Joe Lane
43e199b6a5 add copy key to neotree
CHANGES
-------
Add new keybinding to neotree to allow the copying of nodes from the neotree
buffer. Update documentation as well.

WHY
-------
There appear to be all other common file operations bound to the neotree buffer,
however copying of a node is not.
2016-12-09 18:19:52 +02:00
d12frosted
96e6de20f6 add some notes on ivy usage 2016-11-22 20:41:45 -05:00
Rob Donnelly
779072a651 Documentation has outdated shortcut
The suggestions to use SPC ; SPC y is from the previous versions where SPC y was bound to avy-goto-line.
Now that command is bound to SPC j l
2016-11-20 18:59:22 -05:00
Rory O’Kane
31bc9425ff Fix typo in beginner’s tutorial – “differend” 2016-11-20 18:54:48 -05:00
syl20bnr
237b2a7373 Move SPC b m to kill other buffers to SPC b C-d
Also move `SPC b C-d` to kill other buffer with regexp to `SPC b C-D`
Update Documentation accordingly.
2016-11-20 13:27:16 -05:00
Aron Griffis
385c12743a Add ripgrep support
* Add rg to helm completion layer
* Add rg to ivy layer
* Prepend rg to dotspacemacs-search-tools
* Add rg to documentation
2016-11-11 15:22:03 +02:00
syl20bnr
c379cd46cd Beginnier tutorial: refill paragraphs to respect 80col/line 2016-11-07 10:05:27 -05:00
Nikolai Myllymäki
8dd2eb410f Add beginners tutorial - further amendments
Amend suggested fixes:
- Add chapter on key notation
- Fix document structure according to conventions
- Add note on emacs path on Windows
- Expand on evil and emacs mode explanations
- Expand on first startup procedure
- Various typo fixes and clarifications
2016-11-07 10:02:45 -05:00
deb0ch
855d786100
Add duplicate-line-or-region to layer better-defaults
from https://www.emacswiki.org/emacs/CopyingWholeLines

Duplicate current line, or region if active.
With argument N, make N copies.
With negative N, comment out original line and use the absolute value.

keybinding: `SPC x l d` (text - line - duplicate)
2016-11-02 21:07:15 +02:00
Stratos Gerakakis
4f46efcf07 Simple misspelling typos... 2016-10-31 08:35:23 +02:00
Michael Weiss
4a02c8a90a Fix some minor mistakes and typos in the documentation 2016-10-30 08:12:00 +02:00
Eivind Fonn
4bf8e529b8 Move SPC p C-g to SPC p G 2016-10-28 13:44:29 +02:00
Willian van der Velde
187290b6e0 Updates links to layers 2016-10-23 19:44:35 +02:00
syl20bnr
2c5b628570 Move SPC t H to SPC t h s
SPC t h is the prefix for toggling highlighting stuff.
2016-10-23 19:44:35 +02:00
jupl
253276e0d1 Add toggle for syntax highlighting (via font-lock) 2016-10-23 19:44:35 +02:00
syl20bnr
7cdd998e78 Inverse SPC t m t and SPC t m T
Toggling the time is a segment so it is more consistent with the rest
of the lowercase keys.
Toggling the whole mode-line feels better on a capital letter.
2016-10-23 19:44:35 +02:00
jupl
e384b2124b Add toggle to display time in modeline 2016-10-23 19:44:35 +02:00
syl20bnr
d04ab325db Add achievements
9000th star to deb0ch
2016-10-18 22:40:38 -04:00
syl20bnr
66d9f38a45 Add hide/show comments on SPC c h 2016-10-17 15:32:43 -04:00
Peter Nagy
781aa079ab Update layer docs for packages.el to note where should local packages reside
The information about location of local packages is noted in the parent section. While this can be considered enough I kept re-reading `packages.el` and couldn't find the information. Adding the information here as well makes the section more self-contained.
2016-10-17 13:56:53 +02:00
syl20bnr
5e4f609a19 FAQ: add explanation about the usage of the word "distribution" 2016-10-09 12:25:56 -04:00
bmag
c337eb083e Paste TS: fix doc 2016-10-08 19:36:11 +02:00
Andrew Schwartzmeyer
00e0b99c35 Change 'SPC :' to 'SPC SPC' in quick start
The former was deprecated.
2016-10-08 19:27:11 +02:00
syl20bnr
bcf2ce6ca4 Move SPC b k to SPC b C-d 2016-10-03 00:23:15 -04:00
ChuntaoLu
e659965a70
fix typo 2016-09-23 10:45:59 +03:00
bmag
753b81275c dumb-jump: bind key instead of enable mode 2016-09-16 15:07:05 +02:00
syl20bnr
80694ea676 Add some achievements
justbur
 d12frosted
 deb0ch
 shsteven
 JAremko
 TheBB
 travisbhartwell
2016-09-05 21:47:00 -04:00
JAremko
95f4119366 disabled by default centering in space-doc-mode.
Fix centered-buffer-mode conflict with Emacs 25
2016-09-05 21:12:52 -04:00
syl20bnr
4c72b369c3 Typo in DOCUMENTATION.org 2016-08-31 22:34:57 -04:00
syl20bnr
d998c7edf5 Move SPC p G to SPC p C-g to regenerate tags
I have the impression that SPC p G can be used for something more
useful regarding tags.
Tags regeneration triggers a process that can take a while to make
more sense to make it less accessible.

If there is nothing useful to be added to SPC p G we can consider
reverting this commit.
2016-08-31 22:32:27 -04:00
syl20bnr
1b4efdddc3 Move projectile-find-tag from SPC p y to SPC p g
SPC p g was free so why not using it.
2016-08-31 22:32:22 -04:00
Eivind Fonn
3a28393a23 Implement :enabled-for layer keyword 2016-08-31 22:15:13 -04:00
bmag
64a1b85523 NeoTree: clarify docs 2016-08-30 15:55:48 +02:00
Eivind Fonn
0b92e47189 Add note about ivy/helm choice 2016-08-30 15:51:26 +02:00
Allen Li
5877d2fd54
Fix references to declare-used-layer(s) in docs 2016-08-25 21:01:31 -07:00
syl20bnr
c1c2d06f36 Remove SPC j F and SPC j V and add SPC m g G in Emacs Lisp
SPC j F and SPC j V don't fit the SPC j prefix because they require
the thing under point to be an Emacs lisp thing, which means that these
bindings should be major mode specific.
To replace them and accordingly to the convention the key bindings
SPC m g G in Emacs Lisp buffers has been added to go to definition
in other window.

SPC j f and SPC j v (minus letters) don't require the current buffer
to be Emacs Lisp and thus I only updated the documentation about them
mentioning that they're about Emacs Lisp variables and functions.
2016-08-25 21:19:21 -04:00
JAremko
328c6b81aa Add aspect ratio check for centering.
Fix git conflict.
minor improvements and cleanup.
2016-08-21 17:29:19 +02:00
JAremko
7140e8dfa8 Add extra checks, cleanup
simplify space-doc customization

rearrange defcustom groups

more checks
2016-08-21 17:29:16 +02:00
JAremko
9ba525cdde simplify space-doc-mode
refactoring
2016-08-21 17:29:13 +02:00
Eivind Fonn
e94ab321cd faq: add exec-path-from-shell entry 2016-08-21 17:25:36 +02:00
duianto
c6dda79768 added/corrected, rotate keybindings
In the "Windows manipulation commands (start with ~w~):" section:
Added the `SPC w r` keybinding:
| ~SPC w r~              | rotate windows forward                                                      |

In the `SPC w R` keybinding description, replaced "clockwise" with "backward".
| ~SPC w R~              | rotate windows backward                                                     |

In the "Window manipulation transient state" section:
Added the`r` keybinding.
| ~r~           | rotate windows forward                                        |

In the `R` keybinding description, added "backward"
| ~R~           | rotate windows backward                                       |
2016-08-21 17:07:41 +02:00
syl20bnr
1e64768fb7 core: rename dotspacemacs-download-packages
Rename dotspacemacs-download-packages to dotspacemacs-install-packages
to better reflect the changes in the previous commit.

Also change the value 'used to 'used-only (note that 'used is still
supported for backward compatibility).
2016-08-19 21:31:57 -03:00
Jonathan Boiser
98990b25bd Fix docs link to themes-megapack README.org 2016-08-07 16:35:24 +02:00
nashamri
3b9b1ff0ce Fix broken links in the docs 2016-08-05 21:20:41 +02:00
Steve Dignam
cce0213273
Fix typo in doc/DOCUMENTATION.org
increase or increase --> increase or decrease

parenthesis --> parentheses
2016-08-01 10:21:59 +03:00
d12frosted
72cec40cd2
fix docs for declaring layer dependencies 2016-07-29 14:25:16 +03:00
eareese
421b97f36f Correct key binding 2016-07-26 16:22:03 +09:00
bmag
fe60d0fc1e Set buffer-predicate to spacemacs/useful-buffer-p
Prevent next-buffer, other-buffer, etc. from choosing useless buffers.
No need for spacemacs/next-useful-buffer,
spacemacs/previous-useful-buffer anymore.

Also fix spacemacs/alternate-buffer to respect buffer-predicate.

When spacemacs-layouts is used, buffer-predicate filters useful buffer
that belong to the current layout.
2016-07-25 20:02:28 +09:00
ivanbrennan
3c85dd7f0c fix typo in VIMUSERS Customization section
Pluralize "four top-level functions".
2016-07-25 14:03:55 +09:00
Caleb Meyer
94d71cda83
Fix notes on wrong powerline separators
I recently uninstalled railwaycat's emacs-mac-port (the old
recommendation for OS X) and installed @d12frosted's emacs-plus.

When I did that my powerline separators became just slightly off in
color from the rest of the spaceline. Asking on chat yielded that
ns-use-srgb-colorspace is set to true by default but should be nil.
2016-07-22 12:59:29 +03:00
syl20bnr
bd50484689 conventions: add code formatting key bindings 2016-07-06 22:10:34 -04:00
syl20bnr
98a4a81375 Add 3000th PR achievement
Goes to darkfeline.
2016-07-06 21:57:39 -04:00
JAremko
f9a846d2ee Integrate centered-buffer-mode and space-doc-mode. 2016-07-06 21:27:34 -04:00
JAremko
7a52759aa3 Rework buffer centering mode.
Add functions:
  - `spacemacs/maximize-horizontally` `SPC w _`
  - `spacemacs/toggle-centered-buffer-mode` `SPC w c`
  - `spacemacs/centered-buffer-mode-full-width` `SPC w C`
2016-07-06 21:27:17 -04:00
syl20bnr
a650877bea Remove SPC j L key binding which is the same as SPC f e l 2016-07-05 00:23:16 -04:00
ralesi
c4b7c29bb9 Provide additional jump options. 2016-07-05 00:23:16 -04:00
Laverne Schrock
35024b150d Correct docs on loading of packages without layer
This commit clarifies where to find the
=dotspacemacs-additional-packages= variable. It also improves upon the
code example.
2016-07-05 00:23:16 -04:00
syl20bnr
d858725360 Fix doc typo and tweak source code pro doc 2016-07-05 00:23:16 -04:00
d12frosted
5b9e84ea72 improve font documentation
- make it clear that setting dotspacemacs-default-font has no effect in
  terminal
- make it clear that it's user responsibility to install Source Code Pro
  font
2016-07-05 00:23:16 -04:00
JAremko
e3c86859b3 refactor space-doc, add to the FAQ. 2016-07-05 00:23:16 -04:00
Eivind Fonn
6609cbe85f Evilify indent-rigidly 2016-07-05 00:23:16 -04:00
syl20bnr
b30c393b8d Refactor SPC w and SPC b regarding deletion
The motivation is to clean redundent actions and bring more consistency
between `SPC b` and `SPC w` by:
- using capital letters for ace-window actions
- reusing the same letters between window and buffer when possible
- adding support for universal prefix argument to delete both window
and buffer

Details of changes:

Buffer

- `SPC b k` has been removed since the functionality is
available directly in Helm by selecting the kill buffer action

- `SPC b m` (buffer move) has been removed because the functionality
is available via `SPC w` with `SPC w h/j/k/l`, `SPC w H/J/K/L` and
`SPC w M` (see window section for the new `SPC w M`).

- `SPC b K` (kill other buffers) is now `SPC b m` to map with `SPC w m`
(kill other window or maximize). Using the universal prefix argument
`SPC u SPC b m` will also kill the windows.

- `SPC b C-k` (kill buffer matching regexp) is now simply on `SPC b k`.

- `SPC b D` now kills a buffer using ace-window.

- `SPC b d` and `SPC b D` now accept an universal prefix argument to
also delete the window. So `SPC u SPC b d` and `SPC u SPC b D` delete
the buffer and the window.

Window

- `SPC w M` now swap the window using ace-window.

- old `SPC w M` (center window) is now on `SPC w c` and `SPC w C` uses
ace-window.

- `SPC w SPC` (select window) is now on `SPC w W` since it uses
ace-window.

- `SPC w d` and `SPC w D` now accepts an universal prefix argument to
delete the window and the buffer.
2016-06-26 00:05:55 -04:00
Jonas Benn
878c45abf9
Add kill-buffer-and-window keybinding
`kill-buffer-and-window` is now bound to `SPC b D` and the keybinding
is documented.
2016-06-25 09:06:40 +03:00
MadAnd
7733146a33 DOCUMENTATION.org: fix indent text object docs 2016-06-23 22:34:56 -04:00
syl20bnr
829f00a824 Add more info for fish shell and ansi-term 2016-06-22 23:28:41 -04:00
Eivind Fonn
2f51da332a Update indent textobjects documentation 2016-06-22 18:37:28 +02:00
d12frosted
6d5bca70c9
don't ask users to spaceline-compile 2016-06-21 09:43:57 +03:00
Eivind Fonn
92b48eadea 💣 Drop support for Emacs 24.3
Spacemacs now needs at least 24.4 to launch.
2016-06-20 22:05:56 -04:00
syl20bnr
117dcba0ed Revert "Drop support for Emacs 24.3"
This reverts commit 31bab70397 making
a new commit to put TheBB as the author.
2016-06-20 22:05:12 -04:00
syl20bnr
31bab70397 💣 Drop support for Emacs 24.3
Spacemacs now needs at least 24.4 to launch.
2016-06-20 21:55:36 -04:00
syl20bnr
57350a3b48 core: reimplement :packages keyword and update documentation
Old implementation excluded package that were not selected, this
implementation does not excluded them, it simply ignore it in the
layer where they are not selected. This reimplementation comes from
a refactor of the way packages.el files are loaded, instead of loading
these files at the moment of resolving the list of used packages, they
are now loaded when making the layer objects. A neat consequence is that
side effects is better confined and the configuration-layer/get-packages
is now pure (at least a lot more pure than before).
In the `cfgl-layer` class the slot `:user-packages` has been renamed
to `:selected-packages` which defaults to `'all` meaning that all
the packages in `:packages` are selected. `:selected-packages` value
is given by the new function `configuration-layer//select-packages`.
Effectively selected packages are given by a new method for `cfgl-layer`
class called `cfgl-layer-get-packages`.

Tests have been updated to reflect the changes.

Also documentation on configuration layer declaration in the dotfile
section of DOCUMENTATION.org has been greatly improved (I hope) and
reflect the last feature added to the
`dotspacemacs-configuration-layers` list.
2016-06-20 20:48:25 -04:00
ralesi
704732fc84 Reimplement #5339 by justbur to add :packages keyword. 2016-06-19 22:07:44 -04:00
Eivind Fonn
c24553dee2 Update documentation 2016-06-18 19:21:27 -04:00
d12frosted
52202cc927
fix double equals sign in FAQ 2016-06-17 09:28:09 +03:00
syl20bnr
ad72dab624 Move pcre2el key bindings to SPC x r prefix
Also document it.
Move everything to spacemacs-base since the new prefix is not as invasive
2016-06-13 00:01:25 -04:00
Robert O'Connor
f4fcd93b2f 2000th fork 🔱 by @Gameguykiler
😹 🍰 👏 🔥 ❤️  🎉 🚀 :octocat:
2016-06-12 23:02:15 -04:00
Brett Cannon
9b4586837f Fix a minor grammatical mistake 2016-06-12 21:45:48 -04:00
Albin Ludvig Otterhäll
9e3f75a36f Remove references to Solarized themes
Solarized themes has been removed from the default distribution of
Spacemacs.
2016-06-12 21:12:34 -04:00
syl20bnr
dc822d5b9e space-doc: disable line numbers and resized images
Resize images to 600 pixel width (exclude README.org for now)
Disable line numbers.
2016-06-10 15:50:45 -04:00
syl20bnr
f23ecf0b12 Rename +distribution to +distributions 2016-06-08 22:17:04 -04:00
Markus Koller
58bb7d122f spacemacs-base: Always kill buffers with SPC b d
Fixes #4929
2016-06-05 21:22:50 -04:00
Allen Li
5c1f56f636 Use defconst in LAYER documentation 2016-06-02 23:14:55 -04:00
syl20bnr
c0f19caa5a New local package spacemacs-whitespace-cleanup
Under toggle SPC t W with lighter W
2016-06-02 22:39:41 -04:00
Eivind Fonn
5a4e8a3f01 core: add toggle for whitespace cleanup 2016-06-02 21:02:30 -04:00
syl20bnr
29bae4026a Improve lighter consistency of toggles
Make global and local whitespace mode lighters identical
Add a lighter for fill column indicator
2016-06-02 20:57:15 -04:00
syl20bnr
4dead4cca7 Use use-package hooks for helm and ivy projectile setup
It allows the configuration function for projectile to be agnostic of
other packages.

Also fix wrong `SPC p s` key binding (it is `SPC p p`).
2016-05-31 23:19:54 -04:00
Eivind Fonn
6b3e1452cf core: misc. goodies for describe-package
- Use completing-read when called interactively
- Check for string locations in addition to built-in etc.
- Don’t double-princ on/off for toggles
- Bind to SPC hdP
2016-05-31 22:26:59 -04:00
syl20bnr
60f5a3a0fa New dotfile variable dotspacemacs-download-packages
This new variable replace dotspacemacs-delete-orphan-packages

It defines the behaviour of Spacemacs when downloading packages.

Possible values are `used', `used-but-keep-unused' and `all'.
- `used' will download only explicitly used packages and remove any
unused packages as well as their dependencies.
- `used-but-keep-unused' will download only the used packages but won't
delete them if they become unused.
- `all' will download all the packages regardless if they are used or
not and packages won't be deleted by Spacemacs.

Default value is `used`.
2016-05-30 22:58:59 -04:00
JP-Ellis
e49c41adf9 Add make-frame shortcut, SPC w F
Placed it under the `SPC w` prefix since the related `other-frame` is
set to `SPC w o`.

Signed-off-by: JP-Ellis <josh@jpellis.me>
2016-05-29 23:13:47 -04:00
syl20bnr
d98be63dfa core: new layer file -> layers.el / Fix regressions of previous commits
The new layer file `layers.el` is used to declared additional layers.
It is like the sibling of packages.el except that for now it does not
take a list (can do this in a futur commit).

The new order for file loading is the following:

layers.el > packages.el > funcs.el > config.el > keybindings.el

Since packages.el relies on some undefined stuff encapsulated
in init functions, it is not meant to be byte compiled. OTOH funcs.el
(where lies most of the computation added by a package config) should
be compilable.

Since we load packages.el very early it is not possible to use
`configuration-layer/package-usedp` in funcs.el.

This commit also fixes the tests.
2016-05-28 21:20:23 -04:00
syl20bnr
380be09700 Fix wrong documentation introduced by previous commit. 2016-05-27 07:58:37 -04:00
syl20bnr
c35e4ee27b core: remove packages-funcs and packages-config
Change the semantic of the files for a better control over the
configuration (like being able to use package-usedp function to
guard package configuration and function definition).

This is a big change!

The list of packages of the layer must now be placed in config.el
packages.el only contains pre-init, init and post-init functions

Now both packages.el and funcs.el can use
configuration-layer/package-usedp which is much more powerful than
just configuration-layer/layer-usedp.

Also merging into one file the layer variable and the list of packages
make sense (in this case config.el).

It also means that we can quickly load all the packages declared in
all layer for helm and ivy sources by just loading the config.el file.

Expect some regressions introduced by this change, like the helm
and ivy sources, they will be fixed in other commits.
2016-05-27 00:32:05 -04:00
sooheon
15e6290151 Make check for company-mode explicit, not implicit
People may have company-mode installed without necessarily using the
auto-completion layer.
2016-05-27 00:32:05 -04:00