[Laszlo-dev] For Review: Change 20071015-lou-Y Summary: fix broken links in dguide preface

[John Sundman]

Approved, but can you please confirm that the <ulink > syntax is the  
proper form we should be using between and among all books in the  
documentation?

There are now at least three, maybe four different formats used for  
links within docs and between docs, viz:

<a href="[url]">  <!-- deprecated-->
<a href="$[{dguide}|{reference}].filename">  <!--deprecated, but  
still in use ?-->
<xref linkend="">   <!-- is this to be deprecated in favor of ulink?-->
<ulink >

The preferred syntax has changed over time as the tools have  
improved.  Until now, some syntaxes work within documents but not  
within (for example from Developer's Guide to Reference, and vice  
versa).

At some point we need to clarify what the policy is; I'll be writing  
a proposal for the doctools page on the wiki.

In the meantime, I'm OK with whatever works to fix broken links.

Comments welcome.

jrs


On Oct 15, 2007, at 10:07 AM, Lou Iorio wrote:

> Change 20071015-lou-Y by lou at loumac.local on 2007-10-15 10:02:32 AST
>     in /Users/lou/src/svn/openlaszlo/trunk
>     for http://svn.openlaszlo.org/openlaszlo/trunk
>
> Summary: fix broken links in dguide preface
>
> New Features:
>
> Bugs Fixed: LPP-4897
>
> Technical Reviewer: (pending)
> QA Reviewer: (pending)
> Doc Reviewer: John Sundman
>
> Documentation: fix links in:
>
> 1.1. Audience and rationale for this book, last para
> 1.4. Related documentation, last para
> 1.5. Suggested reading paths, 3rd para
>
> Also in sect 1.5, fixed
>
> Then read the rest of ???
>
> Files:
> M      docs/src/developers/developers_guide_preface.dbk
>
>
> Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20071015- 
> lou-Y.tar