Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
Reply-To: <derby-dev@db.apache.org>
Received-SPF: pass (asf.osuosl.org: local policy)
Date: Thu, 31 Aug 2006 14:19:49 -0400
From: Kim Haase <Camilla.Haase@Sun.COM>
Subject: Re: Doc reviews: should the internal links for the PDFs work?
In-reply-to: <54ac72d70608301723s5b6c6f84ua8888cb60ede1280@mail.gmail.com>
Sender: Camilla.Haase@Sun.COM
To: derby-dev@db.apache.org
Reply-to: Camilla.Haase@Sun.COM
Message-id: <44F72845.8030900@Sun.COM>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
References: <20060830215703.71250.qmail@web81307.mail.mud.yahoo.com>
 <9f40b500608301626s156ab8f9wf0401f57b7a0a3e5@mail.gmail.com>
 <54ac72d70608301723s5b6c6f84ua8888cb60ede1280@mail.gmail.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS sun4u; en-US; rv:1.4) Gecko/20041214

Andrew McIntyre wrote On 08/30/06 20:23,:
> On 8/30/06, Laura Stewart <scotsmatrix@gmail.com> wrote:
> 
>>>When I click on those links with the HTML pages version of the doc they do work.
>>>Is this a general (known) problem?  Or is this a problem with this specific section
>>>that I need to report in the doc review?
>>
>>Susan - this is a problem with only the Alpha versions of the docs. In
>>the 10.1 PDF versions the links work just fine.  There is another
>>problem with the Alpha versions, they do not display the graphic
>>files.  These problems must be as a result of some setting in the
>>build for the Alpha versions.
> 
> 
> They should work, but it looks like another problem with our custom
> dita2fo-shell.xsl stylesheet's handling of internal links.
> 
> Please file a JIRA for it. This will be a fairly involved fix to the
> stylesheet and I don't know if I'll have time to get to it before the
> release.
> 
> Thanks,
> andrew

I looked into the graphics file issue yesterday and was going to file a
JIRA issue on it. I think this is the problem:

* The HTML Pages use the GIF files from the src directory, which are
copied into the out directory during the build (for the two books that
use graphics, devguide and tuning).

* The PDF and HTML one-pager seem to expect the JPG versions of the
files, which are not copied into the out directory during the build. If
I manually copy them over, the graphics show up.

I expect the graphics issue is separate from the links issue. Should it
have a separate JIRA issue? It might be an easier problem. If so, Laura
can file the links one and I can file this one.

There's yet another small graphics issue in that one of the GIF files
has a misspelled name -- it's called ptsmt_os.gif instead of
pstmt_os.gif -- so it doesn't get copied over at all. I guess that's yet
another issue.

Thanks,
Kim