]> git.wincent.com - docvim.git/blob - tests/fixtures/parser/integration-ferret-plugin.golden
46c33ae53e1c80203ac5580f571ca0f8431c59ab
[docvim.git] / tests / fixtures / parser / integration-ferret-plugin.golden
1 Project
2   [ PluginAnnotation "ferret" "Ferret plug-in for Vim"
3   , HeadingAnnotation "Intro"
4   , Blockquote
5       [ Paragraph
6           [ Plaintext "\"ferret"
7           , Whitespace
8           , Plaintext "(verb)"
9           , BreakTag
10           , Plaintext "(ferret"
11           , Whitespace
12           , Plaintext "something"
13           , Whitespace
14           , Plaintext "out)"
15           , Whitespace
16           , Plaintext "search"
17           , Whitespace
18           , Plaintext "tenaciously"
19           , Whitespace
20           , Plaintext "for"
21           , Whitespace
22           , Plaintext "and"
23           , Whitespace
24           , Plaintext "find"
25           , Whitespace
26           , Plaintext "something:"
27           , Whitespace
28           , Plaintext "she"
29           , Whitespace
30           , Plaintext "had"
31           , Whitespace
32           , Plaintext "the"
33           , Whitespace
34           , Plaintext "ability"
35           , Whitespace
36           , Plaintext "to"
37           , Whitespace
38           , Plaintext "ferret"
39           , Whitespace
40           , Plaintext "out"
41           , Whitespace
42           , Plaintext "the"
43           , Whitespace
44           , Plaintext "facts.\""
45           ]
46       ]
47   , LinkTargets [ "ferret-features" ]
48   , Paragraph
49       [ Plaintext "Ferret"
50       , Whitespace
51       , Plaintext "improves"
52       , Whitespace
53       , Plaintext "Vim's"
54       , Whitespace
55       , Plaintext "multi-file"
56       , Whitespace
57       , Plaintext "search"
58       , Whitespace
59       , Plaintext "in"
60       , Whitespace
61       , Plaintext "four"
62       , Whitespace
63       , Plaintext "ways:"
64       ]
65   , SubheadingAnnotation "1. Powerful multi-file search"
66   , Paragraph
67       [ Plaintext "Ferret"
68       , Whitespace
69       , Plaintext "provides"
70       , Whitespace
71       , Plaintext "an"
72       , Whitespace
73       , Link ":Ack"
74       , Whitespace
75       , Plaintext "command"
76       , Whitespace
77       , Plaintext "for"
78       , Whitespace
79       , Plaintext "searching"
80       , Whitespace
81       , Plaintext "across"
82       , Whitespace
83       , Plaintext "multiple"
84       , Whitespace
85       , Plaintext "files"
86       , Whitespace
87       , Plaintext "using"
88       , Whitespace
89       , Plaintext "The"
90       , Whitespace
91       , Plaintext "Silver"
92       , Whitespace
93       , Plaintext "Searcher"
94       , Whitespace
95       , Plaintext "(https://github.com/ggreer/the_silver_searcher),"
96       , Whitespace
97       , Plaintext "Ack"
98       , Whitespace
99       , Plaintext "(http://beyondgrep.com/),"
100       , Whitespace
101       , Plaintext "or"
102       , Whitespace
103       , Plaintext "Grep"
104       , Whitespace
105       , Plaintext "(http://www.gnu.org/software/grep/)."
106       , Whitespace
107       , Plaintext "Support"
108       , Whitespace
109       , Plaintext "for"
110       , Whitespace
111       , Plaintext "passing"
112       , Whitespace
113       , Plaintext "options"
114       , Whitespace
115       , Plaintext "through"
116       , Whitespace
117       , Plaintext "to"
118       , Whitespace
119       , Plaintext "the"
120       , Whitespace
121       , Plaintext "underlying"
122       , Whitespace
123       , Plaintext "search"
124       , Whitespace
125       , Plaintext "command"
126       , Whitespace
127       , Plaintext "exists,"
128       , Whitespace
129       , Plaintext "along"
130       , Whitespace
131       , Plaintext "with"
132       , Whitespace
133       , Plaintext "the"
134       , Whitespace
135       , Plaintext "ability"
136       , Whitespace
137       , Plaintext "to"
138       , Whitespace
139       , Plaintext "use"
140       , Whitespace
141       , Plaintext "full"
142       , Whitespace
143       , Plaintext "regular"
144       , Whitespace
145       , Plaintext "expression"
146       , Whitespace
147       , Plaintext "syntax"
148       , Whitespace
149       , Plaintext "without"
150       , Whitespace
151       , Plaintext "doing"
152       , Whitespace
153       , Plaintext "special"
154       , Whitespace
155       , Plaintext "escaping."
156       ]
157   , Paragraph
158       [ Plaintext "Shortcut"
159       , Whitespace
160       , Plaintext "mappings"
161       , Whitespace
162       , Plaintext "are"
163       , Whitespace
164       , Plaintext "provided"
165       , Whitespace
166       , Plaintext "to"
167       , Whitespace
168       , Plaintext "start"
169       , Whitespace
170       , Plaintext "an"
171       , Whitespace
172       , Link ":Ack"
173       , Whitespace
174       , Plaintext "search"
175       , Whitespace
176       , Plaintext "(<leader>a)"
177       , Whitespace
178       , Plaintext "or"
179       , Whitespace
180       , Plaintext "to"
181       , Whitespace
182       , Plaintext "search"
183       , Whitespace
184       , Plaintext "for"
185       , Whitespace
186       , Plaintext "the"
187       , Whitespace
188       , Plaintext "word"
189       , Whitespace
190       , Plaintext "currently"
191       , Whitespace
192       , Plaintext "under"
193       , Whitespace
194       , Plaintext "the"
195       , Whitespace
196       , Plaintext "cursor"
197       , Whitespace
198       , Plaintext "(<leader>s)."
199       ]
200   , Paragraph
201       [ Plaintext "Results"
202       , Whitespace
203       , Plaintext "are"
204       , Whitespace
205       , Plaintext "normally"
206       , Whitespace
207       , Plaintext "displayed"
208       , Whitespace
209       , Plaintext "in"
210       , Whitespace
211       , Plaintext "the"
212       , Whitespace
213       , Link "quickfix"
214       , Whitespace
215       , Plaintext "window,"
216       , Whitespace
217       , Plaintext "but"
218       , Whitespace
219       , Plaintext "Ferret"
220       , Whitespace
221       , Plaintext "also"
222       , Whitespace
223       , Plaintext "provides"
224       , Whitespace
225       , Plaintext "a"
226       , Whitespace
227       , Link ":Lack"
228       , Whitespace
229       , Plaintext "command"
230       , Whitespace
231       , Plaintext "that"
232       , Whitespace
233       , Plaintext "behaves"
234       , Whitespace
235       , Plaintext "like"
236       , Whitespace
237       , Link ":Ack"
238       , Whitespace
239       , Plaintext "but"
240       , Whitespace
241       , Plaintext "uses"
242       , Whitespace
243       , Plaintext "the"
244       , Whitespace
245       , Link "location-list"
246       , Whitespace
247       , Plaintext "instead,"
248       , Whitespace
249       , Plaintext "and"
250       , Whitespace
251       , Plaintext "a"
252       , Whitespace
253       , Plaintext "<leader>l"
254       , Whitespace
255       , Plaintext "mapping"
256       , Whitespace
257       , Plaintext "as"
258       , Whitespace
259       , Plaintext "a"
260       , Whitespace
261       , Plaintext "shortcut"
262       , Whitespace
263       , Plaintext "to"
264       , Whitespace
265       , Link ":Lack"
266       , Plaintext "."
267       ]
268   , Paragraph
269       [ Plaintext "Finally,"
270       , Whitespace
271       , Plaintext "Ferret"
272       , Whitespace
273       , Plaintext "offers"
274       , Whitespace
275       , Plaintext "integration"
276       , Whitespace
277       , Plaintext "with"
278       , Whitespace
279       , Plaintext "dispatch.vim"
280       , Whitespace
281       , Plaintext "(https://github.com/tpope/vim-dispatch),"
282       , Whitespace
283       , Plaintext "which"
284       , Whitespace
285       , Plaintext "enables"
286       , Whitespace
287       , Plaintext "asynchronous"
288       , Whitespace
289       , Plaintext "searching"
290       , Whitespace
291       , Plaintext "despite"
292       , Whitespace
293       , Plaintext "the"
294       , Whitespace
295       , Plaintext "fact"
296       , Whitespace
297       , Plaintext "that"
298       , Whitespace
299       , Plaintext "Vim"
300       , Whitespace
301       , Plaintext "itself"
302       , Whitespace
303       , Plaintext "is"
304       , Whitespace
305       , Plaintext "single-threaded."
306       ]
307   , SubheadingAnnotation "2. Streamlined multi-file replace"
308   , Paragraph
309       [ Plaintext "The"
310       , Whitespace
311       , Plaintext "companion"
312       , Whitespace
313       , Plaintext "to"
314       , Whitespace
315       , Link ":Ack"
316       , Whitespace
317       , Plaintext "is"
318       , Whitespace
319       , Link ":Acks"
320       , Whitespace
321       , Plaintext "(mnemonic:"
322       , Whitespace
323       , Plaintext "\"Ack"
324       , Whitespace
325       , Plaintext "substitute\","
326       , Whitespace
327       , Plaintext "accessible"
328       , Whitespace
329       , Plaintext "via"
330       , Whitespace
331       , Plaintext "shortcut"
332       , Whitespace
333       , Plaintext "<leader>r),"
334       , Whitespace
335       , Plaintext "which"
336       , Whitespace
337       , Plaintext "allows"
338       , Whitespace
339       , Plaintext "you"
340       , Whitespace
341       , Plaintext "to"
342       , Whitespace
343       , Plaintext "run"
344       , Whitespace
345       , Plaintext "a"
346       , Whitespace
347       , Plaintext "multi-file"
348       , Whitespace
349       , Plaintext "replace"
350       , Whitespace
351       , Plaintext "across"
352       , Whitespace
353       , Plaintext "all"
354       , Whitespace
355       , Plaintext "the"
356       , Whitespace
357       , Plaintext "files"
358       , Whitespace
359       , Plaintext "placed"
360       , Whitespace
361       , Plaintext "in"
362       , Whitespace
363       , Plaintext "the"
364       , Whitespace
365       , Link "quickfix"
366       , Whitespace
367       , Plaintext "window"
368       , Whitespace
369       , Plaintext "by"
370       , Whitespace
371       , Plaintext "a"
372       , Whitespace
373       , Plaintext "previous"
374       , Whitespace
375       , Plaintext "invocation"
376       , Whitespace
377       , Plaintext "of"
378       , Whitespace
379       , Link ":Ack"
380       , Plaintext "."
381       ]
382   , SubheadingAnnotation "3. Quickfix listing enhancements"
383   , Paragraph
384       [ Plaintext "The"
385       , Whitespace
386       , Link "quickfix"
387       , Whitespace
388       , Plaintext "listing"
389       , Whitespace
390       , Plaintext "itself"
391       , Whitespace
392       , Plaintext "is"
393       , Whitespace
394       , Plaintext "enhanced"
395       , Whitespace
396       , Plaintext "with"
397       , Whitespace
398       , Plaintext "settings"
399       , Whitespace
400       , Plaintext "to"
401       , Whitespace
402       , Plaintext "improve"
403       , Whitespace
404       , Plaintext "its"
405       , Whitespace
406       , Plaintext "usability,"
407       , Whitespace
408       , Plaintext "and"
409       , Whitespace
410       , Plaintext "natural"
411       , Whitespace
412       , Plaintext "mappings"
413       , Whitespace
414       , Plaintext "that"
415       , Whitespace
416       , Plaintext "allow"
417       , Whitespace
418       , Plaintext "quick"
419       , Whitespace
420       , Plaintext "removal"
421       , Whitespace
422       , Plaintext "of"
423       , Whitespace
424       , Plaintext "items"
425       , Whitespace
426       , Plaintext "from"
427       , Whitespace
428       , Plaintext "the"
429       , Whitespace
430       , Plaintext "list"
431       , Whitespace
432       , Plaintext "(for"
433       , Whitespace
434       , Plaintext "example,"
435       , Whitespace
436       , Plaintext "you"
437       , Whitespace
438       , Plaintext "can"
439       , Whitespace
440       , Plaintext "reduce"
441       , Whitespace
442       , Plaintext "clutter"
443       , Whitespace
444       , Plaintext "in"
445       , Whitespace
446       , Plaintext "the"
447       , Whitespace
448       , Plaintext "listing"
449       , Whitespace
450       , Plaintext "by"
451       , Whitespace
452       , Plaintext "removing"
453       , Whitespace
454       , Plaintext "lines"
455       , Whitespace
456       , Plaintext "that"
457       , Whitespace
458       , Plaintext "you"
459       , Whitespace
460       , Plaintext "don't"
461       , Whitespace
462       , Plaintext "intend"
463       , Whitespace
464       , Plaintext "to"
465       , Whitespace
466       , Plaintext "make"
467       , Whitespace
468       , Plaintext "changes"
469       , Whitespace
470       , Plaintext "to)."
471       ]
472   , Paragraph
473       [ Plaintext "Additionally,"
474       , Whitespace
475       , Plaintext "Vim's"
476       , Whitespace
477       , Link ":cn"
478       , Plaintext ","
479       , Whitespace
480       , Link ":cp"
481       , Plaintext ","
482       , Whitespace
483       , Link ":cnf"
484       , Whitespace
485       , Plaintext "and"
486       , Whitespace
487       , Link ":cpf"
488       , Whitespace
489       , Plaintext "commands"
490       , Whitespace
491       , Plaintext "are"
492       , Whitespace
493       , Plaintext "tweaked"
494       , Whitespace
495       , Plaintext "to"
496       , Whitespace
497       , Plaintext "make"
498       , Whitespace
499       , Plaintext "it"
500       , Whitespace
501       , Plaintext "easier"
502       , Whitespace
503       , Plaintext "to"
504       , Whitespace
505       , Plaintext "immediately"
506       , Whitespace
507       , Plaintext "identify"
508       , Whitespace
509       , Plaintext "matches"
510       , Whitespace
511       , Plaintext "by"
512       , Whitespace
513       , Plaintext "centering"
514       , Whitespace
515       , Plaintext "them"
516       , Whitespace
517       , Plaintext "within"
518       , Whitespace
519       , Plaintext "the"
520       , Whitespace
521       , Plaintext "viewport."
522       ]
523   , SubheadingAnnotation
524       "4. Easy operations on files in the quickfix listing"
525   , Paragraph
526       [ Plaintext "Finally,"
527       , Whitespace
528       , Plaintext "Ferret"
529       , Whitespace
530       , Plaintext "provides"
531       , Whitespace
532       , Plaintext "a"
533       , Whitespace
534       , Link ":Qargs"
535       , Whitespace
536       , Plaintext "command"
537       , Whitespace
538       , Plaintext "that"
539       , Whitespace
540       , Plaintext "puts"
541       , Whitespace
542       , Plaintext "the"
543       , Whitespace
544       , Plaintext "files"
545       , Whitespace
546       , Plaintext "currently"
547       , Whitespace
548       , Plaintext "in"
549       , Whitespace
550       , Plaintext "the"
551       , Whitespace
552       , Link "quickfix"
553       , Whitespace
554       , Plaintext "listing"
555       , Whitespace
556       , Plaintext "into"
557       , Whitespace
558       , Plaintext "the"
559       , Whitespace
560       , Link ":args"
561       , Whitespace
562       , Plaintext "list,"
563       , Whitespace
564       , Plaintext "where"
565       , Whitespace
566       , Plaintext "they"
567       , Whitespace
568       , Plaintext "can"
569       , Whitespace
570       , Plaintext "be"
571       , Whitespace
572       , Plaintext "operated"
573       , Whitespace
574       , Plaintext "on"
575       , Whitespace
576       , Plaintext "in"
577       , Whitespace
578       , Plaintext "bulk"
579       , Whitespace
580       , Plaintext "via"
581       , Whitespace
582       , Plaintext "the"
583       , Whitespace
584       , Link ":argdo"
585       , Whitespace
586       , Plaintext "command."
587       , Whitespace
588       , Plaintext "This"
589       , Whitespace
590       , Plaintext "is"
591       , Whitespace
592       , Plaintext "what's"
593       , Whitespace
594       , Plaintext "used"
595       , Whitespace
596       , Plaintext "under"
597       , Whitespace
598       , Plaintext "the"
599       , Whitespace
600       , Plaintext "covers"
601       , Whitespace
602       , Plaintext "by"
603       , Whitespace
604       , Link ":Acks"
605       , Whitespace
606       , Plaintext "to"
607       , Whitespace
608       , Plaintext "do"
609       , Whitespace
610       , Plaintext "its"
611       , Whitespace
612       , Plaintext "work."
613       ]
614   , HeadingAnnotation "Installation"
615   , Paragraph
616       [ Plaintext "To"
617       , Whitespace
618       , Plaintext "install"
619       , Whitespace
620       , Plaintext "Ferret,"
621       , Whitespace
622       , Plaintext "use"
623       , Whitespace
624       , Plaintext "your"
625       , Whitespace
626       , Plaintext "plug-in"
627       , Whitespace
628       , Plaintext "management"
629       , Whitespace
630       , Plaintext "system"
631       , Whitespace
632       , Plaintext "of"
633       , Whitespace
634       , Plaintext "choice."
635       ]
636   , Paragraph
637       [ Plaintext "If"
638       , Whitespace
639       , Plaintext "you"
640       , Whitespace
641       , Plaintext "don't"
642       , Whitespace
643       , Plaintext "have"
644       , Whitespace
645       , Plaintext "a"
646       , Whitespace
647       , Plaintext "\"plug-in"
648       , Whitespace
649       , Plaintext "management"
650       , Whitespace
651       , Plaintext "system"
652       , Whitespace
653       , Plaintext "of"
654       , Whitespace
655       , Plaintext "choice\","
656       , Whitespace
657       , Plaintext "I"
658       , Whitespace
659       , Plaintext "recommend"
660       , Whitespace
661       , Plaintext "Pathogen"
662       , Whitespace
663       , Plaintext "(https://github.com/tpope/vim-pathogen)"
664       , Whitespace
665       , Plaintext "due"
666       , Whitespace
667       , Plaintext "to"
668       , Whitespace
669       , Plaintext "its"
670       , Whitespace
671       , Plaintext "simplicity"
672       , Whitespace
673       , Plaintext "and"
674       , Whitespace
675       , Plaintext "robustness."
676       , Whitespace
677       , Plaintext "Assuming"
678       , Whitespace
679       , Plaintext "that"
680       , Whitespace
681       , Plaintext "you"
682       , Whitespace
683       , Plaintext "have"
684       , Whitespace
685       , Plaintext "Pathogen"
686       , Whitespace
687       , Plaintext "installed"
688       , Whitespace
689       , Plaintext "and"
690       , Whitespace
691       , Plaintext "configured,"
692       , Whitespace
693       , Plaintext "and"
694       , Whitespace
695       , Plaintext "that"
696       , Whitespace
697       , Plaintext "you"
698       , Whitespace
699       , Plaintext "want"
700       , Whitespace
701       , Plaintext "to"
702       , Whitespace
703       , Plaintext "install"
704       , Whitespace
705       , Plaintext "Ferret"
706       , Whitespace
707       , Plaintext "into"
708       , Whitespace
709       , Code "~/.vim/bundle"
710       , Plaintext ","
711       , Whitespace
712       , Plaintext "you"
713       , Whitespace
714       , Plaintext "can"
715       , Whitespace
716       , Plaintext "do"
717       , Whitespace
718       , Plaintext "so"
719       , Whitespace
720       , Plaintext "with:"
721       ]
722   , Fenced
723       [ "git clone https://github.com/wincent/ferret.git ~/.vim/bundle/ferret"
724       ]
725   , Paragraph
726       [ Plaintext "Alternatively,"
727       , Whitespace
728       , Plaintext "if"
729       , Whitespace
730       , Plaintext "you"
731       , Whitespace
732       , Plaintext "use"
733       , Whitespace
734       , Plaintext "a"
735       , Whitespace
736       , Plaintext "Git"
737       , Whitespace
738       , Plaintext "submodule"
739       , Whitespace
740       , Plaintext "for"
741       , Whitespace
742       , Plaintext "each"
743       , Whitespace
744       , Plaintext "Vim"
745       , Whitespace
746       , Plaintext "plug-in,"
747       , Whitespace
748       , Plaintext "you"
749       , Whitespace
750       , Plaintext "could"
751       , Whitespace
752       , Plaintext "do"
753       , Whitespace
754       , Plaintext "the"
755       , Whitespace
756       , Plaintext "following"
757       , Whitespace
758       , Plaintext "after"
759       , Whitespace
760       , Code "cd"
761       , Plaintext "-ing"
762       , Whitespace
763       , Plaintext "into"
764       , Whitespace
765       , Plaintext "the"
766       , Whitespace
767       , Plaintext "top-level"
768       , Whitespace
769       , Plaintext "of"
770       , Whitespace
771       , Plaintext "your"
772       , Whitespace
773       , Plaintext "Git"
774       , Whitespace
775       , Plaintext "superproject:"
776       ]
777   , Fenced
778       [ "git submodule add https://github.com/wincent/ferret.git ~/vim/bundle/ferret"
779       , "git submodule init"
780       ]
781   , Paragraph
782       [ Plaintext "To"
783       , Whitespace
784       , Plaintext "generate"
785       , Whitespace
786       , Plaintext "help"
787       , Whitespace
788       , Plaintext "tags"
789       , Whitespace
790       , Plaintext "under"
791       , Whitespace
792       , Plaintext "Pathogen,"
793       , Whitespace
794       , Plaintext "you"
795       , Whitespace
796       , Plaintext "can"
797       , Whitespace
798       , Plaintext "do"
799       , Whitespace
800       , Plaintext "so"
801       , Whitespace
802       , Plaintext "from"
803       , Whitespace
804       , Plaintext "inside"
805       , Whitespace
806       , Plaintext "Vim"
807       , Whitespace
808       , Plaintext "with:"
809       ]
810   , Fenced [ ":call pathogen#helptags()" ]
811   , Project
812       [ Unit
813           [ DocBlock []
814           , GenericStatement "\"\""
815           , GenericStatement
816               "if exists('g:FerretLoaded') || &compatible || v:version < 700"
817           , GenericStatement "finish"
818           , GenericStatement "endif"
819           , LetStatement { letLexpr = "g:FerretLoaded " , letValue = "1" }
820           , LetStatement
821               { letLexpr = "s:cpoptions " , letValue = "&cpoptions" }
822           , GenericStatement "set cpoptions&vim"
823           , GenericStatement
824               "if executable('ag') \" The Silver Searcher: faster than ack."
825           , LetStatement
826               { letLexpr = "s:ackprg "
827               , letValue = "'ag --column --nocolor --nogroup'"
828               }
829           , GenericStatement
830               "elseif executable('ack') \" Ack: better than grep."
831           , LetStatement
832               { letLexpr = "s:ackprg " , letValue = "'ack --column'" }
833           , GenericStatement
834               "elseif executable('grep') \" Grep: it's just grep."
835           , LetStatement
836               { letLexpr = "s:ackprg "
837               , letValue = "&grepprg \" default is: grep -n $* /dev/null"
838               }
839           , GenericStatement "endif"
840           , GenericStatement "if !empty(s:ackprg)"
841           , LetStatement { letLexpr = "&grepprg" , letValue = "s:ackprg" }
842           , GenericStatement "set grepformat=%f:%l:%c:%m"
843           , GenericStatement "endif"
844           , GenericStatement "if has('autocmd')"
845           , GenericStatement "augroup Ferret"
846           , GenericStatement "autocmd!"
847           , GenericStatement "autocmd QuickFixCmdPost [^l]* nested cwindow"
848           , GenericStatement "autocmd QuickFixCmdPost l* nested lwindow"
849           , GenericStatement "augroup END"
850           , GenericStatement "endif"
851           , DocBlock
852               [ CommandAnnotation ":Ack {pattern} {options}"
853               , Paragraph
854                   [ Plaintext "Searches"
855                   , Whitespace
856                   , Plaintext "for"
857                   , Whitespace
858                   , Plaintext "{pattern}"
859                   , Whitespace
860                   , Plaintext "in"
861                   , Whitespace
862                   , Plaintext "all"
863                   , Whitespace
864                   , Plaintext "the"
865                   , Whitespace
866                   , Plaintext "files"
867                   , Whitespace
868                   , Plaintext "under"
869                   , Whitespace
870                   , Plaintext "the"
871                   , Whitespace
872                   , Plaintext "current"
873                   , Whitespace
874                   , Plaintext "directory"
875                   , Whitespace
876                   , Plaintext "(see"
877                   , Whitespace
878                   , Link ":pwd"
879                   , Plaintext "),"
880                   , Whitespace
881                   , Plaintext "unless"
882                   , Whitespace
883                   , Plaintext "otherwise"
884                   , Whitespace
885                   , Plaintext "overridden"
886                   , Whitespace
887                   , Plaintext "via"
888                   , Whitespace
889                   , Plaintext "{options},"
890                   , Whitespace
891                   , Plaintext "and"
892                   , Whitespace
893                   , Plaintext "displays"
894                   , Whitespace
895                   , Plaintext "the"
896                   , Whitespace
897                   , Plaintext "results"
898                   , Whitespace
899                   , Plaintext "in"
900                   , Whitespace
901                   , Plaintext "the"
902                   , Whitespace
903                   , Link "quickfix"
904                   , Whitespace
905                   , Plaintext "listing."
906                   ]
907               , Paragraph
908                   [ Code "ag"
909                   , Whitespace
910                   , Plaintext "(The"
911                   , Whitespace
912                   , Plaintext "Silver"
913                   , Whitespace
914                   , Plaintext "Searcher)"
915                   , Whitespace
916                   , Plaintext "will"
917                   , Whitespace
918                   , Plaintext "be"
919                   , Whitespace
920                   , Plaintext "used"
921                   , Whitespace
922                   , Plaintext "preferentially"
923                   , Whitespace
924                   , Plaintext "if"
925                   , Whitespace
926                   , Plaintext "present"
927                   , Whitespace
928                   , Plaintext "on"
929                   , Whitespace
930                   , Plaintext "the"
931                   , Whitespace
932                   , Plaintext "system,"
933                   , Whitespace
934                   , Plaintext "because"
935                   , Whitespace
936                   , Plaintext "it"
937                   , Whitespace
938                   , Plaintext "is"
939                   , Whitespace
940                   , Plaintext "faster,"
941                   , Whitespace
942                   , Plaintext "falling"
943                   , Whitespace
944                   , Plaintext "back"
945                   , Whitespace
946                   , Plaintext "to"
947                   , Whitespace
948                   , Code "ack"
949                   , Whitespace
950                   , Plaintext "and"
951                   , Whitespace
952                   , Plaintext "then"
953                   , Whitespace
954                   , Code "grep"
955                   , Whitespace
956                   , Plaintext "as"
957                   , Whitespace
958                   , Plaintext "needed."
959                   ]
960               , Paragraph
961                   [ Plaintext "If"
962                   , Whitespace
963                   , Plaintext "dispatch.vim"
964                   , Whitespace
965                   , Plaintext "is"
966                   , Whitespace
967                   , Plaintext "installed"
968                   , Whitespace
969                   , Plaintext "the"
970                   , Whitespace
971                   , Plaintext "search"
972                   , Whitespace
973                   , Plaintext "process"
974                   , Whitespace
975                   , Plaintext "will"
976                   , Whitespace
977                   , Plaintext "run"
978                   , Whitespace
979                   , Plaintext "asynchronously"
980                   , Whitespace
981                   , Plaintext "via"
982                   , Whitespace
983                   , Plaintext "the"
984                   , Whitespace
985                   , Link ":Make"
986                   , Whitespace
987                   , Plaintext "command,"
988                   , Whitespace
989                   , Plaintext "otherwise"
990                   , Whitespace
991                   , Plaintext "it"
992                   , Whitespace
993                   , Plaintext "will"
994                   , Whitespace
995                   , Plaintext "be"
996                   , Whitespace
997                   , Plaintext "run"
998                   , Whitespace
999                   , Plaintext "synchronously"
1000                   , Whitespace
1001                   , Plaintext "via"
1002                   , Whitespace
1003                   , Link ":cexpr"
1004                   , Plaintext "."
1005                   , Whitespace
1006                   , Plaintext "Asynchronous"
1007                   , Whitespace
1008                   , Plaintext "searches"
1009                   , Whitespace
1010                   , Plaintext "are"
1011                   , Whitespace
1012                   , Plaintext "preferred"
1013                   , Whitespace
1014                   , Plaintext "because"
1015                   , Whitespace
1016                   , Plaintext "they"
1017                   , Whitespace
1018                   , Plaintext "do"
1019                   , Whitespace
1020                   , Plaintext "not"
1021                   , Whitespace
1022                   , Plaintext "block,"
1023                   , Whitespace
1024                   , Plaintext "despite"
1025                   , Whitespace
1026                   , Plaintext "the"
1027                   , Whitespace
1028                   , Plaintext "fact"
1029                   , Whitespace
1030                   , Plaintext "that"
1031                   , Whitespace
1032                   , Plaintext "Vim"
1033                   , Whitespace
1034                   , Plaintext "itself"
1035                   , Whitespace
1036                   , Plaintext "is"
1037                   , Whitespace
1038                   , Plaintext "single"
1039                   , Whitespace
1040                   , Plaintext "threaded."
1041                   , Whitespace
1042                   , Plaintext "The"
1043                   , Whitespace
1044                   , Link "g:FerretDispatch"
1045                   , Whitespace
1046                   , Plaintext "option"
1047                   , Whitespace
1048                   , Plaintext "can"
1049                   , Whitespace
1050                   , Plaintext "be"
1051                   , Whitespace
1052                   , Plaintext "used"
1053                   , Whitespace
1054                   , Plaintext "to"
1055                   , Whitespace
1056                   , Plaintext "prevent"
1057                   , Whitespace
1058                   , Plaintext "the"
1059                   , Whitespace
1060                   , Plaintext "use"
1061                   , Whitespace
1062                   , Plaintext "of"
1063                   , Whitespace
1064                   , Plaintext "dispatch.vim."
1065                   ]
1066               , Paragraph
1067                   [ Plaintext "The"
1068                   , Whitespace
1069                   , Plaintext "{pattern}"
1070                   , Whitespace
1071                   , Plaintext "is"
1072                   , Whitespace
1073                   , Plaintext "passed"
1074                   , Whitespace
1075                   , Plaintext "through"
1076                   , Whitespace
1077                   , Plaintext "as-is"
1078                   , Whitespace
1079                   , Plaintext "to"
1080                   , Whitespace
1081                   , Plaintext "the"
1082                   , Whitespace
1083                   , Plaintext "underlying"
1084                   , Whitespace
1085                   , Plaintext "search"
1086                   , Whitespace
1087                   , Plaintext "program,"
1088                   , Whitespace
1089                   , Plaintext "and"
1090                   , Whitespace
1091                   , Plaintext "no"
1092                   , Whitespace
1093                   , Plaintext "escaping"
1094                   , Whitespace
1095                   , Plaintext "is"
1096                   , Whitespace
1097                   , Plaintext "required"
1098                   , Whitespace
1099                   , Plaintext "other"
1100                   , Whitespace
1101                   , Plaintext "than"
1102                   , Whitespace
1103                   , Plaintext "preceding"
1104                   , Whitespace
1105                   , Plaintext "spaces"
1106                   , Whitespace
1107                   , Plaintext "by"
1108                   , Whitespace
1109                   , Plaintext "a"
1110                   , Whitespace
1111                   , Plaintext "single"
1112                   , Whitespace
1113                   , Plaintext "backslash."
1114                   , Whitespace
1115                   , Plaintext "For"
1116                   , Whitespace
1117                   , Plaintext "example,"
1118                   , Whitespace
1119                   , Plaintext "to"
1120                   , Whitespace
1121                   , Plaintext "search"
1122                   , Whitespace
1123                   , Plaintext "for"
1124                   , Whitespace
1125                   , Plaintext "\"\\bfoo[0-9]{2}"
1126                   , Whitespace
1127                   , Plaintext "bar\\b\""
1128                   , Whitespace
1129                   , Plaintext "(ie."
1130                   , Whitespace
1131                   , Plaintext "using"
1132                   , Whitespace
1133                   , Code "ag"
1134                   , Plaintext "'s"
1135                   , Whitespace
1136                   , Plaintext "Perl-style"
1137                   , Whitespace
1138                   , Plaintext "regular"
1139                   , Whitespace
1140                   , Plaintext "expression"
1141                   , Whitespace
1142                   , Plaintext "syntax),"
1143                   , Whitespace
1144                   , Plaintext "you"
1145                   , Whitespace
1146                   , Plaintext "could"
1147                   , Whitespace
1148                   , Plaintext "do:"
1149                   ]
1150               , Fenced [ ":Ack \\bfoo[0-9]{2}\\ bar\\b" ]
1151               , Paragraph
1152                   [ Plaintext "Likewise,"
1153                   , Whitespace
1154                   , Plaintext "{options}"
1155                   , Whitespace
1156                   , Plaintext "are"
1157                   , Whitespace
1158                   , Plaintext "passed"
1159                   , Whitespace
1160                   , Plaintext "through."
1161                   , Whitespace
1162                   , Plaintext "In"
1163                   , Whitespace
1164                   , Plaintext "this"
1165                   , Whitespace
1166                   , Plaintext "example,"
1167                   , Whitespace
1168                   , Plaintext "we"
1169                   , Whitespace
1170                   , Plaintext "pass"
1171                   , Whitespace
1172                   , Plaintext "the"
1173                   , Whitespace
1174                   , Code "-w"
1175                   , Whitespace
1176                   , Plaintext "option"
1177                   , Whitespace
1178                   , Plaintext "(to"
1179                   , Whitespace
1180                   , Plaintext "search"
1181                   , Whitespace
1182                   , Plaintext "on"
1183                   , Whitespace
1184                   , Plaintext "word"
1185                   , Whitespace
1186                   , Plaintext "boundaries),"
1187                   , Whitespace
1188                   , Plaintext "and"
1189                   , Whitespace
1190                   , Plaintext "scope"
1191                   , Whitespace
1192                   , Plaintext "the"
1193                   , Whitespace
1194                   , Plaintext "search"
1195                   , Whitespace
1196                   , Plaintext "to"
1197                   , Whitespace
1198                   , Plaintext "the"
1199                   , Whitespace
1200                   , Plaintext "\"foo\""
1201                   , Whitespace
1202                   , Plaintext "and"
1203                   , Whitespace
1204                   , Plaintext "\"bar\""
1205                   , Whitespace
1206                   , Plaintext "subdirectories:"
1207                   , Whitespace
1208                   , Plaintext ">"
1209                   ]
1210               , Fenced [ ":Ack -w something foo bar" ]
1211               , Paragraph
1212                   [ Plaintext "As"
1213                   , Whitespace
1214                   , Plaintext "a"
1215                   , Whitespace
1216                   , Plaintext "convenience"
1217                   , Whitespace
1218                   , Plaintext "<leader>a"
1219                   , Whitespace
1220                   , Plaintext "is"
1221                   , Whitespace
1222                   , Plaintext "set-up"
1223                   , Whitespace
1224                   , Plaintext "("
1225                   , Link "<Plug>(FerretAck)"
1226                   , Plaintext ")"
1227                   , Whitespace
1228                   , Plaintext "as"
1229                   , Whitespace
1230                   , Plaintext "a"
1231                   , Whitespace
1232                   , Plaintext "shortcut"
1233                   , Whitespace
1234                   , Plaintext "to"
1235                   , Whitespace
1236                   , Plaintext "enter"
1237                   , Whitespace
1238                   , Link "Cmdline-mode"
1239                   , Whitespace
1240                   , Plaintext "with"
1241                   , Whitespace
1242                   , Code ":Ack"
1243                   , Whitespace
1244                   , Plaintext "inserted"
1245                   , Whitespace
1246                   , Plaintext "on"
1247                   , Whitespace
1248                   , Plaintext "the"
1249                   , Whitespace
1250                   , Link "Cmdline"
1251                   , Plaintext "."
1252                   , Whitespace
1253                   , Plaintext "Likewise"
1254                   , Whitespace
1255                   , Plaintext "<leader>s"
1256                   , Whitespace
1257                   , Plaintext "("
1258                   , Link "<Plug>(FerretAckWord)"
1259                   , Plaintext ")"
1260                   , Whitespace
1261                   , Plaintext "is"
1262                   , Whitespace
1263                   , Plaintext "a"
1264                   , Whitespace
1265                   , Plaintext "shortcut"
1266                   , Whitespace
1267                   , Plaintext "for"
1268                   , Whitespace
1269                   , Plaintext "running"
1270                   , Whitespace
1271                   , Link ":Ack"
1272                   , Whitespace
1273                   , Plaintext "with"
1274                   , Whitespace
1275                   , Plaintext "the"
1276                   , Whitespace
1277                   , Plaintext "word"
1278                   , Whitespace
1279                   , Plaintext "currently"
1280                   , Whitespace
1281                   , Plaintext "under"
1282                   , Whitespace
1283                   , Plaintext "the"
1284                   , Whitespace
1285                   , Plaintext "cursor."
1286                   ]
1287               ]
1288           , GenericStatement
1289               "command! -nargs=+ -complete=file Ack call ferret#private#ack(<q-args>)"
1290           , DocBlock
1291               [ CommandAnnotation ":Lack {pattern} {options}"
1292               , Paragraph
1293                   [ Plaintext "Just"
1294                   , Whitespace
1295                   , Plaintext "like"
1296                   , Whitespace
1297                   , Link ":Ack"
1298                   , Plaintext ","
1299                   , Whitespace
1300                   , Plaintext "but"
1301                   , Whitespace
1302                   , Plaintext "instead"
1303                   , Whitespace
1304                   , Plaintext "of"
1305                   , Whitespace
1306                   , Plaintext "using"
1307                   , Whitespace
1308                   , Plaintext "the"
1309                   , Whitespace
1310                   , Link "quickfix"
1311                   , Whitespace
1312                   , Plaintext "listing,"
1313                   , Whitespace
1314                   , Plaintext "which"
1315                   , Whitespace
1316                   , Plaintext "is"
1317                   , Whitespace
1318                   , Plaintext "global"
1319                   , Whitespace
1320                   , Plaintext "across"
1321                   , Whitespace
1322                   , Plaintext "an"
1323                   , Whitespace
1324                   , Plaintext "entire"
1325                   , Whitespace
1326                   , Plaintext "Vim"
1327                   , Whitespace
1328                   , Plaintext "instance,"
1329                   , Whitespace
1330                   , Plaintext "it"
1331                   , Whitespace
1332                   , Plaintext "uses"
1333                   , Whitespace
1334                   , Plaintext "the"
1335                   , Whitespace
1336                   , Link "location-list"
1337                   , Plaintext ","
1338                   , Whitespace
1339                   , Plaintext "which"
1340                   , Whitespace
1341                   , Plaintext "is"
1342                   , Whitespace
1343                   , Plaintext "a"
1344                   , Whitespace
1345                   , Plaintext "per-window"
1346                   , Whitespace
1347                   , Plaintext "construct."
1348                   ]
1349               , Paragraph
1350                   [ Plaintext "Note"
1351                   , Whitespace
1352                   , Plaintext "that"
1353                   , Whitespace
1354                   , Link ":Lack"
1355                   , Whitespace
1356                   , Plaintext "always"
1357                   , Whitespace
1358                   , Plaintext "runs"
1359                   , Whitespace
1360                   , Plaintext "synchronously"
1361                   , Whitespace
1362                   , Plaintext "via"
1363                   , Whitespace
1364                   , Link ":cexpr"
1365                   , Plaintext ","
1366                   , Whitespace
1367                   , Plaintext "because"
1368                   , Whitespace
1369                   , Plaintext "dispatch.vim"
1370                   , Whitespace
1371                   , Plaintext "doesn't"
1372                   , Whitespace
1373                   , Plaintext "currently"
1374                   , Whitespace
1375                   , Plaintext "support"
1376                   , Whitespace
1377                   , Plaintext "the"
1378                   , Whitespace
1379                   , Link "location-list"
1380                   , Plaintext "."
1381                   ]
1382               ]
1383           , GenericStatement
1384               "command! -nargs=+ -complete=file Lack call ferret#private#lack(<q-args>)"
1385           , DocBlock
1386               [ CommandAnnotation ":Acks /{pattern}/{replacement}/"
1387               , Paragraph
1388                   [ Plaintext "Takes"
1389                   , Whitespace
1390                   , Plaintext "all"
1391                   , Whitespace
1392                   , Plaintext "of"
1393                   , Whitespace
1394                   , Plaintext "the"
1395                   , Whitespace
1396                   , Plaintext "files"
1397                   , Whitespace
1398                   , Plaintext "currently"
1399                   , Whitespace
1400                   , Plaintext "in"
1401                   , Whitespace
1402                   , Plaintext "the"
1403                   , Whitespace
1404                   , Link "quickfix"
1405                   , Whitespace
1406                   , Plaintext "listing"
1407                   , Whitespace
1408                   , Plaintext "and"
1409                   , Whitespace
1410                   , Plaintext "performs"
1411                   , Whitespace
1412                   , Plaintext "a"
1413                   , Whitespace
1414                   , Plaintext "substitution"
1415                   , Whitespace
1416                   , Plaintext "of"
1417                   , Whitespace
1418                   , Plaintext "all"
1419                   , Whitespace
1420                   , Plaintext "instances"
1421                   , Whitespace
1422                   , Plaintext "of"
1423                   , Whitespace
1424                   , Plaintext "{pattern}"
1425                   , Whitespace
1426                   , Plaintext "(a"
1427                   , Whitespace
1428                   , Plaintext "standard"
1429                   , Whitespace
1430                   , Plaintext "Vim"
1431                   , Whitespace
1432                   , Plaintext "search"
1433                   , Whitespace
1434                   , Link "pattern"
1435                   , Plaintext ")"
1436                   , Whitespace
1437                   , Plaintext "by"
1438                   , Whitespace
1439                   , Plaintext "{replacement}."
1440                   ]
1441               , Paragraph
1442                   [ Plaintext "A"
1443                   , Whitespace
1444                   , Plaintext "typical"
1445                   , Whitespace
1446                   , Plaintext "sequence"
1447                   , Whitespace
1448                   , Plaintext "consists"
1449                   , Whitespace
1450                   , Plaintext "of"
1451                   , Whitespace
1452                   , Plaintext "an"
1453                   , Whitespace
1454                   , Link ":Ack"
1455                   , Whitespace
1456                   , Plaintext "invocation"
1457                   , Whitespace
1458                   , Plaintext "to"
1459                   , Whitespace
1460                   , Plaintext "populate"
1461                   , Whitespace
1462                   , Plaintext "the"
1463                   , Whitespace
1464                   , Link "quickfix"
1465                   , Whitespace
1466                   , Plaintext "listing"
1467                   , Whitespace
1468                   , Plaintext "and"
1469                   , Whitespace
1470                   , Plaintext "then"
1471                   , Whitespace
1472                   , Link ":Acks"
1473                   , Whitespace
1474                   , Plaintext "(mnemonic:"
1475                   , Whitespace
1476                   , Plaintext "\"Ack"
1477                   , Whitespace
1478                   , Plaintext "substitute\")"
1479                   , Whitespace
1480                   , Plaintext "to"
1481                   , Whitespace
1482                   , Plaintext "perform"
1483                   , Whitespace
1484                   , Plaintext "replacements."
1485                   , Whitespace
1486                   , Plaintext "For"
1487                   , Whitespace
1488                   , Plaintext "example,"
1489                   , Whitespace
1490                   , Plaintext "to"
1491                   , Whitespace
1492                   , Plaintext "replace"
1493                   , Whitespace
1494                   , Plaintext "\"foo\""
1495                   , Whitespace
1496                   , Plaintext "with"
1497                   , Whitespace
1498                   , Plaintext "\"bar\""
1499                   , Whitespace
1500                   , Plaintext "across"
1501                   , Whitespace
1502                   , Plaintext "all"
1503                   , Whitespace
1504                   , Plaintext "files"
1505                   , Whitespace
1506                   , Plaintext "in"
1507                   , Whitespace
1508                   , Plaintext "the"
1509                   , Whitespace
1510                   , Plaintext "current"
1511                   , Whitespace
1512                   , Plaintext "directory:"
1513                   ]
1514               , Fenced [ ":Ack foo" , ":Acks /foo/bar/" ]
1515               ]
1516           , GenericStatement
1517               "command! -nargs=1 Acks call ferret#private#acks(<q-args>)"
1518           , DocBlock
1519               [ OptionAnnotation "g:FerretMap" "boolean" (Just "1")
1520               , Paragraph
1521                   [ Plaintext "Controls"
1522                   , Whitespace
1523                   , Plaintext "whether"
1524                   , Whitespace
1525                   , Plaintext "to"
1526                   , Whitespace
1527                   , Plaintext "set"
1528                   , Whitespace
1529                   , Plaintext "up"
1530                   , Whitespace
1531                   , Plaintext "the"
1532                   , Whitespace
1533                   , Plaintext "Ferret"
1534                   , Whitespace
1535                   , Plaintext "mappings,"
1536                   , Whitespace
1537                   , Plaintext "such"
1538                   , Whitespace
1539                   , Plaintext "as"
1540                   , Whitespace
1541                   , Link "<Plug>(FerretAck)"
1542                   , Whitespace
1543                   , Plaintext "(see"
1544                   , Whitespace
1545                   , Link "ferret-mappings"
1546                   , Whitespace
1547                   , Plaintext "for"
1548                   , Whitespace
1549                   , Plaintext "a"
1550                   , Whitespace
1551                   , Plaintext "full"
1552                   , Whitespace
1553                   , Plaintext "list)."
1554                   , Whitespace
1555                   , Plaintext "To"
1556                   , Whitespace
1557                   , Plaintext "prevent"
1558                   , Whitespace
1559                   , Plaintext "any"
1560                   , Whitespace
1561                   , Plaintext "mapping"
1562                   , Whitespace
1563                   , Plaintext "from"
1564                   , Whitespace
1565                   , Plaintext "being"
1566                   , Whitespace
1567                   , Plaintext "configured,"
1568                   , Whitespace
1569                   , Plaintext "set"
1570                   , Whitespace
1571                   , Plaintext "to"
1572                   , Whitespace
1573                   , Plaintext "0:"
1574                   ]
1575               , Fenced [ "let g:FerretMap=0" ]
1576               ]
1577           , LetStatement
1578               { letLexpr = "s:map" , letValue = "get(g:, 'FerretMap', 1)" }
1579           , GenericStatement "if s:map"
1580           , GenericStatement
1581               "if !hasmapto('<Plug>(FerretAck)') && maparg('<leader>a', 'n') ==# ''"
1582           , DocBlock
1583               [ MappingAnnotation "<Plug>(FerretAck)"
1584               , Paragraph
1585                   [ Plaintext "Ferret"
1586                   , Whitespace
1587                   , Plaintext "maps"
1588                   , Whitespace
1589                   , Plaintext "<leader>a"
1590                   , Whitespace
1591                   , Plaintext "to"
1592                   , Whitespace
1593                   , Link "<Plug>(FerretAck)"
1594                   , Plaintext ","
1595                   , Whitespace
1596                   , Plaintext "which"
1597                   , Whitespace
1598                   , Plaintext "triggers"
1599                   , Whitespace
1600                   , Plaintext "the"
1601                   , Whitespace
1602                   , Link ":Ack"
1603                   , Whitespace
1604                   , Plaintext "command."
1605                   , Whitespace
1606                   , Plaintext "To"
1607                   , Whitespace
1608                   , Plaintext "use"
1609                   , Whitespace
1610                   , Plaintext "an"
1611                   , Whitespace
1612                   , Plaintext "alternative"
1613                   , Whitespace
1614                   , Plaintext "mapping"
1615                   , Whitespace
1616                   , Plaintext "instead,"
1617                   , Whitespace
1618                   , Plaintext "create"
1619                   , Whitespace
1620                   , Plaintext "a"
1621                   , Whitespace
1622                   , Plaintext "different"
1623                   , Whitespace
1624                   , Plaintext "one"
1625                   , Whitespace
1626                   , Plaintext "in"
1627                   , Whitespace
1628                   , Plaintext "your"
1629                   , Whitespace
1630                   , Link ".vimrc"
1631                   , Whitespace
1632                   , Plaintext "instead"
1633                   , Whitespace
1634                   , Plaintext "using"
1635                   , Whitespace
1636                   , Link ":nmap"
1637                   , Plaintext ":"
1638                   ]
1639               , Fenced
1640                   [ "\" Instead of <leader>a, use <leader>x."
1641                   , "nmap <leader>x <Plug>(FerretAck)"
1642                   ]
1643               ]
1644           , GenericStatement "nmap <unique> <leader>a <Plug>(FerretAck)"
1645           , GenericStatement "endif"
1646           , GenericStatement "nnoremap <Plug>(FerretAck) :Ack<space>"
1647           , GenericStatement
1648               "if !hasmapto('<Plug>FerretLack') && maparg('<leader>l', 'n') ==# ''"
1649           , DocBlock
1650               [ MappingAnnotation "<Plug>(FerretLack)"
1651               , Paragraph
1652                   [ Plaintext "Ferret"
1653                   , Whitespace
1654                   , Plaintext "maps"
1655                   , Whitespace
1656                   , Plaintext "<leader>l"
1657                   , Whitespace
1658                   , Plaintext "to"
1659                   , Whitespace
1660                   , Link "<Plug>(FerretLack)"
1661                   , Plaintext ","
1662                   , Whitespace
1663                   , Plaintext "which"
1664                   , Whitespace
1665                   , Plaintext "triggers"
1666                   , Whitespace
1667                   , Plaintext "the"
1668                   , Whitespace
1669                   , Link ":Lack"
1670                   , Whitespace
1671                   , Plaintext "command."
1672                   , Whitespace
1673                   , Plaintext "To"
1674                   , Whitespace
1675                   , Plaintext "use"
1676                   , Whitespace
1677                   , Plaintext "an"
1678                   , Whitespace
1679                   , Plaintext "alternative"
1680                   , Whitespace
1681                   , Plaintext "mapping"
1682                   , Whitespace
1683                   , Plaintext "instead,"
1684                   , Whitespace
1685                   , Plaintext "create"
1686                   , Whitespace
1687                   , Plaintext "a"
1688                   , Whitespace
1689                   , Plaintext "different"
1690                   , Whitespace
1691                   , Plaintext "one"
1692                   , Whitespace
1693                   , Plaintext "in"
1694                   , Whitespace
1695                   , Plaintext "your"
1696                   , Whitespace
1697                   , Link ".vimrc"
1698                   , Whitespace
1699                   , Plaintext "instead"
1700                   , Whitespace
1701                   , Plaintext "using"
1702                   , Whitespace
1703                   , Link ":nmap"
1704                   , Plaintext ":"
1705                   ]
1706               , Fenced
1707                   [ "\" Instead of <leader>l, use <leader>y."
1708                   , "nmap <leader>y <Plug>(FerretLack)"
1709                   ]
1710               ]
1711           , GenericStatement "nmap <unique> <leader>l <Plug>(FerretLack)"
1712           , GenericStatement "endif"
1713           , GenericStatement "nnoremap <Plug>(FerretLack) :Lack<space>"
1714           , GenericStatement
1715               "if !hasmapto('<Plug>(FerretAckWord)') && maparg('<leader>s', 'n') ==# ''"
1716           , DocBlock
1717               [ MappingAnnotation "<Plug>(FerretAckWord)"
1718               , Paragraph
1719                   [ Plaintext "Ferret"
1720                   , Whitespace
1721                   , Plaintext "maps"
1722                   , Whitespace
1723                   , Plaintext "<leader>s"
1724                   , Whitespace
1725                   , Plaintext "(mnemonix:"
1726                   , Whitespace
1727                   , Plaintext "\"selection)"
1728                   , Whitespace
1729                   , Plaintext "to"
1730                   , Whitespace
1731                   , Link "<Plug>(FerretAckWord)"
1732                   , Plaintext ","
1733                   , Whitespace
1734                   , Plaintext "which"
1735                   , Whitespace
1736                   , Plaintext "uses"
1737                   , Whitespace
1738                   , Link ":Ack"
1739                   , Whitespace
1740                   , Plaintext "to"
1741                   , Whitespace
1742                   , Plaintext "search"
1743                   , Whitespace
1744                   , Plaintext "for"
1745                   , Whitespace
1746                   , Plaintext "the"
1747                   , Whitespace
1748                   , Plaintext "word"
1749                   , Whitespace
1750                   , Plaintext "currently"
1751                   , Whitespace
1752                   , Plaintext "under"
1753                   , Whitespace
1754                   , Plaintext "the"
1755                   , Whitespace
1756                   , Plaintext "cursor."
1757                   , Whitespace
1758                   , Plaintext "To"
1759                   , Whitespace
1760                   , Plaintext "use"
1761                   , Whitespace
1762                   , Plaintext "an"
1763                   , Whitespace
1764                   , Plaintext "alternative"
1765                   , Whitespace
1766                   , Plaintext "mapping"
1767                   , Whitespace
1768                   , Plaintext "instead,"
1769                   , Whitespace
1770                   , Plaintext "create"
1771                   , Whitespace
1772                   , Plaintext "a"
1773                   , Whitespace
1774                   , Plaintext "different"
1775                   , Whitespace
1776                   , Plaintext "one"
1777                   , Whitespace
1778                   , Plaintext "in"
1779                   , Whitespace
1780                   , Plaintext "your"
1781                   , Whitespace
1782                   , Link ".vimrc"
1783                   , Whitespace
1784                   , Plaintext "instead"
1785                   , Whitespace
1786                   , Plaintext "using"
1787                   , Whitespace
1788                   , Link ":nmap"
1789                   , Plaintext ":"
1790                   ]
1791               , Fenced
1792                   [ "\" Instead of <leader>s, use <leader>z."
1793                   , "nmap <leader>z <Plug>(FerretAckWord)"
1794                   ]
1795               ]
1796           , GenericStatement "nmap <unique> <leader>s <Plug>(FerretAckWord)"
1797           , GenericStatement "endif"
1798           , GenericStatement
1799               "nnoremap <Plug>(FerretAckWord) :Ack <C-r><C-w><CR>"
1800           , GenericStatement
1801               "if !hasmapto('<Plug>(FerretAcks)') && maparg('<leader>r', 'n') ==# ''"
1802           , DocBlock
1803               [ MappingAnnotation "*<Plug>(FerretAcks)*"
1804               , Paragraph
1805                   [ Plaintext "Ferret"
1806                   , Whitespace
1807                   , Plaintext "maps"
1808                   , Whitespace
1809                   , Plaintext "<leader>r"
1810                   , Whitespace
1811                   , Plaintext "(mnemonic:"
1812                   , Whitespace
1813                   , Plaintext "\"replace\")"
1814                   , Whitespace
1815                   , Plaintext "to"
1816                   , Whitespace
1817                   , Link "<Plug>(FerretAcks)"
1818                   , Plaintext ","
1819                   , Whitespace
1820                   , Plaintext "which"
1821                   , Whitespace
1822                   , Plaintext "triggers"
1823                   , Whitespace
1824                   , Plaintext "the"
1825                   , Whitespace
1826                   , Link ":Acks"
1827                   , Whitespace
1828                   , Plaintext "command"
1829                   , Whitespace
1830                   , Plaintext "and"
1831                   , Whitespace
1832                   , Plaintext "fills"
1833                   , Whitespace
1834                   , Plaintext "the"
1835                   , Whitespace
1836                   , Plaintext "prompt"
1837                   , Whitespace
1838                   , Plaintext "with"
1839                   , Whitespace
1840                   , Plaintext "the"
1841                   , Whitespace
1842                   , Plaintext "last"
1843                   , Whitespace
1844                   , Plaintext "search"
1845                   , Whitespace
1846                   , Plaintext "term"
1847                   , Whitespace
1848                   , Plaintext "from"
1849                   , Whitespace
1850                   , Plaintext "Ferret."
1851                   , Whitespace
1852                   , Plaintext "to"
1853                   , Whitespace
1854                   , Plaintext "use"
1855                   , Whitespace
1856                   , Plaintext "an"
1857                   , Whitespace
1858                   , Plaintext "alternative"
1859                   , Whitespace
1860                   , Plaintext "mapping"
1861                   , Whitespace
1862                   , Plaintext "instead,"
1863                   , Whitespace
1864                   , Plaintext "create"
1865                   , Whitespace
1866                   , Plaintext "a"
1867                   , Whitespace
1868                   , Plaintext "different"
1869                   , Whitespace
1870                   , Plaintext "one"
1871                   , Whitespace
1872                   , Plaintext "in"
1873                   , Whitespace
1874                   , Plaintext "your"
1875                   , Whitespace
1876                   , Link ".vimrc"
1877                   , Whitespace
1878                   , Plaintext "instead"
1879                   , Whitespace
1880                   , Plaintext "using"
1881                   , Whitespace
1882                   , Link ":nmap"
1883                   , Plaintext ":"
1884                   ]
1885               , Fenced
1886                   [ "\" Instead of <leader>r, use <leader>u."
1887                   , "nmap <leader>u <Plug>(FerretAcks)"
1888                   ]
1889               ]
1890           , GenericStatement "nmap <unique> <leader>r <Plug>(FerretAcks)"
1891           , GenericStatement "endif"
1892           , GenericStatement
1893               "nnoremap <Plug>(FerretAcks) :Acks <c-r>=(exists('g:ferret_lastsearch') ? '/' . g:ferret_lastsearch . '//' : ' ')<CR><Left>"
1894           , GenericStatement "endif"
1895           , DocBlock
1896               [ CommandAnnotation ":Qargs"
1897               , Paragraph
1898                   [ Plaintext "This"
1899                   , Whitespace
1900                   , Plaintext "is"
1901                   , Whitespace
1902                   , Plaintext "a"
1903                   , Whitespace
1904                   , Plaintext "utility"
1905                   , Whitespace
1906                   , Plaintext "function"
1907                   , Whitespace
1908                   , Plaintext "that"
1909                   , Whitespace
1910                   , Plaintext "is"
1911                   , Whitespace
1912                   , Plaintext "used"
1913                   , Whitespace
1914                   , Plaintext "by"
1915                   , Whitespace
1916                   , Plaintext "the"
1917                   , Whitespace
1918                   , Link ":Acks"
1919                   , Whitespace
1920                   , Plaintext "command"
1921                   , Whitespace
1922                   , Plaintext "but"
1923                   , Whitespace
1924                   , Plaintext "is"
1925                   , Whitespace
1926                   , Plaintext "also"
1927                   , Whitespace
1928                   , Plaintext "generally"
1929                   , Whitespace
1930                   , Plaintext "useful"
1931                   , Whitespace
1932                   , Plaintext "enough"
1933                   , Whitespace
1934                   , Plaintext "to"
1935                   , Whitespace
1936                   , Plaintext "warrant"
1937                   , Whitespace
1938                   , Plaintext "being"
1939                   , Whitespace
1940                   , Plaintext "exposed"
1941                   , Whitespace
1942                   , Plaintext "publicly."
1943                   ]
1944               , Paragraph
1945                   [ Plaintext "It"
1946                   , Whitespace
1947                   , Plaintext "takes"
1948                   , Whitespace
1949                   , Plaintext "the"
1950                   , Whitespace
1951                   , Plaintext "files"
1952                   , Whitespace
1953                   , Plaintext "currently"
1954                   , Whitespace
1955                   , Plaintext "in"
1956                   , Whitespace
1957                   , Plaintext "the"
1958                   , Whitespace
1959                   , Link "quickfix"
1960                   , Whitespace
1961                   , Plaintext "listing"
1962                   , Whitespace
1963                   , Plaintext "and"
1964                   , Whitespace
1965                   , Plaintext "sets"
1966                   , Whitespace
1967                   , Plaintext "them"
1968                   , Whitespace
1969                   , Plaintext "as"
1970                   , Whitespace
1971                   , Link ":args"
1972                   , Whitespace
1973                   , Plaintext "so"
1974                   , Whitespace
1975                   , Plaintext "that"
1976                   , Whitespace
1977                   , Plaintext "they"
1978                   , Whitespace
1979                   , Plaintext "can"
1980                   , Whitespace
1981                   , Plaintext "be"
1982                   , Whitespace
1983                   , Plaintext "operated"
1984                   , Whitespace
1985                   , Plaintext "on"
1986                   , Whitespace
1987                   , Plaintext "en"
1988                   , Whitespace
1989                   , Plaintext "masse"
1990                   , Whitespace
1991                   , Plaintext "via"
1992                   , Whitespace
1993                   , Plaintext "the"
1994                   , Whitespace
1995                   , Link ":argdo"
1996                   , Whitespace
1997                   , Plaintext "command."
1998                   ]
1999               ]
2000           , GenericStatement
2001               "command! -bar Qargs execute 'args' ferret#private#qargs()"
2002           , DocBlock
2003               [ OptionAnnotation "g:FerretQFCommands" "boolean" (Just "1")
2004               , Paragraph
2005                   [ Plaintext "Controls"
2006                   , Whitespace
2007                   , Plaintext "whether"
2008                   , Whitespace
2009                   , Plaintext "to"
2010                   , Whitespace
2011                   , Plaintext "set"
2012                   , Whitespace
2013                   , Plaintext "up"
2014                   , Whitespace
2015                   , Plaintext "custom"
2016                   , Whitespace
2017                   , Plaintext "versions"
2018                   , Whitespace
2019                   , Plaintext "of"
2020                   , Whitespace
2021                   , Plaintext "the"
2022                   , Whitespace
2023                   , Link "quickfix"
2024                   , Whitespace
2025                   , Plaintext "commands,"
2026                   , Whitespace
2027                   , Link ":cn"
2028                   , Plaintext ","
2029                   , Whitespace
2030                   , Link ":cnf"
2031                   , Plaintext ","
2032                   , Whitespace
2033                   , Link ":cp"
2034                   , Whitespace
2035                   , Plaintext "an"
2036                   , Whitespace
2037                   , Link ":cpf"
2038                   , Plaintext "."
2039                   , Whitespace
2040                   , Plaintext "These"
2041                   , Whitespace
2042                   , Plaintext "overrides"
2043                   , Whitespace
2044                   , Plaintext "vertically"
2045                   , Whitespace
2046                   , Plaintext "center"
2047                   , Whitespace
2048                   , Plaintext "the"
2049                   , Whitespace
2050                   , Plaintext "match"
2051                   , Whitespace
2052                   , Plaintext "within"
2053                   , Whitespace
2054                   , Plaintext "the"
2055                   , Whitespace
2056                   , Plaintext "viewport"
2057                   , Whitespace
2058                   , Plaintext "on"
2059                   , Whitespace
2060                   , Plaintext "each"
2061                   , Whitespace
2062                   , Plaintext "jump."
2063                   , Whitespace
2064                   , Plaintext "To"
2065                   , Whitespace
2066                   , Plaintext "prevent"
2067                   , Whitespace
2068                   , Plaintext "the"
2069                   , Whitespace
2070                   , Plaintext "custom"
2071                   , Whitespace
2072                   , Plaintext "versions"
2073                   , Whitespace
2074                   , Plaintext "from"
2075                   , Whitespace
2076                   , Plaintext "being"
2077                   , Whitespace
2078                   , Plaintext "configured,"
2079                   , Whitespace
2080                   , Plaintext "set"
2081                   , Whitespace
2082                   , Plaintext "to"
2083                   , Whitespace
2084                   , Plaintext "0:"
2085                   ]
2086               , Fenced [ "let g:FerretQFCommands=0" ]
2087               ]
2088           , LetStatement
2089               { letLexpr = "s:commands"
2090               , letValue = "get(g:, 'FerretQFCommands', 1)"
2091               }
2092           , GenericStatement "if s:commands"
2093           , GenericStatement
2094               "cabbrev <silent> <expr> cn ((getcmdtype() == ':' && getcmdpos() == 3) ? 'cn <bar> normal zz' : 'cn')"
2095           , GenericStatement
2096               "cabbrev <silent> <expr> cnf ((getcmdtype() == ':' && getcmdpos() == 4) ? 'cnf <bar> normal zz' : 'cnf')"
2097           , GenericStatement
2098               "cabbrev <silent> <expr> cp ((getcmdtype() == ':' && getcmdpos() == 3) ? 'cp <bar> normal zz' : 'cp')"
2099           , GenericStatement
2100               "cabbrev <silent> <expr> cpf ((getcmdtype() == ':' && getcmdpos() == 4) ? 'cpf <bar> normal zz' : 'cpf')"
2101           , GenericStatement "endif"
2102           , LetStatement
2103               { letLexpr = "&cpoptions " , letValue = "s:cpoptions" }
2104           , UnletStatement { unletBang = False , unletBody = "s:cpoptions" }
2105           ]
2106       ]
2107   , MappingsAnnotation
2108   , SubheadingAnnotation
2109       "Circumstances where mappings do not get set up"
2110   , Paragraph
2111       [ Plaintext "Note"
2112       , Whitespace
2113       , Plaintext "that"
2114       , Whitespace
2115       , Plaintext "Ferret"
2116       , Whitespace
2117       , Plaintext "will"
2118       , Whitespace
2119       , Plaintext "not"
2120       , Whitespace
2121       , Plaintext "try"
2122       , Whitespace
2123       , Plaintext "to"
2124       , Whitespace
2125       , Plaintext "set"
2126       , Whitespace
2127       , Plaintext "up"
2128       , Whitespace
2129       , Plaintext "the"
2130       , Whitespace
2131       , Plaintext "<leader>"
2132       , Whitespace
2133       , Plaintext "mappings"
2134       , Whitespace
2135       , Plaintext "if"
2136       , Whitespace
2137       , Plaintext "any"
2138       , Whitespace
2139       , Plaintext "of"
2140       , Whitespace
2141       , Plaintext "the"
2142       , Whitespace
2143       , Plaintext "following"
2144       , Whitespace
2145       , Plaintext "are"
2146       , Whitespace
2147       , Plaintext "true:"
2148       ]
2149   , List
2150       [ ListItem
2151           [ Plaintext "A"
2152           , Whitespace
2153           , Plaintext "mapping"
2154           , Whitespace
2155           , Plaintext "for"
2156           , Whitespace
2157           , Plaintext "already"
2158           , Whitespace
2159           , Plaintext "exists."
2160           ]
2161       , ListItem
2162           [ Plaintext "An"
2163           , Whitespace
2164           , Plaintext "alternative"
2165           , Whitespace
2166           , Plaintext "mapping"
2167           , Whitespace
2168           , Plaintext "for"
2169           , Whitespace
2170           , Plaintext "the"
2171           , Whitespace
2172           , Plaintext "same"
2173           , Whitespace
2174           , Plaintext "functionality"
2175           , Whitespace
2176           , Plaintext "has"
2177           , Whitespace
2178           , Plaintext "already"
2179           , Whitespace
2180           , Plaintext "been"
2181           , Whitespace
2182           , Plaintext "set"
2183           , Whitespace
2184           , Plaintext "up"
2185           , Whitespace
2186           , Plaintext "from"
2187           , Whitespace
2188           , Plaintext "a"
2189           , Whitespace
2190           , Link ".vimrc"
2191           , Plaintext "."
2192           ]
2193       , ListItem
2194           [ Plaintext "The"
2195           , Whitespace
2196           , Plaintext "mapping"
2197           , Whitespace
2198           , Plaintext "has"
2199           , Whitespace
2200           , Plaintext "been"
2201           , Whitespace
2202           , Plaintext "suppressed"
2203           , Whitespace
2204           , Plaintext "by"
2205           , Whitespace
2206           , Plaintext "setting"
2207           , Whitespace
2208           , Link "g:FerretMap"
2209           , Whitespace
2210           , Plaintext "to"
2211           , Whitespace
2212           , Plaintext "1"
2213           , Whitespace
2214           , Plaintext "in"
2215           , Whitespace
2216           , Plaintext "your"
2217           , Whitespace
2218           , Link ".vimrc"
2219           , Plaintext "."
2220           ]
2221       ]
2222   , SubheadingAnnotation "Mappings specific to the quickfix window"
2223   , Paragraph
2224       [ Plaintext "Additionally,"
2225       , Whitespace
2226       , Plaintext "Ferret"
2227       , Whitespace
2228       , Plaintext "will"
2229       , Whitespace
2230       , Plaintext "set"
2231       , Whitespace
2232       , Plaintext "up"
2233       , Whitespace
2234       , Plaintext "special"
2235       , Whitespace
2236       , Plaintext "mappings"
2237       , Whitespace
2238       , Plaintext "in"
2239       , Whitespace
2240       , Link "quickfix"
2241       , Whitespace
2242       , Plaintext "listings,"
2243       , Whitespace
2244       , Plaintext "unless"
2245       , Whitespace
2246       , Plaintext "prevented"
2247       , Whitespace
2248       , Plaintext "from"
2249       , Whitespace
2250       , Plaintext "doing"
2251       , Whitespace
2252       , Plaintext "so"
2253       , Whitespace
2254       , Plaintext "by"
2255       , Whitespace
2256       , Link "g:FerretQFMap"
2257       , Plaintext ":"
2258       ]
2259   , List
2260       [ ListItem
2261           [ Code "d"
2262           , Whitespace
2263           , Plaintext "("
2264           , Link "visual-mode"
2265           , Plaintext "):"
2266           , Whitespace
2267           , Plaintext "delete"
2268           , Whitespace
2269           , Plaintext "visual"
2270           , Whitespace
2271           , Plaintext "selection"
2272           ]
2273       , ListItem
2274           [ Code "dd"
2275           , Whitespace
2276           , Plaintext "("
2277           , Link "Normal-mode"
2278           , Plaintext "):"
2279           , Whitespace
2280           , Plaintext "delete"
2281           , Whitespace
2282           , Plaintext "current"
2283           , Whitespace
2284           , Plaintext "line"
2285           ]
2286       , ListItem
2287           [ Code "d"
2288           , Plaintext "{motion}"
2289           , Whitespace
2290           , Plaintext "("
2291           , Link "Normal-mode"
2292           , Plaintext "):"
2293           , Whitespace
2294           , Plaintext "delete"
2295           , Whitespace
2296           , Plaintext "range"
2297           , Whitespace
2298           , Plaintext "indicated"
2299           , Whitespace
2300           , Plaintext "by"
2301           , Whitespace
2302           , Plaintext "{motion}"
2303           ]
2304       ]
2305   , FooterAnnotation
2306   , HeadingAnnotation "Custom autocommands"
2307   , LinkTargets [ "FerretWillWrite" , "FerretDidWrite" ]
2308   , Paragraph
2309       [ Plaintext "For"
2310       , Whitespace
2311       , Plaintext "maximum"
2312       , Whitespace
2313       , Plaintext "compatibility"
2314       , Whitespace
2315       , Plaintext "with"
2316       , Whitespace
2317       , Plaintext "other"
2318       , Whitespace
2319       , Plaintext "plug-ins,"
2320       , Whitespace
2321       , Plaintext "Ferret"
2322       , Whitespace
2323       , Plaintext "runs"
2324       , Whitespace
2325       , Plaintext "the"
2326       , Whitespace
2327       , Plaintext "following"
2328       , Whitespace
2329       , Plaintext "\"User\""
2330       , Whitespace
2331       , Plaintext "autocommands"
2332       , Whitespace
2333       , Plaintext "before"
2334       , Whitespace
2335       , Plaintext "and"
2336       , Whitespace
2337       , Plaintext "after"
2338       , Whitespace
2339       , Plaintext "running"
2340       , Whitespace
2341       , Plaintext "the"
2342       , Whitespace
2343       , Plaintext "file"
2344       , Whitespace
2345       , Plaintext "writing"
2346       , Whitespace
2347       , Plaintext "operations"
2348       , Whitespace
2349       , Plaintext "during"
2350       , Whitespace
2351       , Link ":Acks"
2352       , Plaintext ":"
2353       ]
2354   , List
2355       [ ListItem [ Plaintext "FerretWillWrite" ]
2356       , ListItem [ Plaintext "FerretDidWrite" ]
2357       ]
2358   , Paragraph
2359       [ Plaintext "For"
2360       , Whitespace
2361       , Plaintext "example,"
2362       , Whitespace
2363       , Plaintext "to"
2364       , Whitespace
2365       , Plaintext "call"
2366       , Whitespace
2367       , Plaintext "a"
2368       , Whitespace
2369       , Plaintext "pair"
2370       , Whitespace
2371       , Plaintext "of"
2372       , Whitespace
2373       , Plaintext "custom"
2374       , Whitespace
2375       , Plaintext "functions"
2376       , Whitespace
2377       , Plaintext "in"
2378       , Whitespace
2379       , Plaintext "response"
2380       , Whitespace
2381       , Plaintext "to"
2382       , Whitespace
2383       , Plaintext "these"
2384       , Whitespace
2385       , Plaintext "events,"
2386       , Whitespace
2387       , Plaintext "you"
2388       , Whitespace
2389       , Plaintext "might"
2390       , Whitespace
2391       , Plaintext "do:"
2392       ]
2393   , Fenced
2394       [ "autocmd! User FerretWillWrite"
2395       , "autocmd User FerretWillWrite call CustomWillWrite()"
2396       , "autocmd! User FerretDidWrite"
2397       , "autocmd User FerretDidWrite call CustomDidWrite()"
2398       ]
2399   , HeadingAnnotation "Overrides"
2400   , Paragraph
2401       [ Plaintext "Ferret"
2402       , Whitespace
2403       , Plaintext "overrides"
2404       , Whitespace
2405       , Plaintext "the"
2406       , Whitespace
2407       , Plaintext "'grepformat'"
2408       , Whitespace
2409       , Plaintext "and"
2410       , Whitespace
2411       , Plaintext "'grepprg'"
2412       , Whitespace
2413       , Plaintext "settings,"
2414       , Whitespace
2415       , Plaintext "preferentially"
2416       , Whitespace
2417       , Plaintext "setting"
2418       , Whitespace
2419       , Code "ag"
2420       , Plaintext ","
2421       , Whitespace
2422       , Code "ack"
2423       , Whitespace
2424       , Plaintext "or"
2425       , Whitespace
2426       , Code "grep"
2427       , Whitespace
2428       , Plaintext "as"
2429       , Whitespace
2430       , Plaintext "the"
2431       , Whitespace
2432       , Plaintext "'grepprg'"
2433       , Whitespace
2434       , Plaintext "(in"
2435       , Whitespace
2436       , Plaintext "that"
2437       , Whitespace
2438       , Plaintext "order)"
2439       , Whitespace
2440       , Plaintext "and"
2441       , Whitespace
2442       , Plaintext "configuring"
2443       , Whitespace
2444       , Plaintext "a"
2445       , Whitespace
2446       , Plaintext "suitable"
2447       , Whitespace
2448       , Plaintext "'grepformat'."
2449       ]
2450   , Paragraph
2451       [ Plaintext "Additionally,"
2452       , Whitespace
2453       , Plaintext "Ferret"
2454       , Whitespace
2455       , Plaintext "includes"
2456       , Whitespace
2457       , Plaintext "an"
2458       , Whitespace
2459       , Link "ftplugin"
2460       , Whitespace
2461       , Plaintext "for"
2462       , Whitespace
2463       , Plaintext "the"
2464       , Whitespace
2465       , Link "quickfix"
2466       , Whitespace
2467       , Plaintext "listing"
2468       , Whitespace
2469       , Plaintext "that"
2470       , Whitespace
2471       , Plaintext "adjusts"
2472       , Whitespace
2473       , Plaintext "a"
2474       , Whitespace
2475       , Plaintext "number"
2476       , Whitespace
2477       , Plaintext "of"
2478       , Whitespace
2479       , Plaintext "settings"
2480       , Whitespace
2481       , Plaintext "to"
2482       , Whitespace
2483       , Plaintext "improve"
2484       , Whitespace
2485       , Plaintext "the"
2486       , Whitespace
2487       , Plaintext "usability"
2488       , Whitespace
2489       , Plaintext "of"
2490       , Whitespace
2491       , Plaintext "search"
2492       , Whitespace
2493       , Plaintext "results."
2494       ]
2495   , IndentAnnotation
2496   , LinkTargets [ "ferret-nolist" ]
2497   , Paragraph [ Plaintext "'nolist'" ]
2498   , Paragraph
2499       [ Plaintext "Turned"
2500       , Whitespace
2501       , Plaintext "off"
2502       , Whitespace
2503       , Plaintext "to"
2504       , Whitespace
2505       , Plaintext "reduce"
2506       , Whitespace
2507       , Plaintext "visual"
2508       , Whitespace
2509       , Plaintext "clutter"
2510       , Whitespace
2511       , Plaintext "in"
2512       , Whitespace
2513       , Plaintext "the"
2514       , Whitespace
2515       , Plaintext "search"
2516       , Whitespace
2517       , Plaintext "results,"
2518       , Whitespace
2519       , Plaintext "and"
2520       , Whitespace
2521       , Plaintext "because"
2522       , Whitespace
2523       , Plaintext "'list'"
2524       , Whitespace
2525       , Plaintext "is"
2526       , Whitespace
2527       , Plaintext "most"
2528       , Whitespace
2529       , Plaintext "useful"
2530       , Whitespace
2531       , Plaintext "in"
2532       , Whitespace
2533       , Plaintext "files"
2534       , Whitespace
2535       , Plaintext "that"
2536       , Whitespace
2537       , Plaintext "are"
2538       , Whitespace
2539       , Plaintext "being"
2540       , Whitespace
2541       , Plaintext "actively"
2542       , Whitespace
2543       , Plaintext "edited,"
2544       , Whitespace
2545       , Plaintext "which"
2546       , Whitespace
2547       , Plaintext "is"
2548       , Whitespace
2549       , Plaintext "not"
2550       , Whitespace
2551       , Plaintext "the"
2552       , Whitespace
2553       , Plaintext "case"
2554       , Whitespace
2555       , Plaintext "for"
2556       , Whitespace
2557       , Link "quickfix"
2558       , Whitespace
2559       , Plaintext "results."
2560       ]
2561   , LinkTargets [ "ferret-norelativenumber" ]
2562   , Paragraph [ Plaintext "'norelativenumber'" ]
2563   , Paragraph
2564       [ Plaintext "Turned"
2565       , Whitespace
2566       , Plaintext "off,"
2567       , Whitespace
2568       , Plaintext "because"
2569       , Whitespace
2570       , Plaintext "it"
2571       , Whitespace
2572       , Plaintext "is"
2573       , Whitespace
2574       , Plaintext "more"
2575       , Whitespace
2576       , Plaintext "useful"
2577       , Whitespace
2578       , Plaintext "to"
2579       , Whitespace
2580       , Plaintext "have"
2581       , Whitespace
2582       , Plaintext "a"
2583       , Whitespace
2584       , Plaintext "sense"
2585       , Whitespace
2586       , Plaintext "of"
2587       , Whitespace
2588       , Plaintext "absolute"
2589       , Whitespace
2590       , Plaintext "progress"
2591       , Whitespace
2592       , Plaintext "through"
2593       , Whitespace
2594       , Plaintext "the"
2595       , Whitespace
2596       , Plaintext "results"
2597       , Whitespace
2598       , Plaintext "list"
2599       , Whitespace
2600       , Plaintext "than"
2601       , Whitespace
2602       , Plaintext "to"
2603       , Whitespace
2604       , Plaintext "have"
2605       , Whitespace
2606       , Plaintext "the"
2607       , Whitespace
2608       , Plaintext "ability"
2609       , Whitespace
2610       , Plaintext "to"
2611       , Whitespace
2612       , Plaintext "jump"
2613       , Whitespace
2614       , Plaintext "to"
2615       , Whitespace
2616       , Plaintext "nearby"
2617       , Whitespace
2618       , Plaintext "results"
2619       , Whitespace
2620       , Plaintext "(especially"
2621       , Whitespace
2622       , Plaintext "seeing"
2623       , Whitespace
2624       , Plaintext "as"
2625       , Whitespace
2626       , Plaintext "the"
2627       , Whitespace
2628       , Plaintext "most"
2629       , Whitespace
2630       , Plaintext "common"
2631       , Whitespace
2632       , Plaintext "operations"
2633       , Whitespace
2634       , Plaintext "are"
2635       , Whitespace
2636       , Plaintext "moving"
2637       , Whitespace
2638       , Plaintext "to"
2639       , Whitespace
2640       , Plaintext "the"
2641       , Whitespace
2642       , Plaintext "next"
2643       , Whitespace
2644       , Plaintext "or"
2645       , Whitespace
2646       , Plaintext "previous"
2647       , Whitespace
2648       , Plaintext "file,"
2649       , Whitespace
2650       , Plaintext "which"
2651       , Whitespace
2652       , Plaintext "are"
2653       , Whitespace
2654       , Plaintext "both"
2655       , Whitespace
2656       , Plaintext "handled"
2657       , Whitespace
2658       , Plaintext "nicely"
2659       , Whitespace
2660       , Plaintext "by"
2661       , Whitespace
2662       , Link ":cnf"
2663       , Whitespace
2664       , Plaintext "and"
2665       , Whitespace
2666       , Link ":cpf"
2667       , Whitespace
2668       , Plaintext "respectively)."
2669       ]
2670   , LinkTargets [ "ferret-nowrap" ]
2671   , Paragraph [ Plaintext "'nowrap'" ]
2672   , Paragraph
2673       [ Plaintext "Turned"
2674       , Whitespace
2675       , Plaintext "off"
2676       , Whitespace
2677       , Plaintext "to"
2678       , Whitespace
2679       , Plaintext "avoid"
2680       , Whitespace
2681       , Plaintext "ugly"
2682       , Whitespace
2683       , Plaintext "wrapping"
2684       , Whitespace
2685       , Plaintext "that"
2686       , Whitespace
2687       , Plaintext "makes"
2688       , Whitespace
2689       , Plaintext "the"
2690       , Whitespace
2691       , Plaintext "results"
2692       , Whitespace
2693       , Plaintext "list"
2694       , Whitespace
2695       , Plaintext "hard"
2696       , Whitespace
2697       , Plaintext "to"
2698       , Whitespace
2699       , Plaintext "read,"
2700       , Whitespace
2701       , Plaintext "and"
2702       , Whitespace
2703       , Plaintext "because"
2704       , Whitespace
2705       , Plaintext "in"
2706       , Whitespace
2707       , Plaintext "search"
2708       , Whitespace
2709       , Plaintext "results,"
2710       , Whitespace
2711       , Plaintext "the"
2712       , Whitespace
2713       , Plaintext "most"
2714       , Whitespace
2715       , Plaintext "relevant"
2716       , Whitespace
2717       , Plaintext "information"
2718       , Whitespace
2719       , Plaintext "is"
2720       , Whitespace
2721       , Plaintext "the"
2722       , Whitespace
2723       , Plaintext "filename,"
2724       , Whitespace
2725       , Plaintext "which"
2726       , Whitespace
2727       , Plaintext "is"
2728       , Whitespace
2729       , Plaintext "on"
2730       , Whitespace
2731       , Plaintext "the"
2732       , Whitespace
2733       , Plaintext "left"
2734       , Whitespace
2735       , Plaintext "and"
2736       , Whitespace
2737       , Plaintext "is"
2738       , Whitespace
2739       , Plaintext "usually"
2740       , Whitespace
2741       , Plaintext "visible"
2742       , Whitespace
2743       , Plaintext "even"
2744       , Whitespace
2745       , Plaintext "without"
2746       , Whitespace
2747       , Plaintext "wrapping."
2748       ]
2749   , LinkTargets [ "ferret-number" ]
2750   , Paragraph [ Plaintext "'number'" ]
2751   , Paragraph
2752       [ Plaintext "Turned"
2753       , Whitespace
2754       , Plaintext "on"
2755       , Whitespace
2756       , Plaintext "to"
2757       , Whitespace
2758       , Plaintext "give"
2759       , Whitespace
2760       , Plaintext "a"
2761       , Whitespace
2762       , Plaintext "sense"
2763       , Whitespace
2764       , Plaintext "of"
2765       , Whitespace
2766       , Plaintext "absolute"
2767       , Whitespace
2768       , Plaintext "progress"
2769       , Whitespace
2770       , Plaintext "through"
2771       , Whitespace
2772       , Plaintext "the"
2773       , Whitespace
2774       , Plaintext "results."
2775       ]
2776   , LinkTargets [ "ferret-scrolloff" ]
2777   , Paragraph [ Plaintext "'scrolloff'" ]
2778   , Paragraph
2779       [ Plaintext "Set"
2780       , Whitespace
2781       , Plaintext "to"
2782       , Whitespace
2783       , Plaintext "0"
2784       , Whitespace
2785       , Plaintext "because"
2786       , Whitespace
2787       , Plaintext "the"
2788       , Whitespace
2789       , Link "quickfix"
2790       , Whitespace
2791       , Plaintext "listing"
2792       , Whitespace
2793       , Plaintext "is"
2794       , Whitespace
2795       , Plaintext "usually"
2796       , Whitespace
2797       , Plaintext "small"
2798       , Whitespace
2799       , Plaintext "by"
2800       , Whitespace
2801       , Plaintext "default,"
2802       , Whitespace
2803       , Plaintext "so"
2804       , Whitespace
2805       , Plaintext "trying"
2806       , Whitespace
2807       , Plaintext "to"
2808       , Whitespace
2809       , Plaintext "keep"
2810       , Whitespace
2811       , Plaintext "the"
2812       , Whitespace
2813       , Plaintext "current"
2814       , Whitespace
2815       , Plaintext "line"
2816       , Whitespace
2817       , Plaintext "away"
2818       , Whitespace
2819       , Plaintext "from"
2820       , Whitespace
2821       , Plaintext "the"
2822       , Whitespace
2823       , Plaintext "edge"
2824       , Whitespace
2825       , Plaintext "of"
2826       , Whitespace
2827       , Plaintext "the"
2828       , Whitespace
2829       , Plaintext "viewpoint"
2830       , Whitespace
2831       , Plaintext "is"
2832       , Whitespace
2833       , Plaintext "futile;"
2834       , Whitespace
2835       , Plaintext "by"
2836       , Whitespace
2837       , Plaintext "definition"
2838       , Whitespace
2839       , Plaintext "it"
2840       , Whitespace
2841       , Plaintext "is"
2842       , Whitespace
2843       , Plaintext "usually"
2844       , Whitespace
2845       , Plaintext "near"
2846       , Whitespace
2847       , Plaintext "the"
2848       , Whitespace
2849       , Plaintext "edge."
2850       ]
2851   , LinkTargets [ "ferret-nocursorline" ]
2852   , Paragraph [ Plaintext "'nocursorline'" ]
2853   , Paragraph
2854       [ Plaintext "Turned"
2855       , Whitespace
2856       , Plaintext "off"
2857       , Whitespace
2858       , Plaintext "to"
2859       , Whitespace
2860       , Plaintext "reduce"
2861       , Whitespace
2862       , Plaintext "visual"
2863       , Whitespace
2864       , Plaintext "clutter."
2865       ]
2866   , DedentAnnotation
2867   , Paragraph
2868       [ Plaintext "To"
2869       , Whitespace
2870       , Plaintext "prevent"
2871       , Whitespace
2872       , Plaintext "any"
2873       , Whitespace
2874       , Plaintext "of"
2875       , Whitespace
2876       , Plaintext "these"
2877       , Whitespace
2878       , Link "quickfix"
2879       , Plaintext "-specific"
2880       , Whitespace
2881       , Plaintext "overrides"
2882       , Whitespace
2883       , Plaintext "from"
2884       , Whitespace
2885       , Plaintext "being"
2886       , Whitespace
2887       , Plaintext "set"
2888       , Whitespace
2889       , Plaintext "up,"
2890       , Whitespace
2891       , Plaintext "you"
2892       , Whitespace
2893       , Plaintext "can"
2894       , Whitespace
2895       , Plaintext "set"
2896       , Whitespace
2897       , Link "g:FerretQFOptions"
2898       , Whitespace
2899       , Plaintext "to"
2900       , Whitespace
2901       , Plaintext "0"
2902       , Whitespace
2903       , Plaintext "in"
2904       , Whitespace
2905       , Plaintext "your"
2906       , Whitespace
2907       , Link ".vimrc"
2908       , Plaintext ":"
2909       ]
2910   , Fenced [ "let g:FerretQFOptions=0" ]
2911   , HeadingAnnotation "Troubleshooting"
2912   , LinkTargets [ "ferret-quotes" ]
2913   , SubheadingAnnotation
2914       "Ferret fails to find patterns containing spaces"
2915   , Paragraph
2916       [ Plaintext "As"
2917       , Whitespace
2918       , Plaintext "described"
2919       , Whitespace
2920       , Plaintext "in"
2921       , Whitespace
2922       , Plaintext "the"
2923       , Whitespace
2924       , Plaintext "documentation"
2925       , Whitespace
2926       , Plaintext "for"
2927       , Whitespace
2928       , Link ":Ack"
2929       , Plaintext ","
2930       , Whitespace
2931       , Plaintext "the"
2932       , Whitespace
2933       , Plaintext "search"
2934       , Whitespace
2935       , Plaintext "pattern"
2936       , Whitespace
2937       , Plaintext "is"
2938       , Whitespace
2939       , Plaintext "passed"
2940       , Whitespace
2941       , Plaintext "through"
2942       , Whitespace
2943       , Plaintext "as-is"
2944       , Whitespace
2945       , Plaintext "to"
2946       , Whitespace
2947       , Plaintext "the"
2948       , Whitespace
2949       , Plaintext "underlying"
2950       , Whitespace
2951       , Plaintext "search"
2952       , Whitespace
2953       , Plaintext "command,"
2954       , Whitespace
2955       , Plaintext "and"
2956       , Whitespace
2957       , Plaintext "no"
2958       , Whitespace
2959       , Plaintext "escaping"
2960       , Whitespace
2961       , Plaintext "is"
2962       , Whitespace
2963       , Plaintext "required"
2964       , Whitespace
2965       , Plaintext "other"
2966       , Whitespace
2967       , Plaintext "than"
2968       , Whitespace
2969       , Plaintext "preceding"
2970       , Whitespace
2971       , Plaintext "spaces"
2972       , Whitespace
2973       , Plaintext "by"
2974       , Whitespace
2975       , Plaintext "a"
2976       , Whitespace
2977       , Plaintext "single"
2978       , Whitespace
2979       , Plaintext "backslash."
2980       ]
2981   , Paragraph
2982       [ Plaintext "So,"
2983       , Whitespace
2984       , Plaintext "to"
2985       , Whitespace
2986       , Plaintext "find"
2987       , Whitespace
2988       , Plaintext "\"foo"
2989       , Whitespace
2990       , Plaintext "bar\","
2991       , Whitespace
2992       , Plaintext "you"
2993       , Whitespace
2994       , Plaintext "would"
2995       , Whitespace
2996       , Plaintext "search"
2997       , Whitespace
2998       , Plaintext "like:"
2999       ]
3000   , Fenced [ ":Ack foo\\ bar" ]
3001   , Paragraph
3002       [ Plaintext "Unescaped"
3003       , Whitespace
3004       , Plaintext "spaces"
3005       , Whitespace
3006       , Plaintext "in"
3007       , Whitespace
3008       , Plaintext "the"
3009       , Whitespace
3010       , Plaintext "search"
3011       , Whitespace
3012       , Plaintext "are"
3013       , Whitespace
3014       , Plaintext "treated"
3015       , Whitespace
3016       , Plaintext "as"
3017       , Whitespace
3018       , Plaintext "argument"
3019       , Whitespace
3020       , Plaintext "separators,"
3021       , Whitespace
3022       , Plaintext "so"
3023       , Whitespace
3024       , Plaintext "a"
3025       , Whitespace
3026       , Plaintext "command"
3027       , Whitespace
3028       , Plaintext "like"
3029       , Whitespace
3030       , Plaintext "the"
3031       , Whitespace
3032       , Plaintext "following"
3033       , Whitespace
3034       , Plaintext "means"
3035       , Whitespace
3036       , Plaintext "pass"
3037       , Whitespace
3038       , Plaintext "the"
3039       , Whitespace
3040       , Code "-w"
3041       , Whitespace
3042       , Plaintext "option"
3043       , Whitespace
3044       , Plaintext "through,"
3045       , Whitespace
3046       , Plaintext "search"
3047       , Whitespace
3048       , Plaintext "for"
3049       , Whitespace
3050       , Plaintext "pattern"
3051       , Whitespace
3052       , Plaintext "\"foo\","
3053       , Whitespace
3054       , Plaintext "and"
3055       , Whitespace
3056       , Plaintext "limit"
3057       , Whitespace
3058       , Plaintext "search"
3059       , Whitespace
3060       , Plaintext "to"
3061       , Whitespace
3062       , Plaintext "the"
3063       , Whitespace
3064       , Plaintext "\"bar\""
3065       , Whitespace
3066       , Plaintext "directory:"
3067       ]
3068   , Fenced [ ":Ack -w foo bar" ]
3069   , Paragraph
3070       [ Plaintext "Note"
3071       , Whitespace
3072       , Plaintext "that"
3073       , Whitespace
3074       , Plaintext "including"
3075       , Whitespace
3076       , Plaintext "quotes"
3077       , Whitespace
3078       , Plaintext "will"
3079       , Whitespace
3080       , Plaintext "not"
3081       , Whitespace
3082       , Plaintext "do"
3083       , Whitespace
3084       , Plaintext "what"
3085       , Whitespace
3086       , Plaintext "you"
3087       , Whitespace
3088       , Plaintext "intend."
3089       ]
3090   , Fenced
3091       [ " \" Search for '\"foo' in the 'bar\"' directory:"
3092       , " :Ack \"foo bar\""
3093       , ""
3094       , " \" Search for \"'foo' in the \"bar'\" directory:"
3095       , " :Ack 'foo bar'"
3096       ]
3097   , Paragraph
3098       [ Plaintext "This"
3099       , Whitespace
3100       , Plaintext "approach"
3101       , Whitespace
3102       , Plaintext "to"
3103       , Whitespace
3104       , Plaintext "escaping"
3105       , Whitespace
3106       , Plaintext "is"
3107       , Whitespace
3108       , Plaintext "taken"
3109       , Whitespace
3110       , Plaintext "in"
3111       , Whitespace
3112       , Plaintext "order"
3113       , Whitespace
3114       , Plaintext "to"
3115       , Whitespace
3116       , Plaintext "make"
3117       , Whitespace
3118       , Plaintext "it"
3119       , Whitespace
3120       , Plaintext "straightfoward"
3121       , Whitespace
3122       , Plaintext "to"
3123       , Whitespace
3124       , Plaintext "use"
3125       , Whitespace
3126       , Plaintext "powerful"
3127       , Whitespace
3128       , Plaintext "Perl-compatible"
3129       , Whitespace
3130       , Plaintext "regular"
3131       , Whitespace
3132       , Plaintext "expression"
3133       , Whitespace
3134       , Plaintext "syntax"
3135       , Whitespace
3136       , Plaintext "in"
3137       , Whitespace
3138       , Plaintext "an"
3139       , Whitespace
3140       , Plaintext "unambiguous"
3141       , Whitespace
3142       , Plaintext "way"
3143       , Whitespace
3144       , Plaintext "without"
3145       , Whitespace
3146       , Plaintext "having"
3147       , Whitespace
3148       , Plaintext "to"
3149       , Whitespace
3150       , Plaintext "worry"
3151       , Whitespace
3152       , Plaintext "about"
3153       , Whitespace
3154       , Plaintext "shell"
3155       , Whitespace
3156       , Plaintext "escaping"
3157       , Whitespace
3158       , Plaintext "rules:"
3159       ]
3160   , Fenced
3161       [ ":Ack \\blog\\((['\"]).*?\\1\\) -i --ignore-dir=src/vendor src dist build"
3162       ]
3163   , HeadingAnnotation "FAQ"
3164   , SubheadingAnnotation
3165       "Why do Ferret commands start with \"Ack\", \"Lack\" and so on?"
3166   , Paragraph
3167       [ Plaintext "Ferret"
3168       , Whitespace
3169       , Plaintext "was"
3170       , Whitespace
3171       , Plaintext "originally"
3172       , Whitespace
3173       , Plaintext "the"
3174       , Whitespace
3175       , Plaintext "thinnest"
3176       , Whitespace
3177       , Plaintext "of"
3178       , Whitespace
3179       , Plaintext "wrappers"
3180       , Whitespace
3181       , Plaintext "(7"
3182       , Whitespace
3183       , Plaintext "lines"
3184       , Whitespace
3185       , Plaintext "of"
3186       , Whitespace
3187       , Plaintext "code"
3188       , Whitespace
3189       , Plaintext "in"
3190       , Whitespace
3191       , Plaintext "my"
3192       , Whitespace
3193       , Link ".vimrc"
3194       , Plaintext ")"
3195       , Whitespace
3196       , Plaintext "around"
3197       , Whitespace
3198       , Code "ack"
3199       , Plaintext "."
3200       , Whitespace
3201       , Plaintext "The"
3202       , Whitespace
3203       , Plaintext "earliest"
3204       , Whitespace
3205       , Plaintext "traces"
3206       , Whitespace
3207       , Plaintext "of"
3208       , Whitespace
3209       , Plaintext "it"
3210       , Whitespace
3211       , Plaintext "can"
3212       , Whitespace
3213       , Plaintext "be"
3214       , Whitespace
3215       , Plaintext "seen"
3216       , Whitespace
3217       , Plaintext "in"
3218       , Whitespace
3219       , Plaintext "the"
3220       , Whitespace
3221       , Plaintext "initial"
3222       , Whitespace
3223       , Plaintext "commit"
3224       , Whitespace
3225       , Plaintext "to"
3226       , Whitespace
3227       , Plaintext "my"
3228       , Whitespace
3229       , Plaintext "dotfiles"
3230       , Whitespace
3231       , Plaintext "repo"
3232       , Whitespace
3233       , Plaintext "in"
3234       , Whitespace
3235       , Plaintext "May,"
3236       , Whitespace
3237       , Plaintext "2009"
3238       , Whitespace
3239       , Plaintext "(https://wt.pe/h)."
3240       ]
3241   , Paragraph
3242       [ Plaintext "So,"
3243       , Whitespace
3244       , Plaintext "even"
3245       , Whitespace
3246       , Plaintext "though"
3247       , Whitespace
3248       , Plaintext "Ferret"
3249       , Whitespace
3250       , Plaintext "has"
3251       , Whitespace
3252       , Plaintext "a"
3253       , Whitespace
3254       , Plaintext "new"
3255       , Whitespace
3256       , Plaintext "name"
3257       , Whitespace
3258       , Plaintext "now"
3259       , Whitespace
3260       , Plaintext "and"
3261       , Whitespace
3262       , Plaintext "actually"
3263       , Whitespace
3264       , Plaintext "prefers"
3265       , Whitespace
3266       , Code "ag"
3267       , Whitespace
3268       , Plaintext "over"
3269       , Whitespace
3270       , Code "ack"
3271       , Whitespace
3272       , Plaintext "when"
3273       , Whitespace
3274       , Plaintext "available,"
3275       , Whitespace
3276       , Plaintext "I"
3277       , Whitespace
3278       , Plaintext "prefer"
3279       , Whitespace
3280       , Plaintext "to"
3281       , Whitespace
3282       , Plaintext "keep"
3283       , Whitespace
3284       , Plaintext "the"
3285       , Whitespace
3286       , Plaintext "command"
3287       , Whitespace
3288       , Plaintext "names"
3289       , Whitespace
3290       , Plaintext "intact"
3291       , Whitespace
3292       , Plaintext "and"
3293       , Whitespace
3294       , Plaintext "benefit"
3295       , Whitespace
3296       , Plaintext "from"
3297       , Whitespace
3298       , Plaintext "years"
3299       , Whitespace
3300       , Plaintext "of"
3301       , Whitespace
3302       , Plaintext "accumulated"
3303       , Whitespace
3304       , Plaintext "muscle-memory."
3305       ]
3306   , HeadingAnnotation "Related"
3307   , Paragraph
3308       [ Plaintext "Just"
3309       , Whitespace
3310       , Plaintext "as"
3311       , Whitespace
3312       , Plaintext "Ferret"
3313       , Whitespace
3314       , Plaintext "aims"
3315       , Whitespace
3316       , Plaintext "to"
3317       , Whitespace
3318       , Plaintext "improve"
3319       , Whitespace
3320       , Plaintext "the"
3321       , Whitespace
3322       , Plaintext "multi-file"
3323       , Whitespace
3324       , Plaintext "search"
3325       , Whitespace
3326       , Plaintext "and"
3327       , Whitespace
3328       , Plaintext "replace"
3329       , Whitespace
3330       , Plaintext "experience,"
3331       , Whitespace
3332       , Plaintext "Loupe"
3333       , Whitespace
3334       , Plaintext "does"
3335       , Whitespace
3336       , Plaintext "the"
3337       , Whitespace
3338       , Plaintext "same"
3339       , Whitespace
3340       , Plaintext "for"
3341       , Whitespace
3342       , Plaintext "within-file"
3343       , Whitespace
3344       , Plaintext "searching:"
3345       ]
3346   , Paragraph [ Plaintext "https://github.com/wincent/loupe" ]
3347   , HeadingAnnotation "Website"
3348   , Paragraph
3349       [ Plaintext "The"
3350       , Whitespace
3351       , Plaintext "official"
3352       , Whitespace
3353       , Plaintext "Ferret"
3354       , Whitespace
3355       , Plaintext "source"
3356       , Whitespace
3357       , Plaintext "code"
3358       , Whitespace
3359       , Plaintext "repo"
3360       , Whitespace
3361       , Plaintext "is"
3362       , Whitespace
3363       , Plaintext "at:"
3364       ]
3365   , Paragraph [ Plaintext "http://git.wincent.com/ferret.git" ]
3366   , Paragraph
3367       [ Plaintext "A"
3368       , Whitespace
3369       , Plaintext "mirror"
3370       , Whitespace
3371       , Plaintext "exists"
3372       , Whitespace
3373       , Plaintext "at:"
3374       ]
3375   , Paragraph [ Plaintext "https://github.com/wincent/ferret" ]
3376   , Paragraph
3377       [ Plaintext "Official"
3378       , Whitespace
3379       , Plaintext "releases"
3380       , Whitespace
3381       , Plaintext "are"
3382       , Whitespace
3383       , Plaintext "listed"
3384       , Whitespace
3385       , Plaintext "at:"
3386       ]
3387   , Paragraph
3388       [ Plaintext "http://www.vim.org/scripts/script.php?script_id=5220"
3389       ]
3390   , HeadingAnnotation "License"
3391   , Paragraph
3392       [ Plaintext "Copyright"
3393       , Whitespace
3394       , Plaintext "2015-present"
3395       , Whitespace
3396       , Plaintext "Greg"
3397       , Whitespace
3398       , Plaintext "Hurrell."
3399       , Whitespace
3400       , Plaintext "All"
3401       , Whitespace
3402       , Plaintext "rights"
3403       , Whitespace
3404       , Plaintext "reserved."
3405       ]
3406   , Paragraph
3407       [ Plaintext "Redistribution"
3408       , Whitespace
3409       , Plaintext "and"
3410       , Whitespace
3411       , Plaintext "use"
3412       , Whitespace
3413       , Plaintext "in"
3414       , Whitespace
3415       , Plaintext "source"
3416       , Whitespace
3417       , Plaintext "and"
3418       , Whitespace
3419       , Plaintext "binary"
3420       , Whitespace
3421       , Plaintext "forms,"
3422       , Whitespace
3423       , Plaintext "with"
3424       , Whitespace
3425       , Plaintext "or"
3426       , Whitespace
3427       , Plaintext "without"
3428       , Whitespace
3429       , Plaintext "modification,"
3430       , Whitespace
3431       , Plaintext "are"
3432       , Whitespace
3433       , Plaintext "permitted"
3434       , Whitespace
3435       , Plaintext "provided"
3436       , Whitespace
3437       , Plaintext "that"
3438       , Whitespace
3439       , Plaintext "the"
3440       , Whitespace
3441       , Plaintext "following"
3442       , Whitespace
3443       , Plaintext "conditions"
3444       , Whitespace
3445       , Plaintext "are"
3446       , Whitespace
3447       , Plaintext "met:"
3448       ]
3449   , Paragraph
3450       [ Plaintext "1."
3451       , Whitespace
3452       , Plaintext "Redistributions"
3453       , Whitespace
3454       , Plaintext "of"
3455       , Whitespace
3456       , Plaintext "source"
3457       , Whitespace
3458       , Plaintext "code"
3459       , Whitespace
3460       , Plaintext "must"
3461       , Whitespace
3462       , Plaintext "retain"
3463       , Whitespace
3464       , Plaintext "the"
3465       , Whitespace
3466       , Plaintext "above"
3467       , Whitespace
3468       , Plaintext "copyright"
3469       , Whitespace
3470       , Plaintext "notice,"
3471       , Whitespace
3472       , Plaintext "this"
3473       , Whitespace
3474       , Plaintext "list"
3475       , Whitespace
3476       , Plaintext "of"
3477       , Whitespace
3478       , Plaintext "conditions"
3479       , Whitespace
3480       , Plaintext "and"
3481       , Whitespace
3482       , Plaintext "the"
3483       , Whitespace
3484       , Plaintext "following"
3485       , Whitespace
3486       , Plaintext "disclaimer."
3487       , Whitespace
3488       , Plaintext "2."
3489       , Whitespace
3490       , Plaintext "Redistributions"
3491       , Whitespace
3492       , Plaintext "in"
3493       , Whitespace
3494       , Plaintext "binary"
3495       , Whitespace
3496       , Plaintext "form"
3497       , Whitespace
3498       , Plaintext "must"
3499       , Whitespace
3500       , Plaintext "reproduce"
3501       , Whitespace
3502       , Plaintext "the"
3503       , Whitespace
3504       , Plaintext "above"
3505       , Whitespace
3506       , Plaintext "copyright"
3507       , Whitespace
3508       , Plaintext "notice,"
3509       , Whitespace
3510       , Plaintext "this"
3511       , Whitespace
3512       , Plaintext "list"
3513       , Whitespace
3514       , Plaintext "of"
3515       , Whitespace
3516       , Plaintext "conditions"
3517       , Whitespace
3518       , Plaintext "and"
3519       , Whitespace
3520       , Plaintext "the"
3521       , Whitespace
3522       , Plaintext "following"
3523       , Whitespace
3524       , Plaintext "disclaimer"
3525       , Whitespace
3526       , Plaintext "in"
3527       , Whitespace
3528       , Plaintext "the"
3529       , Whitespace
3530       , Plaintext "documentation"
3531       , Whitespace
3532       , Plaintext "and/or"
3533       , Whitespace
3534       , Plaintext "other"
3535       , Whitespace
3536       , Plaintext "materials"
3537       , Whitespace
3538       , Plaintext "provided"
3539       , Whitespace
3540       , Plaintext "with"
3541       , Whitespace
3542       , Plaintext "the"
3543       , Whitespace
3544       , Plaintext "distribution."
3545       ]
3546   , Paragraph
3547       [ Plaintext "THIS"
3548       , Whitespace
3549       , Plaintext "SOFTWARE"
3550       , Whitespace
3551       , Plaintext "IS"
3552       , Whitespace
3553       , Plaintext "PROVIDED"
3554       , Whitespace
3555       , Plaintext "BY"
3556       , Whitespace
3557       , Plaintext "THE"
3558       , Whitespace
3559       , Plaintext "COPYRIGHT"
3560       , Whitespace
3561       , Plaintext "HOLDERS"
3562       , Whitespace
3563       , Plaintext "AND"
3564       , Whitespace
3565       , Plaintext "CONTRIBUTORS"
3566       , Whitespace
3567       , Plaintext "\"AS"
3568       , Whitespace
3569       , Plaintext "IS\""
3570       , Whitespace
3571       , Plaintext "AND"
3572       , Whitespace
3573       , Plaintext "ANY"
3574       , Whitespace
3575       , Plaintext "EXPRESS"
3576       , Whitespace
3577       , Plaintext "OR"
3578       , Whitespace
3579       , Plaintext "IMPLIED"
3580       , Whitespace
3581       , Plaintext "WARRANTIES,"
3582       , Whitespace
3583       , Plaintext "INCLUDING,"
3584       , Whitespace
3585       , Plaintext "BUT"
3586       , Whitespace
3587       , Plaintext "NOT"
3588       , Whitespace
3589       , Plaintext "LIMITED"
3590       , Whitespace
3591       , Plaintext "TO,"
3592       , Whitespace
3593       , Plaintext "THE"
3594       , Whitespace
3595       , Plaintext "IMPLIED"
3596       , Whitespace
3597       , Plaintext "WARRANTIES"
3598       , Whitespace
3599       , Plaintext "OF"
3600       , Whitespace
3601       , Plaintext "MERCHANTABILITY"
3602       , Whitespace
3603       , Plaintext "AND"
3604       , Whitespace
3605       , Plaintext "FITNESS"
3606       , Whitespace
3607       , Plaintext "FOR"
3608       , Whitespace
3609       , Plaintext "A"
3610       , Whitespace
3611       , Plaintext "PARTICULAR"
3612       , Whitespace
3613       , Plaintext "PURPOSE"
3614       , Whitespace
3615       , Plaintext "ARE"
3616       , Whitespace
3617       , Plaintext "DISCLAIMED."
3618       , Whitespace
3619       , Plaintext "IN"
3620       , Whitespace
3621       , Plaintext "NO"
3622       , Whitespace
3623       , Plaintext "EVENT"
3624       , Whitespace
3625       , Plaintext "SHALL"
3626       , Whitespace
3627       , Plaintext "THE"
3628       , Whitespace
3629       , Plaintext "COPYRIGHT"
3630       , Whitespace
3631       , Plaintext "HOLDERS"
3632       , Whitespace
3633       , Plaintext "OR"
3634       , Whitespace
3635       , Plaintext "CONTRIBUTORS"
3636       , Whitespace
3637       , Plaintext "BE"
3638       , Whitespace
3639       , Plaintext "LIABLE"
3640       , Whitespace
3641       , Plaintext "FOR"
3642       , Whitespace
3643       , Plaintext "ANY"
3644       , Whitespace
3645       , Plaintext "DIRECT,"
3646       , Whitespace
3647       , Plaintext "INDIRECT,"
3648       , Whitespace
3649       , Plaintext "INCIDENTAL,"
3650       , Whitespace
3651       , Plaintext "SPECIAL,"
3652       , Whitespace
3653       , Plaintext "EXEMPLARY,"
3654       , Whitespace
3655       , Plaintext "OR"
3656       , Whitespace
3657       , Plaintext "CONSEQUENTIAL"
3658       , Whitespace
3659       , Plaintext "DAMAGES"
3660       , Whitespace
3661       , Plaintext "(INCLUDING,"
3662       , Whitespace
3663       , Plaintext "BUT"
3664       , Whitespace
3665       , Plaintext "NOT"
3666       , Whitespace
3667       , Plaintext "LIMITED"
3668       , Whitespace
3669       , Plaintext "TO,"
3670       , Whitespace
3671       , Plaintext "PROCUREMENT"
3672       , Whitespace
3673       , Plaintext "OF"
3674       , Whitespace
3675       , Plaintext "SUBSTITUTE"
3676       , Whitespace
3677       , Plaintext "GOODS"
3678       , Whitespace
3679       , Plaintext "OR"
3680       , Whitespace
3681       , Plaintext "SERVICES;"
3682       , Whitespace
3683       , Plaintext "LOSS"
3684       , Whitespace
3685       , Plaintext "OF"
3686       , Whitespace
3687       , Plaintext "USE,"
3688       , Whitespace
3689       , Plaintext "DATA,"
3690       , Whitespace
3691       , Plaintext "OR"
3692       , Whitespace
3693       , Plaintext "PROFITS;"
3694       , Whitespace
3695       , Plaintext "OR"
3696       , Whitespace
3697       , Plaintext "BUSINESS"
3698       , Whitespace
3699       , Plaintext "INTERRUPTION)"
3700       , Whitespace
3701       , Plaintext "HOWEVER"
3702       , Whitespace
3703       , Plaintext "CAUSED"
3704       , Whitespace
3705       , Plaintext "AND"
3706       , Whitespace
3707       , Plaintext "ON"
3708       , Whitespace
3709       , Plaintext "ANY"
3710       , Whitespace
3711       , Plaintext "THEORY"
3712       , Whitespace
3713       , Plaintext "OF"
3714       , Whitespace
3715       , Plaintext "LIABILITY,"
3716       , Whitespace
3717       , Plaintext "WHETHER"
3718       , Whitespace
3719       , Plaintext "IN"
3720       , Whitespace
3721       , Plaintext "CONTRACT,"
3722       , Whitespace
3723       , Plaintext "STRICT"
3724       , Whitespace
3725       , Plaintext "LIABILITY,"
3726       , Whitespace
3727       , Plaintext "OR"
3728       , Whitespace
3729       , Plaintext "TORT"
3730       , Whitespace
3731       , Plaintext "(INCLUDING"
3732       , Whitespace
3733       , Plaintext "NEGLIGENCE"
3734       , Whitespace
3735       , Plaintext "OR"
3736       , Whitespace
3737       , Plaintext "OTHERWISE)"
3738       , Whitespace
3739       , Plaintext "ARISING"
3740       , Whitespace
3741       , Plaintext "IN"
3742       , Whitespace
3743       , Plaintext "ANY"
3744       , Whitespace
3745       , Plaintext "WAY"
3746       , Whitespace
3747       , Plaintext "OUT"
3748       , Whitespace
3749       , Plaintext "OF"
3750       , Whitespace
3751       , Plaintext "THE"
3752       , Whitespace
3753       , Plaintext&nbs