Contents

Chapter 3

Module Design and Implementation 

...................65

Check Your Slack 

................................................................................................65

Size Matters 

.........................................................................................................66

Document First 

.....................................................................................................66

Interface Design 

................................................................................................73

Summary 

....................................................................................................................94

Chapter 4

CPAN Module Distributions 

.....................................95

Module Installation 

..........................................................................................95

Always Begin with h2xs 

...................................................................................98

Exploring the Distribution 

.........................................................................112

Portability 

.........................................................................................................122

Choosing a License 

..........................................................................................126

Summary 

..................................................................................................................128

Chapter 5

Submitting Your Module to CPAN 

......................129

Requesting Comments 

........................................................................................129

Requesting a CPAN Author ID 

......................................................................131

Registering Your Namespace 

.........................................................................132

Uploading Your Module Distribution 

.......................................................134

Post Upload Processing 

.................................................................................137

Summary 

..................................................................................................................138

Chapter 6

Module Maintenance 

.....................................................139

Growing a User Community 

.............................................................................139

Managing the Source 

........................................................................................142

Making Releases 

.................................................................................................161

Summary 

..................................................................................................................163

Chapter 7

Great CPAN Modules 

.....................................................165

What Makes a Great CPAN Module? 

..............................................................165

CGI.pm 

....................................................................................................................166

DBI 

...........................................................................................................................168

Storable 

................................................................................................................169

Net::FTP 

................................................................................................................170

LWP 

...........................................................................................................................171

XML::SAX 

................................................................................................................172

Parse::RecDescent 

............................................................................................173

Summary 

..................................................................................................................174

viii