OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [dita] Bug: fragref does not allow keyref


As I've always understood these elements, they do not make sense when used
to reference a fragment or synnote in another diagram. I know that the
tools we use to render syntax diagrams in IBM do not allow these to
reference elements in other diagrams.

The DITA 1.1 langspec for fragref/@href says that the target fragment
"should" be in the same diagram. I have always viewed this as a "must". The
purpose of <fragment> is to break out a chunk of syntax to render on its
own; it seems that fragref would be difficult to understand if it takes you
out of the current diagram to syntax that is part of another set of syntax.

For synnoteref, the 1.1 spec begins with "The syntax note (<synnoteref>)
reference element references a syntax note element (<synnote>) that has
already been defined elsewhere in the syntax diagram." The synnoteref/@href
description also says that the target must be in the same diagram.

Based on our existing definitions - synnoteref cannot leave the diagram,
much less the topic, so keyref would not be useful. Based on my own
experience, it makes even less sense to reference a fragment that is part
of another diagram, so I don't view keyref as critical there. To me this is
not so much a bug as an intentional way to discourage references outside
the current diagram.

Robert D Anderson
IBM Authoring Tools Development
Chief Architect, DITA Open Toolkit

Eliot Kimber <ekimber@reallysi.com> wrote on 01/24/2010 02:47:42 PM:

> Re: [dita] Bug: fragref does not allow keyref
>
> On 1/24/10 1:41 PM, "Eliot Kimber" <ekimber@reallysi.com> wrote:
>
> > The fragref element is a specialization of topic/xref. As currently
declared
> > it does not allow @keyref, only @href. I can't think of any reason it
> > shouldn't also allow @keyref. This looks like a bug to me.
>
> Ditto synnoteref, which explicitly allows referencing notes from other
> syntax diagrams, which makes allowing @keyref essential.
>
> Cheers,
>
> E.
>
> --
> Eliot Kimber
> Senior Solutions Architect
> "Bringing Strategy, Content, and Technology Together"
> Main: 610.631.6770
> www.reallysi.com
> www.rsuitecms.com
>
>
> ---------------------------------------------------------------------
> To unsubscribe from this mail list, you must leave the OASIS TC that
> generates this mail.  Follow this link to all your TCs in OASIS at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
>



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]