Changeset 34214 in project


Ignore:
Timestamp:
06/27/17 18:41:15 (3 months ago)
Author:
kon
Message:

rel 2.4

File:
1 edited

Legend:

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

    r34118 r34214  
    6060This procedure must at least have the signature of a SRFI 28 {{format}}
    6161procedure. The default is the Chicken {{extras#format}} procedure.
    62 
    63 This is '''not''' a {{paramter}} but a {{variable}}. It is '''not''' ''thread-local''.
    6462
    6563==== reset-locale-parameters
     
    109107filesystem for the bundle database.
    110108
    111 Bundles are stored in the system bundle directory, {{(make-pathname
    112 (repository-path) "srfi-29-bundles")}}, unless an {{ALTERNATE}} directory is
    113 specified.
     109Bundles are stored in the {{system-bundle-directory}}, unless an {{ALTERNATE}}
     110directory is specified.
    114111
    115112Within a bundle directory the structure is {{(directory [LANGUAGE] [COUNTRY] [SCRIPT]
    116113[CODESET] [MODIFIER] PACKAGE-NAME)}}.
     114
     115==== system-bundle-directory
     116
     117<parameter>(system-bundle-directory [DIRECTORY-PATHNAME])</parameter>
     118
     119Initially {{DIRECTORY-PATHNAME}} is {{(make-pathname (repository-path)
     120"srfi-29-bundles")}}.
    117121
    118122==== store-bundle!
     
    259263This can be used to extend the meaning of a package template at runtime. For
    260264example: caching the actual closure for a named procedure.
     265
     266==== localized-templates
     267
     268<procedure>(localized-templates PACKAGE-NAME) => list</procedure>
     269
     270Returns an association-list of all the templates for the {{PACKAGE-NAME}}.
    261271
    262272==== load-localized-compiled-code
     
    273283
    274284{{LIBRARY}} is an absolute {{pathname}}, relative {{pathname}}, or {{(unitname
    275 pathname)}}. The corresponding load call is {{load-relative}}, {{load-relative}}, and
    276 {{load-library}}. (See [[Unit eval]].)
     285pathname)}}. The corresponding load call is {{load-relative}},
     286{{load-relative}}, and {{load-library}}. (See [[Unit eval]].)
    277287
    278288{{TEMPLATE-NAMES}} is a {{list}} of {{template-name}}.
     
    286296{{pathname}} is needed.
    287297
    288 ==== localized-templates
    289 
    290 <procedure>(localized-templates PACKAGE-NAME) => list</procedure>
    291 
    292 Returns an association-list of all the templates for the {{PACKAGE-NAME}}.
     298This is an experimental API.
    293299
    294300
     
    309315=== Thread Local Storage
    310316
    311 Just as the [[locale]] extension supports per thread locale information so does
    312 this extension support per thread bundles. However, localized information is
    313 probably accessed more frequently than locale information. So the support for
    314 per thread bundles is delayed until runtime. Setting the environment variable
    315 {{SRFI29_TLS}} to {{[Yy1]}} will activate the feature.
     317Just as the [[locale]] extension supports per thread locale information so
     318does this extension support per thread bundles. However, localized information
     319is probably accessed more frequently than locale information. So the support
     320for per thread bundles is delayed until runtime. Setting the environment
     321variable {{SRFI29_TLS}} to {{[Yy1]}} before loading the runtime will activate
     322the feature.
    316323
    317324When active each thread may have a different bundle for a package; i.e. a user
     
    331338another thread be performing the same action.
    332339
    333 Just do not allow this to happen.
    334 
    335340* The locale symbols must have a lowercase printname! As such they do not truly
    336341reflect ISO 639-1/2 & ISO 3166-1 standard names. This is a SRFI 29 restriction.
     
    346351== Requirements
    347352
     353[[miscmacros|miscmacros]]
    348354[[lookup-table|lookup-table]]
    349 [[variable-item|variable-item]]
    350355[[posix-utils|posix-utils]]
    351356[[locale|locale]]
    352357[[check-errors|check-errors]]
     358[[condition-utils|condition-utils]]
    353359
    354360
     
    357363* Currently there is no support for source-form code. Such is considered an
    358364even worse security-hole than loading compiled code. However, a possibility is
    359 use of the [[sandbox]]. Should there be sufficient interest this area
    360 can be explored.
     365use of the [[sandbox]].
    361366
    362367* {{store-bundle!}} does not ensure filemode of 'a+rx' for the created directory tree.
     
    370375== Version history
    371376
     377; 2.4.0 : Changed {{current-locale-format-function}} to {{parameter}}. Documented {{system-bundle-directory}}.
    372378; 2.3.3 :
    373379; 2.3.2 : Ensures filemode of 'a+rx' for bundles directory.
Note: See TracChangeset for help on using the changeset viewer.