Re: Help files [PATCH]

[Peter Bloomfield <bloomfld eos ncsu edu>]

On 2001.07.31 09:53 Pawel Salek wrote:

[snip]

> For me, the following two steps worked:
> 1. get gnome-doc-tools package from, for example,
> http://people.redhat.com/dcm/software.html
> 2. make sure your SGML catalog contains proper sub-catalogs, in
> particular PNG-support. In my case, I had to add a line
> CATALOG /usr/share/sgml/docbook/png-support-3.1/catalog
> to /etc/sgml/sgml-docbook.cat
> 
> You should never get any warning messages when parsing the sgml file.

Thanks for the advice, Pawel! I was getting scads of errors. In addition to
your steps 1 and 2, I needed to add the line

CATALOG /usr/share/sgml/docbook/sgml-dtd-3.1/catalog

to my /etc/sgml/sgml-docbook.cat, as it had only a reference to 4.1.

Now I can see the docs, and there's one minor change I'd like to make
(patch attached).

Peter
diff -Nur balsa-cvs/help/C/balsa.sgml balsa-temp/help/C/balsa.sgml
--- balsa-cvs/help/C/balsa.sgml	Fri Jul 27 13:18:00 2001
+++ balsa-temp/help/C/balsa.sgml	Tue Jul 31 18:53:40 2001
@@ -2845,13 +2845,14 @@
       selected a mailbox in an IMAP tree, only that tree is 
       shown for browsing; otherwise, all IMAP trees will be shown.</para>
 
-    <para>When the dialog is opened by right-clicking on an IMAP
+    <para>When the dialog is opened from the ``Mailbox->Edit'' menu item
+      with an IMAP folder selected, or by right-clicking on an IMAP
       mailbox and selecting ``Properties...'', the mailbox may be:
-    <itemizedlist mark="bullet">
-      <listitem><para>Renamed, by editing the folder name;</para></listitem>
-      <listitem><para>Moved, by browsing for a different parent folder
-	in the same tree.</para></listitem>
-    </itemizedlist></para>
+      <itemizedlist mark="bullet">
+        <listitem><para>Renamed, by editing the folder name;</para></listitem>
+        <listitem><para>Moved, by browsing for a different parent folder
+  	in the same tree.</para></listitem>
+      </itemizedlist></para>
   </sect2>
   </sect1>