r26623 - docs/Perl6/Spec

2009-05-02 Thread pugs-commits
Author: hinrik Date: 2009-05-03 05:20:40 +0200 (Sun, 03 May 2009) New Revision: 26623 Modified: docs/Perl6/Spec/S26-documentation.pod Log: [S26] Let's eat some more of our own dog food by using semantic Pod blocks where we can Modified: docs/Perl6/Spec/S26-documentation.pod ==

Docstrings in Perl 6

2009-05-02 Thread Hinrik Örn Sigurðsson
I've been thinking lately about how Perl 6 might offer functionality similar to Python's docstrings. That is, documentation which is tied directly to a particular routine, class or module[1]. This is something which would is very useful in a REPL, and for documentation readers[2]. Taking one case,