install.html 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119
  1. <html>
  2. <body>
  3. <h1 align='right'><a name='INSTALL'><img src="1.gif" align="right"
  4. hspace="10" width="100" height="100" alt="1"></a>Building,
  5. Installing, and Packaging Mini-XML</h1>
  6. <p>This chapter describes how to build, install, and package
  7. Mini-XML on your system from the source archive. You will need an
  8. ANSI/ISO-C compatible compiler to build Mini-XML - GCC works, as
  9. do most vendors' C compilers. If you are building Mini-XML on
  10. Windows, we recommend using the Visual C++ environment with the
  11. supplied solution file. For other operating systems, you'll need a
  12. POSIX-compatible shell and <tt>make</tt> program in addition to
  13. the C compiler.</p>
  14. <h2>Compiling Mini-XML</h2>
  15. <p>Mini-XML comes with both an autoconf-based configure script
  16. and a Visual C++ solution that can be used to compile the library
  17. and associated tools.</p>
  18. <h3>Compiling with Visual C++</h3>
  19. <p>Open the <VAR>mxml.sln</VAR> solution in the <VAR>vcnet</VAR>
  20. folder. Choose the desired build configuration, "Debug" (the
  21. default) or "Release", and then choose <VAR>Build Solution</VAR>
  22. from the <VAR>Build</VAR> menu.</p>
  23. <h3>Compiling with Command-Line Tools</h3>
  24. <p>Type the following command to configure the Mini-XML source
  25. code for your system:</p>
  26. <pre>
  27. <kbd>./configure ENTER</kbd>
  28. </pre>
  29. <p>The default install prefix is <var>/usr/local</var>, which
  30. can be overridden using the <kbd>--prefix</kbd> option:</p>
  31. <pre>
  32. <kbd>./configure --prefix=/foo ENTER</kbd>
  33. </pre>
  34. <p>Other configure options can be found using the
  35. <kbd>--help</kbd> option:</p>
  36. <pre>
  37. <kbd>./configure --help ENTER</kbd>
  38. </pre>
  39. <p>Once you have configured the software, use the
  40. <tt>make(1)</tt> program to do the build and run the test
  41. program to verify that things are working, as follows:</p>
  42. <pre>
  43. <kbd>make ENTER</kbd>
  44. </pre>
  45. <h2>Installing Mini-XML</h2>
  46. <p>If you are using Visual C++, copy the <VAR>mxml.lib</VAR> and
  47. and <VAR>mxml.h</VAR> files to the Visual C++ <VAR>lib</VAR> and
  48. <VAR>include<VAR> directories, respectively.</p>
  49. <p>Otherwise, use the <tt>make</tt> command with the
  50. <kbd>install</kbd> target to install Mini-XML in the configured
  51. directories:</p>
  52. <pre>
  53. <kbd>make install ENTER</kbd>
  54. </pre>
  55. <h2>Creating Mini-XML Packages</h2>
  56. <p>Mini-XML includes two files that can be used to create binary
  57. packages. The first file is <var>mxml.spec</var> which is used
  58. by the <tt>rpmbuild(8)</tt> software to create Red Hat Package
  59. Manager ("RPM") packages which are commonly used on Linux. Since
  60. <tt>rpmbuild</tt> wants to compile the software on its own, you
  61. can provide it with the Mini-XML tar file to build the
  62. package:</p>
  63. <pre>
  64. <kbd>rpmbuild -ta mxml-<i>version</i>.tar.gz ENTER</kbd>
  65. </pre>
  66. <p>The second file is <var>mxml.list</var> which is used by the
  67. <tt>epm(1)</tt> program to create software packages in a variety
  68. of formats. The <tt>epm</tt> program is available from the
  69. following URL:</p>
  70. <pre>
  71. <a href="http://www.epmhome.org/">http://www.epmhome.org/</a>
  72. </pre>
  73. <p>Use the <tt>make</tt> command with the <kbd>epm</kbd> target
  74. to create portable and native packages for your system:</p>
  75. <pre>
  76. <kbd>make epm ENTER</kbd>
  77. </pre>
  78. <p>The packages are stored in a subdirectory named
  79. <var>dist</var> for your convenience. The portable packages
  80. utilize scripts and tar files to install the software on the
  81. target system. After extracting the package archive, use the
  82. <var>mxml.install</var> script to install the software.</p>
  83. <p>The native packages will be in the local OS's native format:
  84. RPM for Red Hat Linux, DPKG for Debian Linux, PKG for Solaris,
  85. and so forth. Use the corresponding commands to install the
  86. native packages.</p>
  87. </body>
  88. </html>