]> git.wincent.com - docvim.git/blobdiff - tests/fixtures/integration/loupe/golden/markdown.golden
Add additional blank line above headings
[docvim.git] / tests / fixtures / integration / loupe / golden / markdown.golden
index 07f24a0d39e89b466a01f3b8084f82a0807795da..9e5cd454c637c7142c282523dc299efdad8b5b6b 100644 (file)
@@ -1,5 +1,7 @@
+
 # loupe<a name="loupe-loupe" href="#user-content-loupe-loupe"></a>
 
+
 ## Intro<a name="loupe-intro" href="#user-content-loupe-intro"></a>
 
 > "loupe (noun)<br />a small magnifying glass used by jewelers and watchmakers."
@@ -7,6 +9,7 @@
 <p align="right"><a name="loupe-features" href="#user-content-loupe-features"><code>loupe-features</code></a></p>
 Loupe enhances Vim's <strong>`search-commands`</strong> in four ways:
 
+
 ### 1. Makes the currently selected match easier to see<a name="loupe-1-makes-the-currently-selected-match-easier-to-see" href="#user-content-loupe-1-makes-the-currently-selected-match-easier-to-see"></a>
 
 When searching using <strong>`/`</strong>, <strong>`?`</strong>, <strong>`star`</strong>, <strong>`#`</strong>, <strong>`n`</strong>, <strong>`N`</strong> or similar, it can be hard to see the "current" match from among all the matches that 'hlsearch' highlights. Loupe makes the currently selected match easier to see by:
@@ -14,20 +17,24 @@ When searching using <strong>`/`</strong>, <strong>`?`</strong>, <strong>`star`<
 - Applying a different <strong>`:highlight`</strong> group (by default, <strong>`hl-IncSearch`</strong>) to the match under the cursor.
 - Keeping the matching line centered within the window when jumping between matches with <strong>`n`</strong> and <strong>`N`</strong>.
 
+
 ### 2. Applies sane pattern syntax by default<a name="loupe-2-applies-sane-pattern-syntax-by-default" href="#user-content-loupe-2-applies-sane-pattern-syntax-by-default"></a>
 
 Loupe makes "very magic" (<strong>`/\v`</strong>) syntax apply by default when searching. This is true even if you initiate a search via a novel means, such as from a visual selection or with a complicated <strong>`:range`</strong> prefix.
 
 This means that you can use a pattern syntax closer to the familiar regular expression syntax from languages such as Perl, Ruby, JavaScript (indeed, most other modern languages that support regular expressions).
 
+
 ### 3. Provides a shortcut to remove search highlighting<a name="loupe-3-provides-a-shortcut-to-remove-search-highlighting" href="#user-content-loupe-3-provides-a-shortcut-to-remove-search-highlighting"></a>
 
 Loupe maps <leader>n to quickly remove all 'hlsearch' highlighting (although you can provide an alternative mapping of your choosing or suppress the feature entirely).
 
+
 ### 4. Sensible defaults for search-related features<a name="loupe-4-sensible-defaults-for-search-related-features" href="#user-content-loupe-4-sensible-defaults-for-search-related-features"></a>
 
 Loupe provides reasonable defaults for most search-related Vim settings to provide a good "out of the box" experience. For more details, or to see how to override Loupe's settings, see <strong>[`loupe-overrides`](#user-content-loupe-overrides)</strong>.
 
+
 ## Installation<a name="loupe-installation" href="#user-content-loupe-installation"></a>
 
 To install Loupe, use your plug-in management system of choice.
