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

10 files changed, 63 insertions, 29 deletions

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 <vvv@vsu.ru>
+	* 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 <sanjoy@mit.edu>
+	* 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 <chofchof@ktug.or.kr>
+	* 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 <chofchof@ktug.or.kr>
     
+    Includes two small fixes by Sanjoy Mahajan <sanjoy@mit.edu>.  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 <chofchof@ktug.or.kr>
     
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 <chofchof@ktug.or.kr>
     
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 <chofchof@ktug.or.kr>
 
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 <chofchof@ktug.or.kr>
 
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 <chofchof@ktug.or.kr>
     
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 <chofchof@ktug.or.kr>
     
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