otty / dotfiles

All tools/Perl

Perl

perl

Perl is a highly capable, feature-rich programming language with over 38 years of development.

Detected by perl, cpan | macOS, Linux |www.perl.org

Sync it perl.toml

Sync rules

What travels, what stays, what never leaves

Perl in your home directory Every rule on this page, by file

· ~/.perldb Sync

…

'applypatch' => q[],

'auto_commit' => q[0],

'build_cache' => q[100],

'build_dir' => q[/home/octocat/.cpan/build],machine-local

'build_dir_reuse' => q[0],

'build_requires_install_policy' => q[yes],

'bzip2' => q[/usr/bin/bzip2],

…

'check_sigs' => q[0],

'colorize_output' => q[1],

'commandnumber_in_prompt' => q[1],

'cpan_home' => q[/home/octocat/.cpan],machine-local

'ftpstats_period' => q[14],

'ftpstats_size' => q[99],

'halt_on_failure' => q[0],

…

'histsize' => q[100],

'inactivity_timeout' => q[0],

'index_expire' => q[1],

'keep_source_where' => q[/home/octocat/.cpan/sources],machine-local

'load_module_verbosity' => q[none],

'make_install_make_command' => q[make],

'prefer_installer' => q[MB],

…

Each machine keeps its own copy of these.

· build/ Exclude

· sources/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/perl.tomlThe file this page is generated from

id = "perl"

name = "Perl"

homepage = "https://www.perl.org"

description = "Perl is a highly capable, feature-rich programming language with over 38 years of development."

# Perl's own sentence, from the front page of www.perl.org.

icon = "SimpleIcons:perl"

detect = ["perl", "cpan"]

platforms = ["macos", "linux"]

# Two user-level files, from Perl's own documentation:

# perldebug, Configurable Options: the debugger reads a startup file before a

# session begins — "The file is named ./.perldb or ~/.perldb under Unix with

# /dev/tty, perldb.ini otherwise." The home-directory one is the user's; the

# ./.perldb beside a project is not.

# perldoc CPAN: "Default values defined in the CPAN/Config.pm file can be

# overridden in a user specific file: CPAN/MyConfig.pm. Such a file is best

# placed in $HOME/.cpan/CPAN/MyConfig.pm", and `o conf mkmyconfig` writes it

# there. It is Perl source: one hash of configuration keys.

# Both are joined to $HOME by the tools themselves, so they stay literal rather

# than becoming a base directory.

paths = [

"~/.perldb",

"~/.cpan/CPAN/MyConfig.pm",

]

# The rest of ~/.cpan is CPAN.pm's working area, and perldoc CPAN names the two

# keys that put it there: `build_dir`, "Directory where the distributions are

# built", and `keep_source_where`, "Directory in which to keep the source", both

# defaulting under `cpan_home`. Downloaded tarballs and unpacked build trees are

# not configuration.

exclude = [

"~/.cpan/build/",

"~/.cpan/sources/",

]

# Neither file is a credential. A CPAN mirror needing authentication carries it

# in the mirror URL rather than in a separate file.

secret = []

# perldoc CPAN describes cpan_home as "The directory where CPAN.pm keeps its

# state", build_dir as the build area and keep_source_where as the download

# cache — three absolute paths into this machine's disk, written by

# `mkmyconfig` from wherever it was run. MyConfig.pm is Perl source with one

# key per line (`'build_dir' => q[/home/octocat/.cpan/build],`), which prefix

# matching reads once leading whitespace is stripped. Everything else in the

# file — the mirror list, the build and test policies, the term settings — is

# a preference worth carrying.

[[machine_lines]]

file = "~/.cpan/CPAN/MyConfig.pm"

match = { prefix = ["'cpan_home'", "'build_dir'", "'keep_source_where'"] }

# No machine_lines for ~/.perldb: it is debugger options and aliases, and the

# `parse_options` line a user puts there is the same on every machine.

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/perl. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits 'cpan_home' and 'build_dir' for you — that part is Otty’s own sync, or a template you write by hand.