Eli Barzilay
6b2b784e79
Further improvements to the documentation search.
...
Revise the subword matching to have three different levels for full
match (= a permutation of the input), a generic match for all parts, and
everything else.
2012-06-14 15:46:53 -04:00
Eli Barzilay
ecc43ff104
Improve the documentation search code.
...
Instead of just one array for exact results and one for all the rest,
use one array for each possible comparison result, and concatenate them
all for the final list.
2012-06-14 15:46:53 -04:00
Matthias Felleisen
f82f528a8c
added 'boolean' to the grammars for the *SLs, fixing an emailed bug report from Klause Ostermann. -- To avoid the 'true, '(true) etc issue I ommitted boolean from the [quasi]quoted grammar, which makes the current behavior kind of correct.
2012-06-14 14:20:46 -04:00
Asumu Takikawa
6c569415cc
Update list of redirected procedures in docs
2012-06-13 14:28:01 -04:00
Matthew Flatt
a871574318
make #%plain-module-begin' transformer detect
module*' in stop list
2012-06-13 17:07:06 +08:00
Asumu Takikawa
4ce4d7531b
Improve docs & errors for control proxies
...
In particular, use consistent terminology for errors
and provide usage examples
2012-06-12 12:16:56 -04:00
Asumu Takikawa
87ecb55d40
Documentation for control proxies & prompt/c
2012-06-11 18:18:37 -04:00
Asumu Takikawa
c9fd4ef538
Fix docs for impersonate/chaperone-box
2012-06-11 17:28:38 -04:00
Robby Findler
e9ddc54b18
added the #:draw-border? argument to disk and filled-ellipse
2012-06-10 11:53:54 -05:00
Vincent St-Amour
ede83be3fb
Fix docs for unsafe-flmin and unsafe-flmax.
...
Closes PR12826.
2012-06-09 09:20:55 -04:00
Rodolfo Henrique Carvalho
1b5069f47a
Fix minor typo
2012-06-09 09:20:55 -04:00
Matthew Flatt
815fd1b49c
misc changes to speed up doc search generation
...
Cuts about 30% of the time on my machine.
2012-06-08 16:08:55 +08:00
Matthew Flatt
fbb6a294f3
local-expand' allows a stop list to have only
module*'
...
That is, when the sto plist contains only `module*', core
forms are not implicitly added to the stop list.
2012-06-08 16:08:55 +08:00
Neil Toronto
b7fea6be5a
Fixed contracts on exact-round, etc.
2012-06-06 16:16:52 -06:00
Neil Toronto
e644e6afb1
Documented new additions to racket/math
2012-06-06 11:31:49 -06:00
Matthew Flatt
c5f821b641
clarifications and additions to style guide
2012-06-03 04:50:06 +08:00
Matthew Flatt
900b66332c
adjust `racket/generic' documentation style
2012-06-03 04:50:06 +08:00
Matthew Flatt
85a2267e6c
ffi/unsafe: new error message convention at primitives
...
Also, fix FFI procedures to preserve names: change `ptr-ref' with
`_fpointer' on an `ffi-obj' value to return the `ffi-obj'
value, so that the name in the `ffi-obj' value can be used
by `_cprocedure'.
Closes PR 12645
2012-06-01 19:03:43 -07:00
Sam Tobin-Hochstadt
725854f66c
Flag booleans *follow* the arguments for optional keywords.
2012-06-01 14:50:39 -04:00
Robby Findler
37ebbfa635
adjust global-port-print-handler's documented contract to match
...
what it does (and what the text says)
2012-05-30 22:31:55 -05:00
Vincent St-Amour
84c6fe1522
Don't index some subsubsections of the text editor docs.
...
Closes PR 12801.
2012-05-30 16:25:33 -04:00
Matthew Flatt
74844152bc
fix load handlers to match docs on parameters
...
Problems exposed by setting `read-accept-lang' to #f.
2012-05-29 13:57:32 -06:00
Matthew Flatt
def4da4f9a
doc fix
...
Closes PR 12796
2012-05-29 11:01:52 -06:00
Matthew Flatt
26269c329e
racket/base: add some missing predicates
...
The new predicates are `progress-evt?' `thread-cell-values?',
`prefab-key?', `semaphore-peek-evt?', and `channel-put-evt?'.
These were used internally, and now they appear in contract
error messages.
2012-05-29 11:01:52 -06:00
Matthew Flatt
b098ca7aa6
slideshow: run a slideshow' or
main' submodule, if any
...
A common Slideshow pattern is to put a subset of slides in its
own module with a `run-slides' function, and then you'd
(un)comment a `(run-slides)' call at the end of the module to
work on the subset by itself. Now, you can write
`(module+ main (run-slides))' atthe end of the module and not
have to comment it out. Adding `main' support to the `slideshow'
executable makes it more consistent with using `racket' directly.
Checking first for a `slideshow' submodule makes it possible
for `slideshow' and `racket' to do different things, in case
that's useful.
2012-05-29 11:00:43 -06:00
Matthew Flatt
0c303ca9cd
racket/cmdline add `#:ps' clause
2012-05-29 11:00:43 -06:00
Matthew Flatt
99635ab091
change `impersonate-struct' to require evidence that a field is mutable
...
When supplying an accessor to redirect, either the corresponding field
must be accessible through the current inspector, or a mutator for
the same field must be redirected, too.
Stevie realized that we need this constraint; otherwise, impersonators
can implement mutator-like behavior even when the mutator is otherwise
secret.
2012-05-27 15:37:45 -06:00
Matthew Flatt
6eeb8fccbd
more error-message conversion
2012-05-27 09:03:19 -06:00
Matthew Flatt
00ef7da640
racket/draw: background and text colors in `record-dc%'
...
Also, improve docs to clarify how the recorded settings interact with
the target DC's settings.
2012-05-27 06:38:30 -06:00
Matthew Flatt
8ab87a9fcc
racket/class: new error message convention
2012-05-26 21:08:21 -06:00
Asumu Takikawa
81d13ee7ed
racket/generic: doc improvements
2012-05-26 13:53:43 -04:00
Matthew Flatt
09cb2a348f
ffi/com: add 'variant type description
...
Used to prevent extra array dimensions and instead construct nested
arrays.
2012-05-26 06:38:02 -06:00
Matthew Flatt
d6774d5d54
racket/sandbox: add sandbox-propagate-exceptions
2012-05-25 18:37:29 -06:00
Matthew Flatt
9e7548de61
new error message convention
...
Add `raise-argument-error', `raise-result-error', `raise-arguments-error',
and `raise-range-error'.
The old convention was designed for reporting on a single (sometimes very
long line). The new convention is
<name>: <short message>
<field>: <detail>
...
If <detail> is long or itself spans multiple lines, then it may
also use the form
<field>:
<detail>
where each line of <detail> is indented by 3 spaces.
Backtrace information is shown as a multi-line "context" field.
2012-05-25 15:08:05 -06:00
Vincent St-Amour
cee88f05dd
Docs for gen:custom-write.
2012-05-24 16:51:14 -04:00
Vincent St-Amour
13b82e9a59
Reorder docs.
2012-05-24 16:51:14 -04:00
Asumu Takikawa
a22633e348
Rename generics => generic.
2012-05-24 16:51:14 -04:00
Vincent St-Amour
11dc825126
Forge gen:equal+hash and gen:custom-write to provide them from racket/base.
2012-05-24 16:51:13 -04:00
Vincent St-Amour
3210cd1d12
Remove vestigial set of parens and fix docs for new syntax.
2012-05-24 16:51:12 -04:00
Vincent St-Amour
94bd484a66
Resolve collision between class generics and struct generics.
2012-05-24 16:51:12 -04:00
Vincent St-Amour
02055aa1b3
Add remark about auxiliary definitions in method blocks.
2012-05-24 16:51:12 -04:00
Vincent St-Amour
390cd02b52
Have a generic interface for equal+hash.
...
Currently provided by racket/struct, for lack of a better place.
2012-05-24 16:51:11 -04:00
Asumu Takikawa
8ac82eaf58
Use simplified interface for define-generics
...
Also removed `generics`
2012-05-24 16:51:09 -04:00
Vincent St-Amour
3bfaa2b00b
New naming convention for generics names.
2012-05-24 16:51:07 -04:00
Asumu Takikawa
f866e34b26
Expand documentation on sequence/stream extension
2012-05-24 16:51:06 -04:00
Asumu Takikawa
3a93df5566
Use racket/generics for extensions to racket/stream
2012-05-24 16:50:44 -04:00
Vincent St-Amour
991cb5f371
Hide #:coerce-method-table from the public generics API.
2012-05-24 16:50:43 -04:00
Vincent St-Amour
d5de436b9c
Add a pointer to generics in the struct property docs.
2012-05-24 16:50:42 -04:00
Vincent St-Amour
448ad27a37
Move generics to racket/generics.
...
After discussion with Eli.
2012-05-24 16:50:42 -04:00
Vincent St-Amour
17bb9073b9
Document new dict extensibility API.
2012-05-24 16:31:32 -04:00
Eli Barzilay
f55eba70c0
Just have string-replace' now, with an
#:all?' keyword (defaulting to #t).
2012-05-24 10:40:20 -04:00
Eli Barzilay
784857e9fa
Add `string-split'.
2012-05-24 10:40:20 -04:00
Eli Barzilay
dcf2754a57
Clarify `regexp-split' on an empty input.
...
The text that says that (regexp-split #rx"whatever" "") returns '("")
rather than '() is
If `input' contains no matches [...] the result is a list containing
input’s content [...] as a single element.
This is a little implicit, if you consider such an input as having
nothing left to match over so it's as if there is no input (with a port
this confusion is a little clearer).
Clarify with an example in the docs, and also add tests.
2012-05-24 10:40:20 -04:00
Eli Barzilay
6318df82e5
Drop the now-redundant " " argument from existing uses of `string-join'.
2012-05-24 10:40:20 -04:00
Eli Barzilay
29beae55c1
Redo string-trim' and
string-normalize-spaces'.
...
This is following the mailing list discussion. In addition get
`string-join' more in-line with these by making its `sep' argument
default to a space.
2012-05-24 10:40:20 -04:00
Asumu Takikawa
94545a7cd7
Fix doc breakage.
...
`abstract` from racket/class conflicted with `abstract`
in scribble paper modules.
2012-05-22 19:55:44 -04:00
Asumu Takikawa
b50a2c7518
Add documentation for abstract clause.
2012-05-22 15:59:16 -04:00
Asumu Takikawa
be9faeac65
Minor fix in Guide section on contracts
...
Reported by Shambles
2012-05-22 10:50:46 -04:00
Matthew Flatt
5962e542f7
slideshow: add `slide->pict'
2012-05-22 06:20:54 -04:00
Kevin Tew
83c26eef4b
[Distributed Places] a few of Eli's documentation suggestions
2012-05-20 22:50:58 -06:00
Matthew Flatt
2d7521c78c
racket/place/distributed: fix doc problems
...
Various repairs --- especially to avoid duplicated prose.
Instead of
@(define explain @t{Long explanation about X...})
@defproc[(a ....) ....]{ .... @|explain| }
@defproc[(b ....) ....]{ .... @|explain| }
@defproc[(c ....) ....]{ .... @|explain| }
write
@defproc[(a ....) ....]{ .... Long explanation about X ... }
@defproc[(b ....) ....]{ .... X is like @racket[a]. }
@defproc[(c ....) ....]{ .... X is like @racket[a]. }
Otherwise, a reader is forced to reverse-engineer the
abstraction underlying `a', `b', and `c'.
2012-05-20 14:11:17 -06:00
Matthew Flatt
1ee2b6a522
slideshow: add current-gap-size' and some
#:gap-size' arguments
2012-05-20 13:39:08 -06:00
Matthew Flatt
a39d16fab4
doc layout repair
2012-05-20 07:39:05 -06:00
Robby Findler
9d000cdd1a
added thermometer
2012-05-18 10:48:24 -05:00
Robby Findler
fc3f4e675f
added a ``dissection'' of a contract error message to the Guide
...
closes PR 12738
2012-05-18 09:13:58 -05:00
Matthew Flatt
b7d5aed8d7
add "alias" and "converted-arguments-variant" properties
...
The properties appear in the inlining expansion of an application
of a keyword-accepting function, and they're mainly intended for
use by Typed Racket.
The property keys are hidden, so that the property value can be
trusted as originating from `racket/base'. The accessor functions are
`syntax-procedure-alias-property' and
`syntax-procedure-converted-arguments-property' from
`racket/keyword-transform'.
2012-05-17 10:58:22 -06:00
Matthew Flatt
3fbbf7cf94
add note about find-executable-path' to
subprocess', etc.
2012-05-16 09:43:23 -06:00
Matthew Flatt
65313a82a7
add a #:build?' argument to
directory-list'
2012-05-16 09:43:23 -06:00
Matthew Flatt
9270936a28
instantiate require'd modules in the order that they are
require'd
...
This order is now specified, whereas the order was previously unspecified,
and the previous reverse order was an artifact of the implementation.
2012-05-16 07:12:27 -06:00
Robby Findler
3fceae2715
adjusted the contract error messages so that the words expected/promised
...
are switched in and out based on the sense of the blame (similar to a recent
change that made given/produced swap in and out)
2012-05-15 22:08:42 -05:00
Matthew Flatt
e8d7b8696e
doc fix
...
Closes PR 12772
2012-05-15 20:13:12 -06:00
Matthew Flatt
b5ce4f281d
fix example
...
Closes PR 12723
2012-05-15 20:11:42 -06:00
Matthew Flatt
e35337dcfd
add `relative-in'
2012-05-15 20:03:41 -06:00
Matthew Flatt
1067aa59e3
fix docs for `syntax-local-module-exports'
2012-05-14 21:57:10 -06:00
Matthew Flatt
0653d1c966
add `syntax-local-submodules'
2012-05-14 21:57:09 -06:00
Matthew Flatt
1bf1564f90
add `variable-reference->module-path-index'
2012-05-14 21:57:09 -06:00
Kevin Tew
fbbf8579e0
[Distributed Places] Docs clean up part 2
2012-05-14 14:58:40 -06:00
Matthew Flatt
d93f4214a4
fix `compiler/zo-parse', etc. for phase-shift addition
2012-05-13 09:00:28 -06:00
Matthew Flatt
84d1c6dc06
remove sfi links from the Reference
...
In consultation with Ryan. We'd prefer to have versions of all
useful things in a `racket/...' library that is consistent as
possible with Racket forms and conventions.
2012-05-13 06:57:44 -06:00
Matthew Flatt
906180ebe8
doc edits
2012-05-13 06:57:44 -06:00
Matthew Flatt
1d1f4dfc3c
fix docs on `prop:{require,provide,provide-pre}-transformer'
2012-05-13 06:57:44 -06:00
Matthew Flatt
45659b0cc1
fix doc example
...
Closes PR 12768
2012-05-13 06:57:44 -06:00
Robby Findler
0278b9e0af
fix bug in example code noted by Ray Racine
2012-05-12 22:10:10 -05:00
Robby Findler
52fa588f7a
deprecate define-contract-struct (also fix a broken require in the contract docs)
2012-05-12 22:10:04 -05:00
Matthew Flatt
bfbccb918d
fix reference to non-existant private contract module
2012-05-12 01:37:51 -06:00
Matthew Flatt
964020f288
implement scribble/srcdoc' via submodules instead of
expand'
...
Also add a `for-doc' require form, make `proc-doc' et al. provide
forms, make `provide/doc' an alias for `provide'.
2012-05-12 01:37:50 -06:00
Matthew Flatt
1432912357
racket/draw: fix outline adjustment in `draw-rectangle' and others
2012-05-12 00:55:12 -06:00
Matthew Flatt
dbd940611e
allow #f as shift for `syntax-shift-phase-level'
2012-05-12 00:55:12 -06:00
Robby Findler
329d3bb3c8
add some example code showing how to bind a menu to a key via the keymaps
2012-05-11 07:13:55 -05:00
Kevin Tew
4c59943b0d
[Distributed Places] Remove caps and camelcase
2012-05-10 19:58:52 -06:00
Kevin Tew
154a96ab1f
[Distributed Places] Docs clean up part 1
2012-05-10 15:36:58 -06:00
Kevin Tew
076e698e8c
[Distributed Places] RMPI docs
2012-05-10 15:36:58 -06:00
Kevin Tew
c619f7cbbf
[Distributed Places] more docs, removed old functions, RMPI function renames
2012-05-10 15:36:58 -06:00
Matthew Flatt
2d027e7ee5
scribble/eval: add eval:result' and
eval:results'
2012-05-09 19:11:21 -06:00
Eli Barzilay
7738f21a5b
Move the srfi references to the section ends.
2012-05-09 04:11:17 -04:00
Eli Barzilay
f1a7517ab6
Adds note about `system*' output.
...
(Slightly revised by Eli.)
2012-05-09 03:48:55 -04:00
Michael W
267a009e03
Adds note about system* output. UNTESTED
2012-05-09 02:46:33 -04:00
Eli Barzilay
d04920c032
(Try to) Fix the section that talks about `apply' and keyword arguments.
...
Closes PR 12438.
2012-05-08 21:18:15 -04:00
Eli Barzilay
99f87cf72b
Remove prose infelicity.
...
(Reported by Shriram a while ago.)
2012-05-08 21:18:15 -04:00
Eli Barzilay
6dfcf68a12
Fix a typo.
...
Closes PR 12456.
2012-05-08 21:18:15 -04:00