Skip to content

Commit 3d03f5c

Browse files
author
Matthew King
committed
Clear as mud - be explicit about the definition of 'module'.
1 parent 7882ee7 commit 3d03f5c

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

doc/Language/modules.pod

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -21,13 +21,16 @@ files in a namespace.
2121
2222
=head2 Basic Structure
2323
24-
Module distributions in Perl 6 have the same structure as any distribution in
25-
the Perl family of languages: there is a main project directory containing
26-
a C<README> and C<LICENSE> file, a C<lib> directory for modules, a C<t>
27-
directory for tests, and possibly a C<bin> directory for executable programs
28-
and scripts.
29-
30-
Module files generally use the standard C<.pm> extension, and scripts or
24+
Module distributions (in the I<set of related source files> sense) in Perl 6
25+
have the same structure as any distribution in the Perl family of languages:
26+
there is a main project directory containing a C<README> and a C<LICENSE> file,
27+
a C<lib> directory for the source filesE<mdash>which may be individually
28+
referred to as modules and/or may themselves define modules with the C<module>
29+
keywordN<As L<synopsis S11|https://design.perl6.org/S11.html#Units> says:
30+
Confusing? Yes it is.>, a C<t> directory for tests, and possibly a C<bin>
31+
directory for executable programs and scripts.
32+
33+
Source files generally use the standard C<.pm> extension, and scripts or
3134
executables use C<.pl>. However, if you wish to highlight that the file is
3235
written in Perl 6 you can use the C<.pm6> extension for modules, and the
3336
C<.p6> extension for scripts. Test files still use the normal C<.t>

0 commit comments

Comments
 (0)