@@ -51,8 +58,10 @@ To generate help tags under Pathogen, you can do so from inside Vim with:
 :call pathogen#helptags()
 ```
 
+
 ## Mappings<a name="loupe-mappings" href="#user-content-loupe-mappings"></a>
 
+
 ### `<Plug>(LoupeClearHighlight)`<a name="loupe-plugloupeclearhighlight" href="#user-content-loupe-plugloupeclearhighlight"></a>
 
 Loupe maps <leader>n to <strong>[`<Plug>(LoupeClearHighlight)`](#user-content-plugloupeclearhighlight)</strong>, which clears all visible highlights (like <strong>`:nohighlight`</strong> does). To use an alternative mapping instead, create a different one in your <strong>`.vimrc`</strong> instead using <strong>`:nmap`</strong>:
@@ -68,6 +77,7 @@ Note that Loupe will not try to set up its <leader>n mapping if any of the follo
 - An alternative mapping for <strong>[`<Plug>(LoupeClearHighlight)`](#user-content-plugloupeclearhighlight)</strong> has already been set up from a <strong>`.vimrc`</strong>.
 - The mapping has been suppressed by setting <strong>`g:LoupeClearHighlightMap`</strong> to 1 in your <strong>`.vimrc`</strong>.
 
+
 ### `<Plug>(LoupeOctothorpe)`<a name="loupe-plugloupeoctothorpe" href="#user-content-loupe-plugloupeoctothorpe"></a>
 
 Loupe maps <strong>`#`</strong> to <strong>[`<Plug>(LoupeOctothorpe)`](#user-content-plugloupeoctothorpe)</strong> in order to implement custom highlighting and line-centering for the current match.
@@ -78,6 +88,7 @@ To prevent this from happening, create an alternate mapping in your <strong>`.vi
 nmap <Nop> <Plug>(LoupeOctothorpe)
 ```
 
