rxvt-unicode.

Ag. D. Hatzimanikas a.hatzim at gmail.com
Thu Aug 2 10:09:50 PDT 2007


Hi,

I created a patch (attached) to include the rxvt-unicode (urxvt)
terminal emulator into the Book.

I was tried to resemble, as possible, the xterm page, since both
packages are similar.

I was working with the 8.2 version, although the 8.3 it's out as of
today.

I did this because, jugging from the past, the author constantly
adds major features between the releases and quite? often brake things
(so new versions needs some testing first); and since the terminal is
quite critical for the daily activities, I chose 8.2 because it proved
stable enough.
I am using this version for 5 months and I didn't noticed any serious
problems, so I would like 8.2 to be the version, that will ship with the
upcoming 6.3 blfs release.

I've enabled the (--enable-everything) switch (pretty much the default
options), and I give later in the command explanations, the options to
disable Perl and Xft support, since that's the ones that could made the
binaries bigger and to use more memory.

The other option was to use (--disable-everything), and add any other
desired option but which also maybe will add and *adds* in my opinion
complexity.

Comments, suggestions and objections are welcome.

--Ag. 
http://wiki.linuxfromscratch.org/blfs/wiki/Hacking
-------------- next part --------------
Index: general.ent
===================================================================
--- general.ent	(revision 6997)
+++ general.ent	(working copy)
@@ -171,6 +171,7 @@
 <!ENTITY graphviz-version             "2.12">
 <!ENTITY recode-version               "3.6">
 <!ENTITY icon-naming-utils-version    "0.8.2">
+<!ENTITY rxvt-unicode-version         "8.2">
 
 <!-- Chapter 11 -->
 <!ENTITY gpm-version                  "1.20.1">
