Pugs::Doc::Hack 6.2.13

Pugs::Doc::Hack is a Perl module documentation on how to hack on Pugs.

SYNOPSIS

# Fetch latest Pugs from Subversion repository
$ svn co http://svn.openfoundry.org/pugs
$ cd pugs

# review build options controlled by env variables
$ $PAGER ./INSTALL

# Configure Pugs
$ perl Makefile.PL

# Compile Pugs
$ make

# Test
$ make test

# or instead of Test, Smoke:

# do the following only once
$ sudo cpan Task::Smoke
$ cp util/smoker-example.yml ~/.smoker.yml
$ $EDITOR ~/.smoker.yml

$ make smoke # generates smoke.html, smoke.yml
# Optionally, submit your smoke report to the public smokeserver:
$ perl util/smokeserv/smokeserv-client.pl smoke.html smoke.yml

This document attempts to explain how to start working on Pugs, as well as conventions used in day-to-day development.