<HTML ><HEAD ><TITLE >JadeTeX 3.12</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"></HEAD ><BODY CLASS="book" BGCOLOR="#FFFFFF" TEXT="#000000" ><DIV CLASS="BOOK" ><A NAME="AEN1" ></A ><DIV CLASS="TITLEPAGE" ><H1 CLASS="title" ><A NAME="AEN2" >JadeTeX 3.12</A ></H1 ><H2 CLASS="subtitle" >Release Notes</H2 ><H3 CLASS="corpauthor" >JadeTeX Development Team</H3 ><P CLASS="copyright" >Copyright © 2002 by Ian Castle</P ><HR></DIV ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT >1. <A HREF="#AEN11" >JadeTeX 3.12 Release Notes</A ></DT ><DD ><DL ><DT ><A HREF="#AEN17" >Obtaining JadeTeX</A ></DT ><DT ><A HREF="#AEN21" >Dependencies</A ></DT ><DT ><A HREF="#AEN92" >Installation</A ></DT ><DT ><A HREF="#AEN95" >Configuration</A ></DT ><DT ><A HREF="#AEN107" >Version 3.12</A ></DT ></DL ></DD ></DL ></DIV ><DIV CLASS="LOT" ><DL CLASS="LOT" ><DT ><B >List of Tables</B ></DT ><DT >1-1. <A HREF="#texdepends" >Dependencies on LaTeX</A ></DT ><DT >1-2. <A HREF="#id1" >Changes for release 3.12</A ></DT ></DL ></DIV ><DIV CLASS="chapter" ><HR><H1 ><A NAME="AEN11" >Chapter 1. JadeTeX 3.12 Release Notes</A ></H1 ><P >JadeTeX is a companion package to the OpenJade DSSSL processor. OpenJade applies a DSSSL stylesheet to an SGML or XML document. The output of this process can be in a number of forms, including a set of high level LaTeX macros. It is the task of the JadeTeX package to transform these macros into DVI/PostScript (use the command <B CLASS="command" >jadetex</B >) or Portable Document Format (PDF) form (use the command <B CLASS="command" >pdfjadetex</B >).</P ><P >JadeTeX is architecture and platform independent. If LaTeX is available for your platform, then JadeTeX will be also.</P ><DIV CLASS="sect1" ><HR><H1 CLASS="sect1" ><A NAME="AEN17" >Obtaining JadeTeX</A ></H1 ><P >The latest version of JadeTeX may be obtained from <TT CLASS="filename" >http://jadetex.sourceforge.net</TT ></P ></DIV ><DIV CLASS="sect1" ><HR><H1 CLASS="sect1" ><A NAME="AEN21" >Dependencies</A ></H1 ><P >Jadetex is dependent upon OpenJade and a reasonably up to date and full featured LaTeX installation. For best results OpenJade 1.3.1 should be used. However, JadeTeX will work fine with older versions (including Jade 1.2.1), although it may be necessary to adjust your <TT CLASS="filename" >jadetex.cfg</TT > configuration file to supply JadeTeX with any features missing from your version of OpenJade.</P ><P >Any recent LaTeX distribution such as TeXlive, fpTeX or teTeX is required. As a guide the following table lists some of the requirements and suggested minimum versions.</P ><DIV CLASS="table" ><A NAME="texdepends" ></A ><P ><B >Table 1-1. Dependencies on LaTeX</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" >Package</TH ><TH WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >Minimum Required Version</TH ><TD > </TD ><TD > </TD ></TR ></THEAD ><TBODY ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >times</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >fontenc</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >array</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >longtable</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >color</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >colortbl</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >marvosym</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >graphicx</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >1997/06/09</TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >multicol</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >hyperref</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >2000/03/01</TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >fancyhdr</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >inputenc</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >1997/12/20</TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >ulem</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" > </TD ><TD > </TD ><TD > </TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="filename" >pdfTeX</TT ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >0.13d</TD ><TD > </TD ><TD > </TD ></TR ></TBODY ></TABLE ></DIV ></DIV ><DIV CLASS="sect1" ><HR><H1 CLASS="sect1" ><A NAME="AEN92" >Installation</A ></H1 ><P >See the installation guide.</P ></DIV ><DIV CLASS="sect1" ><HR><H1 CLASS="sect1" ><A NAME="AEN95" >Configuration</A ></H1 ><P >It is possible to customize the behavior of JadeTeX by placing definitions in the file <TT CLASS="filename" >jadetex.cfg</TT >. This is usually placed in your working directory, but theoretically make be placed anywhere in your TeX path.</P ><P >If you are producing PDF files then you may wish to consult the <B CLASS="command" >hyperref</B > documentation. Options for customizing the look and feel of the PDF file described in the hyperref documentation should be placed in the <TT CLASS="filename" >jadetex.cfg</TT >. For example: <PRE CLASS="screen" > \hypersetup{pdfpagemode=None, pdfauthor=jadetex team, colorlinks=false, linkcolor=black, pdfstartview=FitH} \def\Gin@extensions{.pdf,.png,.jpg,.mps,.tif} </PRE > Would cause the PDF document to open without displaying book marks. Links would not be highlighted in anyway (if they were, the would be color black). The document will be placed in a "fit width" viewing mode. Finally, pdfjadetex would prefer image with a pdf extensions over a png extension if none is specified. This is useful if you want to give priority to scalable documents for a PDF file, while preferring a bit mapped format for other output types.</P ><P >If you have a out of date version of openjade, which does not support the characteristics <PRE CLASS="screen" > "UNREGISTERED::OpenJade//Characteristic::page-two-side?" "UNREGISTERED::OpenJade//Characteristic::two-side-start-on-right?" </PRE > and you want to use two sided output then you would have to add the definitions <PRE CLASS="screen" > \def\PageTwoSide{1} \def\TwoSideStartOnRight{1} </PRE > to your <TT CLASS="filename" >jadetex.cfg</TT > to make up for the deficiency.</P ></DIV ><DIV CLASS="sect1" ><HR><H1 CLASS="sect1" ><A NAME="AEN107" >Version 3.12</A ></H1 ><DIV CLASS="formalpara" ><P ><B >Released January 2002. </B >This release is primarily a maintenance release and is intended to be used with openjade 1.3.1. In addition to fixing some bugs it also provides enhanced support for the "euro" monetary symbol €.</P ></DIV ><DIV CLASS="table" ><A NAME="id1" ></A ><P ><B >Table 1-2. Changes for release 3.12</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" >Item 1</TH ><TH WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >Fix for space above horizontal rule</TH ></TR ></THEAD ><TBODY ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >References</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Source Forge patch #444445</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Category</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Software Bug</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Problem</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >A horizontal rule has spurious blank space above it</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Resolution</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Added \nointerlineskip to suppress the blank space</P ></TD ></TR ></TBODY ></TABLE ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" >Item 2</TH ><TH WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >Graphics centered within page not column</TH ></TR ></THEAD ><TBODY ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >References</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Source Forge patch #470586</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Category</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Software Bug</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Problem</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >External Graphics are centered with respect to the entire page. This causes a problem in multicolumn mode.</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Resolution</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >External Graphics are now centered within the column width</P ></TD ></TR ></TBODY ></TABLE ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" >Item 3</TH ><TH WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >Fix fatal error with unbalanced columns</TH ></TR ></THEAD ><TBODY ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >References</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Source Forge patch #492522</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Category</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Software Bug</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Problem</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >The TeX multicol package supports both balanced and unbalanced columns. However, JadeTeX 3.11 didn't call the functions for unbalanced columns correctly. Since a bug in the handling of %page-balanced-columns?% was fixed in 3.11, this is now the common case - so multicolumn documents that used to work in 3.10 no longer work</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Resolution</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Reworked the invocation of the unbalanced column macros. It isn't pretty, but it works.</P ></TD ></TR ></TBODY ></TABLE ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" >Item 4</TH ><TH WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >Add <TT CLASS="varname" >DESTDIR</TT > environment variable to <TT CLASS="filename" >Makefile</TT ></TH ></TR ></THEAD ><TBODY ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >References</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >None</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Category</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Software Installation / Configuration</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Problem</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Makefile doesn't have <TT CLASS="varname" >DESTDIR</TT > environment variable</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Resolution</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Make makefile more friendly for packagers with introduction of <TT CLASS="varname" >DESTDIR</TT > environment variable. This change is transparent to those that don't want to use <TT CLASS="varname" >DESTDIR</TT >.</P ></TD ></TR ></TBODY ></TABLE ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" >Item 5</TH ><TH WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >Long directory/file names disappear of the page</TH ></TR ></THEAD ><TBODY ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >References</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Red Hat Bugzilla bug 47345</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Category</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Software Bug</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Problem</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >If there is a long directory path in a document it goes off the side of the page. Long pathnames should be split or put on a separate line so that they don't go off the edge of the page.</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Resolution</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Added '\setlength\emergencystretch{2in}'. In case of overfull hboxes, an extra stretchable length gets added to the end of the lines.</P ></TD ></TR ></TBODY ></TABLE ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" >Item 6</TH ><TH WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >Add Extra Fonts</TH ></TR ></THEAD ><TBODY ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >References</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >sf.net request #452537, Mandrakesoft Documentation Project</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Category</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Software Bug</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Problem</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Many commonly installed fonts such as Charter and Utopia are not available for use with JadeTeX</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Resolution</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Added the following fonts: Utopia, ZapfChancery, Fibonacci, Funny, Dunhill, Concrete, Charter, Fontpxr, Fontaer, Fontaess, Fontaett, Fontlcmss, Fontlcmtt, Fontlcmvtt, Fontcmbr, Fontcmtl, Fontpxss, Fonttxss, Fonttxr. Note that this justs makes the fonts available to JadeTeX. You must have them installed already to actually use them in documents</P ></TD ></TR ></TBODY ></TABLE ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" >Item 7</TH ><TH WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" >Enhanced Euro symbol € support</TH ></TR ></THEAD ><TBODY ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >References</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >None</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Category</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Functional Change</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Problem</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Using the reference <B CLASS="command" >&euro;</B > does not produce any output. Using the Unicode character reference produces a black square unless a Computer Modern font is being used.</P ></TD ></TR ><TR ><TD WIDTH="25%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Resolution</P ></TD ><TD WIDTH="75%" ALIGN="LEFT" VALIGN="MIDDLE" ><P >Switched to the <B CLASS="command" >marvosym.sty</B > package for the euro symbol. This is provides a good quality postscript font containing the euro symbol. Some consideration was given to using Adobe's freely available euro fonts and the <B CLASS="command" >eurosans.sty</B > package. However as the adobe fonts cannot be distributed freely this option was not chosen. In addition, the <B CLASS="command" >marvosym.sty</B > package is available in most modern TeX distributions.</P > <P >Additionally, support was added for the <B CLASS="command" >&euro;</B > entity reference.</P ></TD ></TR ></TBODY ></TABLE ></DIV ></DIV ></DIV ></DIV ></BODY ></HTML >