Changeset 35216 in project


Ignore:
Timestamp:
02/25/18 21:25:51 (4 months ago)
Author:
kon
Message:

expand load-localized-compiled-code doc

File:
1 edited

Legend:

Unmodified
Added
Removed
  • wiki/eggref/4/srfi-29

    r34214 r35216  
    7575{{(PACKAGE-NAME [LANGUAGE] [COUNTRY] [DETAILS...])}}.
    7676
    77 * A {{BUNDLE-ALIST}} is an association-list over with key {{TEMPLATE-NAME}} &
    78 value {{TEMPLATE-VALUE}}. The association-list elements must be of the form
    79 {{(TEMPLATE-NAME . TEMPLATE-VALUE)}}.
    80 
    81 That is {{(cons 'template-example 'value-example)}} is legal, whereas {{(list
     77* A {{TEMPLATE-NAME}} is something suitable as a key, such as a {{symbol}} or
     78{{string}}, but can be any {{object}} with a readable printname.
     79
     80* A {{TEMPLATE-VALUE}} maybe any object, but should have a readable printname.
     81
     82* A {{BUNDLE-ALIST}} is an alist with key {{TEMPLATE-NAME}} & value
     83{{TEMPLATE-VALUE}}.
     84
     85So {{(cons 'template-example 'value-example)}} is legal, whereas {{(list
    8286'template-example 'value-example)}} is not. The form {{(list 'template-example
    8387'value-example)}} will have the value {{(list 'value-example)}}, and not
    8488{{'value-example}}, as expected.
    8589
    86 * A {{TEMPLATE-NAME}} is something suitable as a key, such as a {{symbol}} or
    87 {{string}}, but can be any {{object}} with a readable printname.
    88 
    89 * A {{TEMPLATE-VALUE}} maybe any object, but should have a readable printname.
    90 
    9190==== declare-bundle!
    9291
     
    174173<procedure>(declared-bundle-templates BUNDLE-SPECIFIER) => list</procedure>
    175174
    176 Returns an association-list of all the templates for the {{BUNDLE-SPECIFIER}}.
     175Returns an alist of all the templates for the {{BUNDLE-SPECIFIER}}.
    177176
    178177==== most-specific-bundle-specifier
     
    268267<procedure>(localized-templates PACKAGE-NAME) => list</procedure>
    269268
    270 Returns an association-list of all the templates for the {{PACKAGE-NAME}}.
     269Returns an alist of all the templates for the {{PACKAGE-NAME}}.
    271270
    272271==== load-localized-compiled-code
     
    286285{{load-relative}}, and {{load-library}}. (See [[Unit eval]].)
    287286
    288 {{TEMPLATE-NAMES}} is a {{list}} of {{template-name}}.
    289 
    290 A {{variable-reference}} is a {{symbol}} or {{(symbol symbol)}}. The later is a
    291 {{module}} import reference; this is a ''brittle'' feature as it relies upon
    292 knowledge of implementation details.
    293 
    294 ''Note'' that only {{load-relative}} is used for a library {{pathname}}. Be sure
     287; {{TEMPLATE-NAMES}} : {{(list-of template-name)}}.
     288; {{template-name}} : {{(or TEMPLATE-NAME variable-reference)}}.
     289;{{variable-reference}} : {{(or symbol (symbol symbol))}}.
     290
     291'''Note''' {{(symbol symbol)}} in {{variable-reference}} is a {{module}}
     292import reference; this is a ''brittle'' feature as it relies upon knowledge of
     293implementation details.
     294
     295'''Note''' that only {{load-relative}} is used for a library {{pathname}}. Be sure
    295296to provide an {{absolute-pathname}} when a {{current-directory}} relative
    296297{{pathname}} is needed.
Note: See TracChangeset for help on using the changeset viewer.