File: README-build-from-git.md

package info (click to toggle)
libconfig-model-openssh-perl 2.9.9.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 640 kB
  • sloc: perl: 4,596; makefile: 12
file content (68 lines) | stat: -rw-r--r-- 2,004 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
# How to build Config::Model::OpenSsh from git repository

`Config::Model::OpenSsh` is build with [Dist::Zilla](http://dzil.org/). This
page details how to install the tools and dependencies required to
build this module.

## Install tools and dependencies

### Debian, Ubuntu and derivatives

Run

    $ sudo apt install libdist-zilla-perl libdist-zilla-app-command-authordebs-perl
    $ dzil authordebs --install
    $ sudo apt build-dep libconfig-model-openssh-perl

The [libdist-zilla-app-command-authordebs-perl package](https://tracker.debian.org/pkg/libdist-zilla-app-command-authordebs-perl) is quite recent (uploaded on Dec 2016 in Debian/unstable) 
and may not be available yet on your favorite distribution.

### Other systems

Run 

    $ cpamn Dist::Zilla
    $ dzil authordeps -missing | cpanm --notest
    $ dzil listdeps --missing | cpanm --notest

NB: The author would welcome pull requests that explains how to
install these tools and dependencies using native package of other
distributions.

## Build Config::Model::OpenSsh

Run

    dzil build 

or 

    dzil test

`dzil` may complain about missing `EmailNotify` or `Twitter`
plugin. You may ignore this or edit [dist.ini](dist.ini) to comment
out the last 2 sections. These are useful only to the author when
releasing a new version.


`dzil` may also return an error like `Cannot determine local time
zone`. In this case, you should specify explicitely your timezone in
a `TZ` environement variable. E.g run `dzil` this way:

    TZ="Europe/Paris" dzil test

The list of possible timezones is provided by
[DateTime::TimeZone::Catalog](https://metacpan.org/pod/DateTime::TimeZone::Catalog)
documentation.

## Model generation

Ssh model can be regenerated from ssh man pages with the following steps:

* make sure that `ssh_config` and `sshd_config` man pages are available
* Run `perl contrib/parse-man.pl`
* Inspect the result
* Then build the module as shown above

For more details, see this [readme file](contrib/README.org)