diff options
author | Karl Berry <karl@freefriends.org> | 2016-03-26 22:57:34 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-03-26 22:57:34 +0000 |
commit | 9fb1a6c3b6f3b49db9c3f5a959dc2cc5ec663ecf (patch) | |
tree | c0af2de6d7959e615f20394a819b6b275f978c03 /Master/texmf-dist/doc/latex | |
parent | db21d9213462b72292fcd4ebd457a6420770f4cd (diff) |
bxdvidriver (26mar16)
git-svn-id: svn://tug.org/texlive/trunk@40148 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/bxdvidriver/LICENSE | 27 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/bxdvidriver/README.md | 102 |
2 files changed, 129 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bxdvidriver/LICENSE b/Master/texmf-dist/doc/latex/bxdvidriver/LICENSE new file mode 100644 index 00000000000..49f803e083e --- /dev/null +++ b/Master/texmf-dist/doc/latex/bxdvidriver/LICENSE @@ -0,0 +1,27 @@ +$BK\%=%U%H%&%'%"$O(B MIT $B%i%$%;%s%9$N2<$GG[I[$5$l$^$9!#(B +$BCx:n8"$O:n<T$G$"$k!VH,EP(B $B?rG7!JJLL>(B ZR$B!K!W$KB0$7$^$9!#(B +$B$^$?K\%=%U%H%&%'%"$OL5J]>Z$G$9!#(B + +This software is distributed under the MIT License. + +The MIT License + +Copyright (c) 2016 Takayuki YATO (aka. "ZR") + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Master/texmf-dist/doc/latex/bxdvidriver/README.md b/Master/texmf-dist/doc/latex/bxdvidriver/README.md new file mode 100644 index 00000000000..3e85864b83e --- /dev/null +++ b/Master/texmf-dist/doc/latex/bxdvidriver/README.md @@ -0,0 +1,102 @@ +BXdvidriver Package +=================== + +LaTeX: To specify a driver option effective only in DVI output + +This single-function package enables authors to specify a global +driver option (dvips, dvipdfmx, etc) which is applied only when the +engine outputs a DVI file. It is useful to create special document- +templates that can be compiled in both PDF-mode and DVI-mode. + +### System requirement + + * TeX format: LaTeX. + * TeX engine: Anything. + * Dependent packages: + - ifpdf, ifluatex, ifxetex, ifvtex + - pdftexcmds + +### Installation + + - `*.sty` → $TEXMF/tex/latex/BXdvidriver + +### License + +This package is distributed under the MIT License. + +The bxdvidriver Package +----------------------- + +### Package Loading + + \usepackage[<option>,...]{bxdvidriver} + +The available options are described hereafter. + +#### Driver options + +The following driver options are available: + + dvips,xdvi,dvipdf,dvipdfm,dvipdfmx,dvipsone + dviwindo,oztex,textures,pctexps,pctex32 + +Suppose the document begins with: + + \documentclass[a4paper]{article} + \usepackage[dvipdfmx]{bxdvidriver} + \usepackage{graphicx,color} + +If the document is compiled with pdflatex (or xelatex, lualatex), then +the package does nothing and the driver option `dvipdfmx` is simply +ignored. + +However, if the document is compiled with latex (or any other engine +that outputs DVI files), then the package adds the given driver option +`dvipdfmx` to the global option list, and makes the settings effectively +the same as the following: + + \documentclass[a4paper,dvipdfmx]{article} + \usepackage{graphicx,color} + +The driver option is globally in effect, and thus the packages graphicx +and color will choose the driver for dvipdfmx. + +*Note.* Some care must be taken when the document class itself has some +driver-dependent behavior. In that case, simply loading bxdvidriver +after `\documentclass` would leave its driver option unapplied to the +document class. Instead, you must load the bxdvidriver package *before* +`\documentclass` with `\RequirePackage` command. + + \RequirePackage[dvipdfmx]{bxdvidriver} + \documentclass[a4paper]{some-fancy-class} + \usepackage{graphicx,color} + +#### Other options + +This package is essentially single-function, but as side effect it also +checks some integrity on driver settings: + + * whether (at most) one driver option is given; + * whether the driver matches the (PDF-output) engine; + * whether (at most) one graphics driver is loaded. + +By default, an error is issued when any check fails. But the behavior +can be changed by options. + + * `check` (default): Check failure issues an error. + * `nocheck`: Check failure does not issue an error. + +### Usage + +This package offers no user commands or environments. All the settings +are done by package options. + +Revision History +---------------- + + * Version 0.2 ‹2016/03/26› + - The first public version. + +-------------------- +Takayuki YATO (aka. "ZR") +http://zrbabbler.sp.land.to/ |