source: postlfs/editors/bluefish.xml@ 671e64f

<?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 bluefish-download-http "http://www.bennewitz.com/bluefish/stable/source/bluefish-&bluefish-version;.tar.bz2">
  <!ENTITY bluefish-download-ftp  "&gentoo-ftp-repo;/bluefish-&bluefish-version;.tar.bz2">
  <!ENTITY bluefish-md5sum        "23d894e065585d35dbc74c246c15cc9d">
  <!ENTITY bluefish-size          "3.2 MB">
  <!ENTITY bluefish-buildsize     "53 MB">
  <!ENTITY bluefish-time          "0.4 SBU">
]>

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

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

  <title>Bluefish-&bluefish-version;</title>

  <indexterm zone="bluefish">
    <primary sortas="a-Bluefish">Bluefish</primary>
  </indexterm>

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

    <para><application>Bluefish</application> is a
    <application>Gtk+-2</application> text editor targeted towards programmers
    and webdesigners, with many options to write websites, scripts and
    programming code. Bluefish supports many programming and markup languages,
    and it focuses on editing dynamic and interactive websites.</para>

    &lfs70_checked;

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

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="gtk2"/> and
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="pcre"/>, <xref linkend="gucharmap"/>,
    <xref linkend="enchant"/> (for spellchecking),
    <xref linkend="desktop-file-utils"/> and
    <xref linkend="shared-mime-info"/></para>

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

  </sect2>

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

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

<screen><userinput>./configure --prefix=/usr &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="configuration">
    <title>Configuring Bluefish</title>

    <sect3 id="bluefish-config">
      <title>Config Files</title>

      <para><filename>~/.bluefish/*</filename></para>

      <indexterm zone="bluefish bluefish-config">
        <primary sortas="e-AA.bluefish">~/.bluefish</primary>
      </indexterm>

    </sect3>

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

      <para>The directory <filename class='directory'>~/.bluefish</filename> is
      created by the program when it is first run, and the configuration files
      are maintained by the program automatically to preserve settings from run
      to run.</para>

    </sect3>

  </sect2>

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

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>bluefish</seg>
        <seg>/usr/lib/bluefish and /usr/share/bluefish</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="bluefish-prog">
        <term><command>bluefish</command></term>
        <listitem>
          <para>is an X Window System editor for markup and programming.</para>
          <indexterm zone="bluefish bluefish-prog">
            <primary sortas="b-bluefish">bluefish</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>