From bd20a8ca78657278f385d36860ed91569b264ba1 Mon Sep 17 00:00:00 2001 From: Sanjoy Mahajan Date: Wed, 17 Jan 2007 19:44:57 +0000 Subject: dvipos: added ChangeLog, revised man page, fixed version strings Consistent with the GPL's section 2(a), I added a ChangeLog and updated the version strings to be 20070107. People will then know that they are running a different dvipos from the CTAN -20030628 version (which didn't work with current versions of ConTeXt), and can blame the right people (i.e. me) if one of my two changes to dvicore.c causes a problem. No binaries need rebuilding because all the changes are to uncompiled files (ChangeLog, dvipos.1) or to uncompiled parts of files (comments). In utils.h, the #define VERSION was already 20070107, so it remains unchanged. git-svn-id: svn://tug.org/texlive/trunk@3556 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/dvipos/ChangeLog | 28 ++++++++++++++++++++++++++++ Build/source/texk/dvipos/dvicore.c | 7 ++++--- Build/source/texk/dvipos/dvicore.h | 4 +--- Build/source/texk/dvipos/dvipos.1 | 31 ++++++++++++++++++++++++------- Build/source/texk/dvipos/dvipos.c | 4 +--- Build/source/texk/dvipos/tfm.c | 4 +--- Build/source/texk/dvipos/tfm.h | 4 +--- Build/source/texk/dvipos/utils.c | 4 +--- Build/source/texk/dvipos/utils.h | 4 +--- Build/source/texk/dvipos/win32.mak | 2 +- 10 files changed, 63 insertions(+), 29 deletions(-) create mode 100644 Build/source/texk/dvipos/ChangeLog (limited to 'Build') diff --git a/Build/source/texk/dvipos/ChangeLog b/Build/source/texk/dvipos/ChangeLog new file mode 100644 index 00000000000..8fd191b1e5d --- /dev/null +++ b/Build/source/texk/dvipos/ChangeLog @@ -0,0 +1,28 @@ +2007-01-07 Vladimir Volovich + * build scripts: provide configure(.in) and Makefile.in so that + dvipos builds cleanly with kpathsea and for the TeXLive + architectures. + +2007-01-06 Sanjoy Mahajan + * dvicore.c: do_pos_special() needed two fixes in its interaction + with ConTeXt. [As far as I know, ConTeXt in dvi mode is the only + user of dvipos.] + + First, it was writing out coordinates for the pos \specials using + scaled points but not appending the sp to the magnitudes. So when + the ConTeXt macros read in the .tuo file, they complained about + missing dimensions and assumed the coordinates were given in pt, a + factor of 65536 different from sp. The simplest fix was to still + write scaled points but to append 'sp' to the magnitudes. + + Second, the 'list' variable needed to become a struct containing + hsize, leftskip, rightskip, hangindent, hangafter, parindent. + This struct is sscanf'ed into when do_pos_special() is parsing a a + pos:pxywhd special in the dvi file, and do_pos_special() uses the + information to write the corresponding \\pospxyplus command for + the .tuo file. + +2003-06-28 Jin-Hwan + * Wrote dvipos! [In the distant past, its functions were done in + a Perl script written by Taco Hoekwater.] + diff --git a/Build/source/texk/dvipos/dvicore.c b/Build/source/texk/dvipos/dvicore.c index 6da32d1da90..0abfb13b063 100644 --- a/Build/source/texk/dvipos/dvicore.c +++ b/Build/source/texk/dvipos/dvicore.c @@ -1,9 +1,10 @@ -/* $Header: /home/cvsroot/dvipos/dvicore.c,v 1.8 2003/06/28 05:43:40 chofchof Exp $ - - dvipos-20030628 +/* dvipos-20070107 Copyright (C) 2003 by Jin-Hwan + Includes two small fixes by Sanjoy Mahajan . See + the ChangeLog. + This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or diff --git a/Build/source/texk/dvipos/dvicore.h b/Build/source/texk/dvipos/dvicore.h index f3168143662..db80fd166d0 100644 --- a/Build/source/texk/dvipos/dvicore.h +++ b/Build/source/texk/dvipos/dvicore.h @@ -1,6 +1,4 @@ -/* $Header - - dvipos-20030422 +/* dvipos-20070107 Copyright (C) 2003 by Jin-Hwan diff --git a/Build/source/texk/dvipos/dvipos.1 b/Build/source/texk/dvipos/dvipos.1 index 477fdcec7bf..14e726b578f 100644 --- a/Build/source/texk/dvipos/dvipos.1 +++ b/Build/source/texk/dvipos/dvipos.1 @@ -1,4 +1,4 @@ -.TH "DVIPOS" "1" "January 2007" "dvipos 20030628 (KPATHSEA)" "ConTeXt" +.TH "DVIPOS" "1" "January 2007" "dvipos 20070107 (KPATHSEA)" "ConTeXt" .de URL \\$2 \(laURL: \\$1 \(ra\\$3 .. @@ -35,7 +35,10 @@ and is suitable for including in a .BR tex (1) or .BR pdftex (1) -auxilliary file, such as \fIdocument.tuo\fP, to be read in on the next run. +auxilliary file, such as \fIdocument.tuo\fP, to be read in by the next +run of the +.BR tex (1) +or similar typesetting engine. .SH OPTIONS @@ -81,22 +84,32 @@ set page ranges from X to Y. .SH USAGE .B dvipos -is run mostly by ConTeXt's +is run mostly behind the scenes by ConTeXt's .BR texexec (1) between runs of .BR tex (1) or .BR pdftex (1), -in order to compute positions for the metafun interface to +in order to provide information to and get information about +positional graphics. These graphics are provided by the MetaFun +interface to .BR mpost (1). -A typical use: +\fBdvipos\fP is not used (or needed) in PDF-output mode but is +needed for DVI-output mode. +.BR pdftex (1) +starting with version 1.40 can produce position information even in +DVI mode, so once the ConTeXt macros take advantage of this feature, +the need for \fBdvipos\fP will fade. + +Until then, here is a typical use of \fBdvipos\fP: .EX dvipos notes.dvi .EE The position information that is output is collected by .BR texexec (1) -to include in the \fInotes.tuo\fP auxilliary file for the next run -to use. +to include in the \fInotes.tuo\fP auxilliary file to use in the next +run. + .SH EXAMPLES .TP @@ -117,6 +130,10 @@ Instead send bbox information to \fI/tmp/debug.pos\fP: .BR tex (1), .BR texexec (1). +For more about positional graphics, see the MetaFun documentation on +the +.URL "http://wiki.contextgarden.net/MetaFun" "ConTeXt wiki" . + .SH BUGS If you specify a file for the \fB-b\fP option, you must join the option and name with rather than (the more common) space: diff --git a/Build/source/texk/dvipos/dvipos.c b/Build/source/texk/dvipos/dvipos.c index 430cd954aaa..e945b23e04d 100644 --- a/Build/source/texk/dvipos/dvipos.c +++ b/Build/source/texk/dvipos/dvipos.c @@ -1,6 +1,4 @@ -/* $Header: /home/cvsroot/dvipos/dvipos.c,v 1.9 2003/06/28 05:43:40 chofchof Exp $ - - dvipos-20030627 +/* dvipos-20070107 Copyright (C) 2003 by Jin-Hwan diff --git a/Build/source/texk/dvipos/tfm.c b/Build/source/texk/dvipos/tfm.c index e15f93ea116..2bf61357f89 100644 --- a/Build/source/texk/dvipos/tfm.c +++ b/Build/source/texk/dvipos/tfm.c @@ -1,6 +1,4 @@ -/* $Header: /home/cvsroot/dvipos/tfm.c,v 1.2 2003/04/24 00:56:00 chofchof Exp $ - - dvipos-20030225 +/* dvipos-20070107 Copyright (C) 2003 by Jin-Hwan Cho diff --git a/Build/source/texk/dvipos/tfm.h b/Build/source/texk/dvipos/tfm.h index 049c8f0a282..0d97c5914d7 100644 --- a/Build/source/texk/dvipos/tfm.h +++ b/Build/source/texk/dvipos/tfm.h @@ -1,6 +1,4 @@ -/* $Header - - dvipos-20030225 +/* dvipos-20070107 Copyright (C) 2003 by Jin-Hwan Cho diff --git a/Build/source/texk/dvipos/utils.c b/Build/source/texk/dvipos/utils.c index 461be09d5a8..716d75dd425 100644 --- a/Build/source/texk/dvipos/utils.c +++ b/Build/source/texk/dvipos/utils.c @@ -1,6 +1,4 @@ -/* $Header: /home/cvsroot/dvipos/utils.c,v 1.1 2003/04/24 00:56:27 chofchof Exp $ - - dvipos-20030422 +/* dvipos-20070107 Copyright (C) 2003 by Jin-Hwan diff --git a/Build/source/texk/dvipos/utils.h b/Build/source/texk/dvipos/utils.h index c6d19a7f543..1802b8237a6 100644 --- a/Build/source/texk/dvipos/utils.h +++ b/Build/source/texk/dvipos/utils.h @@ -1,6 +1,4 @@ -/* $Header: /home/cvsroot/dvipos/utils.h,v 1.5 2003/06/28 05:43:40 chofchof Exp $ - - dvipos-20030628 +/* dvipos-20070107 Copyright (C) 2003 by Jin-Hwan diff --git a/Build/source/texk/dvipos/win32.mak b/Build/source/texk/dvipos/win32.mak index 12077cd5b6c..728cad387dd 100644 --- a/Build/source/texk/dvipos/win32.mak +++ b/Build/source/texk/dvipos/win32.mak @@ -9,7 +9,7 @@ root_srcdir = ..\.. INCLUDE=$(INCLUDE);$(root_srcdir)\..\win32 -version = 20030628 +version = 20070107 USE_GNUW32 = 1 USE_KPATHSEA = 1 -- cgit v1.2.3