Add badges to README
brian d foy
6 years ago
1 | 1 | |
2 | 2 | =encoding utf8 |
3 | 3 | |
4 | =for HTML <a href="https://travis-ci.org/briandfoy/io-interactive"><img src="https://travis-ci.org/briandfoy/io-interactive.svg?branch=master" /></a> | |
5 | ||
6 | =for HTML <a href='https://ci.appveyor.com/project/briandfoy/io-interactive'><img src='https://ci.appveyor.com/api/projects/status/nxocrwut3tcni3ei' /></a> | |
7 | ||
8 | =for HTML <a href='https://coveralls.io/github/briandfoy/io-interactive?branch=master'><img src='https://coveralls.io/repos/github/briandfoy/io-interactive/badge.svg?branch=master' alt='Coverage Status' /></a> | |
9 | ||
10 | =for HTML <a href="https://github.com/briandfoy/io-interactive/blob/master/LICENSE"><img src="https://img.shields.io/cpan/l/IO-Interactive.svg" /></a> | |
11 | ||
12 | =for HTML <a href="http://www.metacpan.org/module/IO::Interactive"><img src="https://img.shields.io/cpan/v/IO-Interactive.svg" /></A> | |
13 | ||
4 | 14 | =head1 The IO::Interactive module |
5 | 15 | |
6 | This is the I<README> for the L<IO::Interactive> Perl module. You're probably | |
16 | This is the I<README> for the L<IO::Interactive> Perl module. You're probably | |
7 | 17 | looking at this because you don't know where else to find what you're |
8 | looking for. Read this once and you might never have to read one again | |
18 | looking for. Read this once and you might never have to read one again | |
9 | 19 | for any Perl module. |
10 | 20 | |
11 | 21 | =head2 Documentation |
12 | 22 | |
13 | To read about L<IO::Interactive>, look at the embedded documentation | |
14 | in the module itself. Inside the distribution, you can format it | |
23 | To read about L<IO::Interactive>, look at the embedded documentation | |
24 | in the module itself. Inside the distribution, you can format it | |
15 | 25 | with L<perldoc|http://perldoc.perl.org/perldoc.html>: |
16 | 26 | |
17 | 27 | % perldoc lib/IO/Interactive.pm |
21 | 31 | |
22 | 32 | % perldoc IO::Interactive |
23 | 33 | |
24 | You can read the documentation and inspect the meta data on one of the | |
25 | CPAN web interfaces, such as L<CPAN Search|http://search.cpan.org/dist/IO-Interactive> or | |
34 | You can read the documentation and inspect the meta data on one of the | |
35 | CPAN web interfaces, such as L<CPAN Search|http://search.cpan.org/dist/IO-Interactive> or | |
26 | 36 | L<MetaCPAN|http://www.metacpan.org/module/IO::Interactive>: |
27 | 37 | |
28 | 38 | =over 4 |
58 | 68 | % make test |
59 | 69 | % make install |
60 | 70 | |
61 | You probably don't want to do that unless you're fiddling with the | |
71 | You probably don't want to do that unless you're fiddling with the | |
62 | 72 | module and only want to run the tests without installing anything. |
63 | 73 | |
64 | 74 | =head2 Source location |
65 | ||
75 | ||
66 | 76 | The meta data, such as the source repository and bug tracker, is in |
67 | 77 | I<Makefile.PL> or the I<META.*> files it creates. You can find that on |
68 | 78 | those CPAN web interfaces, but you can also look at files directly in |
74 | 84 | |
75 | 85 | =back |
76 | 86 | |
77 | If you find a problem, file a ticket in the L<issue | |
87 | If you find a problem, file a ticket in the L<issue | |
78 | 88 | tracker|https://github.com/briandfoy/io-interactive/issues>: |
79 | 89 | |
80 | 90 | =over 4 |
93 | 103 | L<Stackoverflow|http://www.stackoverflow.com>, both of which have many |
94 | 104 | competent Perlers who can answer your question, almost in real time. |
95 | 105 | They might not know the particulars of this module, but they can help |
96 | you diagnose your problem. | |
106 | you diagnose your problem. | |
97 | 107 | |
98 | You might like to read L<brian's Guide to Solving Any Perl | |
108 | You might like to read L<brian's Guide to Solving Any Perl | |
99 | 109 | Problem|http://archive.oreilly.com/pub/a/perl/excerpts/9780596527242/brians-guide.html>. |
100 | 110 | |
101 | 111 | =head2 Copyright and License |
102 | 112 | |
103 | 113 | You should have received a I<LICENSE> file, but the license is also noted |
104 | 114 | in the module files. About the only thing you can't do is pretend that |
105 | you wrote code that you didn't. | |
115 | you wrote code that you didn't. | |
106 | 116 | |
107 | 117 | =head2 Good luck! |
108 | 118 | |
109 | Enjoy, | |
119 | Enjoy, | |
110 | 120 | |
111 | 121 | brian d foy, bdfoy@cpan.org |
112 | 122 |