This site

This site is the successor to the Mediawiki site – which for now can still be found at http://code.kx.com/wiki. The Reference section has been migrated from the wiki; the Cookbook will follow.

Reference

The wiki’s Reference section, organised by glyphs, was a good tool for reading q. It was easy to find, for example, all the possible meanings of $. On the other hand, a writer looking for tools to convert between datatypes and representations would have to explore most of the Reference section to be confident she had found them all.

The new site reference has three aims:

  • to be a fast prompt for things already learned
  • to help reading by showing what terms mean
  • to help writing by categorising the tools

Terminology

We have revised the terms in which we talk about q to align them with common usage. You will find operators and unary and binary functions applied prefix, infix and postfix. Q’s adverbs still need their distinctive name, but you will no longer find references to verbs, monads or dyads.

We also now distinguish consistently between glyphs and what they denote. In some cases we’ve had to coin new names for what was previously conflated. So, for example, / denotes three adverbs: over, fold and converge-repeat.

Overloads such as these are distinguished in use by syntax and arguments. Every operator, function and adverb now has its syntax and arguments consistently and clearly described.

Open source

A finished work is exactly that, requires resurrection.
John Cage, “Lecture on Nothing”, 1949

The repository for this site is github.com/KxSystems/docs.

The contribution model for this site is GitHub and Forking Workflow. To contribute, submit a pull request.

Contact

A librarian’s job is to put information where people can find it.

This site is maintained by the Librarian.