source: x/installing/x7proto.xml@ de53c9be

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY x7proto-download-http "http://xorg.freedesktop.org/releases/individual/proto/">
  <!ENTITY x7proto-download-ftp  "ftp://ftp.x.org/pub/individual/proto/">
  <!ENTITY x7proto-wget          "&files-anduin;/xorg/proto-&xorg7-release;.wget">
  <!ENTITY x7proto-md5sum        "&files-anduin;/xorg/proto-&xorg7-release;.md5">
  <!ENTITY x7proto-size          "1.9 MB">
<!-- Editors note:  Because we recommend a scripted build that removes
     the source directories after installation, the xorg buildsizes are
     determined by the sum of all package source tarballs, the size of
     installed files, and the size of the largest package's build
     directory after running make install. -->
  <!ENTITY x7proto-buildsize     "10.2 MB">
  <!ENTITY x7proto-time          "0.8 SBU">

]>

<sect1 id="xorg7-proto" xreflabel="Xorg Protocol Headers">
  <?dbhtml filename="x7proto.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Xorg Protocol Headers</title>

  <indexterm zone="xorg7-proto">
    <primary sortas="a-xorg7-proto">Xorg Protocol Headers</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Xorg Protocol Headers</title>

    <para>The <application>Xorg</application> protocol headers provide the
    header files required to build the system, and to allow other
    applications to build against the installed X Window system.</para>

    &lfs65_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&x7proto-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&x7proto-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: <ulink url="&x7proto-md5sum;"/></para>
      </listitem>
      <listitem>
        <para>Download size: &x7proto-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &x7proto-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &x7proto-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Required download list: <ulink url="&x7proto-wget;"/></para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Xorg Protocol Headers Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"> <xref linkend="xorg7-util"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="required"> <xref linkend="fop"/> and <xref linkend="xmlto"/>
    (to build additional documentation)</para>

    <note><para>There is a reciprocal dependency with <xref linkend="fop"/>. If
    you wish to build the documentation, you'll need to re-install the 
    Protocol Headers after the installation is complete and
    <xref linkend="fop"/> has been installed.</para></note>

    <para condition="html" role="usernotes">User Notes:
    <ulink url='&blfs-wiki;/Xorg7ProtocolHeaders'/></para>

  </sect2>

  <sect2>
    <title>Downloading Xorg Protocol Headers</title>

    <para>To download the needed files using <application>wget</application>,
    use the following commands:</para>

<screen><userinput>mkdir proto &amp;&amp;
cd proto &amp;&amp;
grep -v '^#' ../proto-&xorg7-release;.wget | wget -i- -c \
    -B http://xorg.freedesktop.org/releases/individual/proto/ &amp;&amp;
md5sum -c ../proto-&xorg7-release;.md5</userinput></screen>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Xorg Protocol Headers</title>

    <para>Install the <application>Xorg</application> protocol headers
    by running the following commands for each package to be installed.</para>

<screen><userinput>./configure $XORG_CONFIG</userinput></screen>

    <para>These packages do not provide test suites.</para>

    <para>Now as the <systemitem class="username">root</systemitem>
    user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>None</seg>
        <seg>None</seg>
        <seg>The following subdirectories of <envar>$XORG_PREFIX</envar>/:
        include/X11, include/GL, and lib/pkgconfig</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>