Skip to content
Using Perl 6 - an unfinished book about Perl 6
Perl Makefile TeX Perl6
Find file
Latest commit a5f3c17 Aug 25, 2015 @moritz moritz Merge pull request #84 from stmuk/master
fix minor typos
Failed to load latest commit information.
bin TT sends output to STDOUT, removed extra print(). Dec 26, 2010
dist
docs updated operators chapter to reflect Pm's review Jul 28, 2010
lib Several text and markup fixes Nov 26, 2011
src fix minor typos Aug 24, 2015
test add test for bold in verbatims Jul 25, 2010
wip [basics] start explanations Oct 31, 2009
.gitignore add build and dist to ignored files, since there never is something c… Aug 15, 2010
Makefile move chapters: OO now comes before multi dispatch Sep 26, 2010
README Add note about archival nature of repo Jul 23, 2015
TODO add a TODO file. Because we have much to do :-) Mar 28, 2011
authors.pod This fixes the Pod error: '=item' outside of any '=over'. Jun 4, 2012
book-ideas add a small idea Jul 20, 2011
outline.pod

README

**NOTE**:

This repository is retained only for archival purposes.  The project is
currently considered dead and only really useful for updating the
documentation on https://doc.perl6.org.  If you are looking for documentation
about Perl 6, please search on http://doc.perl6.org and/or check out its
GitHub project: https://github.com/perl6/doc

======================================================================

We are writing a book about Perl 6.

It will be some kind of example-driven introduction to Perl 6, and at
the same time showing off the reasons why we love that language.

We plan to have monthly releases, see docs/release-guide.pod

"We" are Carl Mäsak, Jonathan Worthington, Patrick Michaud, Moritz
Lenz, Jonathan Scott Duff (Scott) and anybody who's willing to work on
it.  If you're not on that list yet, you're still very welcome to join
us.

You can find us on #perl6book on irc.freenode.net.  Logs of the IRC
discussions: <http://irclog.perlgeek.de/perl6book/> (If you do not
have an IRC client, you can use a web-based client at
<http://webchat.freenode.net/?randomnick=1&channels=perl6book&prompt=1>
)

To build the PDF version of this book, you need to have the following
software installed (for HTML output only, the first section of the prereqs
is enough; 'make html' will be your friend):

    * GNU make
    * perl 5.10
    * the Perl 5 modules:
      Pod::PseudoPod::LaTeX version 1.101050 or newer
      Template version 2.22 or newer
    * inkscape (for svg -> pdf conversion)

    * A number of LaTeX packages (see lib/*.sty). Ubuntu 10.04
      supplies most of what is needed with its texlive-latex-base,
      texlive-latex-extra, texlive-xetex, texlive-fonts-extra,
      texlive-latex-recommended and texlive-font-utils packages.

    * Adobe's fonts and B&H Luxi Sans. To get those, install
      ttf-xfree86-nonfree (and uninstall t1-xfree86-nonfree) and
      Acrobat Reader then copy *.otf from
      /opt/Adobe/Reader9/Resource/Font/ to ~/.fonts/
	
    * Run 'sudo fc-cache -f -v' to rebuild the cache in case the fonts
      are not found.

The book is produced from src/*.pod chapters ultimately rendered into
dist/*.pdf using bin/* and lib/* files.

Just type 'make' on your command line, and the book should be built in
dist/UsingPerl6.a4.pdf, with an A4 paper size; to get U.S. letter
size, type 'make PAPER=letter'. To get any PAPER width and height type
'make PAPER=6.125in,9.25in'; accepted length units are pt, in, cm and mm.

PDF versions of this book can be found at 
http://puffin.ch/perl/6/ and http://github.com/perl6/book/downloads

All material in this repository is licensed under a CC-by-nc-sa
license: <http://creativecommons.org/licenses/by-nc-sa/2.5/>
(attribution, noncommercial, share-alike), unless explicitly stated
otherwise.

(Maybe we'll open up towards removing the noncommercial part at some
point).
Something went wrong with that request. Please try again.