summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bxpdfver
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-08-05 20:15:15 +0000
committerKarl Berry <karl@freefriends.org>2015-08-05 20:15:15 +0000
commite5da00ff8fae772d4c808ca0266dc28a049259bd (patch)
treee3bb36cf4fc3e7e73362909c3d097572e072d2ff /Master/texmf-dist/doc/latex/bxpdfver
parenta4b78f0fc9446d2cfae36e0d82ef6a80d3e5f039 (diff)
bxpdfver (5aug15)
git-svn-id: svn://tug.org/texlive/trunk@38050 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bxpdfver')
-rw-r--r--Master/texmf-dist/doc/latex/bxpdfver/LICENSE27
-rw-r--r--Master/texmf-dist/doc/latex/bxpdfver/README84
-rw-r--r--Master/texmf-dist/doc/latex/bxpdfver/README-ja87
-rw-r--r--Master/texmf-dist/doc/latex/bxpdfver/sample-bxpdfver.tex11
4 files changed, 209 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bxpdfver/LICENSE b/Master/texmf-dist/doc/latex/bxpdfver/LICENSE
new file mode 100644
index 00000000000..4acbc245013
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bxpdfver/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) 2013 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/bxpdfver/README b/Master/texmf-dist/doc/latex/bxpdfver/README
new file mode 100644
index 00000000000..c5af09b52be
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bxpdfver/README
@@ -0,0 +1,84 @@
+BXpdfver Package
+================
+
+LaTeX: To specify the version and compression level of output PDF files
+
+This package enables users to specify in their sources the following
+settings on the PDF document to output:
+
+ * PDF version (1.4, 1.5 etc.);
+ * whether or not to compress streams;
+ * whether or not to use object streams.
+
+### SYSTEM REQUIREMENT
+
+ * TeX format: LaTeX.
+ * TeX engine: pdfTeX, XeTeX, LuaTeX, and any DVI-output engines.
+ * DVI-ware: dvipdfmx.
+ * Required packages:
+ - atbegshi (when using dvipdfmx driver)
+
+### INSTALLATION
+
+ - `*.sty` → $TEXMF/tex/latex/BXpdfver
+
+### LICENSE
+
+This package is distributed under the MIT license.
+
+bxpdfver package
+----------------
+
+### PACKAGE LOADING
+
+ \usepackage[<option>,...]{bxpdfver}
+
+The available options are:
+
+ * `1.4`, `1.5`, `1.6`, or `1.7`: Sets PDF version.
+ * `nocompress`: Suppresses stream compression.
+ * `compress` (defalt): Does not suppress stream compression.
+ * `noobjcompress`: Suppresses use of object streams.
+ * `objcompress` (default): Does not suppress use of object streams.
+ * Driver options: As below:
+ + When using a PDF-output engine, you need not give driver options
+ since the appropriate one is auto-detected.
+ + `dvipdfmx`: Uses dvipdfmx driver.
+ + `disabled`: Disables all functions of the package.
+
+Note that the options `compress` and `objcompress` mean that this
+package *does not suppress* a feature. They do not active a feature
+when it is already suppressed by other means.
+
+### NOTE ON DRIVERS
+
+ * pdfTeX and LuaTeX support all features.
+ * XeTeX and dvipdfmx support only PDF version setting.
+ * If you try to use unavailable features, an error will occur.
+ * The package recognizes some “unsupported” driver options such as
+ `dvips`; when such drivers are used, use of any feature will cause
+ an error.
+ * When `disabled` is used, use of any feature will do nothing (nor
+ issue an error).
+
+### COMMANDS
+
+ * `\setpdfversion{<version>}`: Sets PDF version.
+ Here `<version>` is either one of the following:
+ + `1.4`, `1.5`, `1.6`, or `1.7`; the version itself.
+ + the name of a PDF file; the version is set equal to that of
+ the given file.
+ * `\suppresspdfcompression`: Suppresses use of object streams.
+ * `\suppresspdfobjcompression`: Suppresses use of object streams.
+
+REVISION HISTORY
+----------------
+
+ * Version 0.2a [2015/08/05]
+ - Minor fix.
+ * Version 0.2 [2014/07/04]
+ - First public version.
+
+--------------------
+Takayuki YATO (aka. "ZR")
+http://zrbabbler.sp.land.to/
diff --git a/Master/texmf-dist/doc/latex/bxpdfver/README-ja b/Master/texmf-dist/doc/latex/bxpdfver/README-ja
new file mode 100644
index 00000000000..7b51dda9669
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bxpdfver/README-ja
@@ -0,0 +1,87 @@
+BXpdfver パッケージバンドル
+===========================
+
+LaTeX: 出力 PDF のバージョンや圧縮状態を指定する
+
+LaTeX 文書を PDF 文書に変換する際に出力 PDF に関する以下の設定を文書中で
+行う機能を提供する。
+
+ * PDF バージョン(1.4, 1.5 等)
+ * ストリームの圧縮の有無
+ * オブジェクトストリームの使用の有無
+
+### 前提環境
+
+ * フォーマット: LaTeX
+ * エンジン: 不問
+ * DVIウェア: dvipdfmx、および PDF 出力のエンジン
+ * 依存パッケージ:
+ - atbegshi(dvipdfmx ドライバの場合)
+
+### インストール
+
+ - `*.sty` → $TEXMF/tex/latex/BXpdfver
+
+### ライセンス
+
+本パッケージは MIT ライセンスの下で配布される。
+
+bxpdfver パッケージ
+-------------------
+
+### パッケージ読込
+
+ \usepackage[<オプション>,...]{bxpdfver}
+
+利用可能なオプションは以下の通り。
+
+ * `1.4`、`1.5`、`1.6`、`1.7`: PDF バージョンを指定する。
+ * `nocompress`: ストリームの圧縮を抑止する。
+ * `compress`(既定): ストリームの圧縮を抑止しない。
+ * `noobjcompress`: オブジェクトストリームの使用を抑止する。
+ * `objcompress`(既定): オブジェクトストリームの使用を抑止しない。
+ * ドライバオプション: 以下の通り。なお、後述の「ドライバ指定」の
+ 節も参照されたい。
+ + PDF 出力のエンジンの場合は、既定で適切なドライバが選択される
+ のでドライバオプションは不要である。
+ + `dvipdfmx`: dvipdfmx 用のドライバを指定する。
+ + `disabled`: 全ての機能を無効化する。
+
+`compress`、`objcompress` はこのパッケージによる抑止を行わないという意味
+であり、既に抑止されている場合にそれを再び有効化するものではない。
+
+### ドライバ指定
+
+ * pdfTeX および LuaTeX では全ての機能が使用可能。
+ * XeTeX および dvipdfmx では PDF バージョン指定のみ使用可能。
+ * 使用不可能な機能を使おうと試みるとエラーが発生する。
+ * `dvips` 等の“全く対応していない”若干のドライバオプションを認識
+ する。この場合、全ての機能の呼出でエラーが発生する。
+ * `disabled` は特殊で、これを指定した場合は、どの機能の呼出でも
+ エラーは発生しないが、全く何の動作も行わない。
+
+### 機能
+
+ * `\setpdfversion{<バージョン>}`: 出力 PDF バージョンを指定する。
+ `<バージョン>` には以下の何れかを指定する。
+ + `1.4`、`1.5`、`1.6`、`1.7` の何れか。バージョンをその値に設定
+ する。
+ + PDF ファイルの名前。この場合、その PDF のバージョンと同じ値に
+ 設定する。
+ * `\suppresspdfcompression`: ストリームの圧縮を抑止する。
+ * `\suppresspdfobjcompression`: オブジェクトストリームの使用を抑止
+ する。(実はこの指定自体は圧縮とは無関係であるが、pdfTeX エンジンの
+ プリミティブ `\pdfobjcompresslevel` に合わせた命令名を用いた。)
+
+
+更新履歴
+--------
+
+ * Version 0.2a [2015/08/05]
+ - 細かい修正。
+ * Version 0.2 [2014/07/04]
+ - 最初の公開版。
+
+--------------------
+Takayuki YATO (aka. "ZR")
+http://zrbabbler.sp.land.to/
diff --git a/Master/texmf-dist/doc/latex/bxpdfver/sample-bxpdfver.tex b/Master/texmf-dist/doc/latex/bxpdfver/sample-bxpdfver.tex
new file mode 100644
index 00000000000..b421b75a3c9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bxpdfver/sample-bxpdfver.tex
@@ -0,0 +1,11 @@
+\documentclass[a4paper]{article}
+%\documentclass[a4paper,dvipdfmx]{article}% when using dvipdfmx
+\usepackage[%
+ 1.5,% to set output PDF version
+ %nocompress,% to suppress all stream compression
+ noobjcompress% to suppress compression of strings for describing objects
+ ]{bxpdfver}
+%\setpdfversion{some.pdf}% to set output version equal to some other PDF file
+\begin{document}
+Need to say hello {\TeX}!?
+\end{document}