Commit Graph

154 Commits

Author SHA1 Message Date
Matthew Flatt
90455e2d6a add tests for examples 2015-12-13 09:09:33 -07:00
Matthew Flatt
ad9a465ab1 Latex: 'inset style renders through a SInsetFlow environment 2015-12-13 07:40:26 -07:00
Matthew Flatt
50f835c4f1 add scribble/examples
The `scribble/examples` library provides a cleaner and more modern
interface for evaluation compared to `scribble/eval`.
2015-12-11 11:54:07 -07:00
Matthew Flatt
f1f47c5f16 scribble/examples: revert logging change, add options
The error-logging change in 81aeab1687 didn't work well for me
in further experiments. Change `interactions`, etc., to have a
`#:no-errors?` argument, instead. Also, add `eval:no-prompt`,
which provides an alternative to `def+int`.

Improve the documentaiton by correcting mistakes and filling
in some missing exports.
2015-12-11 10:03:31 -07:00
Matthew Flatt
0bd9a0d070 examples: add "Examples:" label as compound para
Instead of creating a table to combine "Examples:" with the exmaple
content, use a compound paragraph (which didn't exist when `examples`
was first implemented). A compound paragraph provides better and more
consistent typesetting; for example, it doesn't make the word
"Examples:" use a fixed-width font in HTML output.
2015-12-10 09:24:34 -07:00
Matthew Flatt
81aeab1687 scribble/eval: add eval:error and logging of other exceptions
When an expression in `examples` or `interactions` raises an
exception, the error message is rendered as part of the documentation.
Now, however, unless the expression is wrapped with `eval:error`, an
error is also logged.

Logging an error is a compromise between backward compatibility (for
documents that rely on undeclared but expected errors) and making a
document fail completely (which would be nicer when an error is not
expected).
2015-12-10 08:33:00 -07:00
Matthew Flatt
f637b94a61 evaluate expression only once for eval:check 2015-12-10 08:06:41 -07:00
Matthew Flatt
904f83ecf3 rely on syntax objects preserving source locations
Rely on the representation of source locations in syntax objects, so
that its marshaling can take care of problems with absolute paths.
2015-12-09 17:24:20 -07:00
Matthew Flatt
6b8490b78b scribble/sigplan: add to-appear 2015-11-23 12:22:31 -07:00
Matthew Flatt
efae6bd375 Latext rendered: support single-line box characters (light and heavy) 2015-11-08 07:32:58 -07:00
Robby Findler
e0bbdf62bf add support for alternative unicode for white square brackets
please include in 6.3
2015-10-18 07:57:28 -05:00
Matthew Flatt
5bd82177cb Latex rendering for not-in character 2015-10-17 12:18:52 -06:00
Matthew Flatt
a2f430020a scribble/eval: strip away code:contracts
Make `code:contract` handled like `code:comment` for evaluation.