+
 ### `<Plug>(LoupeStar)`<a name="loupe-plugloupestar" href="#user-content-loupe-plugloupestar"></a>
 
 Loupe maps <strong>`star`</strong> to <strong>[`<Plug>(LoupeStar)`](#user-content-plugloupestar)</strong> in order to implement custom highlighting and line-centering for the current match.
@@ -88,6 +99,7 @@ To prevent this from happening, create an alternate mapping in your <strong>`.vi
 nmap <Nop> <Plug>(LoupeStar)
 ```
 
+
 ### `<Plug>(LoupeN)`<a name="loupe-plugloupen" href="#user-content-loupe-plugloupen"></a>
 
 Loupe maps <strong>`N`</strong> to <strong>[`<Plug>(LoupeN)`](#user-content-plugloupen)</strong> in order to implement custom highlighting and line-centering for the current match.
@@ -98,6 +110,7 @@ To prevent this from happening, create an alternate mapping in your <strong>`.vi
 nmap <Nop> <Plug>(LoupeN)
 ```
 
+
 ### `<Plug>(LoupeGOctothorpe)`<a name="loupe-plugloupegoctothorpe" href="#user-content-loupe-plugloupegoctothorpe"></a>
 
 Loupe maps <strong>`g#`</strong> to <strong>[`<Plug>(LoupeGOctothorpe)`](#user-content-plugloupegoctothorpe)</strong> in order to implement custom highlighting and line-centering for the current match.
@@ -108,6 +121,7 @@ To prevent this from happening, create an alternate mapping in your <strong>`.vi
 nmap <Nop> <Plug>(LoupeGOctothorpe)
 ```
 
+
 ### `<Plug>(LoupeGStar)`<a name="loupe-plugloupegstar" href="#user-content-loupe-plugloupegstar"></a>
 
 Loupe maps <strong>`gstar`</strong> to <strong>[`<Plug>(LoupeGStar)`](#user-content-plugloupegstar)</strong> in order to implement custom highlighting and line-centering for the current match.
@@ -118,6 +132,7 @@ To prevent this from happening, create an alternate mapping in your <strong>`.vi
 nmap <Nop> <Plug>(LoupeGStar)
 ```
 
+
 ### `<Plug>(Loupen)`<a name="loupe-plugloupen" href="#user-content-loupe-plugloupen"></a>
 
 Loupe maps <strong>`n`</strong> to <strong>[`<Plug>(Loupen)`](#user-content-plugloupen)</strong> in order to implement custom highlighting and line-centering for the current match.
@@ -128,9 +143,11 @@ To prevent this from happening, create an alternate mapping in your <strong>`.vi
 nmap <Nop> <Plug>(Loupen)
 ```
 
+
 ## Options<a name="loupe-options" href="#user-content-loupe-options"></a>
 
 <p align="right"><a name="gloupehighlightgroup" href="#user-content-gloupehighlightgroup"><code>g:LoupeHighlightGroup</code></a></p>
+
 ### `g:LoupeHighlightGroup` (string, default: IncSearch)<a name="loupe-gloupehighlightgroup-string-default-incsearch" href="#user-content-loupe-gloupehighlightgroup-string-default-incsearch"></a>
 
 Specifies the <strong>`:highlight`</strong> group used to emphasize the match currently under the cursor for the current search pattern. Defaults to "IncSearch" (ie. <strong>`hl-IncSearch`</strong>). For example:
@@ -142,6 +159,7 @@ let g:LoupeHighlightGroup='Error'
 To prevent any special highlighting from being applied, set this option to "" (ie. the empty string).
 
 <p align="right"><a name="gloupeloaded" href="#user-content-gloupeloaded"><code>g:LoupeLoaded</code></a></p>
+
 ### `g:LoupeLoaded` (any, default: none)<a name="loupe-gloupeloaded-any-default-none" href="#user-content-loupe-gloupeloaded-any-default-none"></a>
 
 To prevent Loupe from being loaded, set <strong>`g:LoupeLoaded`</strong> to any value in your <strong>`.vimrc`</strong>. For example:
@@ -151,6 +169,7 @@ let g:LoupeLoaded=1
 ```
 
 <p align="right"><a name="gloupeclearhighlightmap" href="#user-content-gloupeclearhighlightmap"><code>g:LoupeClearHighlightMap</code></a></p>
+
 ### `g:LoupeClearHighlightMap` (boolean, default: 1)<a name="loupe-gloupeclearhighlightmap-boolean-default-1" href="#user-content-loupe-gloupeclearhighlightmap-boolean-default-1"></a>
 
 Controls whether to set up the <strong>[`<Plug>(LoupeClearHighlight)`](#user-content-plugloupeclearhighlight)</strong> mapping. To prevent any mapping from being configured, set to 0:
@@ -160,6 +179,7 @@ let g:LoupeClearHighlightMap=0
 ```
 
 <p align="right"><a name="gloupeverymagic" href="#user-content-gloupeverymagic"><code>g:LoupeVeryMagic</code></a></p>
+
 ### `g:LoupeVeryMagic` (boolean, default: 1)<a name="loupe-gloupeverymagic-boolean-default-1" href="#user-content-loupe-gloupeverymagic-boolean-default-1"></a>
 
 Controls whether "very magic" pattern syntax (<strong>`/\v`</strong>) is applied by default. To disable, set to 0:
@@ -169,6 +189,7 @@ let g:LoupeVeryMagic=0
 ```
 
 <p align="right"><a name="gloupecenterresults" href="#user-content-gloupecenterresults"><code>g:LoupeCenterResults</code></a></p>
+
 ### `g:LoupeCenterResults` (boolean, default: 1)<a name="loupe-gloupecenterresults-boolean-default-1" href="#user-content-loupe-gloupecenterresults-boolean-default-1"></a>
 
 Controls whether the match's line is vertically centered within the window when jumping (via <strong>`n`</strong>, <strong>`N`</strong> etc). To disable, set to 0:
@@ -177,13 +198,16 @@ Controls whether the match's line is vertically centered within the window when
 let g:LoupeCenterResults=0
 ```
 
+
 ## Functions<a name="loupe-functions" href="#user-content-loupe-functions"></a>
 
 <p align="right"><a name="loupehlmatch" href="#user-content-loupehlmatch"><code>loupe#hlmatch()</code></a></p>
+
 ### `loupe#hlmatch()`<a name="loupe-loupehlmatch" href="#user-content-loupe-loupehlmatch"></a>
 
 Apply highlighting to the current search match.
 
+
 ## Overrides<a name="loupe-overrides" href="#user-content-loupe-overrides"></a>
 
 Loupe sets a number of search-related Vim settings to reasonable defaults in order to provide a good "out of the box" experience. The following overrides will be set unless suppressed or overridden (see <strong>[`loupe-suppress-overrides`](#user-content-loupe-suppress-overrides)</strong>):
@@ -219,6 +243,7 @@ Adds "s", which suppresses the display of "search hit BOTTOM, continuing at TOP"
 Turned on (overrides 'ignorecase', making the search pattern case-sensitive whenever it containers uppercase characters).
 
 <p align="right"><a name="loupe-suppress-overrides" href="#user-content-loupe-suppress-overrides"><code>loupe-suppress-overrides</code></a></p>
+
 ### Preventing Loupe overrides from taking effect<a name="loupe-preventing-loupe-overrides-from-taking-effect" href="#user-content-loupe-preventing-loupe-overrides-from-taking-effect"></a>
 
 To override any of these choices, you can place overrides in an <strong>`after-directory`</strong> (ie. `~/.vim/after/plugin/loupe.vim`). For example:
@@ -234,12 +259,14 @@ To override any of these choices, you can place overrides in an <strong>`after-d
  set shortmess-=s
 ```
 
+
 ## Related<a name="loupe-related" href="#user-content-loupe-related"></a>
 
 Just as Loupe aims to improve the within-file search experience, Ferret does the same for multi-file searching and replacing:
 
 - https://github.com/wincent/ferret
 
+
 ## Website<a name="loupe-website" href="#user-content-loupe-website"></a>
 
 The official Loupe source code repo is at:
@@ -254,6 +281,7 @@ Official releases are listed at:
 
 - http://www.vim.org/scripts/script.php?script_id=5215
 
+
 ## License<a name="loupe-license" href="#user-content-loupe-license"></a>
 
 Copyright 2015-present Greg Hurrell. All rights reserved.
@@ -266,12 +294,15 @@ Redistribution and use in source and binary forms, with or without modification,
 
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
+
 ## Development<a name="loupe-development" href="#user-content-loupe-development"></a>
 
+
 ### Contributing patches<a name="loupe-contributing-patches" href="#user-content-loupe-contributing-patches"></a>
 
 Patches can be sent via mail to greg@hurrell.net, or as GitHub pull requests at: https://github.com/wincent/loupe/pulls
 
+
 ### Cutting a new release<a name="loupe-cutting-a-new-release" href="#user-content-loupe-cutting-a-new-release"></a>
 
 At the moment the release process is manual:
@@ -305,6 +336,7 @@ git archive -o loupe-$VERSION.zip HEAD -- .
 
 - Upload to http://www.vim.org/scripts/script.php?script_id=5215
 
+
 ## Authors<a name="loupe-authors" href="#user-content-loupe-authors"></a>
 
 Loupe is written and maintained by Greg Hurrell <greg@hurrell.net>.
@@ -317,17 +349,21 @@ Which he discussed in his "More Instantly Better Vim" presentation at OSCON 2013
 
 - https://www.youtube.com/watch?v=aHm36-na4-4
 
+
 ## History<a name="loupe-history" href="#user-content-loupe-history"></a>
 
+
 ### 1.1 (15 June 2016)<a name="loupe-11-15-june-2016" href="#user-content-loupe-11-15-june-2016"></a>
 
 - Make compatible with older versions of Vim that do not have <strong>`v:hlsearch`</strong>.
 - Add support for special delimiters with <strong>`:substitute`</strong> command.
 
+
 ### 1.0 (28 December 2015)<a name="loupe-10-28-december-2015" href="#user-content-loupe-10-28-december-2015"></a>
 
 - Renamed the <strong>`<Plug>LoupeClearHighlight`</strong> mapping to <strong>[`<Plug>(LoupeClearHighlight)`](#user-content-plugloupeclearhighlight)</strong>.
 
+
 ### 0.1 (5 July 2015)<a name="loupe-01-5-july-2015" href="#user-content-loupe-01-5-july-2015"></a>
 
 - Initial release, extracted from my dotfiles (https://github.com/wincent/wincent).