Liking cljdoc? Tell your friends :D

grammar.lang.perl

Perl as a target language: literal encoders, realizations, context wrappers and the probes behind every capability they rely on.

Exports data in exactly the shapes of grammar.realize and grammar.probe. module bundles them for grammar.core/compose, and grammar.core/modules includes it by default.

Strings are bytes. A Perl literal here denotes the UTF-8 bytes of the intent's string as a byte string (every char < 256, no utf8 flag), and every handle written to is binmode'd first, so no I/O layer (PERL_UNICODE, -C, a locale) can re-encode what is printed.

Capabilities (all probed through the shell, all needing :interp/perl):

:interp/perl perl -e runs a program from the PATH :pl/binmode binmode(STDOUT) makes STDOUT a raw byte stream :pl/print print(STDOUT ...) writes and reports success :pl/syswrite syswrite writes unbuffered and returns a byte count :pl/open-write 3-arg open(..., '>', path) creates/truncates a file :pl/sysopen Fcntl loads and sysopen(O_WRONLY|O_CREAT|O_TRUNC) works :pl/system system with a LIST runs a program (no shell) and waits

Perl as a target language: literal encoders, realizations, context
wrappers and the probes behind every capability they rely on.

Exports data in exactly the shapes of grammar.realize and grammar.probe.
`module` bundles them for grammar.core/compose, and grammar.core/modules
includes it by default.

Strings are bytes. A Perl literal here denotes the UTF-8 bytes of the
intent's string as a byte string (every char < 256, no utf8 flag), and
every handle written to is binmode'd first, so no I/O layer (PERL_UNICODE,
-C, a locale) can re-encode what is printed.

Capabilities (all probed through the shell, all needing :interp/perl):

  :interp/perl     perl -e runs a program from the PATH
  :pl/binmode      binmode(STDOUT) makes STDOUT a raw byte stream
  :pl/print        print(STDOUT ...) writes and reports success
  :pl/syswrite     syswrite writes unbuffered and returns a byte count
  :pl/open-write   3-arg open(..., '>', path) creates/truncates a file
  :pl/sysopen      Fcntl loads and sysopen(O_WRONLY|O_CREAT|O_TRUNC) works
  :pl/system       system with a LIST runs a program (no shell) and waits
raw docstring

grammar.lang.php

PHP as a target language, as data in the shapes of grammar.realize and grammar.probe.

realizations :lit, :str and :write-file rendered in :php. Each one requires :php.fn/<f> for every PHP function its text calls, so a function removed with -d disable_functions=... takes the realizations that call it out of the search. Language constructs (echo, eval, exit) are not functions and cannot be disabled; they require nothing. wrappers context emitters into and out of PHP: sh running php -r, php eval, php running sh or python3 through proc_open, python running php through subprocess. probes :interp/php, :php/first-class-callable, :php/proc-open-argv, then one function_exists probe per function the realizations and wrappers call. Each needs :interp/php, so without php they are skipped and stay :unknown.

module bundles the three for grammar.core/compose, and grammar.core/modules includes it by default.

PHP as a target language, as data in the shapes of grammar.realize and
grammar.probe.

realizations  :lit, :str and :write-file rendered in :php. Each one
              requires :php.fn/<f> for every PHP function its text calls,
              so a function removed with `-d disable_functions=...` takes
              the realizations that call it out of the search. Language
              constructs (echo, eval, exit) are not functions and cannot
              be disabled; they require nothing.
wrappers      context emitters into and out of PHP: sh running php -r,
              php eval, php running sh or python3 through proc_open,
              python running php through subprocess.
probes        :interp/php, :php/first-class-callable, :php/proc-open-argv,
              then one function_exists probe per function the realizations
              and wrappers call. Each needs :interp/php, so without php
              they are skipped and stay :unknown.

`module` bundles the three for grammar.core/compose, and
grammar.core/modules includes it by default.
raw docstring

cljdoc builds & hosts documentation for Clojure/Script libraries

Keyboard shortcuts
Ctrl+kJump to recent docs
←Move to previous article
→Move to next article
Ctrl+/Jump to the search field
× close