[osis-core] use cases

[Troy A. Griffitts]

OK, I'm kindof lost on many of the terms and tags being thrown around. 
Could we give excerpts from an XML doc for a few use cases.  I've 
included my best guess or suggestion for each.  Please follow the 
reference in #12 if you find yourself in ill attitude :)  Thanks for 
humoring me.  I really need this, as I am quickly losing coherency on 
these matters :)




1)  I am this work

(from Todd's submission)
<osisText osisWork="eckhart_sermons">


2)  All my osisID, self identifying anchors use this reference system 
unless individually, explicitely stated otherwise.

????????? something like the following was suggested by Todd ?????????
<osisText refSystem="Bible.KJV">


3)  All my osisRef's use KJV reference system unless individually, 
explicitely stated otherwise

?????????
<osisText osisWork="work1" refSystem="augustine_confessions.pusey" 
defaultRefSystem="Bible.KJV">


*** Following items assume a documents 1 and 2 items above, somehow 
define work: KJV, refSystem: KJV

4)  I am a verse that is Jas 1:19

<verse osisID="Jas.1.19">


5)  I am a div that contains Jas 1:19 AND Jas 1:20

<div osisID="Jas.1.19 Jas.1.20">


6)  I am a div that contains all of Jas

<div osisID="Jas">


*** Following items assume a documents 1, 2, and 3 items above, somehow 
define (respectively) work: MHC (Matthew Henry's Commentary), refSystem: 
KJV, defaultRefSystem: KJV


7)  I am a div that is commentary on Jas.1.19-21

?????
<div osisID="Jas.1.19 Jas.1.20 Jas.1.21">

(I still like this suggested markup, as it allow us to say: See comments 
from Matthew Henry on <reference work="mhc" osisRef="Jas.1.20">James 
1:20</reference>)


8)  I am a reference to any Bible that contains Jas.1.19 using my 
default KJV reference system.

<reference osisRef="Jas.1.19">This</reference> might be a hyperlink to 
any Bible containing James 1:19.


9)  I am a reference to any Bible that contains Jas.1.19, but I want to 
use something besides my default *REFERENCE SYSTEM* for some odd reason :)

<reference osisRef="Bible.NIV:Jas.1.19">


10)  I want to refer to the NIV *WORK* using my default KJV reference 
system.

<reference work="niv" osisRef="Jas.1.19">


11)  I want to refer to the NIV *WORK* using the NIV *REFERENCE SYSTEM* 
(which is not my default which is KJV)

<reference work="niv" osisRef="Bible.NIV:Jas.1.19">


12) (because there should be 12)  I want to refer to a work: naves 
(Naves Topical Textbook), using naves reference system (obviously) to a 
div in naves that was tagged with an osisID="GRACE"

Please see Nave's Topical Textbook entry on <reference work="naves" 
osisRef="naves:GRACE">Grace</reference>