Commit graph

522 commits

Author SHA1 Message Date
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
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
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
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
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
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
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
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
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
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
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
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
syl20bnr
901fd09e67 Add SPC w 1..3 key bindings to documentation 2018-05-10 23:43:05 -04:00
syl20bnr
80e792911b Add smile12341234 to the achievement, he is The Orgonaut! 2018-02-27 23:32:52 -05:00
Tad Fisher
662b73282c Make the Emacs server optional
Add `dotspacemacs-enable-server`, which if non-nil prevents Spacemacs from
calling `(server-start)` at init.
2018-02-24 19:49:39 -05:00
JAremko
d2c3b847d8 doc fmt 2018-01-27 16:57:39 +02:00
syl20bnr
a2f16fa876 Add toggle for spaceline responsivness under SPC t m r 2018-01-17 15:23:37 -05:00
syl20bnr
509ff96c66 It is not necesary to restart emacs when changing mode-line theme 2018-01-17 11:29:59 -05:00
syl20bnr
0f646b884d Add properties for mode-line theme, remove powerline-scale
Since we have now a variable for the mode-line theme, it makes sense to move
the scaling of the mode-line to this variable. Thus the property
=:powerline-scale= of variable dotspacemacs-default-font has been removed and
it is replace by the property =:separator-scale= used in the variable
=dotspacemacs-mode-line-theme=.

This commit also adds a the property =:sperator= for the variable
=dotspacemacs-mode-line-theme= which allows to set the separator type.

Example of the final result:

   dotspacemacs-mode-line-theme '(all-the-icons
                                  :separator cup
                                  :separator-scale 1.5)

Documentation has been updated to reflect the changes.
2018-01-16 22:59:29 -05:00
syl20bnr
4c231ae282 Replace SPC j j and SPC j J by evil-avy-goto-char-timer
evil-avy-goto-char-timer is a better all around solution.
2018-01-15 16:41:24 -05:00
Muneeb Shaikh
0d5f3cfe2f doc: fix supported spaceline-all-the-icons-separator-type 2018-01-12 23:31:24 -05:00
syl20bnr
a7bca298ff Add doc for SPC b x and SPC w x 2018-01-12 23:20:30 -05:00
syl20bnr
8914e78537 doc: further tweaks of mode-line section 2018-01-12 00:06:50 -05:00
syl20bnr
726077faf1 doc: mention fonts to install for all-the-icons mode-line theme 2018-01-12 00:02:05 -05:00
syl20bnr
a131c89909 core: add support for mode-line themes
New layer variable `dotspacemacs-mode-line-themes`:

Set the theme for the Spaceline. Supported themes are `spacemacs',
`all-the-icons', `custom', `vim-powerline' and `vanilla'. The first three
are spaceline themes. `vanilla' is default Emacs mode-line. `custom' is a
user defined themes, refer to the DOCUMENTATION.org for more info on how
to create your own spaceline theme."

See DOCUMENTATION.org changes for more info.

This commit adds support for `spaceline-all-the-icons` package.
2018-01-11 23:53:44 -05:00
Daniel Hodson
3342532f9c Update guidance on using external Git repository
Changed the wording to something that flows better.
2018-01-09 23:37:44 -05:00
Daniel Hodson
8a8e726561 Fix capitalization of changes
Update capitalization as per feedback.
2018-01-09 23:37:44 -05:00
Daniel Hodson
f99dcfc985 Update DOCUMENTATION.org
Delete erroneous blank space in screenshots section.
2018-01-09 23:37:44 -05:00
Daniel Hodson
bf0cabb356 Update wording in DOCUMENTATION.org for readability and consistency. 2018-01-09 23:37:44 -05:00