X-Git-Url: https://gitweb.factorcode.org/gitweb.cgi?p=factor.git;a=blobdiff_plain;f=basis%2Falien%2Fc-types%2Fc-types-docs.factor;h=c425d290edcc173bbcc4ec40f40e5f58043899aa;hp=57a24f36e228566fbf5e6984e7b2af496d5fc6ec;hb=98e31346d3ddd0f54d622e6ec489bdb48e090355;hpb=cead9c7849b94122470882d5882131f323c4604f diff --git a/basis/alien/c-types/c-types-docs.factor b/basis/alien/c-types/c-types-docs.factor index 57a24f36e2..c425d290ed 100644 --- a/basis/alien/c-types/c-types-docs.factor +++ b/basis/alien/c-types/c-types-docs.factor @@ -83,7 +83,7 @@ $nl "Pointer output values are represented in Factor as " { $link alien } "s. If the pointed-to type is a struct, the alien will automatically be wrapped in a struct object if it is not null." $nl "In " { $link POSTPONE: TYPEDEF: } ", " { $link POSTPONE: FUNCTION: } ", " { $link POSTPONE: CALLBACK: } ", and " { $link POSTPONE: STRUCT: } " definitions, pointer types can be created by suffixing " { $snippet "*" } " to a C type name. Outside of FFI definitions, a pointer C type can be created using the " { $link POSTPONE: pointer: } " syntax word:" -{ $unchecked-example "FUNCTION: int* foo ( char* bar ) ;" } +{ $unchecked-example "FUNCTION: int* foo ( char* bar )" } { $unchecked-example ": foo ( bar -- int* ) pointer: int f \"foo\" { pointer: char } f alien-invoke ;" } } ; @@ -136,20 +136,20 @@ ARTICLE: "c-types.ambiguity" "Word name clashes with C types" "If you use the wrong vocabulary, you will see a " { $link no-c-type } " error. For example, the following is " { $strong "not" } " valid, and will raise an error because the " { $link math:float } " word from the " { $vocab-link "math" } " vocabulary is not a C type:" { $code "USING: alien.syntax math prettyprint ;" - "FUNCTION: float magic_number ( ) ;" + "FUNCTION: float magic_number ( )" "magic_number 3.0 + ." } "The following won't work either; now the problem is that there are two vocabularies in the search path that define a word named " { $snippet "float" } ":" { $code "USING: alien.c-types alien.syntax math prettyprint ;" - "FUNCTION: float magic_number ( ) ;" + "FUNCTION: float magic_number ( )" "magic_number 3.0 + ." } "The correct solution is to use one of " { $link POSTPONE: FROM: } ", " { $link POSTPONE: QUALIFIED: } " or " { $link POSTPONE: QUALIFIED-WITH: } " to disambiguate word lookup:" { $code "USING: alien.syntax math prettyprint ;" "QUALIFIED-WITH: alien.c-types c" - "FUNCTION: c:float magic_number ( ) ;" + "FUNCTION: c:float magic_number ( )" "magic_number 3.0 + ." } "See " { $link "word-search-semantics" } " for details." ;