| Offset 1, 3 lines modified | Offset 1, 3 lines modified | ||
| 1 | · | 1 | ·abaefde4abd7435b6f015f70f2890f18·532896·lisp·optional·elpa-yasnippet_0.14.0+git20200603.5cbdbf0d-1_all.deb |
| 2 | ·51e29e789207e11d55779829cd1b8af4·5032·lisp·optional·yasnippet_0.14.0+git20200603.5cbdbf0d-1_all.deb | 2 | ·51e29e789207e11d55779829cd1b8af4·5032·lisp·optional·yasnippet_0.14.0+git20200603.5cbdbf0d-1_all.deb |
| Offset 1, 3 lines modified | Offset 1, 3 lines modified | ||
| 1 | -rw-r--r--···0········0········0········4·2020-11-05·15:31:38.000000·debian-binary | 1 | -rw-r--r--···0········0········0········4·2020-11-05·15:31:38.000000·debian-binary |
| 2 | -rw-r--r--···0········0········0·····19 | 2 | -rw-r--r--···0········0········0·····1952·2020-11-05·15:31:38.000000·control.tar.xz |
| 3 | -rw-r--r--···0········0········0···5307 | 3 | -rw-r--r--···0········0········0···530752·2020-11-05·15:31:38.000000·data.tar.xz |
| Offset 260, 55 lines modified | Offset 260, 55 lines modified | ||
| 260 | </div> | 260 | </div> |
| 261 | <div·id="content"> | 261 | <div·id="content"> |
| 262 | <h1·class="title">Frequently·Asked·Questions</h1> | 262 | <h1·class="title">Frequently·Asked·Questions</h1> |
| 263 | <div·id="table-of-contents"> | 263 | <div·id="table-of-contents"> |
| 264 | <h2>Table·of·Contents</h2> | 264 | <h2>Table·of·Contents</h2> |
| 265 | <div·id="text-table-of-contents"> | 265 | <div·id="text-table-of-contents"> |
| 266 | <ul> | 266 | <ul> |
| 267 | <li><a·href="#org9 | 267 | <li><a·href="#org9739210">Why·are·my·snippet·abbrev·keys·triggering·when·I·don't·want·them·too?</a></li> |
| 268 | <li><a·href="#org | 268 | <li><a·href="#orgbb9204d">Why·aren't·my·snippet·abbrev·keys·triggering·when·I·want·them·too?</a></li> |
| 269 | <li><a·href="#org | 269 | <li><a·href="#org92594c9">Why·is·there·an·extra·newline?</a></li> |
| 270 | <li><a·href="#org | 270 | <li><a·href="#org7d0e13b">Why·doesn't·TAB·navigation·work·with·flyspell</a></li> |
| 271 | <li><a·href="#org | 271 | <li><a·href="#orgd3dd159">How·do·I·use·alternative·keys,·i.e.·not·TAB?</a></li> |
| 272 | <li><a·href="#org | 272 | <li><a·href="#org8fea2dc">How·do·I·define·an·abbrev·key·containing·characters·not·supported·by·the·filesystem?</a></li> |
| 273 | </ul> | 273 | </ul> |
| 274 | </div> | 274 | </div> |
| 275 | </div> | 275 | </div> |
| 276 | <ul·class="org-ul"> | 276 | <ul·class="org-ul"> |
| 277 | <li><b>Note</b>:·In·addition·to·the·questions·and·answers·presented·here, | 277 | <li><b>Note</b>:·In·addition·to·the·questions·and·answers·presented·here, |
| 278 | you·might·also·with·to·visit·the·list·of·<a·href="https://github.com/joaotavora/yasnippet/issues?q=label%3Asupport">solved·support·issues</a>·in | 278 | you·might·also·with·to·visit·the·list·of·<a·href="https://github.com/joaotavora/yasnippet/issues?q=label%3Asupport">solved·support·issues</a>·in |
| 279 | the·Github·issue·tracker.··It·might·be·more·up-to-date·than·this | 279 | the·Github·issue·tracker.··It·might·be·more·up-to-date·than·this |
| 280 | list.</li> | 280 | list.</li> |
| 281 | </ul> | 281 | </ul> |
| 282 | <div·id="outline-container-org9 | 282 | <div·id="outline-container-org9739210"·class="outline-2"> |
| 283 | <h2·id="org9 | 283 | <h2·id="org9739210">Why·are·my·snippet·abbrev·keys·triggering·when·I·don't·want·them·too?</h2> |
| 284 | <div·class="outline-text-2"·id="text-org9 | 284 | <div·class="outline-text-2"·id="text-org9739210"> |
| 285 | <p> | 285 | <p> |
| 286 | Expansion·of·abbrev·keys·is·controlled·by·<a·href="snippet-reference.html#yas-key-syntaxes"><code>yas-key-syntaxes</code></a>.··Try | 286 | Expansion·of·abbrev·keys·is·controlled·by·<a·href="snippet-reference.html#yas-key-syntaxes"><code>yas-key-syntaxes</code></a>.··Try |
| 287 | removing·entries·which·correspond·to·the·abbrev·key·character·syntax. | 287 | removing·entries·which·correspond·to·the·abbrev·key·character·syntax. |
| 288 | For·example,·if·you·have·a·snippet·with·abbrev·key·"bar",·that·you | 288 | For·example,·if·you·have·a·snippet·with·abbrev·key·"bar",·that·you |
| 289 | don't·want·to·trigger·when·point·follows·the·text·<code>foo_bar</code>,·remove | 289 | don't·want·to·trigger·when·point·follows·the·text·<code>foo_bar</code>,·remove |
| 290 | the·<code>"w"</code>·entry·(since·"bar"·has·only·word·syntax·characters). | 290 | the·<code>"w"</code>·entry·(since·"bar"·has·only·word·syntax·characters). |
| 291 | </p> | 291 | </p> |
| 292 | </div> | 292 | </div> |
| 293 | </div> | 293 | </div> |
| 294 | <div·id="outline-container-org | 294 | <div·id="outline-container-orgbb9204d"·class="outline-2"> |
| 295 | <h2·id="org | 295 | <h2·id="orgbb9204d">Why·aren't·my·snippet·abbrev·keys·triggering·when·I·want·them·too?</h2> |
| 296 | <div·class="outline-text-2"·id="text-org | 296 | <div·class="outline-text-2"·id="text-orgbb9204d"> |
| 297 | <p> | 297 | <p> |
| 298 | See·previous·question,·but·in·reverse. | 298 | See·previous·question,·but·in·reverse. |
| 299 | </p> | 299 | </p> |
| 300 | </div> | 300 | </div> |
| 301 | </div> | 301 | </div> |
| 302 | <div·id="outline-container-org | 302 | <div·id="outline-container-org92594c9"·class="outline-2"> |
| 303 | <h2·id="org | 303 | <h2·id="org92594c9">Why·is·there·an·extra·newline?</h2> |
| 304 | <div·class="outline-text-2"·id="text-org | 304 | <div·class="outline-text-2"·id="text-org92594c9"> |
| 305 | <p> | 305 | <p> |
| 306 | If·there·is·a·newline·at·the·end·of·a·snippet·definition·file, | 306 | If·there·is·a·newline·at·the·end·of·a·snippet·definition·file, |
| 307 | YASnippet·will·add·a·newline·when·expanding·that·snippet.·When·editing | 307 | YASnippet·will·add·a·newline·when·expanding·that·snippet.·When·editing |
| 308 | or·saving·a·snippet·file,·please·be·careful·not·to·accidentally·add·a | 308 | or·saving·a·snippet·file,·please·be·careful·not·to·accidentally·add·a |
| 309 | terminal·newline. | 309 | terminal·newline. |
| 310 | </p> | 310 | </p> |
| Offset 316, 17 lines modified | Offset 316, 17 lines modified | ||
| 316 | Note·that·some·editors·will·automatically·add·a·newline·for·you.·In | 316 | Note·that·some·editors·will·automatically·add·a·newline·for·you.·In |
| 317 | Emacs,·if·you·set·<code>require-final-newline</code>·to·<code>t</code>,·it·will·add·the | 317 | Emacs,·if·you·set·<code>require-final-newline</code>·to·<code>t</code>,·it·will·add·the |
| 318 | final·newline·automatically. | 318 | final·newline·automatically. |
| 319 | </p> | 319 | </p> |
| 320 | </div> | 320 | </div> |
| 321 | </div> | 321 | </div> |
| 322 | <div·id="outline-container-org | 322 | <div·id="outline-container-org7d0e13b"·class="outline-2"> |
| 323 | <h2·id="org | 323 | <h2·id="org7d0e13b">Why·doesn't·TAB·navigation·work·with·flyspell</h2> |
| 324 | <div·class="outline-text-2"·id="text-org | 324 | <div·class="outline-text-2"·id="text-org7d0e13b"> |
| 325 | <p> | 325 | <p> |
| 326 | This·is·<a·href="https://debbugs.gnu.org/26672">Emacs·Bug#26672</a>,·so·you·should·upgrade·to·version·25.3·or | 326 | This·is·<a·href="https://debbugs.gnu.org/26672">Emacs·Bug#26672</a>,·so·you·should·upgrade·to·version·25.3·or |
| 327 | better.··Otherwise,·a·workaround·is·to·inhibit·flyspell·overlays·while | 327 | better.··Otherwise,·a·workaround·is·to·inhibit·flyspell·overlays·while |
| 328 | the·snippet·is·active: | 328 | the·snippet·is·active: |
| 329 | </p> | 329 | </p> |
| 330 | <div·class="org-src-container"> | 330 | <div·class="org-src-container"> |
| Offset 335, 17 lines modified | Offset 335, 17 lines modified | ||
| 335 | ··············(<span·class="org-keyword">and</span>·yas-active-field-overlay | 335 | ··············(<span·class="org-keyword">and</span>·yas-active-field-overlay |
| 336 | ···················(overlay-buffer·yas-active-field-overlay)))) | 336 | ···················(overlay-buffer·yas-active-field-overlay)))) |
| 337 | </pre> | 337 | </pre> |
| 338 | </div> | 338 | </div> |
| 339 | </div> | 339 | </div> |
| 340 | </div> | 340 | </div> |
| 341 | <div·id="outline-container-org | 341 | <div·id="outline-container-orgd3dd159"·class="outline-2"> |
| 342 | <h2·id="org | 342 | <h2·id="orgd3dd159">How·do·I·use·alternative·keys,·i.e.·not·TAB?</h2> |
| 343 | <div·class="outline-text-2"·id="text-org | 343 | <div·class="outline-text-2"·id="text-orgd3dd159"> |
| 344 | <p> | 344 | <p> |
| 345 | Edit·the·keymaps·<a·href="snippet-reference.html#yas-minor-mode-map"><code>yas-minor-mode-map</code></a>·and·<a·href="snippet-reference.html#yas-keymap"><code>yas-keymap</code></a>·as·you·would | 345 | Edit·the·keymaps·<a·href="snippet-reference.html#yas-minor-mode-map"><code>yas-minor-mode-map</code></a>·and·<a·href="snippet-reference.html#yas-keymap"><code>yas-keymap</code></a>·as·you·would |
| 346 | any·other·keymap,·but·use·<a·href="snippet-reference.html#yas-filtered-definition"><code>yas-filtered-definition</code></a>·on·the·definition | 346 | any·other·keymap,·but·use·<a·href="snippet-reference.html#yas-filtered-definition"><code>yas-filtered-definition</code></a>·on·the·definition |
| 347 | if·you·want·to·respect·<a·href="snippet-reference.html#yas-keymap-disable-hook"><code>yas-keymap-disable-hook</code></a>: | 347 | if·you·want·to·respect·<a·href="snippet-reference.html#yas-keymap-disable-hook"><code>yas-keymap-disable-hook</code></a>: |
| 348 | </p> | 348 | </p> |
| 349 | <div·class="org-src-container"> | 349 | <div·class="org-src-container"> |
| Offset 363, 17 lines modified | Offset 363, 17 lines modified | ||
| 363 | (define-key·yas-keymap·(kbd·<span·class="org-string">"<new-prev-field-key>"</span>) | 363 | (define-key·yas-keymap·(kbd·<span·class="org-string">"<new-prev-field-key>"</span>) |
| 364 | ··(yas-filtered-definition·'yas-prev-field)) | 364 | ··(yas-filtered-definition·'yas-prev-field)) |
| 365 | </pre> | 365 | </pre> |
| 366 | </div> | 366 | </div> |
| 367 | </div> | 367 | </div> |
| 368 | </div> | 368 | </div> |
| 369 | <div·id="outline-container-org | 369 | <div·id="outline-container-org8fea2dc"·class="outline-2"> |
| 370 | <h2·id="org | 370 | <h2·id="org8fea2dc">How·do·I·define·an·abbrev·key·containing·characters·not·supported·by·the·filesystem?</h2> |
| 371 | <div·class="outline-text-2"·id="text-org | 371 | <div·class="outline-text-2"·id="text-org8fea2dc"> |
| 372 | <ul·class="org-ul"> | 372 | <ul·class="org-ul"> |
| 373 | <li><b>Note</b>:·This·question·applies·if·you're·still·defining·snippets | 373 | <li><b>Note</b>:·This·question·applies·if·you're·still·defining·snippets |
| 374 | whose·key·<i>is</i>·the·filename.·This·is·behavior·still·provided·by | 374 | whose·key·<i>is</i>·the·filename.·This·is·behavior·still·provided·by |
| 375 | version·0.6·for·backward·compatibilty,·but·is·somewhat | 375 | version·0.6·for·backward·compatibilty,·but·is·somewhat |
| 376 | deprecated…</li> | 376 | deprecated…</li> |
| 377 | </ul> | 377 | </ul> |
| Offset 260, 98 lines modified | Offset 260, 98 lines modified | ||
| 260 | </div> | 260 | </div> |
| 261 | <div·id="content"> | 261 | <div·id="content"> |
| 262 | <h1·class="title">Writing·snippets</h1> | 262 | <h1·class="title">Writing·snippets</h1> |
| 263 | <div·id="table-of-contents"> | 263 | <div·id="table-of-contents"> |
| 264 | <h2>Table·of·Contents</h2> | 264 | <h2>Table·of·Contents</h2> |
| 265 | <div·id="text-table-of-contents"> | 265 | <div·id="text-table-of-contents"> |
| 266 | <ul> | 266 | <ul> |
| 267 | <li><a·href="#org | 267 | <li><a·href="#orge7ac8db">Snippet·development</a> |
| 268 | <ul> | 268 | <ul> |
| 269 | <li><a·href="#org | 269 | <li><a·href="#org8dbcc7a">Quickly·finding·snippets</a></li> |
| 270 | <li><a·href="#org | 270 | <li><a·href="#orgc4ac330">Using·the·<code>snippet-mode</code>·major·mode·</a></li> |
| 271 | </ul> | 271 | </ul> |
| 272 | </li> | 272 | </li> |
| 273 | <li><a·href="#org | 273 | <li><a·href="#orga14933b">File·content</a> |
| 274 | <ul> | 274 | <ul> |
| 275 | <li><a·href="#org | 275 | <li><a·href="#org3357065"><code>#·key:</code>·snippet·abbrev</a></li> |
| 276 | <li><a·href="#org | 276 | <li><a·href="#org6cfa3c5"><code>#·name:</code>·snippet·name</a></li> |
| 277 | <li><a·href="#org | 277 | <li><a·href="#org35cc531"><code>#·condition:</code>·snippet·condition</a></li> |
| 278 | <li><a·href="#org | 278 | <li><a·href="#org30ff27d"><code>#·group:</code>·snippet·menu·grouping</a></li> |
| 279 | <li><a·href="#org | 279 | <li><a·href="#org293ff69"><code>#·expand-env:</code>·expand·environment</a></li> |
| 280 | <li><a·href="#org | 280 | <li><a·href="#org2871348"><code>#·binding:</code>·direct·keybinding</a></li> |
| 281 | <li><a·href="#org | 281 | <li><a·href="#org424f6ef"><code>#·type:</code>·<code>snippet</code>·or·<code>command</code></a></li> |
| 282 | <li><a·href="#org | 282 | <li><a·href="#org8478d78"><code>#·uuid:</code>·unique·identifier</a></li> |
| 283 | <li><a·href="#org | 283 | <li><a·href="#org51e0d52"><code>#·contributor:</code>·snippet·author</a></li> |
| 284 | </ul> | 284 | </ul> |
| 285 | </li> | 285 | </li> |
| 286 | <li><a·href="#org | 286 | <li><a·href="#org7daca37">Template·Syntax</a> |
| 287 | <ul> | 287 | <ul> |
| 288 | <li><a·href="#org | 288 | <li><a·href="#orgd59cef4">Plain·Text</a></li> |
| 289 | <li><a·href="#org | 289 | <li><a·href="#orgeb76fa5">Embedded·Emacs·Lisp·code</a> |
| 290 | <ul> | 290 | <ul> |
| 291 | <li><a·href="#org | 291 | <li><a·href="#orga12aba2">Note:·backquote·expressions·should·not·modify·the·buffer</a></li> |
| 292 | </ul> | 292 | </ul> |
| 293 | </li> | 293 | </li> |
| 294 | <li><a·href="#org | 294 | <li><a·href="#orgcb4b7cd">Tab·stop·fields</a></li> |
| 295 | <li><a·href="#org | 295 | <li><a·href="#org73cfe6e">Placeholder·fields</a></li> |
| 296 | <li><a·href="#org | 296 | <li><a·href="#org4ed7dfe">Mirrors·</a></li> |
| 297 | <li><a·href="#org | 297 | <li><a·href="#org0f68fd4">Mirrors·with·transformations·</a></li> |
| 298 | <li><a·href="#org | 298 | <li><a·href="#orgd2bc989">Fields·with·transformations</a></li> |
| 299 | <li><a·href="#org | 299 | <li><a·href="#orgf81750e">Choosing·fields·value·from·a·list·and·other·tricks</a></li> |
| 300 | <li><a·href="#org4 | 300 | <li><a·href="#orgd4f335a">Nested·placeholder·fields</a></li> |
| 301 | <li><a·href="#org | 301 | <li><a·href="#orgc0df9d8">Indentation·markers</a></li> |
| 302 | </ul> | 302 | </ul> |
| 303 | </li> | 303 | </li> |
| 304 | </ul> | 304 | </ul> |
| 305 | </div> | 305 | </div> |
| 306 | </div> | 306 | </div> |
| 307 | <div·id="outline-container-org | 307 | <div·id="outline-container-orge7ac8db"·class="outline-2"> |
| 308 | <h2·id="org | 308 | <h2·id="orge7ac8db">Snippet·development</h2> |
| 309 | <div·class="outline-text-2"·id="text-org | 309 | <div·class="outline-text-2"·id="text-orge7ac8db"> |
| 310 | </div> | 310 | </div> |
| 311 | <div·id="outline-container-org | 311 | <div·id="outline-container-org8dbcc7a"·class="outline-3"> |
| 312 | <h3·id="org | 312 | <h3·id="org8dbcc7a">Quickly·finding·snippets</h3> |
| 313 | <div·class="outline-text-3"·id="text-org | 313 | <div·class="outline-text-3"·id="text-org8dbcc7a"> |
| 314 | <p> | 314 | <p> |
| 315 | There·are·some·ways·you·can·quickly·find·a·snippet·file·or·create·a·new·one: | 315 | There·are·some·ways·you·can·quickly·find·a·snippet·file·or·create·a·new·one: |
| 316 | </p> | 316 | </p> |
| 317 | <ul·class="org-ul"> | 317 | <ul·class="org-ul"> |
| 318 | <li><p> | 318 | <li><p> |
| 319 | <code>M-x·yas-new-snippet</code>,·key·binding:·<code>C-c·&·C-n</code> | 319 | <code>M-x·yas-new-snippet</code>,·key·binding:·<code>C-c·&·C-n</code> |
| 320 | </p> | 320 | </p> |
| 321 | <p> | 321 | <p> |
| 322 | Creates·a·new·buffer·with·a·template·for·making·a·new·snippet.··The | 322 | Creates·a·new·buffer·with·a·template·for·making·a·new·snippet.··The |
| 323 | buffer·is·in·<code>snippet-mode</code>·(see·<a·href="#org | 323 | buffer·is·in·<code>snippet-mode</code>·(see·<a·href="#org270e150">below</a>).··When·you·are·done·editing |
| 324 | the·new·snippet,·use·<a·href="#org | 324 | the·new·snippet,·use·<a·href="#org27c9aea"><code>C-c·C-c</code></a>·to·save·it. |
| 325 | </p></li> | 325 | </p></li> |
| 326 | <li><p> | 326 | <li><p> |
| 327 | <code>M-x·yas-visit-snippet-file</code>,·key·binding:·<code>C-c·&·C-v</code> | 327 | <code>M-x·yas-visit-snippet-file</code>,·key·binding:·<code>C-c·&·C-v</code> |
| 328 | </p> | 328 | </p> |
| 329 | <p> | 329 | <p> |
| 330 | Prompts·you·for·possible·snippet·expansions·like | 330 | Prompts·you·for·possible·snippet·expansions·like |
| 331 | <a·href="snippet-reference.html#yas-insert-snippet"><code>yas-insert-snippet</code></a>,·but·instead·of·expanding·it,·takes·you·directly | 331 | <a·href="snippet-reference.html#yas-insert-snippet"><code>yas-insert-snippet</code></a>,·but·instead·of·expanding·it,·takes·you·directly |
| 332 | to·the·snippet·definition's·file,·if·it·exists. | 332 | to·the·snippet·definition's·file,·if·it·exists. |
| 333 | </p></li> | 333 | </p></li> |
| 334 | </ul> | 334 | </ul> |
| 335 | <p> | 335 | <p> |
| 336 | Once·you·find·this·file·it·will·be·set·to·<code>snippet-mode</code>·(see·<a·href="#org | 336 | Once·you·find·this·file·it·will·be·set·to·<code>snippet-mode</code>·(see·<a·href="#org270e150">ahead</a>) |
| 337 | and·you·can·start·editing·your·snippet. | 337 | and·you·can·start·editing·your·snippet. |
| 338 | </p> | 338 | </p> |
| 339 | </div> | 339 | </div> |
| 340 | </div> | 340 | </div> |
| 341 | <div·id="outline-container-org | 341 | <div·id="outline-container-orgc4ac330"·class="outline-3"> |
| 342 | <h3·id="org | 342 | <h3·id="orgc4ac330">Using·the·<code>snippet-mode</code>·major·mode·<a·id="org270e150"></a></h3> |
| 343 | <div·class="outline-text-3"·id="text-org | 343 | <div·class="outline-text-3"·id="text-orgc4ac330"> |
| 344 | <p> | 344 | <p> |
| 345 | There·is·a·major·mode·<code>snippet-mode</code>·to·edit·snippets.·You·can·set·the | 345 | There·is·a·major·mode·<code>snippet-mode</code>·to·edit·snippets.·You·can·set·the |
| 346 | buffer·to·this·mode·with·<code>M-x·snippet-mode</code>.·It·provides·reasonably | 346 | buffer·to·this·mode·with·<code>M-x·snippet-mode</code>.·It·provides·reasonably |
| 347 | useful·syntax·highlighting. | 347 | useful·syntax·highlighting. |
| 348 | </p> | 348 | </p> |
| 349 | <p> | 349 | <p> |
| Offset 366, 15 lines modified | Offset 366, 15 lines modified | ||
| 366 | <p> | 366 | <p> |
| 367 | Prompts·for·a·snippet·table·(with·a·default·based·on·snippet's | 367 | Prompts·for·a·snippet·table·(with·a·default·based·on·snippet's |
| 368 | major·mode)·and·loads·the·snippet·currently·being·edited. | 368 | major·mode)·and·loads·the·snippet·currently·being·edited. |
| 369 | </p></li> | 369 | </p></li> |
| 370 | <li><p> | 370 | <li><p> |
| 371 | <code>M-x·yas-load-snippet-buffer-and-close</code>,·key·binding:·<code>C-c·C-c</code> | 371 | <code>M-x·yas-load-snippet-buffer-and-close</code>,·key·binding:·<code>C-c·C-c</code> |
| 372 | <a·id="org | 372 | <a·id="org27c9aea"></a> |
| 373 | </p> | 373 | </p> |
| 374 | <p> | 374 | <p> |
| 375 | Like·<code>yas-load-snippet-buffer</code>,·but·also·saves·the·snippet·and | 375 | Like·<code>yas-load-snippet-buffer</code>,·but·also·saves·the·snippet·and |
| 376 | calls·<code>quit-window</code>.··The·destination·is·decided·based·on·the | 376 | calls·<code>quit-window</code>.··The·destination·is·decided·based·on·the |
| 377 | chosen·snippet·table·and·snippet·collection·directly·(defaulting·to | 377 | chosen·snippet·table·and·snippet·collection·directly·(defaulting·to |
| 378 | the·first·directory·in·<code>yas-snippet-dirs</code>·(see·<a·href="snippet-organization.html">Organizing·Snippets</a> | 378 | the·first·directory·in·<code>yas-snippet-dirs</code>·(see·<a·href="snippet-organization.html">Organizing·Snippets</a> |
| Offset 396, 17 lines modified | Offset 396, 17 lines modified | ||
| 396 | There·are·also·<i>snippets·for·writing·snippets</i>:·<code>vars</code>,·<code>$f</code>·and·<code>$m</code> | 396 | There·are·also·<i>snippets·for·writing·snippets</i>:·<code>vars</code>,·<code>$f</code>·and·<code>$m</code> |
| 397 | :-). | 397 | :-). |
| 398 | </p> | 398 | </p> |
| 399 | </div> | 399 | </div> |
| 400 | </div> | 400 | </div> |
| 401 | </div> | 401 | </div> |
| 402 | <div·id="outline-container-org | 402 | <div·id="outline-container-orga14933b"·class="outline-2"> |
| 403 | <h2·id="org | 403 | <h2·id="orga14933b">File·content</h2> |
| 404 | <div·class="outline-text-2"·id="text-org | 404 | <div·class="outline-text-2"·id="text-orga14933b"> |
| 405 | <p> | 405 | <p> |
| 406 | A·file·defining·a·snippet·generally·contains·the·template·to·be | 406 | A·file·defining·a·snippet·generally·contains·the·template·to·be |
| Max diff block lines reached; 16739/24199 bytes (69.17%) of diff not shown. | |||
| Offset 260, 42 lines modified | Offset 260, 42 lines modified | ||
| 260 | </div> | 260 | </div> |
| 261 | <div·id="content"> | 261 | <div·id="content"> |
| 262 | <h1·class="title">Expanding·snippets</h1> | 262 | <h1·class="title">Expanding·snippets</h1> |
| 263 | <div·id="table-of-contents"> | 263 | <div·id="table-of-contents"> |
| 264 | <h2>Table·of·Contents</h2> | 264 | <h2>Table·of·Contents</h2> |
| 265 | <div·id="text-table-of-contents"> | 265 | <div·id="text-table-of-contents"> |
| 266 | <ul> | 266 | <ul> |
| 267 | <li><a·href="#org | 267 | <li><a·href="#org63ff3ec">Triggering·expansion</a> |
| 268 | <ul> | 268 | <ul> |
| 269 | <li><a·href="#org | 269 | <li><a·href="#org7e1266d">Trigger·key</a> |
| 270 | <ul> | 270 | <ul> |
| 271 | <li><a·href="#org | 271 | <li><a·href="#org4a24f30">Fallback·behaviour</a></li> |
| 272 | </ul> | 272 | </ul> |
| 273 | </li> | 273 | </li> |
| 274 | <li><a·href="#org | 274 | <li><a·href="#org697e49c">Insert·at·point</a> |
| 275 | <ul> | 275 | <ul> |
| 276 | <li><a·href="#org | 276 | <li><a·href="#org131de76">Inserting·region·or·register·contents·into·snippet</a></li> |
| 277 | </ul> | 277 | </ul> |
| 278 | </li> | 278 | </li> |
| 279 | <li><a·href="#org | 279 | <li><a·href="#org2b38302">Snippet·keybinding</a></li> |
| 280 | <li><a·href="#org | 280 | <li><a·href="#org8df8da6">Expanding·from·the·menu</a></li> |
| 281 | <li><a·href="#org | 281 | <li><a·href="#org956eba0">Expanding·with·<code>hippie-expand</code></a></li> |
| 282 | <li><a·href="#org | 282 | <li><a·href="#orgfa1f047">Expanding·from·emacs-lisp·code</a></li> |
| 283 | </ul> | 283 | </ul> |
| 284 | </li> | 284 | </li> |
| 285 | <li><a·href="#org | 285 | <li><a·href="#orgc8e0389">Controlling·expansion</a> |
| 286 | <ul> | 286 | <ul> |
| 287 | <li><a·href="#org | 287 | <li><a·href="#orga254f46">Eligible·snippets</a></li> |
| 288 | <li><a·href="#org | 288 | <li><a·href="#orgecdf959">The·condition·system·</a></li> |
| 289 | <li><a·href="#org | 289 | <li><a·href="#org5573be4">Multiples·snippet·with·the·same·key</a> |
| 290 | <ul> | 290 | <ul> |
| 291 | <li><a·href="#orgd | 291 | <li><a·href="#orgd0fb538">Use·the·X·window·system</a></li> |
| 292 | <li><a·href="#org | 292 | <li><a·href="#orgf0b4aab">Minibuffer·prompting</a></li> |
| 293 | <li><a·href="#org | 293 | <li><a·href="#orgac679f9">Use·<code>dropdown-menu.el</code></a></li> |
| 294 | <li><a·href="#org | 294 | <li><a·href="#org5a04733">Roll·your·own</a></li> |
| 295 | </ul> | 295 | </ul> |
| 296 | </li> | 296 | </li> |
| 297 | </ul> | 297 | </ul> |
| 298 | </li> | 298 | </li> |
| 299 | </ul> | 299 | </ul> |
| 300 | </div> | 300 | </div> |
| 301 | </div> | 301 | </div> |
| Offset 304, 17 lines modified | Offset 304, 17 lines modified | ||
| 304 | </p> | 304 | </p> |
| 305 | <p> | 305 | <p> |
| 306 | Maybe,·you'll·want·some·snippets·to·be·expanded·in·a·particular | 306 | Maybe,·you'll·want·some·snippets·to·be·expanded·in·a·particular |
| 307 | mode,·or·only·under·certain·conditions,·or·be·prompted·using | 307 | mode,·or·only·under·certain·conditions,·or·be·prompted·using |
| 308 | </p> | 308 | </p> |
| 309 | <div·id="outline-container-org | 309 | <div·id="outline-container-org63ff3ec"·class="outline-2"> |
| 310 | <h2·id="org | 310 | <h2·id="org63ff3ec">Triggering·expansion</h2> |
| 311 | <div·class="outline-text-2"·id="text-org | 311 | <div·class="outline-text-2"·id="text-org63ff3ec"> |
| 312 | <p> | 312 | <p> |
| 313 | You·can·use·YASnippet·to·expand·snippets·in·different·ways: | 313 | You·can·use·YASnippet·to·expand·snippets·in·different·ways: |
| 314 | </p> | 314 | </p> |
| 315 | <ul·class="org-ul"> | 315 | <ul·class="org-ul"> |
| 316 | <li>When·<a·href="snippet-reference.html#yas-minor-mode"><code>yas-minor-mode</code></a>·is·active: | 316 | <li>When·<a·href="snippet-reference.html#yas-minor-mode"><code>yas-minor-mode</code></a>·is·active: |
| 317 | <ul·class="org-ul"> | 317 | <ul·class="org-ul"> |
| Offset 334, 17 lines modified | Offset 334, 17 lines modified | ||
| 334 | <li>Use·m2m's·excellent·auto-complete | 334 | <li>Use·m2m's·excellent·auto-complete |
| 335 | TODO:·example·for·this</li> | 335 | TODO:·example·for·this</li> |
| 336 | <li>Expanding·from·emacs-lisp·code</li> | 336 | <li>Expanding·from·emacs-lisp·code</li> |
| 337 | </ul> | 337 | </ul> |
| 338 | </div> | 338 | </div> |
| 339 | <div·id="outline-container-org | 339 | <div·id="outline-container-org7e1266d"·class="outline-3"> |
| 340 | <h3·id="org | 340 | <h3·id="org7e1266d">Trigger·key</h3> |
| 341 | <div·class="outline-text-3"·id="text-org | 341 | <div·class="outline-text-3"·id="text-org7e1266d"> |
| 342 | <p> | 342 | <p> |
| 343 | <a·href="snippet-reference.html#yas-expand"><code>yas-expand</code></a>·tries·to·expand·a·<i>snippet·abbrev</i>·(also·known·as | 343 | <a·href="snippet-reference.html#yas-expand"><code>yas-expand</code></a>·tries·to·expand·a·<i>snippet·abbrev</i>·(also·known·as |
| 344 | <i>snippet·key</i>)·before·point.··YASnippet·also·provides·a·<i>conditional | 344 | <i>snippet·key</i>)·before·point.··YASnippet·also·provides·a·<i>conditional |
| 345 | binding</i>·for·this·command:·the·variable·<a·href="snippet-reference.html#yas-expand"><code>yas-maybe-expand</code></a>·contains·a | 345 | binding</i>·for·this·command:·the·variable·<a·href="snippet-reference.html#yas-expand"><code>yas-maybe-expand</code></a>·contains·a |
| 346 | special·value·which,·when·bound·in·a·keymap,·tells·Emacs·to·call | 346 | special·value·which,·when·bound·in·a·keymap,·tells·Emacs·to·call |
| 347 | <a·href="snippet-reference.html#yas-expand"><code>yas-expand</code></a>·if·and·only·if·there·is·a·snippet·abbrev·before·point. | 347 | <a·href="snippet-reference.html#yas-expand"><code>yas-expand</code></a>·if·and·only·if·there·is·a·snippet·abbrev·before·point. |
| 348 | If·there·is·no·snippet·to·expand,·Emacs·will·behave·as·if·<a·href="snippet-reference.html#yas-expand"><code>yas-expand</code></a> | 348 | If·there·is·no·snippet·to·expand,·Emacs·will·behave·as·if·<a·href="snippet-reference.html#yas-expand"><code>yas-expand</code></a> |
| Offset 392, 29 lines modified | Offset 392, 29 lines modified | ||
| 392 | <p> | 392 | <p> |
| 393 | When·you·use·<a·href="snippet-reference.html#yas-global-mode"><code>yas-global-mode</code></a>·you·can·also·selectively·disable | 393 | When·you·use·<a·href="snippet-reference.html#yas-global-mode"><code>yas-global-mode</code></a>·you·can·also·selectively·disable |
| 394 | YASnippet·in·some·buffers·by·calling·<a·href="snippet-reference.html#yas-minor-mode"><code>yas-minor-mode</code></a>·with·a·negative | 394 | YASnippet·in·some·buffers·by·calling·<a·href="snippet-reference.html#yas-minor-mode"><code>yas-minor-mode</code></a>·with·a·negative |
| 395 | argument·in·the·buffer's·mode·hook. | 395 | argument·in·the·buffer's·mode·hook. |
| 396 | </p> | 396 | </p> |
| 397 | </div> | 397 | </div> |
| 398 | <div·id="outline-container-org | 398 | <div·id="outline-container-org4a24f30"·class="outline-4"> |
| 399 | <h4·id="org | 399 | <h4·id="org4a24f30">Fallback·behaviour</h4> |
| 400 | <div·class="outline-text-4"·id="text-org | 400 | <div·class="outline-text-4"·id="text-org4a24f30"> |
| 401 | <p> | 401 | <p> |
| 402 | YASnippet·used·to·support·a·more·complicated·way·of·sharing | 402 | YASnippet·used·to·support·a·more·complicated·way·of·sharing |
| 403 | keybindings·before·<a·href="snippet-reference.html#yas-expand"><code>yas-maybe-expand</code></a>·was·added.··This·is·now | 403 | keybindings·before·<a·href="snippet-reference.html#yas-expand"><code>yas-maybe-expand</code></a>·was·added.··This·is·now |
| 404 | obsolete. | 404 | obsolete. |
| 405 | </p> | 405 | </p> |
| 406 | </div> | 406 | </div> |
| 407 | </div> | 407 | </div> |
| 408 | </div> | 408 | </div> |
| 409 | <div·id="outline-container-org | 409 | <div·id="outline-container-org697e49c"·class="outline-3"> |
| 410 | <h3·id="org | 410 | <h3·id="org697e49c">Insert·at·point</h3> |
| 411 | <div·class="outline-text-3"·id="text-org | 411 | <div·class="outline-text-3"·id="text-org697e49c"> |
| 412 | <p> | 412 | <p> |
| 413 | The·command·<a·href="snippet-reference.html#yas-insert-snippet"><code>yas-insert-snippet</code></a>·lets·you·insert·snippets·at·point | 413 | The·command·<a·href="snippet-reference.html#yas-insert-snippet"><code>yas-insert-snippet</code></a>·lets·you·insert·snippets·at·point |
| 414 | <i>for·your·current·major·mode</i>.·It·prompts·you·for·the·snippet·key | 414 | <i>for·your·current·major·mode</i>.·It·prompts·you·for·the·snippet·key |
| 415 | first,·and·then·for·a·snippet·template·if·more·than·one·template | 415 | first,·and·then·for·a·snippet·template·if·more·than·one·template |
| 416 | exists·for·the·same·key. | 416 | exists·for·the·same·key. |
| 417 | </p> | 417 | </p> |
| Offset 426, 17 lines modified | Offset 426, 17 lines modified | ||
| 426 | <p> | 426 | <p> |
| 427 | The·prompting·methods·used·are·again·controlled·by | 427 | The·prompting·methods·used·are·again·controlled·by |
| 428 | <a·href="snippet-reference.html#yas-prompt-functions"><code>yas-prompt-functions</code></a>. | 428 | <a·href="snippet-reference.html#yas-prompt-functions"><code>yas-prompt-functions</code></a>. |
| 429 | </p> | 429 | </p> |
| 430 | </div> | 430 | </div> |
| 431 | <div·id="outline-container-org | 431 | <div·id="outline-container-org131de76"·class="outline-4"> |
| 432 | <h4·id="org | 432 | <h4·id="org131de76">Inserting·region·or·register·contents·into·snippet</h4> |
| 433 | <div·class="outline-text-4"·id="text-org | 433 | <div·class="outline-text-4"·id="text-org131de76"> |
| 434 | <p> | 434 | <p> |
| 435 | It's·often·useful·to·inject·already·written·text·in·the·middle·of·a | 435 | It's·often·useful·to·inject·already·written·text·in·the·middle·of·a |
| 436 | snippet.··The·variable·<a·href="snippet-reference.html#yas-wrap-around-region"><code>yas-wrap-around-region</code></a>·when·to·t·substitute | 436 | snippet.··The·variable·<a·href="snippet-reference.html#yas-wrap-around-region"><code>yas-wrap-around-region</code></a>·when·to·t·substitute |
| 437 | the·region·contents·into·the·<code>$0</code>·placeholder·of·a·snippet·expanded·by | 437 | the·region·contents·into·the·<code>$0</code>·placeholder·of·a·snippet·expanded·by |
| 438 | <a·href="snippet-reference.html#yas-insert-snippet"><code>yas-insert-snippet</code></a>.··Setting·it·to·a·character·value·(e.g.·<code>?0</code>) | 438 | <a·href="snippet-reference.html#yas-insert-snippet"><code>yas-insert-snippet</code></a>.··Setting·it·to·a·character·value·(e.g.·<code>?0</code>) |
| 439 | will·insert·the·contents·of·corresponding·register. | 439 | will·insert·the·contents·of·corresponding·register. |
| 440 | </p> | 440 | </p> |
| Offset 447, 49 lines modified | Offset 447, 49 lines modified | ||
| Max diff block lines reached; 8958/15704 bytes (57.04%) of diff not shown. | |||
| Offset 260, 19 lines modified | Offset 260, 19 lines modified | ||
| 260 | </div> | 260 | </div> |
| 261 | <div·id="content"> | 261 | <div·id="content"> |
| 262 | <h1·class="title">YASnippet·menu</h1> | 262 | <h1·class="title">YASnippet·menu</h1> |
| 263 | <div·id="table-of-contents"> | 263 | <div·id="table-of-contents"> |
| 264 | <h2>Table·of·Contents</h2> | 264 | <h2>Table·of·Contents</h2> |
| 265 | <div·id="text-table-of-contents"> | 265 | <div·id="text-table-of-contents"> |
| 266 | <ul> | 266 | <ul> |
| 267 | <li><a·href="#org | 267 | <li><a·href="#org0d09eeb">Loading·snippets·from·menu</a></li> |
| 268 | <li><a·href="#org6 | 268 | <li><a·href="#org65e7559">Snippet·menu·behavior</a></li> |
| 269 | <li><a·href="#org | 269 | <li><a·href="#orgc4849d4">Controlling·indenting</a></li> |
| 270 | <li><a·href="#org | 270 | <li><a·href="#orgf7a3cc3">Prompting·method</a></li> |
| 271 | <li><a·href="#org | 271 | <li><a·href="#org31f2fac">Misc</a></li> |
| 272 | </ul> | 272 | </ul> |
| 273 | </div> | 273 | </div> |
| 274 | </div> | 274 | </div> |
| 275 | <p> | 275 | <p> |
| 276 | When·<a·href="snippet-reference.html#yas-minor-mode"><code>yas-minor-mode</code></a>·is·active,·YASnippet·will·setup·a·menu·just·after | 276 | When·<a·href="snippet-reference.html#yas-minor-mode"><code>yas-minor-mode</code></a>·is·active,·YASnippet·will·setup·a·menu·just·after |
| 277 | the·"Buffers"·menu·in·the·menubar. | 277 | the·"Buffers"·menu·in·the·menubar. |
| 278 | </p> | 278 | </p> |
| Offset 295, 33 lines modified | Offset 295, 33 lines modified | ||
| 295 | <div·class="figure"> | 295 | <div·class="figure"> |
| 296 | <p><img·src="./images/menu-1.png"·alt="menu-1.png"·/> | 296 | <p><img·src="./images/menu-1.png"·alt="menu-1.png"·/> |
| 297 | </p> | 297 | </p> |
| 298 | </div> | 298 | </div> |
| 299 | <div·id="outline-container-org | 299 | <div·id="outline-container-org0d09eeb"·class="outline-2"> |
| 300 | <h2·id="org | 300 | <h2·id="org0d09eeb">Loading·snippets·from·menu</h2> |
| 301 | <div·class="outline-text-2"·id="text-org | 301 | <div·class="outline-text-2"·id="text-org0d09eeb"> |
| 302 | <p> | 302 | <p> |
| 303 | Invoking·"Load·snippets…"·from·the·menu·invokes·<a·href="snippet-reference.html#yas-load-directory"><code>yas-load-directory</code></a> | 303 | Invoking·"Load·snippets…"·from·the·menu·invokes·<a·href="snippet-reference.html#yas-load-directory"><code>yas-load-directory</code></a> |
| 304 | and·prompts·you·for·a·snippet·directory·hierarchy·to·load. | 304 | and·prompts·you·for·a·snippet·directory·hierarchy·to·load. |
| 305 | </p> | 305 | </p> |
| 306 | <p> | 306 | <p> |
| 307 | Also·useful·is·the·"Reload·everything"·item·to·invoke·<a·href="snippet-reference.html#yas-reload-all"><code>yas-reload-all</code></a> | 307 | Also·useful·is·the·"Reload·everything"·item·to·invoke·<a·href="snippet-reference.html#yas-reload-all"><code>yas-reload-all</code></a> |
| 308 | which·uncondionally·reloads·all·the·snippets·directories·defined·in | 308 | which·uncondionally·reloads·all·the·snippets·directories·defined·in |
| 309 | <a·href="snippet-reference.html#yas-snippet-dirs"><code>yas-snippet-dirs</code></a>·and·rebuilds·the·menus. | 309 | <a·href="snippet-reference.html#yas-snippet-dirs"><code>yas-snippet-dirs</code></a>·and·rebuilds·the·menus. |
| 310 | </p> | 310 | </p> |
| 311 | </div> | 311 | </div> |
| 312 | </div> | 312 | </div> |
| 313 | <div·id="outline-container-org6 | 313 | <div·id="outline-container-org65e7559"·class="outline-2"> |
| 314 | <h2·id="org6 | 314 | <h2·id="org65e7559">Snippet·menu·behavior</h2> |
| 315 | <div·class="outline-text-2"·id="text-org6 | 315 | <div·class="outline-text-2"·id="text-org65e7559"> |
| 316 | <p> | 316 | <p> |
| 317 | YASnippet·will·list·in·this·section·all·the·loaded·snippet·definitions | 317 | YASnippet·will·list·in·this·section·all·the·loaded·snippet·definitions |
| 318 | organized·by·snippet·table·name. | 318 | organized·by·snippet·table·name. |
| 319 | </p> | 319 | </p> |
| 320 | <p> | 320 | <p> |
| 321 | You·can·use·this·section·to·explore·currently·loaded·snippets.·If·you | 321 | You·can·use·this·section·to·explore·currently·loaded·snippets.·If·you |
| Offset 349, 38 lines modified | Offset 349, 38 lines modified | ||
| 349 | <p> | 349 | <p> |
| 350 | These·customizations·can·also·be·found·in·the·menu·itself,·under·the | 350 | These·customizations·can·also·be·found·in·the·menu·itself,·under·the |
| 351 | "Snippet·menu·behavior"·submenu. | 351 | "Snippet·menu·behavior"·submenu. |
| 352 | </p> | 352 | </p> |
| 353 | </div> | 353 | </div> |
| 354 | </div> | 354 | </div> |
| 355 | <div·id="outline-container-org | 355 | <div·id="outline-container-orgc4849d4"·class="outline-2"> |
| 356 | <h2·id="org | 356 | <h2·id="orgc4849d4">Controlling·indenting</h2> |
| 357 | <div·class="outline-text-2"·id="text-org | 357 | <div·class="outline-text-2"·id="text-orgc4849d4"> |
| 358 | <p> | 358 | <p> |
| 359 | The·"Indenting"·submenu·contains·options·to·control·the·values·of | 359 | The·"Indenting"·submenu·contains·options·to·control·the·values·of |
| 360 | <a·href="snippet-reference.html#yas-indent-line"><code>yas-indent-line</code></a>·and·<a·href="snippet-reference.html#yas-also-auto-indent-first-line"><code>yas-also-auto-indent-first-line</code></a>.·See | 360 | <a·href="snippet-reference.html#yas-indent-line"><code>yas-indent-line</code></a>·and·<a·href="snippet-reference.html#yas-also-auto-indent-first-line"><code>yas-also-auto-indent-first-line</code></a>.·See |
| 361 | <a·href="./snippet-development.html">Writing·snippets</a>. | 361 | <a·href="./snippet-development.html">Writing·snippets</a>. |
| 362 | </p> | 362 | </p> |
| 363 | </div> | 363 | </div> |
| 364 | </div> | 364 | </div> |
| 365 | <div·id="outline-container-org | 365 | <div·id="outline-container-orgf7a3cc3"·class="outline-2"> |
| 366 | <h2·id="org | 366 | <h2·id="orgf7a3cc3">Prompting·method</h2> |
| 367 | <div·class="outline-text-2"·id="text-org | 367 | <div·class="outline-text-2"·id="text-orgf7a3cc3"> |
| 368 | <p> | 368 | <p> |
| 369 | The·"Prompting·method"·submenu·contains·options·to·control·the·value·of | 369 | The·"Prompting·method"·submenu·contains·options·to·control·the·value·of |
| 370 | <a·href="snippet-reference.html#yas-prompt-functions"><code>yas-prompt-functions</code></a>.·See·<a·href="./snippet-expansion.html">Expanding·snippets</a>. | 370 | <a·href="snippet-reference.html#yas-prompt-functions"><code>yas-prompt-functions</code></a>.·See·<a·href="./snippet-expansion.html">Expanding·snippets</a>. |
| 371 | </p> | 371 | </p> |
| 372 | </div> | 372 | </div> |
| 373 | </div> | 373 | </div> |
| 374 | <div·id="outline-container-org | 374 | <div·id="outline-container-org31f2fac"·class="outline-2"> |
| 375 | <h2·id="org | 375 | <h2·id="org31f2fac">Misc</h2> |
| 376 | <div·class="outline-text-2"·id="text-org | 376 | <div·class="outline-text-2"·id="text-org31f2fac"> |
| 377 | <p> | 377 | <p> |
| 378 | The·"Misc"·submenu·contains·options·to·control·the·values·of·more | 378 | The·"Misc"·submenu·contains·options·to·control·the·values·of·more |
| 379 | variables. | 379 | variables. |
| 380 | </p> | 380 | </p> |
| 381 | </div> | 381 | </div> |
| 382 | </div> | 382 | </div> |
| 383 | </div> | 383 | </div> |
| Offset 260, 28 lines modified | Offset 260, 28 lines modified | ||
| 260 | </div> | 260 | </div> |
| 261 | <div·id="content"> | 261 | <div·id="content"> |
| 262 | <h1·class="title">Organizing·snippets</h1> | 262 | <h1·class="title">Organizing·snippets</h1> |
| 263 | <div·id="table-of-contents"> | 263 | <div·id="table-of-contents"> |
| 264 | <h2>Table·of·Contents</h2> | 264 | <h2>Table·of·Contents</h2> |
| 265 | <div·id="text-table-of-contents"> | 265 | <div·id="text-table-of-contents"> |
| 266 | <ul> | 266 | <ul> |
| 267 | <li><a·href="#org | 267 | <li><a·href="#org4033235">Basic·structure</a></li> |
| 268 | <li><a·href="#org | 268 | <li><a·href="#org31b9f83">Setting·up·<code>yas-snippet-dirs</code></a></li> |
| 269 | <li><a·href="#org | 269 | <li><a·href="#orgdb4cbc0">The·<code>.yas-parents</code>·file</a></li> |
| 270 | <li><a·href="#org | 270 | <li><a·href="#orgfc9e21f"><span·class="todo·TODO">TODO</span>·The·<code>.yas-make-groups</code>·file</a></li> |
| 271 | <li><a·href="#org | 271 | <li><a·href="#org0805e03">The·<code>.yas-setup.el</code>·file</a></li> |
| 272 | <li><a·href="#org | 272 | <li><a·href="#orgd00e308">The·<code>.yas-compiled-snippet.el</code>·file</a></li> |
| 273 | <li><a·href="#org | 273 | <li><a·href="#org157fd86">The·<code>.yas-skip</code>·file</a></li> |
| 274 | </ul> | 274 | </ul> |
| 275 | </div> | 275 | </div> |
| 276 | </div> | 276 | </div> |
| 277 | <div·id="outline-container-org | 277 | <div·id="outline-container-org4033235"·class="outline-2"> |
| 278 | <h2·id="org | 278 | <h2·id="org4033235">Basic·structure</h2> |
| 279 | <div·class="outline-text-2"·id="text-org | 279 | <div·class="outline-text-2"·id="text-org4033235"> |
| 280 | <p> | 280 | <p> |
| 281 | Snippet·collections·can·be·stored·in·plain·text·files.·They·are | 281 | Snippet·collections·can·be·stored·in·plain·text·files.·They·are |
| 282 | arranged·by·sub-directories·naming·<b>snippet·tables</b>.··These·mostly | 282 | arranged·by·sub-directories·naming·<b>snippet·tables</b>.··These·mostly |
| 283 | name·Emacs·major·mode·names. | 283 | name·Emacs·major·mode·names. |
| 284 | </p> | 284 | </p> |
| 285 | <pre·class="example"> | 285 | <pre·class="example"> |
| Offset 299, 17 lines modified | Offset 299, 17 lines modified | ||
| 299 | The·collections·are·loaded·into·<b>snippet·tables</b>·which·the | 299 | The·collections·are·loaded·into·<b>snippet·tables</b>·which·the |
| 300 | triggering·mechanism·(see·<a·href="snippet-expansion.html">Expanding·Snippets</a>)·looks·up·and | 300 | triggering·mechanism·(see·<a·href="snippet-expansion.html">Expanding·Snippets</a>)·looks·up·and |
| 301 | (hopefully)·causes·the·right·snippet·to·be·expanded·for·you. | 301 | (hopefully)·causes·the·right·snippet·to·be·expanded·for·you. |
| 302 | </p> | 302 | </p> |
| 303 | </div> | 303 | </div> |
| 304 | </div> | 304 | </div> |
| 305 | <div·id="outline-container-org | 305 | <div·id="outline-container-org31b9f83"·class="outline-2"> |
| 306 | <h2·id="org | 306 | <h2·id="org31b9f83">Setting·up·<code>yas-snippet-dirs</code></h2> |
| 307 | <div·class="outline-text-2"·id="text-org | 307 | <div·class="outline-text-2"·id="text-org31b9f83"> |
| 308 | <p> | 308 | <p> |
| 309 | The·emacs·variable·<a·href="snippet-reference.html#yas-snippet-dirs"><code>yas-snippet-dirs</code></a>·tells·YASnippet | 309 | The·emacs·variable·<a·href="snippet-reference.html#yas-snippet-dirs"><code>yas-snippet-dirs</code></a>·tells·YASnippet |
| 310 | which·collections·to·consider.·It's·used·when·you·activate | 310 | which·collections·to·consider.·It's·used·when·you·activate |
| 311 | <a·href="snippet-reference.html#yas-global-mode"><code>yas-global-mode</code></a>·or·call | 311 | <a·href="snippet-reference.html#yas-global-mode"><code>yas-global-mode</code></a>·or·call |
| 312 | <a·href="snippet-reference.html#yas-reload-all"><code>yas-reload-all</code></a>·interactively. | 312 | <a·href="snippet-reference.html#yas-reload-all"><code>yas-reload-all</code></a>·interactively. |
| 313 | </p> | 313 | </p> |
| Offset 343, 17 lines modified | Offset 343, 17 lines modified | ||
| 343 | Collections·appearing·earlier·in·the·list·override·snippets·with·same·names | 343 | Collections·appearing·earlier·in·the·list·override·snippets·with·same·names |
| 344 | appearing·in·collections·later·in·the·list.·<a·href="snippet-reference.html#yas-new-snippet"><code>yas-new-snippet</code></a>·always·stores | 344 | appearing·in·collections·later·in·the·list.·<a·href="snippet-reference.html#yas-new-snippet"><code>yas-new-snippet</code></a>·always·stores |
| 345 | snippets·in·the·first·collection. | 345 | snippets·in·the·first·collection. |
| 346 | </p> | 346 | </p> |
| 347 | </div> | 347 | </div> |
| 348 | </div> | 348 | </div> |
| 349 | <div·id="outline-container-org | 349 | <div·id="outline-container-orgdb4cbc0"·class="outline-2"> |
| 350 | <h2·id="org | 350 | <h2·id="orgdb4cbc0">The·<code>.yas-parents</code>·file</h2> |
| 351 | <div·class="outline-text-2"·id="text-org | 351 | <div·class="outline-text-2"·id="text-orgdb4cbc0"> |
| 352 | <p> | 352 | <p> |
| 353 | It's·very·useful·to·have·certain·modes·share·snippets·between | 353 | It's·very·useful·to·have·certain·modes·share·snippets·between |
| 354 | themselves.·To·do·this,·choose·a·mode·subdirectory·and·place·a | 354 | themselves.·To·do·this,·choose·a·mode·subdirectory·and·place·a |
| 355 | <code>.yas-parents</code>·containing·a·whitespace-separated·list·of·other·mode | 355 | <code>.yas-parents</code>·containing·a·whitespace-separated·list·of·other·mode |
| 356 | names.·When·you·reload·those·modes·become·parents·of·the·original | 356 | names.·When·you·reload·those·modes·become·parents·of·the·original |
| 357 | mode. | 357 | mode. |
| 358 | </p> | 358 | </p> |
| Offset 373, 17 lines modified | Offset 373, 17 lines modified | ||
| 373 | 373 | ||
| 374 | ····`--·time | 374 | ····`--·time |
| 375 | </pre> | 375 | </pre> |
| 376 | </div> | 376 | </div> |
| 377 | </div> | 377 | </div> |
| 378 | <div·id="outline-container-org | 378 | <div·id="outline-container-orgfc9e21f"·class="outline-2"> |
| 379 | <h2·id="org | 379 | <h2·id="orgfc9e21f"><span·class="todo·TODO">TODO</span>·The·<code>.yas-make-groups</code>·file</h2> |
| 380 | <div·class="outline-text-2"·id="text-org | 380 | <div·class="outline-text-2"·id="text-orgfc9e21f"> |
| 381 | <p> | 381 | <p> |
| 382 | If·you·place·an·empty·plain·text·file·<code>.yas-make-groups</code>·inside·one | 382 | If·you·place·an·empty·plain·text·file·<code>.yas-make-groups</code>·inside·one |
| 383 | of·the·mode·directories,·the·names·of·these·sub-directories·are | 383 | of·the·mode·directories,·the·names·of·these·sub-directories·are |
| 384 | considered·groups·of·snippets·and·<a·href="snippet-menu.html">the·menu</a>·is·organized·much·more | 384 | considered·groups·of·snippets·and·<a·href="snippet-menu.html">the·menu</a>·is·organized·much·more |
| 385 | cleanly: | 385 | cleanly: |
| 386 | </p> | 386 | </p> |
| Offset 417, 28 lines modified | Offset 417, 28 lines modified | ||
| 417 | <p> | 417 | <p> |
| 418 | Yet·another·way·to·create·a·nice·snippet·menu·is·to·write·into | 418 | Yet·another·way·to·create·a·nice·snippet·menu·is·to·write·into |
| 419 | <code>.yas-make-groups</code>·a·menu·definition.·TODO | 419 | <code>.yas-make-groups</code>·a·menu·definition.·TODO |
| 420 | </p> | 420 | </p> |
| 421 | </div> | 421 | </div> |
| 422 | </div> | 422 | </div> |
| 423 | <div·id="outline-container-org | 423 | <div·id="outline-container-org0805e03"·class="outline-2"> |
| 424 | <h2·id="org | 424 | <h2·id="org0805e03">The·<code>.yas-setup.el</code>·file</h2> |
| 425 | <div·class="outline-text-2"·id="text-org | 425 | <div·class="outline-text-2"·id="text-org0805e03"> |
| 426 | <p> | 426 | <p> |
| 427 | If·there·is·file·named·<code>.yas-setup.el</code>·in·a·mode's·snippet | 427 | If·there·is·file·named·<code>.yas-setup.el</code>·in·a·mode's·snippet |
| 428 | subdirectory,·it·is·loaded·along·with·the·snippets.··Utility | 428 | subdirectory,·it·is·loaded·along·with·the·snippets.··Utility |
| 429 | functions·used·by·the·snippets·can·be·put·here. | 429 | functions·used·by·the·snippets·can·be·put·here. |
| 430 | </p> | 430 | </p> |
| 431 | </div> | 431 | </div> |
| 432 | </div> | 432 | </div> |
| 433 | <div·id="outline-container-org | 433 | <div·id="outline-container-orgd00e308"·class="outline-2"> |
| 434 | <h2·id="org | 434 | <h2·id="orgd00e308">The·<code>.yas-compiled-snippet.el</code>·file</h2> |
| 435 | <div·class="outline-text-2"·id="text-org | 435 | <div·class="outline-text-2"·id="text-orgd00e308"> |
| 436 | <p> | 436 | <p> |
| 437 | You·may·compile·a·top-level·snippet·directory·with·the | 437 | You·may·compile·a·top-level·snippet·directory·with·the |
| 438 | <code>yas-compile-directory</code>·function,·which·will·create·a | 438 | <code>yas-compile-directory</code>·function,·which·will·create·a |
| 439 | <code>.yas-compiled-snippets.el</code>·file·under·each·mode·subdirectory, | 439 | <code>.yas-compiled-snippets.el</code>·file·under·each·mode·subdirectory, |
| 440 | which·contains·definitions·for·all·snippets·in·the·subdirectory. | 440 | which·contains·definitions·for·all·snippets·in·the·subdirectory. |
| 441 | Compilation·helps·improve·loading·time. | 441 | Compilation·helps·improve·loading·time. |
| 442 | </p> | 442 | </p> |
| Offset 446, 17 lines modified | Offset 446, 17 lines modified | ||
| 446 | <p> | 446 | <p> |
| 447 | Alternatively,·you·may·compile·all·directories·in·the·list | 447 | Alternatively,·you·may·compile·all·directories·in·the·list |
| 448 | <code>yas-snippet-dirs</code>·with·the·<code>yas-recompile-all</code>·function. | 448 | <code>yas-snippet-dirs</code>·with·the·<code>yas-recompile-all</code>·function. |
| 449 | </p> | 449 | </p> |
| 450 | </div> | 450 | </div> |
| 451 | </div> | 451 | </div> |
| 452 | <div·id="outline-container-org | 452 | <div·id="outline-container-org157fd86"·class="outline-2"> |
| 453 | <h2·id="org | 453 | <h2·id="org157fd86">The·<code>.yas-skip</code>·file</h2> |
| 454 | <div·class="outline-text-2"·id="text-org | 454 | <div·class="outline-text-2"·id="text-org157fd86"> |
| 455 | <p> | 455 | <p> |
| 456 | A·<code>.yas-skip</code>·file·in·a·mode's·snippet·subdirectory·tells·YASnippet | 456 | A·<code>.yas-skip</code>·file·in·a·mode's·snippet·subdirectory·tells·YASnippet |
| 457 | not·to·load·snippets·from·there. | 457 | not·to·load·snippets·from·there. |
| 458 | </p> | 458 | </p> |
| 459 | </div> | 459 | </div> |
| Max diff block lines reached; 8/6582 bytes (0.12%) of diff not shown. | |||
| Offset 260, 15 lines modified | Offset 260, 15 lines modified | ||
| 260 | </div> | 260 | </div> |
| 261 | <div·id="content"> | 261 | <div·id="content"> |
| 262 | <h1·class="title">Reference</h1> | 262 | <h1·class="title">Reference</h1> |
| 263 | <div·id="table-of-contents"> | 263 | <div·id="table-of-contents"> |
| 264 | <h2>Table·of·Contents</h2> | 264 | <h2>Table·of·Contents</h2> |
| 265 | <div·id="text-table-of-contents"> | 265 | <div·id="text-table-of-contents"> |
| 266 | <ul> | 266 | <ul> |
| 267 | <li><a·href="#org | 267 | <li><a·href="#orgee99421">Interactive·functions</a> |
| 268 | <ul> | 268 | <ul> |
| 269 | <li><a·href="#yas-load-snippet-buffer-and-close"><code·class='function'>yas-load-snippet-buffer-and-close</code>·(<code>table</code>·<i>&optional</i>·<code>kill</code>)</a></li> | 269 | <li><a·href="#yas-load-snippet-buffer-and-close"><code·class='function'>yas-load-snippet-buffer-and-close</code>·(<code>table</code>·<i>&optional</i>·<code>kill</code>)</a></li> |
| 270 | <li><a·href="#yas-expand-from-trigger-key"><code·class='function'>yas-expand-from-trigger-key</code>·(<i>&optional</i>·<code>field</code>)</a></li> | 270 | <li><a·href="#yas-expand-from-trigger-key"><code·class='function'>yas-expand-from-trigger-key</code>·(<i>&optional</i>·<code>field</code>)</a></li> |
| 271 | <li><a·href="#yas-skip-and-clear-or-delete-char"><code·class='function'>yas-skip-and-clear-or-delete-char</code>·(<i>&optional</i>·<code>field</code>)</a></li> | 271 | <li><a·href="#yas-skip-and-clear-or-delete-char"><code·class='function'>yas-skip-and-clear-or-delete-char</code>·(<i>&optional</i>·<code>field</code>)</a></li> |
| 272 | <li><a·href="#yas-clear-field"><code·class='function'>yas-clear-field</code>·(<i>&optional</i>·<code>field</code>)</a></li> | 272 | <li><a·href="#yas-clear-field"><code·class='function'>yas-clear-field</code>·(<i>&optional</i>·<code>field</code>)</a></li> |
| 273 | <li><a·href="#yas-global-mode"><code·class='function'>yas-global-mode</code>·(<i>&optional</i>·<code>arg</code>)</a></li> | 273 | <li><a·href="#yas-global-mode"><code·class='function'>yas-global-mode</code>·(<i>&optional</i>·<code>arg</code>)</a></li> |
| 274 | <li><a·href="#yas-recompile-all"><code·class='function'>yas-recompile-all</code>·()</a></li> | 274 | <li><a·href="#yas-recompile-all"><code·class='function'>yas-recompile-all</code>·()</a></li> |
| Offset 295, 15 lines modified | Offset 295, 15 lines modified | ||
| 295 | <li><a·href="#yas-skip-and-clear-field"><code·class='function'>yas-skip-and-clear-field</code>·(<i>&optional</i>·<code>field</code>)</a></li> | 295 | <li><a·href="#yas-skip-and-clear-field"><code·class='function'>yas-skip-and-clear-field</code>·(<i>&optional</i>·<code>field</code>)</a></li> |
| 296 | <li><a·href="#yas-compile-directory"><code·class='function'>yas-compile-directory</code>·(<code>top-level-dir</code>)</a></li> | 296 | <li><a·href="#yas-compile-directory"><code·class='function'>yas-compile-directory</code>·(<code>top-level-dir</code>)</a></li> |
| 297 | <li><a·href="#yas-load-directory"><code·class='function'>yas-load-directory</code>·(<code>top-level-dir</code>·<i>&optional</i>·<code>use-jit</code>·<code>interactive</code>)</a></li> | 297 | <li><a·href="#yas-load-directory"><code·class='function'>yas-load-directory</code>·(<code>top-level-dir</code>·<i>&optional</i>·<code>use-jit</code>·<code>interactive</code>)</a></li> |
| 298 | <li><a·href="#yas-describe-table-by-namehash"><code·class='function'>yas-describe-table-by-namehash</code>·()</a></li> | 298 | <li><a·href="#yas-describe-table-by-namehash"><code·class='function'>yas-describe-table-by-namehash</code>·()</a></li> |
| 299 | <li><a·href="#yas-tryout-snippet"><code·class='function'>yas-tryout-snippet</code>·(<i>&optional</i>·<code>debug</code>)</a></li> | 299 | <li><a·href="#yas-tryout-snippet"><code·class='function'>yas-tryout-snippet</code>·(<i>&optional</i>·<code>debug</code>)</a></li> |
| 300 | </ul> | 300 | </ul> |
| 301 | </li> | 301 | </li> |
| 302 | <li><a·href="#org | 302 | <li><a·href="#org1505abc">Customization·variables</a> |
| 303 | <ul> | 303 | <ul> |
| 304 | <li><a·href="#yas-expand-only-for-last-commands"><code·class='variable'>yas-expand-only-for-last-commands</code></a></li> | 304 | <li><a·href="#yas-expand-only-for-last-commands"><code·class='variable'>yas-expand-only-for-last-commands</code></a></li> |
| 305 | <li><a·href="#yas-wrap-around-region"><code·class='variable'>yas-wrap-around-region</code></a></li> | 305 | <li><a·href="#yas-wrap-around-region"><code·class='variable'>yas-wrap-around-region</code></a></li> |
| 306 | <li><a·href="#yas-new-snippet-default"><code·class='variable'>yas-new-snippet-default</code></a></li> | 306 | <li><a·href="#yas-new-snippet-default"><code·class='variable'>yas-new-snippet-default</code></a></li> |
| 307 | <li><a·href="#yas-choose-keys-first"><code·class='variable'>yas-choose-keys-first</code></a></li> | 307 | <li><a·href="#yas-choose-keys-first"><code·class='variable'>yas-choose-keys-first</code></a></li> |
| 308 | <li><a·href="#yas-triggers-in-field"><code·class='variable'>yas-triggers-in-field</code></a></li> | 308 | <li><a·href="#yas-triggers-in-field"><code·class='variable'>yas-triggers-in-field</code></a></li> |
| 309 | <li><a·href="#yas-use-menu"><code·class='variable'>yas-use-menu</code></a></li> | 309 | <li><a·href="#yas-use-menu"><code·class='variable'>yas-use-menu</code></a></li> |
| Offset 320, 15 lines modified | Offset 320, 15 lines modified | ||
| 320 | <li><a·href="#yas-also-indent-empty-lines"><code·class='variable'>yas-also-indent-empty-lines</code></a></li> | 320 | <li><a·href="#yas-also-indent-empty-lines"><code·class='variable'>yas-also-indent-empty-lines</code></a></li> |
| 321 | <li><a·href="#yas-also-auto-indent-first-line"><code·class='variable'>yas-also-auto-indent-first-line</code></a></li> | 321 | <li><a·href="#yas-also-auto-indent-first-line"><code·class='variable'>yas-also-auto-indent-first-line</code></a></li> |
| 322 | <li><a·href="#yas-indent-line"><code·class='variable'>yas-indent-line</code></a></li> | 322 | <li><a·href="#yas-indent-line"><code·class='variable'>yas-indent-line</code></a></li> |
| 323 | <li><a·href="#yas-alias-to-yas/prefix-p"><code·class='variable'>yas-alias-to-yas/prefix-p</code></a></li> | 323 | <li><a·href="#yas-alias-to-yas/prefix-p"><code·class='variable'>yas-alias-to-yas/prefix-p</code></a></li> |
| 324 | <li><a·href="#yas-inhibit-overlay-modification-protection"><code·class='variable'>yas-inhibit-overlay-modification-protection</code></a></li> | 324 | <li><a·href="#yas-inhibit-overlay-modification-protection"><code·class='variable'>yas-inhibit-overlay-modification-protection</code></a></li> |
| 325 | </ul> | 325 | </ul> |
| 326 | </li> | 326 | </li> |
| 327 | <li><a·href="#org | 327 | <li><a·href="#org43c197a">Useful·functions</a> |
| 328 | <ul> | 328 | <ul> |
| 329 | <li><a·href="#yas-expand-snippet"><code·class='function'>yas-expand-snippet</code>·(<code>snippet</code>·<i>&optional</i>·<code>start</code>·<code>end</code>·<code>expand-env</code>)</a></li> | 329 | <li><a·href="#yas-expand-snippet"><code·class='function'>yas-expand-snippet</code>·(<code>snippet</code>·<i>&optional</i>·<code>start</code>·<code>end</code>·<code>expand-env</code>)</a></li> |
| 330 | <li><a·href="#yas-define-snippets"><code·class='function'>yas-define-snippets</code>·(<code>mode</code>·<code>snippets</code>)</a></li> | 330 | <li><a·href="#yas-define-snippets"><code·class='function'>yas-define-snippets</code>·(<code>mode</code>·<code>snippets</code>)</a></li> |
| 331 | <li><a·href="#yas-completing-prompt"><code·class='function'>yas-completing-prompt</code>·(<code>prompt</code>·<code>choices</code>·<i>&optional</i>·<code>display-fn</code>·<code>completion-fn</code>)</a></li> | 331 | <li><a·href="#yas-completing-prompt"><code·class='function'>yas-completing-prompt</code>·(<code>prompt</code>·<code>choices</code>·<i>&optional</i>·<code>display-fn</code>·<code>completion-fn</code>)</a></li> |
| 332 | <li><a·href="#yas-maybe-expand-abbrev-key-filter"><code·class='function'>yas-maybe-expand-abbrev-key-filter</code>·(<code>cmd</code>)</a></li> | 332 | <li><a·href="#yas-maybe-expand-abbrev-key-filter"><code·class='function'>yas-maybe-expand-abbrev-key-filter</code>·(<code>cmd</code>)</a></li> |
| 333 | <li><a·href="#yas-inside-string"><code·class='function'>yas-inside-string</code>·()</a></li> | 333 | <li><a·href="#yas-inside-string"><code·class='function'>yas-inside-string</code>·()</a></li> |
| 334 | <li><a·href="#yas-lookup-snippet"><code·class='function'>yas-lookup-snippet</code>·(<code>name</code>·<i>&optional</i>·<code>mode</code>·<code>noerror</code>)</a></li> | 334 | <li><a·href="#yas-lookup-snippet"><code·class='function'>yas-lookup-snippet</code>·(<code>name</code>·<i>&optional</i>·<code>mode</code>·<code>noerror</code>)</a></li> |
| Offset 366, 15 lines modified | Offset 366, 15 lines modified | ||
| 366 | <li><a·href="#yas-default-from-field"><code·class='function'>yas-default-from-field</code>·(<code>number</code>)</a></li> | 366 | <li><a·href="#yas-default-from-field"><code·class='function'>yas-default-from-field</code>·(<code>number</code>)</a></li> |
| 367 | <li><a·href="#yas-key-to-value"><code·class='function'>yas-key-to-value</code>·(<code>alist</code>)</a></li> | 367 | <li><a·href="#yas-key-to-value"><code·class='function'>yas-key-to-value</code>·(<code>alist</code>)</a></li> |
| 368 | <li><a·href="#yas-throw"><code·class='function'>yas-throw</code>·(<code>text</code>)</a></li> | 368 | <li><a·href="#yas-throw"><code·class='function'>yas-throw</code>·(<code>text</code>)</a></li> |
| 369 | <li><a·href="#yas-hippie-try-expand"><code·class='function'>yas-hippie-try-expand</code>·(<code>first-time?</code>)</a></li> | 369 | <li><a·href="#yas-hippie-try-expand"><code·class='function'>yas-hippie-try-expand</code>·(<code>first-time?</code>)</a></li> |
| 370 | <li><a·href="#yas-maybe-load-snippet-buffer"><code·class='function'>yas-maybe-load-snippet-buffer</code>·()</a></li> | 370 | <li><a·href="#yas-maybe-load-snippet-buffer"><code·class='function'>yas-maybe-load-snippet-buffer</code>·()</a></li> |
| 371 | </ul> | 371 | </ul> |
| 372 | </li> | 372 | </li> |
| 373 | <li><a·href="#org | 373 | <li><a·href="#org0dd9b11">Useful·variables</a> |
| 374 | <ul> | 374 | <ul> |
| 375 | <li><a·href="#yas-key-syntaxes"><code·class='variable'>yas-key-syntaxes</code></a></li> | 375 | <li><a·href="#yas-key-syntaxes"><code·class='variable'>yas-key-syntaxes</code></a></li> |
| 376 | <li><a·href="#yas-modified-p"><code·class='variable'>yas-modified-p</code></a></li> | 376 | <li><a·href="#yas-modified-p"><code·class='variable'>yas-modified-p</code></a></li> |
| 377 | <li><a·href="#yas-dont-activate-functions"><code·class='variable'>yas-dont-activate-functions</code></a></li> | 377 | <li><a·href="#yas-dont-activate-functions"><code·class='variable'>yas-dont-activate-functions</code></a></li> |
| 378 | <li><a·href="#yas-maybe-clear-field"><code·class='variable'>yas-maybe-clear-field</code></a></li> | 378 | <li><a·href="#yas-maybe-clear-field"><code·class='variable'>yas-maybe-clear-field</code></a></li> |
| 379 | <li><a·href="#yas-before-expand-snippet-hook"><code·class='variable'>yas-before-expand-snippet-hook</code></a></li> | 379 | <li><a·href="#yas-before-expand-snippet-hook"><code·class='variable'>yas-before-expand-snippet-hook</code></a></li> |
| 380 | <li><a·href="#yas-maybe-skip-and-clear-field"><code·class='variable'>yas-maybe-skip-and-clear-field</code></a></li> | 380 | <li><a·href="#yas-maybe-skip-and-clear-field"><code·class='variable'>yas-maybe-skip-and-clear-field</code></a></li> |
| Offset 396, 19 lines modified | Offset 396, 19 lines modified | ||
| 396 | <li><a·href="#yas-global-mode-buffers"><code·class='variable'>yas-global-mode-buffers</code></a></li> | 396 | <li><a·href="#yas-global-mode-buffers"><code·class='variable'>yas-global-mode-buffers</code></a></li> |
| 397 | </ul> | 397 | </ul> |
| 398 | </li> | 398 | </li> |
| 399 | </ul> | 399 | </ul> |
| 400 | </div> | 400 | </div> |
| 401 | </div> | 401 | </div> |
| 402 | <div·id="outline-container-org | 402 | <div·id="outline-container-orgee99421"·class="outline-2"> |
| 403 | <h2·id="org | 403 | <h2·id="orgee99421">Interactive·functions</h2> |
| 404 | <div·class="outline-text-2"·id="text-org | 404 | <div·class="outline-text-2"·id="text-orgee99421"> |
| 405 | </div> | 405 | </div> |
| 406 | <div·id="outline-container-orgf | 406 | <div·id="outline-container-orgf394740"·class="outline-3"> |
| 407 | <h3·id="yas-load-snippet-buffer-and-close"><code·class='function'>yas-load-snippet-buffer-and-close</code>·(<code>table</code>·<i>&optional</i>·<code>kill</code>)</h3> | 407 | <h3·id="yas-load-snippet-buffer-and-close"><code·class='function'>yas-load-snippet-buffer-and-close</code>·(<code>table</code>·<i>&optional</i>·<code>kill</code>)</h3> |
| 408 | <div·class="outline-text-3"·id="text-yas-load-snippet-buffer-and-close"> | 408 | <div·class="outline-text-3"·id="text-yas-load-snippet-buffer-and-close"> |
| 409 | <p> | 409 | <p> |
| 410 | Load·and·save·the·snippet,·then·<code>quit-window</code>·if·saved. | 410 | Load·and·save·the·snippet,·then·<code>quit-window</code>·if·saved. |
| 411 | Loading·is·performed·by·<a·href="#yas-load-snippet-buffer"><code>yas-load-snippet-buffer</code></a>.··If·the | 411 | Loading·is·performed·by·<a·href="#yas-load-snippet-buffer"><code>yas-load-snippet-buffer</code></a>.··If·the |
| 412 | snippet·is·new,·ask·the·user·whether·(and·where)·to·save·it.··If | 412 | snippet·is·new,·ask·the·user·whether·(and·where)·to·save·it.··If |
| 413 | the·snippet·already·has·a·file,·just·save·it. | 413 | the·snippet·already·has·a·file,·just·save·it. |
| Offset 421, 15 lines modified | Offset 421, 15 lines modified | ||
| 421 | <p> | 421 | <p> |
| 422 | Don't·use·this·from·a·Lisp·program,·call·<a·href="#yas-load-snippet-buffer"><code>yas-load-snippet-buffer</code></a> | 422 | Don't·use·this·from·a·Lisp·program,·call·<a·href="#yas-load-snippet-buffer"><code>yas-load-snippet-buffer</code></a> |
| 423 | and·<code>kill-buffer</code>·instead. | 423 | and·<code>kill-buffer</code>·instead. |
| 424 | </p> | 424 | </p> |
| 425 | </div> | 425 | </div> |
| 426 | </div> | 426 | </div> |
| 427 | <div·id="outline-container-org | 427 | <div·id="outline-container-orgbd36a12"·class="outline-3"> |
| 428 | <h3·id="yas-expand-from-trigger-key"><code·class='function'>yas-expand-from-trigger-key</code>·(<i>&optional</i>·<code>field</code>)</h3> | 428 | <h3·id="yas-expand-from-trigger-key"><code·class='function'>yas-expand-from-trigger-key</code>·(<i>&optional</i>·<code>field</code>)</h3> |
| 429 | <div·class="outline-text-3"·id="text-yas-expand-from-trigger-key"> | 429 | <div·class="outline-text-3"·id="text-yas-expand-from-trigger-key"> |
| 430 | <p> | 430 | <p> |
| 431 | Expand·a·snippet·before·point. | 431 | Expand·a·snippet·before·point. |
| 432 | </p> | 432 | </p> |
| 433 | <p> | 433 | <p> |
| Offset 440, 37 lines modified | Offset 440, 37 lines modified | ||
| 440 | <p> | 440 | <p> |
| 441 | Optional·argument·<code>field</code>·is·for·non-interactive·use·and·is·an | 441 | Optional·argument·<code>field</code>·is·for·non-interactive·use·and·is·an |
| 442 | object·satisfying·<code>yas--field-p</code>·to·restrict·the·expansion·to. | 442 | object·satisfying·<code>yas--field-p</code>·to·restrict·the·expansion·to. |
| 443 | </p> | 443 | </p> |
| 444 | </div> | 444 | </div> |
| 445 | </div> | 445 | </div> |
| 446 | <div·id="outline-container-org | 446 | <div·id="outline-container-org299a272"·class="outline-3"> |
| 447 | <h3·id="yas-skip-and-clear-or-delete-char"><code·class='function'>yas-skip-and-clear-or-delete-char</code>·(<i>&optional</i>·<code>field</code>)</h3> | 447 | <h3·id="yas-skip-and-clear-or-delete-char"><code·class='function'>yas-skip-and-clear-or-delete-char</code>·(<i>&optional</i>·<code>field</code>)</h3> |
| 448 | <div·class="outline-text-3"·id="text-yas-skip-and-clear-or-delete-char"> | 448 | <div·class="outline-text-3"·id="text-yas-skip-and-clear-or-delete-char"> |
| 449 | <p> | 449 | <p> |
| 450 | Clears·unmodified·field·if·at·field·start,·skips·to·next·tab. | 450 | Clears·unmodified·field·if·at·field·start,·skips·to·next·tab. |
| 451 | </p> | 451 | </p> |
| 452 | <p> | 452 | <p> |
| 453 | Otherwise·deletes·a·character·normally·by·calling·<code>delete-char</code>. | 453 | Otherwise·deletes·a·character·normally·by·calling·<code>delete-char</code>. |
| 454 | </p> | 454 | </p> |
| 455 | </div> | 455 | </div> |
| 456 | </div> | 456 | </div> |
| 457 | <div·id="outline-container-org | 457 | <div·id="outline-container-orge095616"·class="outline-3"> |
| 458 | <h3·id="yas-clear-field"><code·class='function'>yas-clear-field</code>·(<i>&optional</i>·<code>field</code>)</h3> | 458 | <h3·id="yas-clear-field"><code·class='function'>yas-clear-field</code>·(<i>&optional</i>·<code>field</code>)</h3> |
| 459 | <div·class="outline-text-3"·id="text-yas-clear-field"> | 459 | <div·class="outline-text-3"·id="text-yas-clear-field"> |
| 460 | <p> | 460 | <p> |
| 461 | Clears·unmodified·<code>field</code>·if·at·field·start. | 461 | Clears·unmodified·<code>field</code>·if·at·field·start. |
| 462 | </p> | 462 | </p> |
| 463 | </div> | 463 | </div> |
| Max diff block lines reached; 52920/61378 bytes (86.22%) of diff not shown. | |||