RE: [dita] question on @locktitle for topichead and topicgroup elements

[Robert D Anderson <robander@us.ibm.com>]

Based on a very short discussion at today's TC call -

I think that locktitle does not serve any purpose on these elements. As
Bruce said, it was pulled in with the topicref-atts attribute. I believe
(digging back into history) some people considered locktitle to be a
cascading attribute, which is probably why it was not removed. However, the
TC has made clear in the past that this attribute should *not* inherit.
With that clear - locktitle is more or less meaningless.

Most of the other attributes do serve a purpose. Bruce listed all of these:
collection-type, processing-role, type, scope, locktitle, format,
linking, toc, print, search, and chunk.

Most of these attributes can cascade to children, and I have often seen
them used on topicgroup in order to treat the children as a group. For the
remaining items:
@chunk has a specific definition for topichead (that is, for any topicref
that just uses a title), in that it indicates a title-only topic must be
generated, possibly including children. [1]
@collection-type generally has an effect on the children, and the same is
true here - it may result in next/previous or family relationships among
those children.
@locktitle was discussed above

[1] (under the definition of "to-content")
http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/chunking.html

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

Tarun Garg <tarung@adobe.com> wrote on 04/03/2011 11:59:35 PM:

> From: Tarun Garg <tarung@adobe.com>
> To: Su-Laine Yeo <su-laine.yeo@justsystems.com>
> Cc: dita <dita@lists.oasis-open.org>
> Date: 04/04/2011 12:03 AM
> Subject: RE: [dita] question on @locktitle for topichead and
> topicgroup elements
>
> Hi Su-Laine,
>
> Nice Catch!
> In fact, that makes me think the purpose of other attributes for
> these elements.  Many attributes like @scope, @type, etc. do not
> have any direct use for these elements. I think they just serve the
> purpose of specifying the value at a higher level; so that it can
> get derived/used in all the descendents where not specified explicitly.
>
> Regards,
> Tarun Garg | Adobe Systems | +91-120-2444711 | tarung@adobe.com
>
>
> From: Su-Laine Yeo [mailto:su-laine.yeo@justsystems.com]
> Sent: Saturday, April 02, 2011 2:34 AM
> To: dita
> Subject: RE: [dita] question on @locktitle for topichead and
> topicgroup elements
>
> Thanks Bruce. I've added an item requesting doc clarification to
> http://wiki.oasis-open.org/dita/DITA_1.3_Proposals
>
> Bruce's point implies that @locktitle is there only because it's
> part of a group of attributes, i.e. it is there for the convenience
> of the DTD developer, but has no defined purpose. If that is case,
> then the spec should say explicitly that attribute x on element y
> has no defined purpose. Otherwise, we're making the user think about
> what possible uses an attribute could have, and then reaching the
> correct conclusion that there is no purpose via the process of
> growing weary of thinking about it.
>
> Su-Laine
>
> From: Bruce Nevin (bnevin) [mailto:bnevin@cisco.com]
> Sent: Thursday, March 31, 2011 6:31 PM
> To: dita
> Subject: RE: [dita] question on @locktitle for topichead and
> topicgroup elements
>
> Is there anything in the topicref-atts group that is needed there?
> Presumably inclusion of the topicref-atts group is the reason we see
> topicref-atts in these elements. Or is there some function of
> @locktitle other than overriding the title found in referenced content?
>
> For reference, the topicref-atts attribute group includes
> collection-type, processing-role, type, scope, locktitle, format,
> linking, toc, print, search, and chunk.
>
>
> From: Su-Laine Yeo [mailto:su-laine.yeo@justsystems.com]
> Sent: Thursday, March 31, 2011 8:55 PM
> To: dita
> Subject: [dita] question on @locktitle for topichead and topicgroup
elements
> Hi everyone,
> This is more out of curiosity than anything: In <topichead> and
> <topicgroup> elements, does the @locktitle attribute do anything?
> If yes, what does it do?
> Su-Laine
> Su-Laine Yeo
> Solutions Consultant
> JustSystems Canada, Inc.
> Office: 1 (778) 327-6356
> syeo@justsystems.com
> XMetaL Community Forums: http://forums.xmetal.com
> For partners only: http://www.justpartnercenter.com