-<html>
-<head>
-<title>Graphviz Build Instructions for Windows</title>
-</head>
-<body bgcolor=#ffffff>
-<h2>Graphviz Build Instructions for Windows</h2>
-For building on Windows:
-<P>
-<b>(Graphviz versions ≥ 2.41)</b>
-<P>
-First, make sure that you've checked out the most recent branch via git.
-Don't download the repository via .zip or .tar.gz, as otherwise you'll
-need to add the git submodule(s) yourself.
-('git init' in a folder, and then 'git clone https://gitlab.com/graphviz/graphviz.git')
-<P>
-Then, run 'git submodule update --init' in the root directory. This will
-download all submodules, which are mostly the dependencies for the Windows build.
-<P>
-You may need to add the ..\windows\dependencies\graphviz-build-utilities
-directory to your PATH environmental variable (and restart Visual Studio
-or the prompt with which you execute msbuild after that). This folder
-contains the tools Bison, Flex and SED (and future additions) with versions
-that are tested.
-<P>
-If all went right, the dependencies are now set up and you can build Graphviz.
-<P>
-Then browse to ..\graphviz\windows\getopt\ and open up getopt.vcxproj in
-Visual Studio. Building, for exaple, dot.exe is done by right-clicking
-dot in the solution explorer, and clicking build.
-<P>
-Then, in ..\graphviz\Debug\Graphviz\bin\ run 'dot.exe -c' to make a
-config file and everything should work.
-
-<P>
-<b>(Graphviz versions ≥ 2.30)</b>
-<P>
-The current build process for Windows using Visual Studio is fairly
-simple <b>assuming all of the necessary files are available and have
-been put in the correct place</b>. The build assumes you have installed
-binary versions of <A HREF="http://www.gtk.org">GTK 2.0</A> or later,
-<A HREF="http://www.qt.io/">Qt</A>,
-and <A HREF="http://gnuwin32.sourceforge.net/packages/libtool.htm">ltdl</A>,
-and source versions of <A HREF="http://gts.sourceforge.net/">GTS</A>
-and <A HREF="http://www.cs.umd.edu/~mount/ANN/">ann</A>.
-Further instructions can be found in the
-<A HREF="https://gitlab.com/graphviz/graphviz/issues/36">Graphviz gitlab repository</A>.
-<P>
-This whole process could and should be simplified. In particular, the
-3rd-party software should not be stored in two places, and the Graphviz
-files that are made part of the release should come from the source package,
-and not be stored separately.
-In addition, the GTS and ANN build should be separate from the Graphviz
-build. As 3rd-party libraries, these should only be built when the source
-is updated.
-<P>
-<b>(Graphviz versions ≥ 2.22)</b>
-<P>
-We now build both Visual Studio and MinGW versions of Graphviz.
-In addition, the source package comes with project files for Visual Studio,
-so building from source should be fairly simple in either case.
-<UL>
-<LI>
-The first step is to add the third-party libraries. These are listed
-<A HREF="https://www.graphviz.org/download/source/">here</A>.
-This is most easily done by installing
-a Windows binary version of <A HREF="http://www.gtk.org">GTK 2.0</A> or later.
-<LI>
-Next, download and unwrap the Graphviz source package. Go to
-<A HREF="https://www.graphviz.org/download/source/">https://www.graphviz.org/download/source/</A>
-and copy over either the stable release
-or the development source package.
-</UL>
-Let $ROOT be the root directory (folder)
-in which you stored the Graphviz source.
-<h3>Building with Visual Studio</h3>
-<OL>
-<LI>
-Copy the file $ROOT/windows/config.h into $ROOT.
-<LI>
-Copy the folder $ROOT/windows/FEATURE into $ROOT.
-<LI>
-Start Visual Studio and read in $ROOT/graphviz.sln.
-There are project files for all of the parts of Graphviz.
-<LI>
-Modify the various settings for include file and library directories to find
-the third-party software.
-<LI>
-Modify the settings as to where you want the software installed.
-<LI>
-Build Graphviz.
-</OL>
-<h3>Building with MinGW</h3>
-<OL>
-<LI> Install MinGW and Msys. This gives a mini GNU-like compile environment
-<LI> Set environment variables based on your machine, giving values to the
-first six below:
-<CODE>
-<PRE>
-export INSTALLROOT # Root install directory
-export GTKDIR # Root of GTK tree
-export FONTCONFIGINCLUDEDIR # Path of fontconfig include dir
-export FONTCONFIGLIBDIR # Path of fontconfig lib dir
-export FREETYPEINCLUDEDIR # Path of freetype2 include dir
-export FREETYPELIBDIR # Path of freetype2 lib dir
-
-export CFLAGS="-DGVDLL=1"
-export CPPFLAGS="-I$GTKDIR/include -I$GTKDIR/include/freetype2 "
-export LDFLAGS="-L$GTKDIR/lib -no-undefined"
-export FONTCONFIG_CFLAGS=-I$GTKDIR/include/
-export FONTCONFIG_LIBS="-L$FONTCONFIGLIBDIR -lfontconfig"
-export FREETYPE2_CFLAGS=-I$FREETYPEINCLUDEDIR
-export FREETYPE2_LIBS=-L$FREETYPELIBDIR
-export PKG_CONFIG=$GTKDIR/bin/pkg-config
-export PKG_CONFIG_PATH=$GTKDIR/lib/pkgconfig
-
-export PANGOFLAGS="--with-fontconfig --with-fontconfiglibdir=$FONTCONFIGLIBDIR --with-fontconfigincludedir=$FONTCONFIGINCLUDEDIR --with-pangocairo"
-
-</PRE>
-</CODE>
-<LI> Change directory to $ROOT and run configure:<BR>
-<CODE>
-<PRE>
-./configure -C --prefix=$INSTALLROOT --without-gdk-pixbuf --with-mylibgd --disable-swig --without-x --disable-tcl --without-ipsepcola --enable-shared --disable-static --with-freetype=$GTKDIR/lib --enable-ltdl $PANGOFLAGS --without-gtk --without-gtkgl
-
-</PRE>
-</CODE>
-When configure finishes, it lists all of the Graphviz features that have been
-enabled. If there are problems, you can check for errors in <TT>config.log</TT>.
-You may have to add or modify
-other flags and environment variables for <TT>configure</TT> to give you the
-settings you want. Run <TT>configure --help</TT>
-to see the allowed options and environment variables.
-<LI> Run <TT>make</TT>
-<LI> Run <TT>make install</TT>
-</OL>
-These builds create a feature-full version of Graphviz. You can tailor
-them to your wants. This is fairly simple for MinGW: just remove or reset
-the flag of the option you don't want. For Visual Studio, you will probably
-need to reset some of the values in <TT>config.h</TT> and some of the
-compile-time options.
-<HR>
-<P>
-<b>(2.21 >= Graphviz versions > 2.14)</b>
-<P>
-To simplify our build process, especially as most Windows users only
-want a binary version of the software, the Graphviz build for Windows
-now uses <A HREF="http://www.research.att.com/sw/tools/uwin/"><B>uwin</B></A>,
-an open-source Unix layer on top of Windows. In this
-environment, we can use essentially the same tools and process
-used on Unix. In particular, we do not have to maintain multiple build
-files.
-<P>
-To build Graphviz:
-<OL>
-<LI>
-Install the third-party libraries. This is most easily done by installing
-a Windows binary verion of <A HREF="http://www.gtk.org">GTK 2.0</A> or later.
-<LI>
-Download the Graphviz source package:<BR>Go to
-<A HREF="https://www.graphviz.org/download/source/">https://www.graphviz.org/download/source/</A>
-and copy over either the stable release <TT>graphviz-</TT><I>VERSION</I><TT>.tar.gz</TT>
-or the development source package <TT>graphviz-working.tar.gz</TT>.
-<LI>
-Unwrap the package:<BR>
-You can use, for example,<BR><BR>
-<TT>gunzip < graphviz-working.tar.gz | tar xf -</TT><BR>
-Let <TT>$ROOT</TT> be the directory in which you stored the Graphviz source.
-<LI>
-Configure the package for your system:<BR><BR>
-<TT>cd $ROOT</TT><BR>
-<TT>configure --disable-shared --enable-static --with-mylibgd --disable-swig --without-x --without-tclsh --with-codegens --disable-ltdl</TT><BR><BR>
-You will probably want to provide additional arguments to
-<TT>configure</TT> to indicate where you have installed GTK, where
-you want the results installed (<TT>--prefix</TT>) and which
-additional optional packages you want built. Run <TT>configure --help</TT>
-to see the available set of arguments.
-<LI>
-Build Graphviz:<BR><BR>
-<TT>make install</TT><BR><BR>
-</OL>
-<P>
-Presumably, a similar approach would work with Cygwin or MinGW.
-The following are some notes by
-<A HREF="https://mailman.research.att.com/pipermail/graphviz-devel/2007/000444.html">Steve Roush</A>
-describing how he
-made a static build of the libraries on MinGW.
-<MENU>
-<LI> Install MinGW and Msys. This gives a mini GNU-like compile environment
-that produces Windows-compatible results.
-<LI> You may need to configure and build in Windows "Safe mode". Try
-./configure in normal mode; if it dies with "fork" problems, use Safe mode.
-<LI> Edit the "configure" file.<BR>
- after this line:<BR>
- <CODE>DEFS=-DHAVE_CONFIG_H</CODE><BR>
- add these lines:<BR>
-<CODE>
-<PRE>
- case "$host_os" in
- mingw*)
- DEFS="$DEFS -DMSWIN32"
- ;;
- esac
-</PRE>
-</CODE>
-<LI> run configure:<BR>
-<CODE>
-<PRE>
- ./configure --enable-static=yes --enable-shared=no
---prefix=/usr/local/ --with-libgd=no --enable-ltdl=no --disable-swig
---disable-sharp --disable-guile --disable-io --disable-java
---disable-lua --disable-ocaml --disable-perl --disable-php
---disable-python --disable-ruby --disable-tcl
-</PRE>
-</CODE>
-<LI> edit lib/Makefile<BR>
- replace these lines:<BR>
-<CODE>
-<PRE>
- SUBDIRS = cdt graph agraph gd pathplan sfio vmalloc ast vpsc \
- circogen dotgen fdpgen neatogen twopigen common pack gvc \
- ingraphs expr
-</PRE>
-</CODE>
-
- with these lines:<BR>
-<CODE>
-<PRE>
- SUBDIRS = cdt graph agraph gd pathplan vpsc \
- circogen dotgen fdpgen neatogen twopigen common pack gvc \
- ingraphs
-
-make # builds most of "lib" (see Makefile changes), cmd/dot and
-cmd/tools - stops on cmd/gvpr
-make install
-</PRE>
-</CODE>
-</MENU>
-here is the command line I used to build "simple.c" (dot.demo/simple.c),
-after adding a few lines based on
-https://mailman.research.att.com/pipermail/graphviz-interest/2006q2/003586.html
-
-
-<CODE>
-<PRE>
-X=simple;gcc -v -I'/usr/local/include/graphviz' -I'/usr/local/include'
--o $X -O $X.c -L/usr/local/lib -L/usr/local/lib/graphviz -lgvc -lgraph
--lpathplan -lcdt -lgvplugin_core -lgvplugin_dot_layout
--lgvplugin_neao_layout -lgvplugin_gd -lgvplugin_pango -lgvc -lpathplan
-</PRE>
-</CODE>
-<P>
-If you
-desire to build directly using Visual Studio or other non-Unix-based
-environment, you will need to derive the necessary information from the
-supplied Makefiles.
-<HR>
-<P>
-<b>(2.14 >= Graphviz versions >= 2.3)</b>
-<P>
-We build Graphviz on Windows using the MS Visual C++ 6.0 compiler
-only. The simplest way to build the software from source on Windows is as
-follows:
-<OL>
-<LI>
-Download the Windows source package from:
-<A HREF="https://www.graphviz.org/download/#windows">https://www.graphviz.org/download/#windows</A>.
-</LI>
-<LI>
-Unwrap the package:<BR>
-If you have Unix tools available, you can use
-<TT>gunzip < graphviz-win.tgz | tar xf -</TT><BR>
-If not, double click on the file and WinZip should start up and let you
-store all of the files into a directory.<BR>
-Let <TT>$ROOT</TT> be the directory in which you stored the Graphviz source.
-</LI>
-<LI>
-Add the third-party libraries:
-<UL TYPE=DISC>
-<LI>
-zlib 1.1.3 <A HREF=http://www.gzip.org/zlib/>http://www.gzip.org/zlib/</A>
-<LI>
-libpng 1.0.6 <A HREF=http://www.libpng.org/pub/png>http://www.libpng.org/pub/png</A>
-<LI>
-jpeg-6b 62 <A HREF=http://www.ijg.org/>http://www.ijg.org/</A>
-<LI>
-freetype 2.1.7 <A HREF=http://freetype.sourceforge.net/>http://freetype.sourceforge.net/</A>
-<LI>
-expat <A HREF=http://expat.sourceforge.net/>http://expat.sourceforge.net/</A>
-</UL>
-The versions should be at least the ones indicated.
-You can download the files from
-<a href=http://www.graphviz.org/Misc/third-party.zip>http://www.graphviz.org/Misc/third-party.zip</a>.
-Unzip the package in the <TT>$ROOT</TT> directory; this will create a subdirectory called
-<TT>third-party</TT>.
-Or you can obtain the libraries yourself, and install
-them in <TT>$ROOT\third-party</TT>
-Also note that these libraries come with the binary release.
-</LI>
-<LI>
-Build the software in one of the following ways:<BR>
-<UL TYPE=DISC>
-<LI> Run the script <TT>$ROOT\build.bat</TT> while in the <TT>$ROOT</TT>
-directory. You'll first want to check
-that the <TT>vc</TT> variable points to your local installation of visual C.
-Obviously, this should be run in a DOS command window.
-<LI> The file <TT>$ROOT\ws\graphviz.dsw</TT>
-is the main workspace for the Graphviz libraries and graph drawing programs.
-The file
-<TT>$ROOT\ws\tools.dsw</TT> provides the workspace for the
-additional Graphviz tools. Double-clicking on these files will open the
-workspaces using the MS Visual Studio, from which you can use the Build
-menu item to create the various libraries and programs.
-<P>
-Note that we have avoided all dependencies (i.e., there are no .dep files)
-because we found they tended to include absolute pathnames.
-If necessary, follow the order used in <TT>build.bat</TT> to be safe.
-<LI> If you have a Unix environment, with a real ksh, run the script
-<TT>$ROOT\wmake.sh</TT>
-after setting the PATH, LIB and INCLUDE shell variables to the paths where
-the Visual C programs are installed on your machine, and the associated
-library and include file directories.
-</UL>
-</OL>
-<P> Once built, all of the libraries and programs will be found in
-either the Release or Debug subdirectory of the corresponding source
-directory. If you wish to install
-the software somewhere, edit the file <TT>$ROOT\install.bat</TT> to
-set the variable <TT>root</TT> to be the absolute pathname of the
-directory where you want
-the software installed, and then run the script <TT>$ROOT\install.bat</TT>
-from the <TT>$ROOT</TT> directory.
-<P>
-If you want to change source files, you can just do it and rebuild.
-If, however, you want to add new files or projects, you will
-have to redo the makefiles or scripts.
-<P>
-If you have problems or questions, please contact us at
-<A href=mailto:erg@research.att.com>erg@research.att.com</A>.
-</body>
-</html>
+<a href="https://graphviz.org/doc/winbuild.html">Moved to graphviz.org</a>
projects / graphviz / commitdiff