source: gnome/add/gedit.xml@ 0492ab0

<?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 gedit-download-http "&gnome-download-http;/gedit/&gnome-version;/gedit-&gedit-version;.tar.bz2">
  <!ENTITY gedit-download-ftp  "&gnome-download-ftp;/gedit/&gnome-version;/gedit-&gedit-version;.tar.bz2">
  <!ENTITY gedit-md5sum        "7e8bf29bd6bf0d17ceaf42d9bd5d94e6">
  <!ENTITY gedit-size          "3.4 MB">
  <!ENTITY gedit-buildsize     "80 MB">
  <!ENTITY gedit-time          "1.1 SBU (includes spell-check support and Python plugins)">
]>

<sect1 id="gedit" xreflabel="gedit-&gedit-version;">
  <?dbhtml filename="gedit.html"?>

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

  <title>gedit-&gedit-version;</title>

  <indexterm zone="gedit">
    <primary sortas="a-gedit">gedit</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to gedit</title>

    <para>The <application>gedit</application> package contains a lightweight
    UTF-8 text editor for the <application>GNOME</application> desktop.</para>

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

    <bridgehead renderas="sect3">gedit Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="libgnomeui"/>,
    <xref linkend="libgnomeprintui"/>,
    <xref linkend="gnome-doc-utils"/>,
    <xref linkend="gtksourceview"/>, and
    <xref linkend="which"/></para>

    <bridgehead renderas="sect4">Optional (to Provide Spell-Checking Capability)</bridgehead>
    <para role="optional"><xref linkend="iso-codes"/> and
    <ulink url="http://www.abisource.com/projects/enchant/">Enchant</ulink>*</para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="intltool"/>,
    <xref linkend="gtk-doc"/>,
    <ulink url="ftp://oss.sgi.com/projects/xfs/cmd_tars/">libattr</ulink>, and
    <ulink url="&gnome-download-http;/gnome-python-desktop">gnome-python-desktop</ulink>
    (requires <ulink url="http://www.pygtk.org/">PyGTK</ulink> and can use
    <ulink url="&gnome-download-http;/gnome-python/">GNOME-Python</ulink> and
    <ulink url="&gnome-download-http;/pyorbit/">PyORBit</ulink>)</para>

    <para>* <xref linkend="aspell"/> is just one of many backend spell libraries
    <application>Enchant</application> can use. See the
    <application>Enchant</application> project page (URL above) for additional
    information about the available backends.</para>

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

  </sect2>

  <sect2 role="installation">
    <title>Installation of gedit</title>

    <para>Install <application>gedit</application> by running the following
    commands:</para>

<screen><userinput>./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
            --sysconfdir=&gnome-etc-dir; \
            --localstatedir=/var/lib \
            --disable-spell &amp;&amp;
make</userinput></screen>

    <para>This package does not come with a test suite.</para>

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

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

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../xincludes/gnome-prefix.xml"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../xincludes/gnome-sysconfdir.xml"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../xincludes/scrollkeeper-dir.xml"/>

    <para><parameter>--disable-spell</parameter>: This parameter disables
    spell-checking capability and is required if
    <application>Enchant</application> is not installed. Remove the
    parameter if <application>Enchant</application> is installed.</para>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../xincludes/gtk-doc-rebuild.xml"/>

  </sect2>

  <!-- <sect2 role="configuration">
    <title>Configuring gedit</title>

    <sect3>
      <title>Configuration Information</title>

      <para>There is no way in the preferences to change the color of
      highlighted (such as when you search for text and it is found) text.
      If you wish to change the color, issue the following command as the
      <systemitem class="username">root</systemitem> user (substitute your
      color of choice):</para>

<screen role="root"><userinput>sed -i 's/FFFF78/<replaceable>&lt;some-color-you-like&gt;</replaceable>/' gedit/gedit-document.c</userinput></screen>

    </sect3>

  </sect2> -->

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

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

      <seglistitem>
        <seg>gedit and gnome-text-editor</seg>
        <seg><application>gedit</application> plugin modules</seg>
        <seg>The following subdirectories of <envar>$GNOME_PREFIX</envar>/:
        include/gedit-2.16,
        lib/gedit-2,
        share/{gedit-2, {gnome/help, omf}/gedit}</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="gedit-prog">
        <term><command>gedit</command></term>
        <listitem>
          <para>is a lightweight text editor integrated with the
          GNOME desktop.</para>
          <indexterm zone="gedit gedit-prog">
            <primary sortas="b-gedit">gedit</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gnome-text-editor">
        <term><command>gnome-text-editor</command></term>
        <listitem>
          <para>is a symlink to <command>gedit</command>.</para>
          <indexterm zone="gedit gnome-text-editor">
            <primary sortas="g-gnome-text-editor">gnome-text-editor</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>