Browse files

Wrote this a few days ago, but forgot to svn add.

git-svn-id: c213334d-75ef-0310-aa23-eaa082d1ae64
  • Loading branch information...
1 parent 704bb79 commit 5b9746af48bca421f828c1a7f6a064305868f06c wayland committed Mar 2, 2009
Showing with 52 additions and 0 deletions.
  1. +52 −0 S21-calling-foreign-code.pod
52 S21-calling-foreign-code.pod
@@ -0,0 +1,52 @@
+=encoding utf8
+=head1 Title
+DRAFT: Synopsis 21: Calling Foreign Code
+=head1 Version
+ Author: Tim Nelson <>
+ Maintainer: Larry Wall <>
+ Contributions: Tim Nelson <>
+ Larry Wall <>
+ Date: 27 Feb 2009
+ Last Modified: 27 Feb 2009
+ Version: 1
+The document is a draft.
+If you read the HTML version, it is generated from the pod in the pugs
+repository under /docs/Perl6/Spec/S21-calling-foreign-code.pod so edit it there in
+the SVN repository if you would like to make changes.
+=head1 Overview
+Unfortunately, calling foreign code properly is quite platform dependent. This means that
+parts of the external calling conventions can't be standardised. But the parts that can
+be standardised are specified here.
+=head1 Specification
+The C<use> statement allows an external language to be specified in
+addition to (or instead of) an authority, so that you can use modules
+from other languages. The C<from> adverb also parses any additional
+parts as short-form arguments. For instance:
+ use Whiteness:from<perl5>:name<Acme::Bleach>:ver<1.12>:auth<cpan:DCONWAY>;
+ use Whiteness:from<perl5 Acme::Bleach 1.12 cpan:DCONWAY>; # same thing
+ use libc:from<C>;
+=head1 Other Considerations
+=head2 Linking to common platforms
+XXX We need a discussion of how to link to some of the common platforms
+=head1 Additions
+Please post errors and feedback to perl6-language. If you are making
+a general laundry list, please separate messages by topic.

0 comments on commit 5b9746a

Please sign in to comment.