summaryrefslogtreecommitdiff
path: root/support/cluttex/doc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-02-07 03:01:03 +0000
committerNorbert Preining <norbert@preining.info>2020-02-07 03:01:03 +0000
commit9c4a09ca6a4130e71ba545412319aaee3c618460 (patch)
tree52b4c3ee8dc02613fc8ce4faffe5292e10e5d10a /support/cluttex/doc
parente684f0597e24a1d09af301d82b340b2df7cf2080 (diff)
CTAN sync 202002070301
Diffstat (limited to 'support/cluttex/doc')
-rw-r--r--support/cluttex/doc/Makefile20
-rw-r--r--support/cluttex/doc/cluttex-ja.pdfbin0 -> 480358 bytes
-rw-r--r--support/cluttex/doc/cluttex-ja.tex (renamed from support/cluttex/doc/manual-ja.tex)17
-rw-r--r--support/cluttex/doc/cluttex.pdfbin0 -> 174976 bytes
-rw-r--r--support/cluttex/doc/cluttex.tex (renamed from support/cluttex/doc/manual.tex)19
-rw-r--r--support/cluttex/doc/manual-ja.pdfbin476078 -> 0 bytes
-rw-r--r--support/cluttex/doc/manual.pdfbin173012 -> 0 bytes
7 files changed, 43 insertions, 13 deletions
diff --git a/support/cluttex/doc/Makefile b/support/cluttex/doc/Makefile
index ca87048802..0685cc8c58 100644
--- a/support/cluttex/doc/Makefile
+++ b/support/cluttex/doc/Makefile
@@ -1,12 +1,16 @@
-all: manual.pdf manual-ja.pdf
+all: cluttex.pdf cluttex-ja.pdf
-manual.pdf: manual.tex
- cluttex -e pdflatex -o $@ --make-depends=manual.pdf.dep $<
+cluttex.pdf: cluttex.tex
+ cluttex -e pdflatex -o $@ --make-depends=cluttex.pdf.dep $<
-manual-ja.pdf: manual-ja.tex
- cluttex -e lualatex -o $@ --make-depends=manual-ja.pdf.dep $<
+cluttex-ja.pdf: cluttex-ja.tex
+ cluttex -e lualatex -o $@ --make-depends=cluttex-ja.pdf.dep $<
-.PHONY: all
+clean-outdir:
+ -rm -rf $(shell cluttex -e pdflatex --print-output-directory cluttex.tex)
+ -rm -rf $(shell cluttex -e lualatex --print-output-directory cluttex-ja.tex)
--include manual.pdf.dep
--include manual-ja.pdf.dep
+.PHONY: all clean-outdir
+
+-include cluttex.pdf.dep
+-include cluttex-ja.pdf.dep
diff --git a/support/cluttex/doc/cluttex-ja.pdf b/support/cluttex/doc/cluttex-ja.pdf
new file mode 100644
index 0000000000..fb5509749c
--- /dev/null
+++ b/support/cluttex/doc/cluttex-ja.pdf
Binary files differ
diff --git a/support/cluttex/doc/manual-ja.tex b/support/cluttex/doc/cluttex-ja.tex
index b89675888f..b48cbe8f8b 100644
--- a/support/cluttex/doc/manual-ja.tex
+++ b/support/cluttex/doc/cluttex-ja.tex
@@ -10,9 +10,9 @@
\renewcommand\sectionautorefname{セクション}
\renewcommand\subsectionautorefname{サブセクション}
-\title{\ClutTeX{}マニュアル\\(バージョン0.4)}
+\title{\ClutTeX{}マニュアル\\(バージョン0.5)}
\author{ARATA Mizuki}
-\date{2019年8月21日}
+\date{2020年2月6日}
\begin{document}
\maketitle
@@ -27,6 +27,7 @@
\item 入力ファイルを監視し、変更があった場合に自動で再処理する(\texttt{--watch}オプション\footnote{Unix系OSでは、別途プログラムが必要。})
\item MakeIndex, \BibTeX, Biber等のコマンドを自動で実行する(\texttt{--makeindex}オプション, \texttt{--bibtex}オプション, \texttt{--biber}オプション)
\item p\TeX 系列の処理系でPDFを生成する場合、別途\texttt{dvipdfmx}を実行する必要がない(自動で\texttt{dvipdfmx}を実行する)
+ もしもDVIファイルが欲しいのであれば、\texttt{--output-format=dvi}を指定すれば良い。
\end{itemize}
などがある。
@@ -99,6 +100,10 @@
\item[\texttt{--package-support=PKG1[,PKG2,...,PKGn]}]
外部コマンドを実行するパッケージ用の個別の対策を有効にする。
現在のところ、\texttt{minted}と\texttt{epstopdf}に対応している。
+\item[\texttt{--check-driver=DRIVER}]
+ いくつかのパッケージについて、正しいドライバーファイルが読み込まれていることを検査する。
+ \metavar{DRIVER}は\texttt{dvipdfmx}, \texttt{dvips}, or \texttt{dvisvgm}のいずれかである。
+ このオプションは\texttt{--output-format=dvi}が指定された場合にのみ指定できる。
\end{description}
補助コマンド実行用のオプション:
@@ -265,4 +270,12 @@ Unix用コマンドの中には、自身の名前によって挙動を変える
cluttex -e pdflatex --shell-escape --package-support=minted document.tex
\end{verbatim}
+\section{ドライバーファイルの検査}
+
+\ClutTeX{}は、いくつかのパッケージについて正しいドライバーファイルが読み込まれていることを検査することができる。
+現在のバージョンで対応しているパッケージは\texpkg{graphics(x)}, \texpkg{color}, \texpkg{expl3}, \texpkg{hyperref}, \texpkg{xy}である。
+
+PDFモードの場合、ドライバーの検査は常に行われる。
+DVIモードで検査を有効にするには、\texttt{--check-driver}オプションを使用する。
+
\end{document}
diff --git a/support/cluttex/doc/cluttex.pdf b/support/cluttex/doc/cluttex.pdf
new file mode 100644
index 0000000000..d9e3f7df04
--- /dev/null
+++ b/support/cluttex/doc/cluttex.pdf
Binary files differ
diff --git a/support/cluttex/doc/manual.tex b/support/cluttex/doc/cluttex.tex
index caf99053eb..4666668d08 100644
--- a/support/cluttex/doc/manual.tex
+++ b/support/cluttex/doc/cluttex.tex
@@ -8,9 +8,9 @@
\newcommand\texpkg[1]{\texttt{#1}}
\newcommand\metavar[1]{\textnormal{\textsf{#1}}}
-\title{\ClutTeX\ manual\\(Version 0.4)}
+\title{\ClutTeX\ manual\\(Version 0.5)}
\author{ARATA Mizuki}
-\date{2019-08-21}
+\date{2020-02-06}
\begin{document}
\maketitle
@@ -25,6 +25,7 @@ Basic features are,
\item Watch input files, and re-process documents if changes are detected\footnote{needs an external program if you are on a Unix system}.
\item Run MakeIndex, \BibTeX, Biber, if requested.
\item Produces a PDF, even if the engine (e.g.\ p\TeX) does not suport direct PDF generation.
+ If you want a DVI file, use \texttt{--output-format=dvi} option.
\end{itemize}
The unique feature of this program is that, auxiliary files such as \texttt{.aux} or \texttt{.toc} are created in an isolated location, so you will not be annoyed with these extra files.
@@ -94,7 +95,11 @@ Basic options:
Print the output directory and exit.
\item[\texttt{--package-support=PKG1[,PKG2,...,PKGn]}]
Enable special support for shell-escaping packages.
- Currently supported packages are `minted` and `epstopdf`.
+ Currently supported packages are `\texttt{minted}` and `\texttt{epstopdf}`.
+\item[\texttt{--check-driver=DRIVER}]
+ Check that the correct driver file is loaded for certain packages.
+ \metavar{DRIVER} is one of \texttt{dvipdfmx}, \texttt{dvips}, or \texttt{dvisvgm}.
+ Can only be used with \texttt{--output-format=dvi}.
\end{description}
Options for running auxiliary programs:
@@ -257,4 +262,12 @@ For example, if you want to typeset a document that uses \texpkg{minted}, run th
cluttex -e pdflatex --shell-escape --package-support=minted document.tex
\end{verbatim}
+\section{Check for driver file}
+
+\ClutTeX\ can check that the correct driver file is loaded when certain packages are loaded.
+Currently, the list of supported packages are \texpkg{graphics}, \texpkg{color}, \texpkg{expl3}, \texpkg{hyperref}, and \texpkg{xy}.
+
+The check is always done with PDF mode.
+To check the driver with DVI mode, use \texttt{--check-driver} option.
+
\end{document}
diff --git a/support/cluttex/doc/manual-ja.pdf b/support/cluttex/doc/manual-ja.pdf
deleted file mode 100644
index 72689f7f3e..0000000000
--- a/support/cluttex/doc/manual-ja.pdf
+++ /dev/null
Binary files differ
diff --git a/support/cluttex/doc/manual.pdf b/support/cluttex/doc/manual.pdf
deleted file mode 100644
index 089181455e..0000000000
--- a/support/cluttex/doc/manual.pdf
+++ /dev/null
Binary files differ