summaryrefslogtreecommitdiff
path: root/Build/source/texk/dviout-util/README
diff options
context:
space:
mode:
authorHironobu Yamashita <h.y.acetaminophen@gmail.com>2018-10-06 11:20:00 +0000
committerHironobu Yamashita <h.y.acetaminophen@gmail.com>2018-10-06 11:20:00 +0000
commitcc4aeb63b21ac72edb3f2f393f8712b9049b4964 (patch)
tree1bd3dc37660bd3ae0abebced5e2c972eed92fd57 /Build/source/texk/dviout-util/README
parent7b0783b59d3e5ae474862fe9a3b6df60c4e4bf06 (diff)
add dviout-util by texjporg
git-svn-id: svn://tug.org/texlive/trunk@48839 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/dviout-util/README')
-rw-r--r--Build/source/texk/dviout-util/README89
1 files changed, 89 insertions, 0 deletions
diff --git a/Build/source/texk/dviout-util/README b/Build/source/texk/dviout-util/README
new file mode 100644
index 00000000000..e3abd62a156
--- /dev/null
+++ b/Build/source/texk/dviout-util/README
@@ -0,0 +1,89 @@
+dviout-util
+===========
+
+This is a *partial* repackaging of elements of the DVIOUT package
+by Toshio OSHIMA, Yoshiki OTOBE, and Kazunori ASAYAMA.
+Here we don't include the main DVI previewer, but just want small utility
+programs. Small description:
+
+* chkdvifont[.exe] : A utility to check font in DVI/TFM/JFM/FONT files
+ (formerly chkfont.exe; renamed due to name conflicts)
+* chkdvifont-ja.txt : Document of chkdvifont.exe (in Japanese)
+ (formerly chkfont.txt)
+* dvispc[.exe] : A utility to correct the page-independence of DVI file
+ using color specials or tpic specials and
+ to transform between a DVI file and a text file
+* dvispc-ja.txt : A document of dvispc.exe (in Japanese)
+ (formerly dvispc.txt)
+* dvispc-en.txt : A document of dvispc.exe
+ (formerly dvispce.txt)
+
+The followings are not (currently) added.
+
+* propw[.exe] : A utility to make jfm files for Japanese proportional font
+* propw-ja.txt : Document of propw.exe (in Japanese)
+ (formerly propw0.txt)
+
+
+### License
+
+This package is licensed under the Expat license. See COPYING for detail.
+(Similar to the original DVIOUT package.)
+
+
+### Repository
+
+This package is maintained on GitHub for development.
+ https://github.com/texjporg/tex-jp-build
+ (under source/texk/dviout-util)
+
+Please email any bug reports or problems to issue@texjp.org mailing list.
+
+
+### Building dviout-util outside TeX Live
+
+You can visit the GitHub repository
+ https://github.com/aminophen/dviout-util
+to obtain the standalone sources of dviout-util.
+
+The files in 00texjporg/ are encoded in UTF-8 (LF) for Unix.
+Other files are encoded in CP932 (LF) for Windows.
+
+For Unix (GNU C; gcc, clang):
+
+ $ cd dviout-util/00texjporg
+ $ gcc -o chkdvifont -I.. chkdvifont.c
+ $ gcc -o dvispc -I.. dvispc.c
+ $ gcc -o propw -I.. propw.c
+
+For Windows:
+
+ $ cd dviout-util
+ $ cl -O2 /MD -I. chkdvifont.c
+ $ cl -O2 /MD -I. dvispc.c
+ $ cl -O2 /MD -I. -DWIN32 propw.c /link gdi32.lib
+
+The only difference from TeX Live version is that dvispc does not use
+PTEXENC, which enables UTF-8 character printing.
+
+
+### Character Encodings
+
+The files in texlive subversion repository (under Build/source/texk/dviout-util)
+ https://www.tug.org/svn/texlive/trunk/
+are encoded in UTF-8 (LF).
+The files in dviout subversion repository
+ https://www.tug.org/svn/dviout/trunk/
+are encoded in CP932 (LF), except for files inside distribution/ directory.
+
+If you like to distribute the files (especially .txt documents) on
+Windows, it might be better to convert LF to CRLF (CP932 should be kept):
+
+ $ nkf -s -Lw --overwrite propw0.txt
+
+The LF -> CRLF conversion is suggested in dviout subversion repository,
+under distribution/ directory.
+
+
+This README was written by Hironobu Yamashita.
+Public domain. (September 2018)