Permalink
Browse files

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

git-svn-id: http://svn.pugscode.org/pugs@25650 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
@@ -0,0 +1,52 @@
+
+=encoding utf8
+
+=head1 Title
+
+DRAFT: Synopsis 21: Calling Foreign Code
+
+=head1 Version
+
+ Author: Tim Nelson <wayland@wayland.id.au>
+ Maintainer: Larry Wall <larry@wall.org>
+ Contributions: Tim Nelson <wayland@wayland.id.au>
+ Larry Wall <larry@wall.org>
+ 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.