Commit Graph

534 Commits

Author SHA1 Message Date
syl20bnr 68dab82d98 [doc] Add documentation for SPC x d l 2020-02-01 10:13:12 -05:00
syl20bnr 2bec3bb719
[doc] Remove unneeded SPC U for numerical prefix argument 2020-01-20 11:26:14 -05:00
syl20bnr 101c920dbc
Add key bindings to randomize word and lines in region 2020-01-20 11:26:14 -05:00
Zach Latta 1d2a1fa6e4 Fix capitalization of GitHub
Change instances of "Github" to "GitHub".
2020-01-20 09:14:12 +01:00
Ullas Holla 8e66bf36df Add missing apostrophe in DOCUMENTATION.org 2020-01-04 09:01:57 +01:00
Maximilian Wolff f6fd88f40b
Change recompile-elpa to a more emacs file specific keybinding 2019-11-24 20:56:52 +00:00
Maximilian Wolff dd7a5d98be
Revise helm recompile package action and bind recompile-elpa
The newly introduced function to compile an elpa package
was very much redundant with the existing recompile-elpa function.

I have adapted recompile-elpa so that it can be used for the helm action too.

In addition I have bound recompile-elpa to `SPC c C-c` to allow users to
easily recompile their entire elpa directory if the need arises.

I have also removed the error handling in the helm action in favor of
standard error reporting via the *Compile-Log* buffer.
2019-11-24 02:07:15 +01:00
duianto 9f16032f69
Update transient state wording, etc.
- Removed the word `Manipulation` from the transient state titles:
  - Buffer Manipulation Transient State and Window Manipulation TS
  - Expanded the TS abbreviation to Transient State
- Documented the Buffer Transient State key binding:
  `q` to quit the transient state
- Capitalized `Transient State` in the titles
- Window Transient State:
  - Added a line break after the title in the folded hint.
    This allows for more keys to be visible horizontally.
  - Moved up the [?] help key after the title, so that
    it's in the same place in both the folded and full
    transient state.
2019-11-23 23:12:37 +01:00
Maximilian Wolff 28959d73ab Document missing keybindings for window manipulation transient state 2019-11-21 22:13:50 +00:00
duianto f19d57eb57 [doc] add visual line nav keys, startup snippet
documentation.org
- added visual line navigation (w/w/o) globally keys and unicode/ascii symbol

faq.org
- updated snippet for enabling visual line navigation globally on startup
2019-10-30 10:00:05 +01:00
Miciah Masters 552fd5953c Update references to macOS
Apple renamed "Mac OS X" to "OS X" in 2012 and then to "macOS" in 2016.
Update references to use the current name.
2019-10-13 12:04:40 +02:00
ahanwadi 98473c2a2d Fixed a typo
share the buffer -> the buffers
2019-10-05 19:03:29 +02: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
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