catch up docs on --xelatex

Also, adjust help text for `--doc-binding` to make it
fit in 80 columns, and clean up related documentation text.
This commit is contained in:
Matthew Flatt 2017-03-03 07:46:29 -07:00
parent 5e49131e44
commit 68c4557968
4 changed files with 26 additions and 9 deletions

View File

@ -415,7 +415,20 @@ support yet.
@defmixin[render-mixin (render<%>) ()]{ @defmixin[render-mixin (render<%>) ()]{
Specializes a @racket[render<%>] class for generating PDF output via Specializes a @racket[render<%>] class for generating PDF output via
Latex, building on @|latex:render-mixin| from @racketmodname[scribble/latex-render].}} Latex, building on @|latex:render-mixin| from @racketmodname[scribble/latex-render].}
@defmixin[dvi-render-mixin (render<%>) ()]{
Like @racket[render-mixin], but generates PDF output via @exec{latex},
@exec{dvips}, and @exec{pstopdf}.
@history[#:added "1.4"]}}
@defmixin[xelatex-render-mixin (render<%>) ()]{
Like @racket[render-mixin], but generates PDF output via @exec{xelatex}.
@history[#:added "1.19"]}
@; ---------------------------------------- @; ----------------------------------------

View File

@ -35,6 +35,9 @@ its file suffix:
@item{@DFlag{pdf} --- PDF @filepath{@|fn|.pdf} that is generated @item{@DFlag{pdf} --- PDF @filepath{@|fn|.pdf} that is generated
via @exec{pdflatex}} via @exec{pdflatex}}
@item{@DFlag{xelatex} --- PDF @filepath{@|fn|.pdf} that is generated
via @exec{xelatex}}
@item{@DFlag{dvipdf} --- PDF @filepath{@|fn|.pdf} that is generated @item{@DFlag{dvipdf} --- PDF @filepath{@|fn|.pdf} that is generated
via @exec{latex}, @exec{dvips}, and @exec{pstopdf}} via @exec{latex}, @exec{dvips}, and @exec{pstopdf}}
@ -65,16 +68,17 @@ source declares a module. The module should either have a @racket[doc]
that exports @racket[doc] as a @racket[part], or it should directly that exports @racket[doc] as a @racket[part], or it should directly
export @racket[doc] as a @racket[part]. (The submodule is tried first, export @racket[doc] as a @racket[part]. (The submodule is tried first,
and the main module is not directly loaded or evaluated if the and the main module is not directly loaded or evaluated if the
submodule can be loaded on its own.) (Use @DFlag{doc-binding} to submodule can be loaded on its own.) Use @DFlag{doc-binding} to
change @racket[doc] to another symbol.) access an alternate exported name in place of @racket[doc].
When multiple documents are rendered at the same time, cross-reference When multiple documents are rendered at the same time, cross-reference
information in one document is visible to the other documents. See information in one document is visible to the other documents. See
@secref["xref-flags"] for information on references that cross @secref["xref-flags"] for information on references that cross
documents that are built separately. documents that are built separately.
@history[#:changed "1.18" @elem{Added @DFlag{doc-binding}.}] @history[#:changed "1.4" @elem{Added @DFlag{dvipdf}.}
@history[#:changed "1.4" @elem{Added @DFlag{dvipdf}.}] #:changed "1.18" @elem{Added @DFlag{doc-binding}.}
#:changed "1.19" @elem{Added @DFlag{xelatex}.}]
@section{Extra and Format-Specific Files} @section{Extra and Format-Specific Files}

View File

@ -23,4 +23,4 @@
(define pkg-authors '(mflatt eli)) (define pkg-authors '(mflatt eli))
(define version "1.18") (define version "1.19")

View File

@ -140,9 +140,9 @@
#:once-each #:once-each
[("--quiet") "suppress output-file and undefined-tag reporting" [("--quiet") "suppress output-file and undefined-tag reporting"
(current-quiet #t)] (current-quiet #t)]
[("--doc-binding") new-doc-binding [("--doc-binding") id
"look for document in new-doc-binding rather than 'doc" "render document provided as <id> instead of `doc`"
(set! doc-binding (string->symbol new-doc-binding))] (set! doc-binding (string->symbol id))]
#:args (file . another-file) #:args (file . another-file)
(let ([files (cons file another-file)]) (let ([files (cons file another-file)])
(parameterize ([current-command-line-arguments (parameterize ([current-command-line-arguments