<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 TRANSITIONAL//EN">
<HTML>
<HEAD>
  <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=UTF-8">
  <META NAME="GENERATOR" CONTENT="GtkHTML/3.32.2">
</HEAD>
<BODY>
On Sat, 2011-09-24 at 11:06 -0600, Matt Dew wrote:
<BLOCKQUOTE TYPE=CITE>
<PRE>
&gt;&gt;&gt; Shall I post all the other patches, (they all do the same thing) or put
&gt;&gt;&gt; up the repos that people can pull or, since the other patches are of the
&gt;&gt;&gt; same things, should I just push those?
&gt;&gt; No need to post hundreds of identical patches. So as long as they do
&gt;&gt; just change the ids.
&gt;&gt; No &quot;while in there&quot; changes.
&gt;&gt;
&gt;&gt; But please, fix the typo first: capitolization
&gt;&gt; I don't want anyone else making more typos than I do :-)

Noted. :)


&gt;&gt;
&gt;&gt; For reference inside the doc, would it not be more appropriate to use
&gt;&gt; xref or something?
&gt;&gt; I thought olink were for refrence across external documents? One
&gt;&gt; drawback of using olinks
&gt;&gt; is that the masterdb may or may not be there. There may be a
&gt;&gt; performance issue as well,
&gt;&gt; or other unforeseen side-effects. No need to use a bigger hammer than
&gt;&gt; necessary.


There were a couple small reasons that together made me think internal 
olinks were better.  Consistency, olinks everywhere therefore no 
confusion, and xref's generated ugly output. You can't define the link 
</PRE>
</BLOCKQUOTE>
How about &lt;link&gt; <A HREF="http://docbook.org/tdg/en/html/link.html">http://docbook.org/tdg/en/html/link.html</A>
<BLOCKQUOTE TYPE=CITE>
<PRE>
text, it pulls it automatically from the link destination.

Before 4.3, which is when I last looked into this,
this:
&lt;xref linkend='sect2id'/&gt;
would only generate link text 'The section called 'sectiontitle.' which 
I though was really ugly.

olink allowed us to define our own link text.

However, 4.3 allows us a little more freedom so i'll change my patches.

&gt;&gt;
&gt;&gt; Recall the for olinks to work, the docs need to be installed (as well
&gt;&gt; as masterdb). It is inconvenient
&gt;&gt; for local links to rely on that. No one will complain now, but
&gt;&gt; eventually if people get use to it,
&gt;&gt; and use the doc from their dev build only, the local links would not
&gt;&gt; work. Unless, of course,
&gt;&gt; there is some smarts in docbook to workaround the situation. have you
&gt;&gt; tried it?

I couldn't find any docbook support for that.

&gt;&gt;
&gt; Not a good idea to use olink for local ref. You will always get, on the
&gt; first build:
&gt;
&gt;     Error: unresolved olink: targetdoc/targetptr = 'dbelib/XdbeQueryExtension'.
&gt;
&gt; It cannot look in its own not yet generated targetdb to find the link.
&gt; This is very annoying.
&gt;&gt; One suggestion for testing is to take some random sample of documents
&gt;&gt; and test the link actually works.

I've been doing that as I go.


thanks for the review,
Matt
</PRE>
</BLOCKQUOTE>
<BR>
</BODY>
</HTML>