CPAN Module を Deprecate する方法

https://neilb.org/2015/01/17/deprecated-metadata.html

neilb 氏のこのページに書いてある方法で OK。

minilla の場合は

[Metadata]
x_deprecated = 1

とする。

~/.claude/skills/deprecate-cpan-module/SKILLS.md に書いてもよさそう。

---
name: deprecate-cpan-module
description: deprecate cpan module
---

Help the user deprecate a CPAN module.

## Overview

Deprecating a CPAN module requires two things:

1. **Add `x_deprecated: 1` to the distribution metadata**
2. **Update the documentation (POD)**

Reference: https://neilb.org/2015/01/17/deprecated-metadata.html

## Steps

### 1. Identify the build tool

Check the project root to determine which build tool is being used:

- `dist.ini` → **Dist::Zilla**
- `minil.toml` → **Minilla**
- `Makefile.PL` → **ExtUtils::MakeMaker** or **Module::Install**
- `Build.PL` → **Module::Build**

### 2. Add x_deprecated to the metadata

#### Dist::Zilla (`dist.ini`)

```ini
[Deprecated]

Minilla (minil.toml)

[Metadata]
x_deprecated = 1

ExtUtils::MakeMaker (Makefile.PL)

META_MERGE => {
    'meta-spec' => { version => 2 },
    x_deprecated => 1,
},

Module::Build (Build.PL)

meta_merge => {
    x_deprecated => 1,
},

Module::Install (Makefile.PL)

add_metadata x_deprecated => 1;

3. Update the POD documentation

Add "(DEPRECATED)" to the abstract in the NAME section

=head1 NAME

Some::Module - (DEPRECATED) original description

Add a deprecation notice at the top of the DESCRIPTION section

If a replacement module exists:

=head1 DESCRIPTION

B<This module is deprecated.> Use L<Other::Module> instead.

If no replacement exists:

=head1 DESCRIPTION

B<This module is deprecated.> Do not use it in new code.

4. Release a new version

Commit the changes and release a new version to CPAN.

Checklist

Published: 2026-02-25(Wed) 07:44