<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <HTML><HEAD><TITLE>6.4 Building Documentation</TITLE><LINK href="ozdoc.css" rel="stylesheet" type="text/css"></HEAD><BODY><TABLE align="center" border="0" cellpadding="6" cellspacing="6" class="nav"><TR bgcolor="#DDDDDD"><TD><A href="node9.html#section.cygwin.building"><< Prev</A></TD><TD><A href="node6.html">- Up -</A></TD><TD><A href="node11.html#section.cygwin.installer">Next >></A></TD></TR></TABLE><DIV id="section.cygwin.documentation"><H2><A name="section.cygwin.documentation">6.4 Building Documentation</A></H2><P> Documentation currently cannot be built under Windows alone. Luckily, this step is optional. If you don't do it, then you simply have a system without documentation, but it runs. </P><P> For Windows, we deliver documentation not as a big bunch of HTML files, but as an HTML Help file (also called a CHM file). HTML Help files provide full-text search capabilities, a full table of contents, and are much smaller than all the HTML sources. This section explains how to obtain this file. Take yourself to a Unix machine. You will need <CODE>gawk</CODE> and <CODE>nsgml</CODE> installed in your system. These tools are used to parse, validate, and normalize SGML and XML files. You can find them in <A href="http://www.gnu.org/software/gawk/gawk.html"> <CODE>http://www.gnu.org/software/gawk/gawk.html</CODE></A> and <A href="http://www.jclark.com/sp/"> <CODE>http://www.jclark.com/sp/</CODE></A>. Then, do something like: </P><BLOCKQUOTE class="code"><CODE><SPAN class="builtin">unset</SPAN> OZHOME OZPATH OZEMULATOR TEXT2PICKLE<BR><SPAN class="builtin">export</SPAN> <SPAN class="variablename">PATH</SPAN>=/opt/gcc-2.95.3/bin:/opt/jdk/bin:/usr/bin:/bin:/usr/X11R6/bin:/usr/local/bin<BR>mkdir /tmp/build<BR><SPAN class="builtin">cd</SPAN> /tmp/build<BR></CODE><I>mozart</I><CODE>/configure --prefix=</CODE><I>linux-install</I><CODE> \ <BR> --with-documents=all --enable-chm --with-stdlib=</CODE><I>stdlib</I><CODE> <BR>make bootstrap<BR>make install</CODE></BLOCKQUOTE><P> where <I>linux-install</I> is a directory different from the <I>install</I> directory. Get back to your Windows machine and do: </P><BLOCKQUOTE class="code"><CODE><SPAN class="builtin">cd</SPAN> </CODE><I>linux-install</I><CODE>/doc<BR>/cygdrive/c/Program<SPAN class="string">\ </SPAN>Files/HTML<SPAN class="string">\ </SPAN>Help<SPAN class="string">\ </SPAN>Workshop/hhc Mozart</CODE></BLOCKQUOTE><P> (assuming that you have <I>linux-install</I> on a network shared file system. If not, you'll have to somehow copy this directory to your Windows machine). <CODE>hhc</CODE> is the HTML Help Compiler from Microsoft's HTML Help Workshop, available freely for download at <A href="http://msdn.microsoft.com/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp"><CODE>http://msdn.microsoft.com/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp</CODE></A>. The current version is 1.4, but this one does not provide <CODE>hhc</CODE>. The version you'll have to install is 1.32. (If the URL is broken, search <A href="http://www.microsoft.com/">Microsoft</A>'s site for ``download html help workshop''. It seems Microsoft tends to reorganize their site every so often.) </P><P> This process will leave behind a file <CODE>Mozart.chm</CODE>, which we can copy to a sensible place: </P><BLOCKQUOTE class="code"><CODE>cp Mozart.chm </CODE><I>install</I><CODE>/doc</CODE></BLOCKQUOTE><P> If you want, you can delete from the <I>install</I><CODE>/doc</CODE> directory all files except <CODE>Mozart.chm</CODE> and the <CODE>demo/applets</CODE> directory. </P></DIV><TABLE align="center" border="0" cellpadding="6" cellspacing="6" class="nav"><TR bgcolor="#DDDDDD"><TD><A href="node9.html#section.cygwin.building"><< Prev</A></TD><TD><A href="node6.html">- Up -</A></TD><TD><A href="node11.html#section.cygwin.installer">Next >></A></TD></TR></TABLE><HR><ADDRESS><A href="http://www.ps.uni-sb.de/~duchier/">Denys Duchier</A>, <A href="http://www.ps.uni-sb.de/~kornstae/">Leif Kornstaedt</A>, <A href="http://www.ps.uni-sb.de/~scheidhr/">Ralf Scheidhauer</A> and <A href="http://www.ps.uni-sb.de/~schulte/">Christian Schulte</A><BR><SPAN class="version">Version 1.4.0 (20090610)</SPAN></ADDRESS></BODY></HTML>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
bd5c3d824c3db63ffd9226c15941e6ad
>
files
>
1428