Index: general/genutils/rxvt-unicode.xml
===================================================================
--- general/genutils/rxvt-unicode.xml	(revision 0)
+++ general/genutils/rxvt-unicode.xml	(revision 0)
@@ -0,0 +1,199 @@
+<?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 rxvt-unicode-download-http "http://dist.schmorp.de/rxvt-unicode/Attic/rxvt-unicode-&rxvt-unicode-version;.tar.bz2">
+  <!ENTITY rxvt-unicode-download-ftp  " ">
+  <!ENTITY rxvt-unicode-md5sum        "7876a1e2a82794c5ebbea8791561daba">
+  <!ENTITY rxvt-unicode-size          "860 KB">
+  <!ENTITY rxvt-unicode-buildsize     "4.8 MB">
+  <!ENTITY rxvt-unicode-time          "0.2 SBU">
+]>
+
+<sect1 id="rxvt-unicode" xreflabel="rxvt-unicode-&rxvt-unicode-version;">
+  <?dbhtml filename="rxvt-unicode.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date: 2007-06-20 16:12:13 +0300 (Τετ, 20 Ιούν 2007) $</date>
+  </sect1info>
+
+  <title>rxvt-unicode-&rxvt-unicode-version;</title>
+
+  <indexterm zone="rxvt-unicode">
+    <primary sortas="a-rxvt-unicode">rxvt-unicode</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to rxvt-unicode</title>
+
+    <para><application>rxvt-unicode</application> is a clone of the terminal
+    emulator <application>rxvt</application>, for the X Window System, with 
+    XFT and Unicode support.</para>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&rxvt-unicode-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&rxvt-unicode-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &rxvt-unicode-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &rxvt-unicode-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &rxvt-unicode-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &rxvt-unicode-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">rxvt-unicode Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required"><xref linkend="xorg7-lib"/></para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url='&blfs-wiki;/rxvt-unicode'/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of rxvt-unicode</title>
+
+    <para>Install <application>rxvt-unicode</application> by running the
+    following commands:</para>
+
+<screen><userinput>./configure --prefix=/usr --enable-everything &&
+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>
+
+    <para><parameter>--enable-everything</parameter>: Add support for all 
+    non-multichoice options. Details about the different options can be found in
+    the file <filename>README.configure</filename>, into the sources directory.</para>
+   
+    <para><option>--disable-xft</option>: Remove support for Xft fonts.</para>
+
+    <para><option>--disable-perl</option>: Disable the embedded <application>Perl</application>
+    interpreter.</para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring rxvt-unicode</title>
+
+    <para>The <application>rxvt-unicode</application> terminal emulator
+    uses the resource class <classname>URxvt</classname> and the resource name
+    <classname>urxvt</classname>. You can add X resource definitions to the user's
+    <filename>~/.Xresources</filename> file, or you can add them to the system-wide
+    <filename>$XORG_PREFIX/share/X11/app-defaults/URxvt</filename> file.
+    The following example provides a way, to load the <classname>matcher</classname>
+    <application>Perl</application> extension (assuming <application>Perl</application>
+    support wasn't disabled), so to be able by middle clicking the underline URL,
+    to open it with the specified  browser. It also sets a backgroung and a foreground
+    color and loads an Xft font. In order to do that, add the following definitions as
+    the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>cat >> $XORG_PREFIX/share/X11/app-defaults/URxvt << "EOF"
+URxvt*perl-ext: matcher
+URxvt*urlLauncher: firefox
+URxvt.background: black
+URxvt.foreground: yellow
+URxvt*font: xft:Monospace:pixelsize=12
+EOF</userinput></screen>
+    
+    <para>The <application>rxvt-unicode</application> can also run in a daemon
+    (<command>urxvtd</command>) mode, that make possible to open multiple terminal
+    windows within the same process. The <command>urxvtc</command> client connects
+    then to <command>urxvtd</command> daemon and requests a new terminal window.
+    <emphasis role="strong">Note</emphasis>: Use that option with caution. If the 
+    daemon crashes for a reason, all the processes in the terminal windows are
+    terminated. You can start the <command>urxvtd</command> daemon in your system or
+    personal startup <command>X</command> session scripts (eg.
+    <filename>~/.xinitrc</filename>) by adding the following lines, near the top of
+    your script:</para>
+    
+<screen><userinput><literal># Start the urxvtd daemon
+urxvtd -q -f -o &
+</literal></userinput></screen>
+
+    <para>For more information, examine the <command>urxvt</command>,
+    <command>urxvtd</command>, <command>urxvtc</command>, and <filename>urxvtperl</filename>
+    man pages.</para>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>urxvt, urxvtd, and urxvtc.</seg>
+        <seg>Many <application>Perl</application> extensions located under
+        <filename class='directory'>/usr/lib/urxvt/perl</filename></seg>
+        <seg>/usr/lib/urxvt</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="urxvt-bin">
+        <term><command>urxvt</command></term>
+        <listitem>
+          <para>is a terminal emulator for the X Window System.</para>
+          <indexterm zone="rxvt-unicode urxvt-bin">
+            <primary sortas="b-urxvt-bin">urxvt</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="urxvtd">
+        <term><command>urxvtd</command></term>
+        <listitem>
+          <para>is the urxvt terminal daemon.</para>
+          <indexterm zone="rxvt-unicode urxvtd">
+            <primary sortas="b-urxvtd">urxvtd</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="urxvtc">
+        <term><command>urxvtc</command></term>
+        <listitem>
+          <para>controls the urxvtd daemon.</para>
+          <indexterm zone="rxvt-unicode urxvtc">
+            <primary sortas="b-urxvtc">xterm</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>

Property changes on: general/genutils/rxvt-unicode.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy

Index: general/genutils/genutils.xml
===================================================================
--- general/genutils/genutils.xml	(revision 6995)
+++ general/genutils/genutils.xml	(working copy)
@@ -38,5 +38,6 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="rman.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="recode.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="icon-naming-utils.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="rxvt-unicode.xml"/>
 
 </chapter>


More information about the blfs-dev mailing list