Changeset 5247:ec6f7d81af91

Timestamp:

2007-11-01 03:04:25 (15 months ago)

Author:

Rocco Rutte <pdmef@…>

Branch:

HEAD

Message:

Manual: Add ids to all tables and use <xref/> for reference.

Files:

• doc/manual.xml.head (modified) (13 diffs)

doc/manual.xml.head

@@ -198 +198 @@
 
 <para>
-Information is presented in menus, very similar to ELM.  Here is a table
-showing the common keys used to navigate menus in Mutt.
-</para>
-
-<para>
-
-<table>
+Information is presented in menus, very similar to ELM, see <xref linkend="tab-keys-nav"/>
+for common keys used to navigate menus in Mutt.
+</para>
+
+<para>
+
+<table id="tab-keys-nav">
 <title>Most common navigation keys</title>
 <tgroup cols="3">
@@ -236 +236 @@
 Mutt has a built-in line editor for inputting text, e.g. email
 addresses or filenames. The keys used to manipulate text input are
-very similar to those of Emacs. See the following table for a full
+very similar to those of Emacs. See <xref linkend="tab-keys-editor"/> for a full
 reference of available functions, their default key bindings, and
 short descriptions.
@@ -243 +243 @@
 <para>
 
-<table>
+<table id="tab-keys-editor">
 <title>Most common line editor keys</title>
 <tgroup cols="3">
@@ -352 +352 @@
 
 <para>
-
-<table>
+Common keys used to navigate through and manage messages in the index
+are shown in <xref linkend="tab-key-index"/>.
+</para>
+
+<para>
+
+<table id="tab-key-index">
 <title>Most common message index keys</title>
 <tgroup cols="2">
@@ -586 +591 @@
 <para>
 
-<table>
+<table id="tab-key-pager">
 <title>Most common pager keys</title>
 <tgroup cols="2">
@@ -611 +616 @@
 
 <para>
-In addition, many of the functions from the <emphasis>index</emphasis> are available in
+In addition to key bindings in <xref linkend="tab-key-pager"/>,
+many of the functions from the <emphasis>index</emphasis> are available in
 the pager, such as <emphasis>delete-message</emphasis> or <emphasis>copy-message</emphasis> (this is one
 advantage over using an external pager to view messages).
@@ -688 +694 @@
 <para>
 When the mailbox is <link linkend="sort">sorted</link> by <emphasis>threads</emphasis>, there are
-a few additional functions available in the <emphasis>index</emphasis> and <emphasis>pager</emphasis> modes.
-</para>
-
-<para>
-
-<table>
+a few additional functions available in the <emphasis>index</emphasis> and <emphasis>pager</emphasis> modes
+as shown in <xref linkend="tab-key-threads"/>.
+</para>
+
+<para>
+
+<table id="tab-key-threads">
 <title>Most common thread mode keys</title>
 <tgroup cols="3">
@@ -932 +939 @@
 
 <para>
-The following bindings are available in the <emphasis>index</emphasis> for sending
-messages.
-</para>
-
-<para>
-
-<table>
+The bindings shown in <xref linkend="tab-key-send"/> are available in the
+<emphasis>index</emphasis> for sending messages.
+</para>
+
+<para>
+
+<table id="tab-key-send">
 <title>Most common mail sending keys</title>
 <tgroup cols="3">
@@ -992 +999 @@
 <para>
 Once you have finished editing the body of your mail message, you are
-returned to the <emphasis>compose</emphasis> menu.  The following functions are available:
-</para>
-
-<para>
-
-<table>
+returned to the <emphasis>compose</emphasis> menu providing the functions
+show in <xref linkend="tab-func-compose"/>.
+</para>
+
+<para>
+
+<table id="tab-func-compose">
 <title>Most common compose menu keys</title>
 <tgroup cols="3">
@@ -1124 +1132 @@
 
 <para>
-The flags sequence (&percnt;f) will expand to one of the following flags:
-
-<table>
+The flags sequence (&percnt;f) will expand to one of the flags in
+<xref linkend="tab-pgp-menuflags"/>.
+
+<table id="tab-pgp-menuflags">
 <title>PGP key menu flags</title>
 <tgroup cols="2">
@@ -1321 +1330 @@
 they were the message's original recipients.  Forwarding a message, on
 the other hand, allows you to modify the message before it is resent
-(for example, by adding your own comments).
-</para>
-
-<para>
-The following keys are bound by default:
-</para>
-
-<para>
-
-<table>
+(for example, by adding your own comments). The default key bindings
+are shown in <xref linkend="tab-key-fwd"/>.
+</para>
+
+<para>
+
+<table id="tab-key-fwd">
 <title>Message forwarding/bouncing keys</title>
 <tgroup cols="3">
@@ -1801 +1807 @@
 equivalent.  An alternative form is to specify the key as a three digit
 octal number prefixed with a ``&bsol;'' (for example <emphasis>&bsol;177</emphasis> is
-equivalent to <emphasis>&bsol;c?</emphasis>).
-</para>
-
-<para>
-In addition, <emphasis>key</emphasis> may consist of:
-</para>
-
-<para>
-
-<table>
+equivalent to <emphasis>&bsol;c?</emphasis>). In addition, <emphasis>key</emphasis> may
+be a symbolic name as shown in <xref linkend="tab-key-names"/>.
+</para>
+
+<para>
+
+<table id="tab-key-names">
 <title>Symbolic key names</title>
 <tgroup cols="2">
@@ -3779 +3782 @@
 <para>
 Many of Mutt's commands allow you to specify a pattern to match
-(limit, tag-pattern, delete-pattern, etc.).  There are several ways to select
-messages:
-</para>
-
-<para>
-
-<table>
+(limit, tag-pattern, delete-pattern, etc.). <xref linkend="tab-patterns"/>
+shows several ways select messages.
+</para>
+
+<para>
+
+<table id="tab-patterns">
 <title>Pattern modifiers</title>
 <tgroup cols="2">