[Scrollkeeper-devel] OMF language element

[Daniel B. K. <dev...@gm...>]

Just started trying to use Scrollkeeper, and am uncertain about the
use of the language element. According to OMF[1], the content should
be a language code as specified in RFC1766[2]. The Scrollkeeper
documentation on OMF extensions[3] specifies use of the 'code'
attribute, which is described as follows:

'The standard OMF specifies the "language" element as optional and as
having no attributes. For ScrollKeeper to relate documents with the
locale of the user, the locale of the documents must be specified.
This is done by using a new attribute, "code", of the "language"
element. The language code should be a standard locale.

That inclines me to believe the value of the code attribute is to be
the same as the value of the element (a language code), in which case
I am unclear why Scrollkeeper felt the need for a new attribute.
Furthermore, the 'complete example'[4] specifies 'C' for the value of
the code attribute. This is not a valid language code, so I am
inclined to believe that the code attribute should contain the name of
the programming language the application the documentation referenced
is written in. Basically, I would like some clarity regarding the
language element and its attribute.

Daniel Brumbaugh Keeney

By the way, as the referenced BCP page[4] notes, RFC1766 is quite
obsolete. I say this presuming you communicate with the authors of the
OMF specification.

[1]
http://www.ibiblio.org/osrt/omf/omf_elements
[2]
http://www.ietf.org/rfc/rfc1766.txt
[3]
http://scrollkeeper.sourceforge.net/documentation/writing_scrollkeeper_omf_files/ar01s06.html
[4]
http://tools.ietf.org/html/bcp47