Relevant to PR 15161
2015-10-02 15:24:08 -06:00
Alexis King
6b1a49f929 Fix typo in CLI help (speficic -> specific) 2015-10-02 11:32:40 -05:00
Vincent St-Amour
70844e237b Remove dependency on eli-tester.
Was causing dependency issues on the Debian package builds.
2015-09-26 21:49:01 -05:00
AlexKnauth
5d15699944 link the #lang in codeblocks
This makes the codeblock form output a (hash-lang) element for the
#lang, which is consistent with racketblock
2015-09-07 11:08:27 -06:00
Alexis King
f33e8c0746 Fix eval:check in interaction to properly validate its arguments 2015-08-25 17:14:34 -05:00
Vincent St-Amour
1a6f1b593e Remove dependency on unstable/struct. 2015-08-19 14:18:53 -05:00
Matthew Flatt
e0a14fa28d tabular: fix insertion of separator before 'cont
Use 'cont before a 'cont cell instead of adding a separator.
2015-08-04 09:44:36 -06:00
Vincent St-Amour
ea70707036 Merge unstable/sandbox with scribble/eval. 2015-07-23 15:04:44 -05:00
Matthew Flatt
8a490208c5 fix racketgrammar, etc., treatment of ... for new macro system
The `(let ([... _]) _)` trick to hide the binding of `...` no
longer works; explicitly strip the context of any `...`,
instead.
2015-07-16 08:40:04 -06:00
Matthew Flatt
6d440f5a6b fix more problems with a generated doc submodule
One problem involved context that should not be included in
a generated submodule, while another one was an issue with
the previous repair to the shift to label phase.
2015-07-16 08:40:04 -06:00
AlexKnauth
b1d380d4b5 convert blueboxes.rkt to typed racket 2015-07-11 09:53:54 -05:00
Matthew Flatt
b812869d3e drop 'aux elements from left-margin contents
Removing aux elements for the left-margin contexts makes link
rendering consistent with other hyperlinks.
2015-06-09 07:09:38 -06:00
Matthew Flatt
c1df897ab3 fix codeblock to use location only for current source 2015-06-09 07:09:11 -06:00
Matthew Flatt
2c45064376 scribble/jfp: work around a collision with mathabx 2015-05-28 16:23:16 -06:00
Alex Suraci
e00eb753c3 markdown hyperlinks can now contain other content
e.g. [**foo** `bar` _baz_](http://example.com)
2015-05-12 09:33:45 -06:00
Alex Suraci
fc08b7ba49 refactor markdown renderer a bit
* favor recursion for wrapping text in markdown notation
* simplify params to just bool, use parameterize with recursion
2015-05-12 09:19:48 -06:00
Robby Findler
5a4e791826 another bug fix like the one in a7cf8d0f5e
thanks to Alexander D. Knauth for spotting this!
2015-04-25 18:18:16 -05:00
Robby Findler
a7cf8d0f5e only fill in meth-ht when there is a tag-ht to pull from 2015-04-25 17:25:08 -05:00
Robby Findler
b3719378fc adjust the code that initializes the cache to be more defensive 2015-04-25 07:09:03 -05:00
Robby Findler
b2255631a8 update version number to allow dependencies on new exports in commits
e6630f0e9 and 39e0f6aec
2015-04-15 05:47:02 -05:00
Robby Findler
ec50ab1afe make blueboxes library work properly when the blueboxes.rktd files content changes 2015-04-15 05:44:57 -05:00
Robby Findler
e6630f0e97 add fetch-blueboxes-method-tags and improve the sanitization of the blueboxes data 2015-04-15 03:41:54 -05:00
Robby Findler
39e0f6aecd add some tag predicates and tag manipulation functions 2015-04-15 03:39:32 -05:00
Robby Findler
17a317fe3d fix default value of #:blueboxes-dirs 2015-04-13 12:18:12 -05:00
Robby Findler
f7672c6186 fix classes so we can see the constructor in the blueboxes now 2015-04-13 09:41:32 -05:00
Robby Findler
9b026739ed refactor blueboxes support code to avoid dependency on racket-index pkg 2015-04-12 16:34:32 -05:00
Robby Findler
1b4b474785 add missing dependency 2015-04-12 06:33:15 -05:00
Robby Findler
b4baa18801 use get-rendered-doc-directories to find the blueboxes.rktd files 2015-04-11 18:01:57 -05:00
Matthew Flatt
5ab18e0db8 scriblb/bibtex: fix author parsing
Closes #2.
2015-03-26 13:33:36 -06:00
Matthew Flatt
76e3ed8ec3 scriblib/figure: add 'never-indents to generated block
The 'never-indents style property prevents a blank link from
being generated in certain cases for Latex/PDF output.

Closes #1.
2015-03-26 13:28:30 -06:00
Matthew Flatt
46e637d019 more Unicode->Latex conversions
Latex output now depends on the "mathabx" package.
2015-03-19 12:43:06 -06:00
Matthew Flatt
5a752f5022 scribble/srcdoc: adjust shift to label phase
Use a technique that depends less on exactly what a shift to the
label phase means when additional bindings are introduced.
2015-02-25 21:05:15 -07:00
Matthew Flatt
4a52d3c57c racketblock: add "#i" to an inexact number to match source span
This heuristic could go slightly wrong, for example causing "10.000"
to render as "#i10.0" instead of "10.0", but it won't affect cases
where the output already matched the input.
2015-02-21 14:12:38 -07:00
Matthew Flatt
6556e9f92a add x-source-pkg to HTML output 2015-02-15 10:26:43 -07:00
Matthew Flatt
a8024d16ed fix alignment of contracts for PDF output 2015-02-10 12:21:27 -07:00
Matthew Flatt
d5e244a068 Fix #:redirect-main/--redirect-main for only main installation
The intent was for the redirection to apply only to links to
documentation in the main installation, but it also affected
other paths.
2015-02-02 21:28:45 +01:00
Matthew Flatt
2eb3c62bd6 fix index generation for Latex/PDF output 2015-01-24 10:09:57 -07:00
Vincent St-Amour
064ccc9bfc Add registered and copyright symbols to LaTeX renderer. 2015-01-09 12:13:19 -05:00
Matthew Flatt
8e4e2e3405 revert enabling of DrRacket's Scribble buttons for scribble/lp
The buttons should be enabled for `scribble/lp2`, only.
2014-12-15 18:18:23 -07:00
Matthew Flatt
f9622dabf3 add scribble/lp2
Unlike `scribble/lp` a programm written with `scribble/lp2` can be used
directly, due to its `doc` submodule.
2014-12-15 18:05:14 -07:00
Matthew Flatt
2f3e989cf5 repair quadraic behavior for a Scribble document's top level
The recursive macro used by `#%module-begin` had a `...` in a pattern
that only matches once, but the match is attempted every time around,
and the `...` list accumulated the body of the module.

Thanks to Shriram Krishnamurthi for reporting the problem.
2014-12-12 08:25:58 -07:00
Sam Tobin-Hochstadt
a316fc12c0 Remove extra directories. 2014-12-02 00:54:52 -05:00