Devnotes

Some notes on Ado development

To ignore or not to ignore some files?

Since version 0.23 we ignore log files. echo >log/development.log; git update-index --assume-unchanged log/development.log

For details see Ignoring versioned files

Setting up a development Environment

If you want to be one of the authors of Ado you need to have a toolset. The following tools are needed:

1. A decent text editor. Any of the following should work for you depending on your preferences: Vim, Sublime Text, jEdit (all of them with a ctags plugin). The ctags tooll must be installed. Eclipse with the EPIC - Perl Editor and IDE for Eclipse is also fine.

2. For running author tests set the $TEST_AUTHOR environment variable in your ~/.bashrc:

export TEST_AUTHOR=1

And install the 'recommended' dependencies.

1. Add some aliases for often used commands in your ./.bashrc

    alias t='./Build test --verbose 1 --test_files'
    #then in the terminal
    t t/pod*
    #or just
     t

1. When preparing a release for CPAN unset $ENV{TEST_AUTHOR} to generate META.json and META.yml that require fewer dependencies.

TEST_AUTHOR=0 ./Build dist

We may need to make this the default behaviour.