source: postlfs/editors/ed.xml@ 60d7202

<?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 ed-download-http "http://ftp.gnu.org/pub/gnu/ed/ed-&ed-version;.tar.bz2">
  <!ENTITY ed-download-ftp  "ftp://ftp.gnu.org/pub/gnu/ed/ed-&ed-version;.tar.bz2">
  <!ENTITY ed-md5sum        "80d096dc98fd17a44fb9e3ed3e719ee7">
  <!ENTITY ed-size          "66 KB">
  <!ENTITY ed-buildsize     "1.3 MB">
  <!ENTITY ed-time          "Less than 0.1 SBU">
]>

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

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

  <title>Ed-&ed-version;</title>

  <indexterm zone="ed">
    <primary sortas="a-Ed">Ed</primary>
  </indexterm>

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

    <para><application>Ed</application> is a line-oriented text editor. It
    is used to create, display, modify and otherwise manipulate text files,
    both interactively and via shell scripts. Ed isn't something which many
    people use. It's described here because it can be used by the patch
    program if you encounter an ed-based patch file. This happens rarely
    because diff-based patches are preferred these days.</para>

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

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

  </sect2>

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

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

<!-- Removing this command after discussion on -dev. Additionally,
     there isn't even a "command explanation" to tell readers what
     it is there for.

     sed -i 's/; ln/&amp; -sv/' Makefile.in &amp;&amp;
-->

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

    <para>To test the results, issue: <command>make check</command>.</para>

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

<screen role="root"><userinput>make install &amp;&amp;
make install-man</userinput></screen>

  </sect2>

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

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

      <seglistitem>
        <seg>ed and red</seg>
        <seg>None</seg>
        <seg>None</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="ed-prog">
        <term><command>ed</command></term>
        <listitem>
          <para>is a line-oriented text editor.</para>
          <indexterm zone="ed ed-prog">
            <primary sortas="b-ed">ed</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="red">
        <term><command>red</command></term>
        <listitem>
          <para>is a restricted <command>ed</command>&mdash;it can only edit
          files in the current directory and cannot execute shell
          commands.</para>
          <indexterm zone="ed red">
            <primary sortas="b-red">red</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>