TheOldFellow wrote: > What's the policy on new packages in the BLFS book? > > For instance I discovered an editor, called Bluefish, and introduced a > number of LFSers to it, with good reports. BLFS doesn't have a tabbed > desktop-independent X-windows editor designed for markup and syntax > highlighting (I know emucks can do everything, thanks) ....
Just in case it's helpful, I did the edit as an exercise to see how easy it is, and here is the 'svn diff' against the book checked out a couple of hours ago. The key learning points seem to be to use 'svn add' to tell svn about any new files, then edit general.ent and the index xxx.xml for the chapter/section. Create the new page by editing something similar. Finally 'svn diff > xxx.patch' at the top level. I didn't try to add anything to changelog... I must say the book source is very tidy now, and Manuel has done a fantastic job with the markup. An interesting exercise, even if you don't use it Bruce. R.
Index: postlfs/editors/bluefish.xml =================================================================== --- postlfs/editors/bluefish.xml (revision 0) +++ postlfs/editors/bluefish.xml (revision 0) @@ -0,0 +1,143 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"; [ + <!ENTITY % general-entities SYSTEM "../../general.ent"> + %general-entities; + + <!ENTITY bluefish-download-http "http://pkedu.fbt.eitn.wau.nl/~olivier/downloads/bluefish-&bluefish-version;.tar.bz2 "> + <!ENTITY bluefish-download-ftp "ftp://ftp.ratisbona.com/pub/bluefish/downloads/bluefish-&bluefish-version;.tar.bz2";> + <!ENTITY bluefish-md5sum "a3cf8abd282d850407e8c7eed38d15e7"> + <!ENTITY bluefish-size "1.4 MB"> + <!ENTITY bluefish-buildsize "23.7 MB"> + <!ENTITY bluefish-time "0.5 SBU"> +]> + +<sect1 id="bluefish"> + <?dbhtml filename="bluefish.html"?> + + <sect1info> + <othername>$LastChangedBy: theoldfellow $</othername> + <date>$Date: 2005-06-04 22:56:54 +0100 (Mon, 4 June 2005) $</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>The <application>bluefish</application> package contains a powerful X Windows editor + designed for web designers, but which is also suitable as a programmers editor. + Bluefish supports many programming and markup languages, and as such is ideal for editing + xml and html files.</para> + + <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><xref linkend="gtk2"/> <xref linkend="pcre"/></para> + <bridgehead renderas="sect4">Optional</bridgehead> + <para><xref linkend="gnome-vfs"/> (for remote files) + <xref linkend="aspell"/> (for spellchecking)</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 && +make</userinput></screen> + + <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> Directory <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 ~/.bluefish 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 Programs</segtitle> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Directory</segtitle> + + <seglistitem> + <seg>bluefish</seg> + <seg>None</seg> + <seg>/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 Windows editor for markup and programming.</para> + <indexterm zone="bluefish bluefish-prog"> + <primary sortas="b-bluefish">bluefish</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> Index: postlfs/editors/editors.xml =================================================================== --- postlfs/editors/editors.xml (revision 4546) +++ postlfs/editors/editors.xml (working copy) @@ -20,6 +20,7 @@ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="nano.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="joe.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="ed.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="bluefish.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="others.xml"/> </chapter> Index: general.ent =================================================================== --- general.ent (revision 4546) +++ general.ent (working copy) @@ -51,6 +51,7 @@ <!ENTITY nano-version "1.2.4"> <!ENTITY joe-version "3.1"> <!ENTITY ed-version "0.2"> +<!ENTITY bluefish-version "1.0.1"> <!-- Chapter 7 --> <!ENTITY ash-version "0.4.0">
-- http://linuxfromscratch.org/mailman/listinfo/blfs-dev FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
