Mercurial > vim-lawrencium
annotate doc/lawrencium.txt @ 40:a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
| author | Ludovic Chabant <ludovic@chabant.com> |
|---|---|
| date | Fri, 30 Mar 2012 15:29:10 -0700 |
| parents | a384b4aff211 |
| children | fc20a265551d |
| rev | line source |
|---|---|
| 0 | 1 *lawrencium.txt* Mercurial wrapper for VIM |
| 2 | |
| 13 | 3 |
| 4 LAWRENCIUM REFERENCE MANUAL | |
| 5 by Ludovic Chabant | |
| 6 | |
| 7 | |
| 8 *lawrencium* | |
| 0 | 9 |
| 13 | 10 1. Introduction |lawrencium-intro| |
| 11 2. Commands |lawrencium-commands| | |
|
31
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
12 3. Status Window |lawrencium-status-window| |
| 0 | 13 |
| 13 | 14 |
| 15 ============================================================================= | |
| 16 1. Introduction *lawrencium-intro* | |
| 0 | 17 |
| 18 When a file from a Mercurial repository is open in a buffer, that buffer gets | |
| 19 new commands defined. | |
| 20 | |
| 13 | 21 This plugin is only available if 'compatible' is not set. |
| 22 | |
| 23 Grab the latest version or report a bug on BitBucket: | |
| 24 | |
| 25 http://bitbucket.org/ludovicchabant/vim-lawrencium | |
| 26 | |
| 27 | |
| 28 | |
| 29 ============================================================================= | |
| 30 2. Commands *lawrencium-commands* | |
| 0 | 31 |
| 32 All commands defined by |lawrencium| are local to each buffer. | |
| 33 | |
| 13 | 34 *:Hg* |
|
6
1da613c13d81
Better hg-status window.
Ludovic Chabant <ludovic@chabant.com>
parents:
0
diff
changeset
|
35 :Hg {args} Run an arbitrary Mercurial command. Similar to :!hg |
| 0 | 36 [args] but the '--repository' is automatically |
| 37 specified with the root of the repository the current | |
|
20
01932a36df03
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
13
diff
changeset
|
38 file belongs to, and it will auto-complete any |
|
01932a36df03
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
13
diff
changeset
|
39 standard command or option. |
| 0 | 40 |
| 13 | 41 *:Hg!* |
|
6
1da613c13d81
Better hg-status window.
Ludovic Chabant <ludovic@chabant.com>
parents:
0
diff
changeset
|
42 :Hg! {args} Like |:Hg|, but the output of the command is placed in |
| 0 | 43 a temp file and edited in the |preview-window|. |
| 44 | |
| 13 | 45 *:Hgcd* |
|
6
1da613c13d81
Better hg-status window.
Ludovic Chabant <ludovic@chabant.com>
parents:
0
diff
changeset
|
46 :Hgcd[!] {path} |:cd| relative to the root of the repository. |
| 0 | 47 |
| 13 | 48 *:Hglcd* |
|
6
1da613c13d81
Better hg-status window.
Ludovic Chabant <ludovic@chabant.com>
parents:
0
diff
changeset
|
49 :Hglcd[!] {path} |:lcd| relative to the root of the repository. |
|
1da613c13d81
Better hg-status window.
Ludovic Chabant <ludovic@chabant.com>
parents:
0
diff
changeset
|
50 |
| 13 | 51 *:Hgedit* |
|
6
1da613c13d81
Better hg-status window.
Ludovic Chabant <ludovic@chabant.com>
parents:
0
diff
changeset
|
52 :Hgedit {file} |:edit| {file} relative to the root of the repository. |
|
1da613c13d81
Better hg-status window.
Ludovic Chabant <ludovic@chabant.com>
parents:
0
diff
changeset
|
53 |
| 13 | 54 *:Hgedit!* |
|
6
1da613c13d81
Better hg-status window.
Ludovic Chabant <ludovic@chabant.com>
parents:
0
diff
changeset
|
55 :Hgedit! {file} |:edit!| {file} relative to the root of the repository. |
| 0 | 56 |
| 13 | 57 *:Hgstatus* |
| 0 | 58 :Hgstatus Shows the output of 'hg status' in the |
|
31
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
59 |preview-window|. Some extra-commands, along with some |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
60 default mappins, are available in this window. See |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
61 |lawrencium-status-window|. |
| 13 | 62 |
| 63 *:Hgdiff* | |
| 64 :Hgdiff Diffs the current file against its parent revision. | |
| 65 | |
| 66 *:Hgdiff_f* | |
| 67 :Hgdiff {revspec} Diffs the current file against the specified revision. | |
| 68 | |
| 69 *:Hgvdiff* | |
| 70 :Hgvdiff Same as |:Hgdiff| but uses a vertical split. | |
| 71 | |
| 72 *:Hgvdiff_f* | |
| 73 :Hgvdiff {revspec} Same as |:Hgdiff_f| but uses a vertical split. | |
| 74 | |
| 75 *:Hgcommit* | |
| 76 :Hgcommit Opens a new window to edit a commit message into a | |
| 77 temporary file and, upon quitting the buffer, if that | |
| 78 file has been written to, commit the current changes | |
| 79 to the repository. | |
| 80 | |
| 81 *:Hgvcommit* | |
| 82 :Hgvcommit Same as |:Hgcommit| but uses a vertical split to edit | |
| 83 the commit message. | |
| 0 | 84 |
|
38
a384b4aff211
Updated documentation with `Hgrevert`.
Ludovic Chabant <ludovic@chabant.com>
parents:
34
diff
changeset
|
85 :Hgrevert {files} *:Hgrevert* |
|
a384b4aff211
Updated documentation with `Hgrevert`.
Ludovic Chabant <ludovic@chabant.com>
parents:
34
diff
changeset
|
86 Reverts the given files (in repo-relative paths). If no |
|
a384b4aff211
Updated documentation with `Hgrevert`.
Ludovic Chabant <ludovic@chabant.com>
parents:
34
diff
changeset
|
87 file are given, reverts the current file. |
|
a384b4aff211
Updated documentation with `Hgrevert`.
Ludovic Chabant <ludovic@chabant.com>
parents:
34
diff
changeset
|
88 |
|
a384b4aff211
Updated documentation with `Hgrevert`.
Ludovic Chabant <ludovic@chabant.com>
parents:
34
diff
changeset
|
89 :Hgrevert! {files} *:Hgrevert!* |
|
a384b4aff211
Updated documentation with `Hgrevert`.
Ludovic Chabant <ludovic@chabant.com>
parents:
34
diff
changeset
|
90 Same as |:Hgrevert| but with the --no-backup option |
|
a384b4aff211
Updated documentation with `Hgrevert`.
Ludovic Chabant <ludovic@chabant.com>
parents:
34
diff
changeset
|
91 given to prevent a .orig backup file from being |
|
a384b4aff211
Updated documentation with `Hgrevert`.
Ludovic Chabant <ludovic@chabant.com>
parents:
34
diff
changeset
|
92 created. |
| 0 | 93 |
| 94 | |
|
31
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
95 ============================================================================= |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
96 3. Status Window *lawrencium-status-window* |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
97 |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
98 The `hg status` window opened by Lawrencium has a few special commands |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
99 defined in it. Also, unless the global `lawrencium_define_mappings` is set to |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
100 `0`, some commands are mapped to keyboard shortcuts, as detailed in the |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
101 following descriptions. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
102 |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
103 |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
104 *:Hgstatusedit* |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
105 :Hgstatusedit Open the file mentioned on the current line. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
106 Mapped to <cr>. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
107 |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
108 *:Hgstatusaddremove* |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
109 :Hgstatusaddremove Run `hg addremove` on the file mentioned on the |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
110 current line, or on the lines currently selected in |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
111 visual selection mode (see |visual-start|). |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
112 Mapped to <C-A>. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
113 |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
114 *:Hgstatusdiff* |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
115 :Hgstatusdiff Open a diff window on the file mentioned on the |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
116 current line, between the working directory version |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
117 and the parent revision version. Similar to running |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
118 |:Hgdiff| on that file. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
119 Mapped to <C-D>. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
120 |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
121 *:Hgstatusvdiff* |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
122 :Hgstatusvdiff Similar to |:Hgstatusdiff|, but use a vertical split. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
123 Similar to running |:Hgvdiff| on that file. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
124 Mapped to <C-V>. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
125 |
|
34
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
126 *:Hgstatuscommit* |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
127 :Hgstatuscommit Runs |:Hgcommit| on the files currently mentioned in |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
128 the buffer, or in the current selection. The first |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
129 option means you can delete lines from the buffer |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
130 until the remaining filenames are those you want to |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
131 commit. |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
132 Mapped to <C-S>. |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
133 |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
134 *:Hgstatusvcommit* |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
135 :Hgstatusvcommit Similar to |:Hgstatuscommit|, but use a vertical |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
136 split, as with |:Hgvcommit|. |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
137 Not mapped byd default. |
|
cfc15ff67aaf
Updated documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
31
diff
changeset
|
138 |
|
31
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
139 *:Hgstatusrefresh* |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
140 :Hgstatusrefresh Refreshes the status window by running `hg status` |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
141 again. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
142 Mapped to <C-R>. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
143 |
|
40
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
144 *:Hgstatusqnew* |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
145 :Hgstatusqnew {patch} {message}. |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
146 If you have the 'mq' extension enabled, creates a new |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
147 patch with the file currently mentioned in the buffer, |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
148 or in the current selection. You must give a patch name, |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
149 and may optionally write a commit message for the patch |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
150 (without surrounding quotes). |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
151 |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
152 *:Hgstatusqrefresh* |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
153 :Hgstatusqrefresh If you have the 'mq' extension enabled, refreshes the |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
154 current patch with the files currently mentioned in the |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
155 buffer, or in the current selection. |
|
a63ec818ab21
Added `qnew` and `qrefresh` commands to the `Hgstatus` window.
Ludovic Chabant <ludovic@chabant.com>
parents:
38
diff
changeset
|
156 |
|
31
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
157 *lawrencium-status-mappings* |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
158 A few other mappings are available in the status window: |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
159 |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
160 <C-N> Jump to the next filename. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
161 <C-P> Jump to the previous filename. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
162 q Quit the status window. |
|
3a0f7bb6ea64
Hgstatus window improvements and bug fixes:
Ludovic Chabant <ludovic@chabant.com>
parents:
20
diff
changeset
|
163 |
| 0 | 164 |
| 165 vim:tw=78:et:ft=help:norl: |