Commit graph

974 commits

Author SHA1 Message Date
syl20bnr
ba4e790dbc [conventions] Add transient state key binding convention 2019-09-30 00:34:26 -04:00
Trey Merkley
1646a246d6 Update DOCUMENTATION.org 2019-09-21 21:26:05 +02:00
emacspace
e61e91fbc5 documentation formatting: Thu Aug 29 23:13:44 UTC 2019 2019-08-30 01:17:29 +02:00
smile13241324
e40c112d55 [doc] Add more detailed troubleshooting information 2019-08-28 23:53:26 +02:00
emacspace
3747afb4b0 documentation formatting: Fri Aug 23 17:22:19 UTC 2019 2019-08-24 00:03:42 +02:00
syl20bnr
bd97ef47ef Move doc for layout restriction and SPC TAB to DOCUMENTATION.org 2019-08-20 00:54:41 -04:00
bb2020
8ed7e5e7a1 Add `spacemacs/iwb-region-or-buffer'. 2019-08-11 20:15:40 +02:00
syl20bnr
cfd2b110f2 Update documentation and parameters for the portable dumper 2019-07-26 15:36:08 -04:00
Aaron Zeng
cc4ab653c2 Update core-dotspacemacs.el default font size
0ffdb353f9 changed the default config template to use a point size instead of a pixel size.  Change the defvar declaration as well.

Commit modified by duianto:
Updated font size in doc/documentation.org
2019-07-18 11:43:45 +02:00
JAremko
28c8bbebc2 fix link 2019-07-15 18:27:44 +03:00
duianto
b9e61e6437 Add transient state keys _, j, k
Thanks sdwolfz for the suggestion to add underscore to the transient states,
then the shift key doesn't have to be released if it was held down to press `+`.

Added key bindings:
Evil numbers:
`SPC n _` decrease number under point
in the transient state:
`j` decrease number under point
`k` increase number under point

`SPC T T _` decrease transparency
`SPC z x _` scale down font
`SPC z f _` zoom out frame

Update documentation:
Zoom frame:
`q` quit transient state

Evil numbers:
`SPC n =` increase number under point
`SPC n _` decrease number under point
`0..9` add a number prefix argument
`q` quit transient state

Fixed a typo and made a small rewrite of the tip about using a prefix argument.

Added keys to transient states:
Font scaling:
Added `_` scale down
Reordered `k` assignment to match the order in the transient state

Frame transparency:
Added `_` decrease
Reordered `k` assignment to match the order in the transient state

Evil numbers:
Added `k` increase
Added `_` and `j` decrease

Zoom frame:
Added `_` zoom frame out
Reordered `k` assignment to match the order in the transient state

Which-key entries for Evil numbers `SPC n`:
Group together keys that call the same command:
From: + and =
To:   +,=

From: - and _
To:   -,_
2019-07-14 22:56:57 +02:00
Hong Xu
9637ceb389 Correct the example for stopping evilification of various magit's major-mode 2019-07-07 17:52:04 +02:00
duianto
d6cdd6aa88 Add a tutorials section to SPC h T
`SPC h T e` for `emacs-tutorial` (aliased from `help-with-tutorial` for a more
descriptive name)
`SPC h T v` for `evil-tutor-start`

Added a wikipedia link to the `vi` article, where the origins of modal editing
is discussed.
2019-07-07 11:34:16 +02:00
syl20bnr
1aa0af260e Move indirect buffer key bindings to SPC b N prefix 2019-06-26 00:10:01 -04:00
syl20bnr
f04ff9e837 Change SPC , to SPC j c to go to last change 2019-06-25 23:52:21 -04:00
syl20bnr
6ce974795e Change SPC j C to SPC j ( to jump to fist unbalanced parens 2019-06-25 23:49:21 -04:00
duianto
84287f020d [doc] Add relative and visual line number keys
Documented two missing line number key bindings:
`SPC t r` toggle relative line numbers
`SPC t V` toggle visual line numbers
2019-06-24 13:31:13 +02:00
jcaw
d4cca74854 Add support for visual line numbers
Emacs 26 added built-in support for line numbers, relative line numbers, and
visual line numbers. Spacemacs supports only absolute and relative, but there is
no way to access the visual mode. It's hard to get around this, since Spacemacs
abstracts line numbers to a reasonably high degree.

Arguably, `visual` is much more useful than `relative` as a display type. Visual
line numbers are like relative line numbers, but only lines that are actually
showing are counted. This means:

  1. Hidden lines are not counted. If a large amount of text is folded, the line
     numbers won't jump from "10" to "546". This is particularly useful in
     buffers like `magit-status`, where a large amount of information is folded
     by default.

  2. Lines that are wrapped are counted as multiple lines, since they're being
     displayed as multiple lines in the editor. Each visual line will be
     numbered - unlike `relative`, where the entire thing is numbered... Once.

With standard relative line numbers, you can't actually navigate using the line
numbers in the sidebar as soon as folded or wrapped lines are introduced. Since
this is one of the main use cases for relative line numbers, this is a big
problem.

Visual mode fixes that problem. Every line that's being displayed is labelled.
Numbers always correspond to the actual number of lines you'd need to navigate
to reach that line.

This commit extends Spacemacs' line number interface to provide visual line
number support.
2019-06-23 19:16:44 +02:00
duianto
e734e9b4a9 [doc] Fix incorrect ace-link instruction
The ace-link instruction says that it's invoked:
"with two key strokes"
but it's invoked by pressing a single letter: o
2019-06-13 01:11:23 +02:00
Ag Ibragimov
cf796a4224 spacemacs/recompile-elpa with argument deletes all existing *.elc files
Rationale: very often users required to find and delete all *.elc files
manually. That's a bit tedious.
2019-06-12 20:15:51 +02:00
Anton Alekseev
b5027f8f2a Add key bindings for indirect buffer functions 2019-06-08 20:36:34 +02:00
duianto
3868a5364f [doc] Fix typos and add missing/remove extra ~
Add missing ~ (tilde) around key bindings.
Remove an extra ~.
2019-06-01 20:40:22 +02:00
emacspace
c7c348a676 documentation formatting: Sun May 26 20:58:52 UTC 2019 2019-05-27 01:23:35 +03:00
bb2020
e1cde25da6 Add bindings for goto-last-change and check-parens 2019-05-24 18:42:55 +02:00
emacspace
4c8d820585 documentation formatting: Sun May 19 20:32:09 UTC 2019 2019-05-19 23:52:00 +02:00
Ag Ibragimov
fd76a7f300 Add j and k to transient states
It is nicer when user can stay in the "home row" for basic operations like
zooming in and out

Font Scaling Transient State
`k` scale up
`j` scale down

Frame Transparency Transient State
`k` increase transparency
`j` decrease transparency

Zoom Frame Transient State
`k` zoom frame in
`j` zoom frame out

Added two additional Zoom Frame TS keys:
`m` max frame
`f` fullscreen
2019-05-19 22:24:11 +02:00
JAremko
1554873414 fix links 2019-05-18 13:25:44 +03:00
Anton-Latukha
f6660f82d4
Switch to the new layers generator 2019-05-15 21:08:21 +03:00
syl20bnr
8fa16d19a9 [editing] Document key binding ~SPC x y~ and sort them 2019-05-12 10:59:57 -04:00
syl20bnr
4e93c2fb88 [conventions] Add ~SPC m t l~ to run last executed tests 2019-05-12 10:08:28 -04:00
Witoslaw Koczewski
9a0275ffef Link updated: Somelauw/evil-org-mode
Since edwtjo/evil-org-mode doesn't receive any updates anymore, the link is changed to Somelauw/evil-org-mode.
2019-05-07 21:46:53 +02:00
Jonathan Chen
c05c421026 [docs] Fix spelling, Reorder configuration functions
To logical order
2019-05-01 23:12:16 +02:00
emacspace
6f6b064c7e documentation formatting: Sat Apr 27 00:15:28 UTC 2019 2019-04-27 02:23:35 +02:00
Max Deineko
764075be70 A note about user-config and files supplied via command line arguments 2019-04-26 21:36:09 +02:00
yuhan0
a3469c04ea Add window maximization bindings to transient state 2019-04-11 10:50:41 +02:00
yuhan0
f961d622cf Add 'SPC w' leader bindings for window resizing
For convenience they directly enter the window manipulation transient state,
since resizing operations tend to involve repeated key presses.
2019-04-11 10:50:40 +02:00
emacspace
7bf2d00857 documentation formatting: Wed Apr 10 18:17:02 UTC 2019 2019-04-10 22:37:15 +02:00
Miciah Masters
b1b483e4ae FAQ: Set sentence-end-double-space in user-config
The FAQ has an entry for configuring Spacemacs to use double-space as the
sentence delimiter.  This FAQ entry instructs the reader to set the
sentence-end-double-space variable in the dotspacemacs/user-init function.

The problem is that the spacemacs-defaults layer sets
sentence-end-double-space when it loads, and Spacemacs loads layers after
calling dotspacemacs/user-init, which means the layer overrides any setting
for sentence-end-double-space in dotspacemacs/user-init.

To solve this problem, this commit modifies the FAQ entry to instruct the
reader to set the variable in the dotspacemacs/user-config function, which
Spacemacs runs after loading layers.

The FAQ entry was added in commit ee4ad69847.

* doc/FAQ.org: Instruct the reader to set sentence-end-double-space in
dotspacemacs/user-init rather than in dotspacemacs/user-config.
2019-04-10 18:32:24 +02:00
smile13241324
b00767cd6e Fix partial merge of last doc update
Just cherry picked the last commit in the
previous PR and noticed that I have just
got part of the changes due to multiple
commits in the PR.

However as I did already push I am now
providing the missing changes manually
rather than to rollback the commit.
2019-04-10 00:05:32 +02:00
Anton-Latukha
16e36d75e1 doc: DOCUMENTATION.org: upd Binding keys: direct to key Conventions 2019-04-09 23:56:53 +02:00
emacspace
584084ab2d documentation formatting: Mon Apr 8 15:39:05 UTC 2019 2019-04-09 23:11:10 +02:00
syl20bnr
5f27edb107 [conventions] Add conventions for imports 2019-04-08 11:32:43 -04:00
duianto
2ef94efbf4 Add line text object using evil-textobj-line 2019-04-07 15:34:02 +02:00
emacspace
18a998b675 documentation formatting: Thu Apr 4 16:29:54 UTC 2019 2019-04-04 23:19:59 +02:00
Miciah Masters
17ec4da516 Delete helm-wikipedia-suggest key binding
Helm has removed the helm-wikipedia-suggest command, so delete Spacemacs's
key binding for the command.

4ef8299d78

* CHANGELOG.develop: Add entry.
* doc/DOCUMENTATION.org: Delete documentation for the key binding for
helm-wikipedia-suggest.
* layers/+completion/helm/packages.el (helm/init-helm): Delete the key
binding for helm-wikipedia-suggest.
2019-04-03 08:19:40 +02:00
duianto
d55f39eed3 Change helm-apropos from SPC h d d to SPC h d a
Change the binding to be more mnemonic.

It calls helm-[a]propos and it pretty much describes [a]ll.
2019-02-18 16:42:12 -05:00
syl20bnr
ab2fc3fb02 First part of review and tweaks of release notes 2019-01-28 23:09:29 -05:00
JAremko
edf3b9d28c document new centering key bindings 2019-01-28 07:15:08 +02:00
yuhan0
6737c8c8e5 Add ivy option to buffer transient state 2019-01-21 23:06:08 +02:00
emacspace
03cb987c6d documentation formatting: Sun Jan 20 15:34:11 UTC 2019 2019-01-20 15:45:54 +00:00
Alexander Miller
e7d13da61d Make treemacs the default file browser. 2019-01-20 14:31:36 +02:00
emacspace
45276bd96f documentation formatting: Wed Dec 5 03:03:03 UTC 2018 2018-12-04 22:06:14 -05:00
emacspace
4912b54f24 documentation formatting: Mon Nov 12 22:12:39 UTC 2018 2018-11-12 22:24:27 +00:00
yuhan0
0596e90c3d Add 'z' recenter bindings for various transient states
By analogy with the "zz", "zb", "zt" vim / evil bindings, this adds an
additional key binding "z" for `recenter-top-bottom` to the following
transient states which navigate around the buffer in large jumps:
- auto-symbol-highlight
- error
- buffer
- vcs
- org-babel

This allows for repositioning of the buffer for visibility without having to
exit the transient state.

Minor updates are also made to documentation of other transient states.
2018-11-12 21:47:17 +00:00
Codruț Constantin Gușoi
9d835384cc Fixes formatting on documentation table 2018-11-12 23:07:49 +02:00
pancho horrillo
d2b7b0a04a DOCUMENTATION.org: Fix typos 2018-11-12 21:07:03 +00:00
pancho horrillo
b67cf79107 DOCUMENTATION.org: Add missing help keybindings
All described in the changelog for 0.200.
2018-11-12 21:04:39 +00:00
JAremko
141b6328e3 Reformat docs 2018-11-08 22:37:23 +02:00
syl20bnr
f46b8c916d Update documentation for SPC b n and SPC b p 2018-11-04 10:15:19 -05:00
emacspace
901f35849a documentation fixes: Tue Oct 23 14:18:21 UTC 2018 2018-10-23 23:38:16 +03:00
emacspace
7ccddbcec6 documentation fixes:Thu Oct 18 17:07:35 UTC 2018 2018-10-18 20:39:35 +03:00
Billy Wade
7002867c24
80's => '80s 2018-10-18 19:33:56 +03:00
emacspace
0fb6470acf documentation fixes:Wed Oct 17 04:03:28 UTC 2018 2018-10-17 04:03:28 +00:00
JAremko
cd39f80c24 Reformat documentation 2018-10-11 00:13:43 +03:00
Boris Buliga
12510f9854 add a special title for JAremko 2018-10-10 00:13:02 +03:00
Boris Buliga
3b24c4729b add a special title for StreakyCobra 2018-10-09 22:01:38 +01:00
deb0ch
f14bf4dde1
DOCUMENTATION.org: fix typo 2018-10-06 09:30:54 +03:00
syl20bnr
9f8b867af1 Add SPC f y n and SPC f y N to copy the name of a file 2018-09-11 15:04:19 -04:00
antonio miranda
89caca3048 Use single *
This ain't markdown...
2018-09-10 22:35:46 +01:00
antonio miranda
bb27a252f3 Improve docs for dotspacemacs-line-numbers
After [loosing some time](https://github.com/syl20bnr/spacemacs/issues/11272#issuecomment-419002973) trying make relative line numbers only available on specific modes I think this minor change could make the documentation more explicit.
2018-09-10 22:35:46 +01:00
Codruț Constantin Gușoi
816099aa2b Fixes keybinding conflict with fasd layer
The `SPC f a` keybinding was already used by the `fasd` layer so a
workaround had to be found for the newly introduced one.

Refs: c2e377c902
Refs: #11224

Thanks @agzam for pointing it out and investigating potential solutions.
2018-08-30 00:13:43 +03:00
Masayuki Takemura
c2e377c902 spacemacs-defaults: add a keybind to open a file and replace buffer with it
Define an alias and use it internally so that (1) the name of the command will
be better to understand what it does than the original name and (2) Helm or Ivy
interface is invoked instead of Ido.

These are suggested in PR #11115.
2018-08-21 00:55:37 +03:00
MarcoIeni
21c3a87044 Spacemacs documentation improvements
`SPC f e f` key binding is no more present, so moved that table entry to
`SPC h f` in DOCUMENTATION.org.

corrected description of paste transient-state behavior.
2018-08-18 12:22:23 +01:00
smile13241324
6b0e696208 doc: add remark for necessary GitHub login to report issues 2018-08-15 22:25:03 +01:00
John Eismeier
5e3c96562a Propose a couple of spelling corrections 2018-08-02 00:20:06 +03:00
Francesc Elies Henar
8bb1cee649 [flycheck] binds flycheck-copy-errors-as-kill to SPC e y 2018-07-27 00:46:47 +03:00
JAremko
6946e255e6 Reformat docs 2018-07-20 02:45:21 +03:00
Vlad Bokov
c1b05ff6c1 Add documentation about specify socket server for client 2018-07-03 23:39:38 +03:00
syl20bnr
a013d86874 core: update environment variables management
* add new dotfile function `dotspacemacs/user-env`
* add ignored env. vars with variable spacemacs-ignored-environment-variables
* ignore env vars: SSH_AUTH_SOCK and DBUS_SESSION_BUS_ADDRESS
* update documentation in DOCUMENTATION.org
* update .spacemacs.template with new function
* rename environment file from spacemacs.env to .spacemacs.env
* move location of .spacemacs.env file to home or dotdirectory
* add a header to the generated .spacemacs.env file to explain what it is
* make SPC f e e fallbacks to the function dotspacemacs/user-env if the user
  manages the env var by themselves
* make SPC f e E call the new function dotspacemacs/user-env
* sort environment variables in .spacemacs.env file
2018-07-03 01:25:28 -04:00
Codruț Constantin Gușoi
aba51afe48 Multiple ways to copy a file path 2018-06-29 01:09:54 +03:00
syl20bnr
6220ace290 core: rework environment variables and PATH management
See updated DOCUMENTATION.org and FAQ.org for more info.

* add core-env.el
* add library load-env-vars.el
* add bootstrap package dotenv-mode.el
* remove spacemacs-environment from bootstrap layer
* remove dotspacemacs variable dotspacemacs-import-env-vars-from-shell
* remove dotspacemacs variable dotspacemacs-improt-env-vars-shell-file-name
* add new key binding SPC f e e to open spacemacs.env file
* add new key binding SPC f e E to reload environment variable from env file
* add new key binding SPC f e C-e to re-initialize the env file from shell.
2018-06-25 02:55:28 -04:00
syl20bnr
d28990537f Add new variable dotspacemacs-import-env-vars-shell-file-name
Used to fetch the environment variables. This allows to keep shell-file-name
untouched.
2018-06-15 02:40:44 -04:00
syl20bnr
9ee832955a core: async import of env.vars and add new dotfile variable
* new variable dotspacemacs-import-env-vars-from-shell
 * asynchronous import of environments variables
 * move loadenv function to funcs.el
 * update documentation
2018-06-15 01:38:07 -04:00
Carl Lange
d423965862 add a bit of documentation about setting the server socket 2018-06-14 00:42:15 -04:00
syl20bnr
c12b72090c Cache PATH and env vars. fetched with exec-path-from-shell
See updated documentation in this commit.
2018-06-11 03:54:51 -04:00
syl20bnr
1ddd843130 Update conventions for test generation 2018-06-09 00:36:32 -04:00
syl20bnr
5004e05d44 Add hybrid-style-visual-feedback variable 2018-06-08 02:32:05 -04:00
syl20bnr
434df17f8b Rename hybrid-mode-xxxx variables to hybrid-style-xxxx
Use aliases to retain backward compatibility.
2018-06-08 02:24:38 -04:00
syl20bnr
2b4d90ba20 Set default value of vim-style-visual-feedback to nil 2018-06-08 02:24:38 -04:00
syl20bnr
9539e4206d Rename Vim style related variable to vim-style-xxxxx
Update the documentation
Define alias for backward compatibility
2018-06-08 02:24:38 -04:00
syl20bnr
e39b3495bd Add vim-style-visual-feedback variable and documentation 2018-06-08 02:24:38 -04:00
syl20bnr
834c39c2fd Update promotion and demotion conventions and apply them to markdown 2018-06-06 01:15:48 -04:00
Miciah Masters
e0b751bee3 Avoid non-idempotent use of push in init code
Replace push with add-to-list in layer init functions and related code.

Modify spacemacs|add-toggle to check for and update an existing toggle in
spacemacs-toggles and only create a new toggle if none already existed.

Replace a conditional push onto erc-packages with use of :toggle.

When initializing which-key, set which-key-replacement-alist to its default
or customized setting before adding all the Spacemacs replacements.  We
want to keep the stock replacements but avoid adding duplicates of the
Spacemacs replacements.

Replace the emacs-lisp-mode-hook lambda with a named function to avoid
adding duplicate hooks (which can add duplicate definitions of the
evil-surround pair).
2018-06-05 22:17:13 -04:00
Guido Kraemer
769add7c7e add keybinding to documentation 2018-06-02 18:34:30 +03:00
Codruț Constantin Gușoi
390462e36d Adds some profiling keybinding under SPC h P 2018-05-31 01:23:02 +03:00
Codruț Constantin Gușoi
83f2fd4d22 Window splitting with custom delete
Implements some custom window layout splitting functions.
2018-05-31 01:16:57 +03:00
bmag
8f82486154 Add support for native line numbers in Emacs 26
Emacs 26.1 will introduce a new native line numbers feature:
"display-line-numbers". It includes relative line numbers, is faster than
current linum-mode, and doesn't use the margin area (it has its own area). So
yeah, we want to use the new feature when possible.

No changes are required on the user side, except for Emacs 26 users are
recommended to remove nlinum layer from their configuration (if they have
enabled it).

With this change:
- Emacs 26:
  - uses display-line-numbers by default.
  - linum and linum-relative packages are excluded.
- Emacs 25:
  - does NOT use display-line-numbers.
  - continues to use linum and linum-relative.
- nlinum layer:
  - can still be used as before in Emacs 25.
  - is NOT recommended in Emacs 26, but can be used.
  - when enabled, excludes display-line-numbers.

Also contains some bug fixes:

Fixes a bug where setting `dostpacemacs-line-numbers` to `t` or `relative`
enabled line numbers in every buffer, instead of only in buffers that derive
from prog-mode and text-mode.

Likewise fixes a bug where specifying `:enabled-for-modes nil` (or not
specifying `:enabled-for-modes` at all) in `dotspacemacs-line-numbers` settings
meant "enable in all modes" instead of "enable in modes derived from prog-mode
or text-mode".

Because of this change, also adds a way for users to enable line numbers
in *all* buffers.

Removes check for special buffer. All our current checks should be enough to
enable line numbers only where it makes sense. Disabling in all special buffers
is not necessary.
2018-05-28 19:29:15 +03:00
Jaremy Creechley
4a73b15503 General solution for underscores in word-motions
c.f. https://github.com/syl20bnr/spacemacs/issues/1261 

I am currently going between many programming languages and the current solution falls short for me. The 'prog-mode-hook seems to work pretty well.
2018-05-25 01:41:48 +03:00
syl20bnr
34739388a3 Add 15000th star achievement
Goes to missingfaktor
2018-05-21 00:29:40 -04:00
Alex
cbf6de8ef1 Add 2x2 grid layout shortcut 2018-05-14 22:39:56 +03:00