#+TITLE: Perl5 layer

[[file:img/perl5.png]]

* Table of Contents                                         :TOC_4_gh:noexport:
- [[#description][Description]]
  - [[#features][Features:]]
- [[#install][Install]]
  - [[#layer][Layer]]
- [[#key-bindings][Key Bindings]]
  - [[#perldoc][Perldoc]]
  - [[#pod-and-here-doc][POD and HERE doc]]
  - [[#find-symbol][Find Symbol]]

* Description
This layer adds support for the Perl5 language.

** Features:
- syntactic and semantic checking using [[https://github.com/flycheck/flycheck][flycheck]]

* Install
** Layer
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =perl5= to the existing =dotspacemacs-configuration-layers= list in this
file.

* Key Bindings
** Perldoc
Browse formated perldocs.

| Key Binding | Description                     |
|-------------+---------------------------------|
| ~SPC m h p~ | view perldoc of symbol at point |
| ~SPC m h d~ | view perldoc of any symbol      |

** POD and HERE doc
select a POD or HERE doc

| Key Binding | Description                            |
|-------------+----------------------------------------|
| ~SPC m v~   | select entire POD or HERE doc at point |

** Find Symbol
jump to symbol definition

| Key Binding | Description                               |
|-------------+-------------------------------------------|
| ~SPC m g g~ | jump to symbol definition                 |
| ~SPC m g G~ | jump to symbol definition in other window |