From 71398a11afe3c12a29b95c10a2b56c83741ce3a1 Mon Sep 17 00:00:00 2001 From: Robert D Anderson Date: Tue, 28 Mar 2023 12:45:34 -0500 Subject: [PATCH 1/4] Remove xNAL langref topics oasis-tcs/dita#898 --- specification/langRef/containers/xnal-d.dita | 32 --- .../key-definitions-tc-elements.ditamap | 1 - ...y-definitions-xnal-domain-elements.ditamap | 31 --- .../technicalContent-elements-a-to-z.dita | 26 --- .../langRef/technicalContent-elements.ditamap | 2 - .../technicalContent/addressdetails.dita | 53 ----- .../technicalContent/administrativearea.dita | 51 ----- .../technicalContent/authorinformation.dita | 49 ----- .../technicalContent/contactnumber.dita | 53 ----- .../technicalContent/contactnumbers.dita | 52 ----- .../langRef/technicalContent/country.dita | 52 ----- .../technicalContent/emailaddress.dita | 52 ----- .../technicalContent/emailaddresses.dita | 52 ----- .../langRef/technicalContent/firstname.dita | 56 ----- .../generationidentifier.dita | 52 ----- .../langRef/technicalContent/honorific.dita | 53 ----- .../langRef/technicalContent/lastname.dita | 52 ----- .../langRef/technicalContent/locality.dita | 52 ----- .../technicalContent/localityname.dita | 56 ----- .../langRef/technicalContent/middlename.dita | 52 ----- .../langRef/technicalContent/namedetails.dita | 55 ----- .../technicalContent/organizationinfo.dita | 52 ----- .../technicalContent/organizationname.dita | 52 ----- .../organizationnamedetails.dita | 53 ----- .../langRef/technicalContent/otherinfo.dita | 71 ------- .../langRef/technicalContent/personinfo.dita | 52 ----- .../langRef/technicalContent/personname.dita | 54 ----- .../langRef/technicalContent/postalcode.dita | 76 ------- .../technicalContent/thoroughfare.dita | 77 ------- .../langRef/technicalContent/url.dita | 75 ------- .../langRef/technicalContent/urls.dita | 74 ------- .../langRef/xnal-domain-elements.ditamap | 33 --- .../non-normative/elementsMerged.dita | 201 ------------------ 33 files changed, 1804 deletions(-) delete mode 100644 specification/langRef/containers/xnal-d.dita delete mode 100644 specification/langRef/key-definitions-xnal-domain-elements.ditamap delete mode 100644 specification/langRef/technicalContent/addressdetails.dita delete mode 100644 specification/langRef/technicalContent/administrativearea.dita delete mode 100644 specification/langRef/technicalContent/authorinformation.dita delete mode 100644 specification/langRef/technicalContent/contactnumber.dita delete mode 100644 specification/langRef/technicalContent/contactnumbers.dita delete mode 100644 specification/langRef/technicalContent/country.dita delete mode 100644 specification/langRef/technicalContent/emailaddress.dita delete mode 100644 specification/langRef/technicalContent/emailaddresses.dita delete mode 100644 specification/langRef/technicalContent/firstname.dita delete mode 100644 specification/langRef/technicalContent/generationidentifier.dita delete mode 100644 specification/langRef/technicalContent/honorific.dita delete mode 100644 specification/langRef/technicalContent/lastname.dita delete mode 100644 specification/langRef/technicalContent/locality.dita delete mode 100644 specification/langRef/technicalContent/localityname.dita delete mode 100644 specification/langRef/technicalContent/middlename.dita delete mode 100644 specification/langRef/technicalContent/namedetails.dita delete mode 100644 specification/langRef/technicalContent/organizationinfo.dita delete mode 100644 specification/langRef/technicalContent/organizationname.dita delete mode 100644 specification/langRef/technicalContent/organizationnamedetails.dita delete mode 100644 specification/langRef/technicalContent/otherinfo.dita delete mode 100644 specification/langRef/technicalContent/personinfo.dita delete mode 100644 specification/langRef/technicalContent/personname.dita delete mode 100644 specification/langRef/technicalContent/postalcode.dita delete mode 100644 specification/langRef/technicalContent/thoroughfare.dita delete mode 100644 specification/langRef/technicalContent/url.dita delete mode 100644 specification/langRef/technicalContent/urls.dita delete mode 100644 specification/langRef/xnal-domain-elements.ditamap diff --git a/specification/langRef/containers/xnal-d.dita b/specification/langRef/containers/xnal-d.dita deleted file mode 100644 index b04f533d..00000000 --- a/specification/langRef/containers/xnal-d.dita +++ /dev/null @@ -1,32 +0,0 @@ - - - -xNAL domain -The xNAL domain elements represent a subset of the Extensible -Name and Address Standard. It is used to encode information about -the author or authors of DITA information. The domain can be included -in any DITA document type shell that requires additional metadata -for names and addresses, although the implementations provided by -OASIS only include it in the bookmap document type. - -Domains elementsxNAL domain -xNAL elements - - -
- General question about elements in this - section:
    -
  • Should many of the examples just be referring to the example in <authorinformation>, - rather than repeating? If yes - need to make the update; if no - need to add prose around the - samples, and bold the relevant elements.
    • -
  • Short descriptions often refer to "the person" or "the author" or "the organization" but - that rarely makes sense in the context of a single element definition. Should it be a person / - an author / etc? See for specific - example
    • -
-

-

- - - diff --git a/specification/langRef/key-definitions-tc-elements.ditamap b/specification/langRef/key-definitions-tc-elements.ditamap index 27bee416..dc29a2e6 100644 --- a/specification/langRef/key-definitions-tc-elements.ditamap +++ b/specification/langRef/key-definitions-tc-elements.ditamap @@ -22,5 +22,4 @@ - diff --git a/specification/langRef/key-definitions-xnal-domain-elements.ditamap b/specification/langRef/key-definitions-xnal-domain-elements.ditamap deleted file mode 100644 index 65ebe9a0..00000000 --- a/specification/langRef/key-definitions-xnal-domain-elements.ditamap +++ /dev/null @@ -1,31 +0,0 @@ - - - - XNAL domain element keys - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/specification/langRef/quick-reference/technicalContent-elements-a-to-z.dita b/specification/langRef/quick-reference/technicalContent-elements-a-to-z.dita index f5014fc8..12eb736c 100644 --- a/specification/langRef/quick-reference/technicalContent-elements-a-to-z.dita +++ b/specification/langRef/quick-reference/technicalContent-elements-a-to-z.dita @@ -10,14 +10,11 @@ - - - @@ -70,12 +67,9 @@ - - - @@ -85,19 +79,15 @@ - - - - @@ -121,36 +111,26 @@ - - - - - - - - - - @@ -158,10 +138,7 @@ - - - @@ -216,7 +193,6 @@ - @@ -224,8 +200,6 @@ - - diff --git a/specification/langRef/technicalContent-elements.ditamap b/specification/langRef/technicalContent-elements.ditamap index fcf37439..4a3bbb8c 100644 --- a/specification/langRef/technicalContent-elements.ditamap +++ b/specification/langRef/technicalContent-elements.ditamap @@ -34,8 +34,6 @@ - - diff --git a/specification/langRef/technicalContent/addressdetails.dita b/specification/langRef/technicalContent/addressdetails.dita deleted file mode 100644 index a73dc425..00000000 --- a/specification/langRef/technicalContent/addressdetails.dita +++ /dev/null @@ -1,53 +0,0 @@ - - - - <xmlelement>addressdetails</xmlelement> - The addressdetails element specifies information about the - address of an author or authoring group. - - - - addressdetailsxNAL - elementsaddressdetails - - - - -
Specialization hierarchy -

The addressdetails element is specialized from - ph. It is defined in the XNAL domain module.

-
Attributes -

-

- Example - Can this and most of the XNAL examples - just be a link to authorinformation? -

The following code sample shows how the addressdetails element can - be used to provide detailed information about the address of an author:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - - diff --git a/specification/langRef/technicalContent/administrativearea.dita b/specification/langRef/technicalContent/administrativearea.dita deleted file mode 100644 index 71d75eb9..00000000 --- a/specification/langRef/technicalContent/administrativearea.dita +++ /dev/null @@ -1,51 +0,0 @@ - - - - <xmlelement>administrativearea</xmlelement> - The administrativearea element specifies information about a - county, state, or province. - - - - xNAL - elementsadministrativearea - administrativearea - - - - -
Specialization hierarchy -

The administrativearea element is specialized from - ph. It is defined in the XNAL domain module.

-
Attributes -

-

The following code sample shows how the administrativearea - element can be used to provide detailed information about a county, state, or - province:

-
- Example - <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/authorinformation.dita b/specification/langRef/technicalContent/authorinformation.dita deleted file mode 100644 index 9c378571..00000000 --- a/specification/langRef/technicalContent/authorinformation.dita +++ /dev/null @@ -1,49 +0,0 @@ - - - - <xmlelement>authorinformation</xmlelement> - The authorinformation element specifies detailed information - about an author or authoring organization. - - - - authorinformation - xNAL - elementsauthorinformation - - - - -
Specialization hierarchy -

The authorinformation element is specialized from - author. It is defined in the XNAL domain module.

-
Attributes
- Example -

The following code sample shows how the authorinformation element - can be used to provide detailed information about an author:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/contactnumber.dita b/specification/langRef/technicalContent/contactnumber.dita deleted file mode 100644 index 47c9da88..00000000 --- a/specification/langRef/technicalContent/contactnumber.dita +++ /dev/null @@ -1,53 +0,0 @@ - - - - <xmlelement>contactnumber</xmlelement> - The contactnumber element specifies a contact number for an - author or authoring organization, such as a telephone number. - - - - contactnumberxNAL - elementscontactnumber - - - - -
- Specialization hierarchy -

The contactnumber element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the contactnumber element can - be used to provide a contact number for an author or authoring organization, such as a - telephone number:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/contactnumbers.dita b/specification/langRef/technicalContent/contactnumbers.dita deleted file mode 100644 index f55ce710..00000000 --- a/specification/langRef/technicalContent/contactnumbers.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>contactnumbers</xmlelement> - The contactnumbers element provides a list of contact - numbers. - - - - contactnumbersxNAL - elementscontactnumbers - - - - -
- Specialization hierarchy -

The contactnumbers element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the contactnumbers element can - be used to provide a list of contact numbers:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/country.dita b/specification/langRef/technicalContent/country.dita deleted file mode 100644 index 72b5ac10..00000000 --- a/specification/langRef/technicalContent/country.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>country</xmlelement> - The country element specifies the name of a - country. - - - - countryxNAL - elementscountry - - - - -
- Specialization hierarchy -

The country element is specialized from - ph. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the country element can be - used to specify the name of a country:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/emailaddress.dita b/specification/langRef/technicalContent/emailaddress.dita deleted file mode 100644 index 5ff43833..00000000 --- a/specification/langRef/technicalContent/emailaddress.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>emailaddress</xmlelement> - The emailaddress element specifies an e-mail address for an - author or authoring organization. - - - - xNAL elementsemailaddress - emailaddress - - - - -
- Specialization hierarchy -

The emailaddress element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the emailaddress element can - be used to provide an email address for an author or authoring organization:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/emailaddresses.dita b/specification/langRef/technicalContent/emailaddresses.dita deleted file mode 100644 index d39747ff..00000000 --- a/specification/langRef/technicalContent/emailaddresses.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>emailaddresses</xmlelement> - The emailaddresses element provides one or more e-mail - addresses for an author or authoring organization. - - - - xNAL elementsemailaddresses - emailaddresses - - - - -
- Specialization hierarchy -

The emailaddresses element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the emailaddresses element can - be used to provide one or more email addresses for an author or authoring organization:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/firstname.dita b/specification/langRef/technicalContent/firstname.dita deleted file mode 100644 index 271c4e2a..00000000 --- a/specification/langRef/technicalContent/firstname.dita +++ /dev/null @@ -1,56 +0,0 @@ - - - - <xmlelement>firstname</xmlelement> - The firstname element specifies the first name of an - author.Question about all of these … - should it be "the person" or "a person"? "The person" only seems to make sense if we are - already talking about a person, but the short description for this element does not have that - context. It seems like when defining the element on its own, it should be "a - person". - - - - firstnamexNAL - elementsfirstname - - - - -
- Specialization hierarchy -

The firstname element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the firstname element can be - used to specify the first name of an author:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/generationidentifier.dita b/specification/langRef/technicalContent/generationidentifier.dita deleted file mode 100644 index 4cabc64a..00000000 --- a/specification/langRef/technicalContent/generationidentifier.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>generationidentifier</xmlelement> - The generationidentifier element specifies information about - the generation of an author's name, for example Jr, III, or VIII. - - - - generationidentifierxNAL - elementsgenerationidentifier - - - - -
- Specialization hierarchy -

The generationidentifier element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the generationidentifier - element can be used to provide information about the generation of an author's name:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/honorific.dita b/specification/langRef/technicalContent/honorific.dita deleted file mode 100644 index d0817491..00000000 --- a/specification/langRef/technicalContent/honorific.dita +++ /dev/null @@ -1,53 +0,0 @@ - - - - <xmlelement>honorific</xmlelement> - The honorific element specifies an author's title, such as - Dr., Mr., or Ms.. - - - - honorificxNAL - elementshonorific - - - - -
- Specialization hierarchy -

The honorific element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the honorific element can be - used to specify a title for an author:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <honorific>Dr.</honorific> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/lastname.dita b/specification/langRef/technicalContent/lastname.dita deleted file mode 100644 index 468efbc7..00000000 --- a/specification/langRef/technicalContent/lastname.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>lastname</xmlelement> - The lastname element specifies the last name of an - author. - - - - lastnamexNAL - elementslastname - - - - -
- Specialization hierarchy -

The lastname element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the lastname element can be - used to specify the last name of an author:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/locality.dita b/specification/langRef/technicalContent/locality.dita deleted file mode 100644 index b32404d9..00000000 --- a/specification/langRef/technicalContent/locality.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>locality</xmlelement> - The locality element specifies information about a city, - postal code, or ZIP code. - - - - xNAL elementslocality - locality - - - - -
- Specialization hierarchy -

The locality element is specialized from - ph. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the locality element can be - used to provide detailed information about a city, postal code, or ZIP code:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/localityname.dita b/specification/langRef/technicalContent/localityname.dita deleted file mode 100644 index b5841848..00000000 --- a/specification/langRef/technicalContent/localityname.dita +++ /dev/null @@ -1,56 +0,0 @@ - - - - <xmlelement>localityname</xmlelement> - The localityname element specifies the name of a locality or - city. - - - - xNAL elementslocalityname - localityname - - - - -
- Specialization hierarchy -

The localityname element is specialized from - ph. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the localityname element can - be used to provide information about the name of a locality or city:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality> - <localityname>Emerald City</localityname> - <postalcode>66780</postalcode> - </locality> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/middlename.dita b/specification/langRef/technicalContent/middlename.dita deleted file mode 100644 index 97926317..00000000 --- a/specification/langRef/technicalContent/middlename.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>middlename</xmlelement> - The middlename element specifies information about the middle - name or middle initial of an author. - - - - middlenamexNAL - elementsmiddlename - - - - -
- Specialization hierarchy -

The middlename element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the middlename element can be - used to specify the middle name or middle initial of an author:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/namedetails.dita b/specification/langRef/technicalContent/namedetails.dita deleted file mode 100644 index e671bb9f..00000000 --- a/specification/langRef/technicalContent/namedetails.dita +++ /dev/null @@ -1,55 +0,0 @@ - - - - <xmlelement>namedetails</xmlelement> - The namedetails element specifies detailed information about - the name of an author or authoring organization. - - - - namedetailsxNAL - elementsnamedetails - - - - -
- Specialization hierarchy -

The namedetails element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the namedetails element can be - used to specify detailed information about the name of an author or authoring - organization:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails> - <personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/organizationinfo.dita b/specification/langRef/technicalContent/organizationinfo.dita deleted file mode 100644 index af96e7cc..00000000 --- a/specification/langRef/technicalContent/organizationinfo.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>organizationinfo</xmlelement> - The organizationinfo element specifies detailed information - about an authoring organization. - - - - organizationinfoxNAL - elementsorganizationinfo - - - - -
- Specialization hierarchy -

The organizationinfo element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the organizationinfo element - can be used to provide detailed information about an authoring organization:

- <bookmeta> - <authorinformation> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>WizardWorks, Inc.</organizationname> - <otherinfo>'Best wizard in Oz'</otherinfo> - </organizationnamedetails> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - <urls><url>www.wizardworks.example.org</url></urls> - </organizationinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/organizationname.dita b/specification/langRef/technicalContent/organizationname.dita deleted file mode 100644 index e12be2f6..00000000 --- a/specification/langRef/technicalContent/organizationname.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>organizationname</xmlelement> - The organizationname element specifies information about the - name of an authoring organization. - - - - organizationnamexNAL - elementsorganizationname - - - - -
- Specialization hierarchy -

The organizationname element is specialized from - ph. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the organizationname element - can be used to provide detailed information about the authoring organization:

- <bookmeta> - <authorinformation> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>WizardWorks, Inc.</organizationname> - <otherinfo>'Best wizard in Oz'</otherinfo> - </organizationnamedetails> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - <urls><url>www.wizardworks.example.org</url></urls> - </organizationinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/organizationnamedetails.dita b/specification/langRef/technicalContent/organizationnamedetails.dita deleted file mode 100644 index 36dfe887..00000000 --- a/specification/langRef/technicalContent/organizationnamedetails.dita +++ /dev/null @@ -1,53 +0,0 @@ - - - - <xmlelement>organizationnamedetails</xmlelement> - The organizationnamedetails element specifies detailed - information about the name of an authoring organization. - - - - organizationnamedetailsxNAL - elementsorganizationnamedetails - - - - -
- Specialization hierarchy -

The organizationnamedetails element is specialized from - ph. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the organizationnamedetails - element can be used to provide detailed information about the name of an authoring - organization:

- <bookmeta> - <authorinformation> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>WizardWorks, Inc.</organizationname> - <otherinfo>'Best wizard in Oz'</otherinfo> - </organizationnamedetails> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - <urls><url>www.wizardworks.example.org</url></urls> - </organizationinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/otherinfo.dita b/specification/langRef/technicalContent/otherinfo.dita deleted file mode 100644 index b1bf75a4..00000000 --- a/specification/langRef/technicalContent/otherinfo.dita +++ /dev/null @@ -1,71 +0,0 @@ - - - - <xmlelement>otherinfo</xmlelement> - The otherinfo element specifies additional detailed - information about the name of an author or authoring organization. - - - - otherinfoxNAL - elementsotherinfo - - - - -
- Specialization hierarchy -

The otherinfo element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the otherinfo element can be - used to provide detailed information about the name of an author - (personinfo) or the name of an authoring organization - (organizationinfo):

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>WizardWorks, Inc.</organizationname> - <otherinfo>'Best wizard in Oz'</otherinfo> - </organizationnamedetails> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - <urls><url>www.wizardworks.example.org</url></urls> - </organizationinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/personinfo.dita b/specification/langRef/technicalContent/personinfo.dita deleted file mode 100644 index 9c23bc46..00000000 --- a/specification/langRef/technicalContent/personinfo.dita +++ /dev/null @@ -1,52 +0,0 @@ - - - - <xmlelement>personinfo</xmlelement> - The personinfo element specifies detailed information about an - author, including name, address, and contact information. - - - - personinfoxNAL - elementspersoninfo - - - - -
- Specialization hierarchy -

The personinfo element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the personinfo element can be - used to provide detailed information about an author:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/personname.dita b/specification/langRef/technicalContent/personname.dita deleted file mode 100644 index 7f7ea153..00000000 --- a/specification/langRef/technicalContent/personname.dita +++ /dev/null @@ -1,54 +0,0 @@ - - - - <xmlelement>personname</xmlelement> - The personname element specifies detailed information about - the name of an author. - - - - personnamexNAL - elementspersonname - - - - -
- Specialization hierarchy -

The personname element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the personname element can be - used to provide detailed information about the name of an author:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails> - <personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality>Emerald City</locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/postalcode.dita b/specification/langRef/technicalContent/postalcode.dita deleted file mode 100644 index 084b40a2..00000000 --- a/specification/langRef/technicalContent/postalcode.dita +++ /dev/null @@ -1,76 +0,0 @@ - - - - <xmlelement>postalcode</xmlelement> - The postalcode element specifies information about a postal - code or ZIP code for an author or authoring organization. - - - - xNAL elementspostalcode - postalcode - - - - -
- Specialization hierarchy -

The postalcode element is specialized from - ph. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the postalcode element can be - used to provide information about a postal code or ZIP code for an author or authoring - organization:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality> - <localityname>Emerald City</localityname> - <postalcode>66780</postalcode> - </locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>WizardWorks, Inc.</organizationname> - <otherinfo>'Best wizard in Oz'</otherinfo> - </organizationnamedetails> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality> - <localityname>Emerald City</localityname> - <postalcode>66780</postalcode> - </locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - <urls><url>www.wizardworks.example.org</url></urls> - </organizationinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/thoroughfare.dita b/specification/langRef/technicalContent/thoroughfare.dita deleted file mode 100644 index 710ad3d1..00000000 --- a/specification/langRef/technicalContent/thoroughfare.dita +++ /dev/null @@ -1,77 +0,0 @@ - - - - <xmlelement>thoroughfare</xmlelement> - The thoroughfare element specifies for an author or authoring - organization information about the thoroughfare, for example the street, avenue, or boulevard on - which an address is located. - - - - xNAL elementsthoroughfare - thoroughfare - - - - -
- Specialization hierarchy -

The thoroughfare element is specialized from - ph. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the thoroughfare element can - be used to provide detailed information about a thoroughfare, for example the street, - avenue, or boulevard on which an address is located:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality> - <localityname>Emerald City</localityname> - <postalcode>66780</postalcode> - </locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>WizardWorks, Inc.</organizationname> - <otherinfo>noted psychologist</otherinfo> - </organizationnamedetails> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality> - <localityname>Emerald City</localityname> - <postalcode>66780</postalcode> - </locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - <urls><url>www.wizardworks.example.org</url></urls> - </organizationinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/url.dita b/specification/langRef/technicalContent/url.dita deleted file mode 100644 index 3ca2c512..00000000 --- a/specification/langRef/technicalContent/url.dita +++ /dev/null @@ -1,75 +0,0 @@ - - - - <xmlelement>url</xmlelement> - The url element specifies a Uniform Resource Locator (URL) for - an authoring organization. - - - - xNAL elementsurl - url - - - - -
- Specialization hierarchy -

The url element is specialized from data. - It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the url element can be used to - specify a Uniform Resource Locator (URL) for an authoring organization:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality> - <localityname>Emerald City</localityname> - <postalcode>66780</postalcode> - </locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>WizardWorks, Inc.</organizationname> - <otherinfo>noted psychologist</otherinfo> - </organizationnamedetails> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality> - <localityname>Emerald City</localityname> - <postalcode>66780</postalcode> - </locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - <urls><url>www.wizardworks.example.org</url></urls> - </organizationinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/technicalContent/urls.dita b/specification/langRef/technicalContent/urls.dita deleted file mode 100644 index 01975807..00000000 --- a/specification/langRef/technicalContent/urls.dita +++ /dev/null @@ -1,74 +0,0 @@ - - - - <xmlelement>urls</xmlelement> - The urls element specifies one or more Uniform Resource - Locators (URLs) for an authoring organization. - - - - urlsxNAL elementsurls - - - - -
- Specialization hierarchy -

The urls element is specialized from - data. It is defined in the XNAL domain module.

-
-
- Attributes -

-

- - Example -

The following code sample shows how the urls element can be used - to list one or more Uniform Resource Locators (URLs) for an authoring organization:

- <bookmeta> - <authorinformation> - <personinfo> - <namedetails><personname> - <firstname>Derek</firstname> - <middlename>L.</middlename> - <lastname>Singleton</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>noted psychologist</otherinfo> - </personname></namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality> - <localityname>Emerald City</localityname> - <postalcode>66780</postalcode> - </locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - </personinfo> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>WizardWorks, Inc.</organizationname> - <otherinfo>noted psychologist</otherinfo> - </organizationnamedetails> - </namedetails> - <addressdetails> - <thoroughfare>123 Yellow Brick Road</thoroughfare> - <locality> - <localityname>Emerald City</localityname> - <postalcode>66780</postalcode> - </locality> - <administrativearea>Kansas</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> - <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> - <urls><url>www.wizardworks.example.org</url></urls> - </organizationinfo> - </authorinformation> -</bookmeta> - - diff --git a/specification/langRef/xnal-domain-elements.ditamap b/specification/langRef/xnal-domain-elements.ditamap deleted file mode 100644 index df7fe1c8..00000000 --- a/specification/langRef/xnal-domain-elements.ditamap +++ /dev/null @@ -1,33 +0,0 @@ - - - - XNAL domain elements - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/specification/non-normative/elementsMerged.dita b/specification/non-normative/elementsMerged.dita index d4d03469..59d4f7ce 100644 --- a/specification/non-normative/elementsMerged.dita +++ b/specification/non-normative/elementsMerged.dita @@ -1801,206 +1801,5 @@ -
- XNAL domain (xnal-d) -

The XNAL information is all metadata, so it generally does not - need to be translated. Exceptions might be needed when selections - from this metadata are used for display purposes. The standard - behavior might need to change based on local business rules. For - example, in some cases it might be appropriate to translate the - honorific, country, or organizationname elements. There are no - translatable attributes

- - - Element name - Specialization base - Same behavior as specialization base? - Block/inline (translation) - Translatable content? - - - addressdetails - ph - no - block - no - - - administrativearea - ph - no - block - no - - - authorinformation - author - no - block - no - - - contactnumber - data - no - block - no - - - contactnumbers - data - no - block - no - - - country - ph - no - block - no - - - emailaddress - data - no - block - no - - - emailaddresses - data - no - block - no - - - firstname - data - no - block - no - - - generationidentifier - data - no - block - no - - - honorific - data - no - block - no - - - lastname - data - no - block - no - - - locality - ph - no - block - no - - - localityname - ph - no - block - no - - - middlename - data - no - block - no - - - namedetails - data - no - block - no - - - organizationinfo - data - no - block - no - - - organizationname - ph - no - block - no - - - organizationnamedetails - ph - no - block - no - - - otherinfo - data - no - block - no - - - personinfo - data - no - block - no - - - personname - data - no - block - no - - - postalcode - ph - no - block - no - - - thoroughfare - ph - no - block - no - - - url - data - no - block - no - - - urls - data - no - block - no - - -
From 62c7f25c3c7861e0f2e0c8d6740f180ce3ed91fa Mon Sep 17 00:00:00 2001 From: Robert D Anderson Date: Tue, 4 Apr 2023 10:49:13 -0500 Subject: [PATCH 2/4] Remove xNAL doctypes oasis-tcs/dita#898 --- doctypes/dtd/catalog.xml | 1 - doctypes/dtd/xnal/catalog.xml | 12 - doctypes/dtd/xnal/xnalDomain.ent | 35 -- doctypes/dtd/xnal/xnalDomain.mod | 475 -------------- doctypes/rng/catalog.xml | 1 - doctypes/rng/xnal/catalog.xml | 16 - doctypes/rng/xnal/xnalDomain.rng | 1006 ------------------------------ 7 files changed, 1546 deletions(-) delete mode 100644 doctypes/dtd/xnal/catalog.xml delete mode 100644 doctypes/dtd/xnal/xnalDomain.ent delete mode 100644 doctypes/dtd/xnal/xnalDomain.mod delete mode 100644 doctypes/rng/xnal/catalog.xml delete mode 100644 doctypes/rng/xnal/xnalDomain.rng diff --git a/doctypes/dtd/catalog.xml b/doctypes/dtd/catalog.xml index 719af776..1eb4a599 100644 --- a/doctypes/dtd/catalog.xml +++ b/doctypes/dtd/catalog.xml @@ -3,5 +3,4 @@ - diff --git a/doctypes/dtd/xnal/catalog.xml b/doctypes/dtd/xnal/catalog.xml deleted file mode 100644 index c932c63f..00000000 --- a/doctypes/dtd/xnal/catalog.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - diff --git a/doctypes/dtd/xnal/xnalDomain.ent b/doctypes/dtd/xnal/xnalDomain.ent deleted file mode 100644 index 488af101..00000000 --- a/doctypes/dtd/xnal/xnalDomain.ent +++ /dev/null @@ -1,35 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/doctypes/dtd/xnal/xnalDomain.mod b/doctypes/dtd/xnal/xnalDomain.mod deleted file mode 100644 index c9c2beee..00000000 --- a/doctypes/dtd/xnal/xnalDomain.mod +++ /dev/null @@ -1,475 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/doctypes/rng/catalog.xml b/doctypes/rng/catalog.xml index 719af776..1eb4a599 100644 --- a/doctypes/rng/catalog.xml +++ b/doctypes/rng/catalog.xml @@ -3,5 +3,4 @@ - diff --git a/doctypes/rng/xnal/catalog.xml b/doctypes/rng/xnal/catalog.xml deleted file mode 100644 index 4fa6cb0b..00000000 --- a/doctypes/rng/xnal/catalog.xml +++ /dev/null @@ -1,16 +0,0 @@ - - - - - - - - - - - - diff --git a/doctypes/rng/xnal/xnalDomain.rng b/doctypes/rng/xnal/xnalDomain.rng deleted file mode 100644 index dc98ac92..00000000 --- a/doctypes/rng/xnal/xnalDomain.rng +++ /dev/null @@ -1,1006 +0,0 @@ - - - - - DITA XNAL Domain - -============================================================= - HEADER -============================================================= - MODULE: XNAL Domain - VERSION: 2.0 - DATE: [[[Release date]]] - PURPOSE: Define elements and specialization atttributes - for the XNAL Domain - -============================================================= - -============================================================= - PUBLIC DOCUMENT TYPE DEFINITION - TYPICAL INVOCATION - - Refer to this file by the following public identfier or an - appropriate system identifier -PUBLIC "-//OASIS//ELEMENTS DITA 2.0 XNAL Domain//EN" - Delivered as file "xnalDomain.mod" - -============================================================= - (C) Copyright OASIS Open 2006, 2009. - All Rights Reserved. - UPDATES: -============================================================= - - - elementdomain - xnal-d - - -//OASIS//ELEMENTS DITA XNAL Domain//EN - -//OASIS//ENTITIES DITA XNAL Domain//EN - urn:oasis:names:tc:dita:rng:xnalDomain.rng - - - -
- DOMAIN EXTENSION PATTERNS - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- ELEMENT DECLARATIONS -
- LONG NAME: Author Information - - - - - - - - - - 20080128: Removed enumeration for @type for DITA 1.2 . Previous values: - creator, contributor, -dita-use-conref-target - - - - - - - - - - - - - - - - external - local - peer - -dita-use-conref-target - - - - - - - - - - element contains detailed information about the author or authoring organization. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Name Details - - - - - - - - - - - - - - element contains information about the name of the author or the authoring organization. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Organization Details - - - - - - - - - - - - - - - - - element contains information about the name of an authoring organization. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Organization Name - - - - - - - - - - - - - - element contains name information about the authoring organization. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Person Name - - - - - - - - - - - - - - - - - - - - - - - - - - element contains name information about the author. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Honorific - - - - - - - - - - - - - - - element contains the person's title, such as: Dr., Mr., Ms., HRH.. or Grand Exalted Wizard. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: First Name - - - - - - - - - - - - - - - element contains the person's first name. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Middle Name - - - - - - - - - - - - - - - element contains the person's middle name or initial. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Last Name - - - - - - - - - - - - - - - element contains the person's last name. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Generation Identifier - - - - - - - - - - - - - - - element contains information about the person's generation, such as: Jr, III, or VIII. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Other Information - - - - - - - - - - - element contains other name information about the author or authoring organization. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Address Details - - - - - - - - - - - - - - - - - - - - element contains information about the address of the author or authoring group. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Locality - - - - - - - - - - - - - - - - - - element contains information about the city and postal or ZIP code. It can contain the information directly, or by acting as a wrapper for and . - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Locality Name - - - - - - - - - - - - - - element contains the name of the locality or city. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Administrative Area - - - - - - - - - - - - - - element contains information about a county, state, or province. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Thoroughfare - - - - - - - - - - - - - - element contains information about the thoroughfare - for example, the street, avenue, or boulevard - on which an address is located. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Postal Code - - - - - - - - - - - - - - - - - - element contains information about the postal code or the ZIP code. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Country - - - - - - - - - - - - - - - - - - element contains the name of a country. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Person Information - - - - - - - - - - - - - - - - - - - - element is a wrapper containing all relevant data about a person, including name, address, and contact information. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Organization Information - - - - - - - - - - - - - - - - - - - - - - - element contains detailed information about an authoring organization. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Contact Numbers - - - - - - - - - - - element contains a list of telephone and fax numbers. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Contact Number - Note: set the type of number using @type - - - - - - - - - - - - - - - element contains a telephone number. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Email Addresses - - - - - - - - - - - element contains a list of e-mail addresses. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: Email Address - - - - - - - - - - - element contains an e-mail address. - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: URLs - - - - - - - - - - - element contains a list of Uniform Resource Locators (URLs). - Category: xNAL elements - ]]> - - - - - - - -
-
- LONG NAME: URL - - - - - - - - - - - element contains a Uniform Resource Locator (URL). - Category: xNAL elements - ]]> - - - - - - - -
-
-
- SPECIALIZATION ATTRIBUTE DECLARATIONS - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- From 761f1aa1975b7e18300a2986f070fe97749a5a6b Mon Sep 17 00:00:00 2001 From: Robert D Anderson Date: Tue, 4 Apr 2023 12:34:11 -0500 Subject: [PATCH 3/4] Remove XNAL topics from arch spec oasis-tcs/dita#898 --- .../archSpec-technicalContent.ditamap | 3 - .../technical-content-domains.dita | 6 +- .../archSpec/technicalContent/xNALDomain.dita | 36 --- .../technicalContent/xnaldetails.dita | 254 ------------------ 4 files changed, 3 insertions(+), 296 deletions(-) delete mode 100644 specification/archSpec/technicalContent/xNALDomain.dita delete mode 100644 specification/archSpec/technicalContent/xnaldetails.dita diff --git a/specification/archSpec/archSpec-technicalContent.ditamap b/specification/archSpec/archSpec-technicalContent.ditamap index 02305a3f..6c037690 100644 --- a/specification/archSpec/archSpec-technicalContent.ditamap +++ b/specification/archSpec/archSpec-technicalContent.ditamap @@ -6,8 +6,5 @@ - - - diff --git a/specification/archSpec/technicalContent/technical-content-domains.dita b/specification/archSpec/technicalContent/technical-content-domains.dita index 2a9ea24a..cfc0b9b0 100644 --- a/specification/archSpec/technicalContent/technical-content-domains.dita +++ b/specification/archSpec/technicalContent/technical-content-domains.dita @@ -3,8 +3,8 @@ Domain specializations This section contains information about the technical content domains, including a - general overview and more specific information about the xNAL, release management, equation, and + general overview and more specific information about the release management, equation, and MathML domains.Should this be more comprehensive, and not just limited to those three or four domains? Or - are the others like "software" too obvious to require a topic? + >Should this be more comprehensive, and not just limited to those domains? Or are the others + like "software" too obvious to require a topic? diff --git a/specification/archSpec/technicalContent/xNALDomain.dita b/specification/archSpec/technicalContent/xNALDomain.dita deleted file mode 100644 index eec284ad..00000000 --- a/specification/archSpec/technicalContent/xNALDomain.dita +++ /dev/null @@ -1,36 +0,0 @@ - - - - xNAL domain - The DITA xNAL domain specialization defines a number of metadata elements that are - useful in representing personal/organizational names and addresses. The metadata can be used - to identify authors and content owners. The OASIS xNAL Standard (extensible Name and Address - Language) was selected to represent close mappings from the DITA bookmap metadata content - model to an existing standard. xNAL is included in the Bookmap document type distributed - with this version of DITA. - -

The OASIS Customer Information Quality (CIQ) standard for global-customer information - management contains the definition of the OASIS - extensible Name and Address Language (xNAL) metadata elements. Version 2 of - the standard states:

- -

The objective of xNAL is to describe a common structure for Personal/Organization Names and - Addresses that would enable any applications that want to represent customer names - and addresses in a common standard format. The applications could be CRM/e-CRM, - Customer Information Systems, Data Quality (Parsing, Matching, Validation, - Verification, etc.), Customer Data Warehouses, Postal services, etc.

-

However, any party for its own purposes and applications can use xNAL grammar or parts of - it.

- -

The DITA xNAL specialization is based on the OASIS extensible Name and Address Language - metadata elements. Due to differences between the two processing architectures, the DITA - xNAL domain does not incorporate all of the definitions from the OASIS xNAL standard - directly. Instead, there is a transformational equivalence between the DITA and OASIS - xNAL definitions for names and addresses. This equivalence enables XML-aware tools in - workflow systems to capture and manipulate names and addresses in a standard manner.

-

The xNAL domain is available for use in the bookmap document type. It - can be included in any DITA document types that require metadata for names and - addresses.

- - diff --git a/specification/archSpec/technicalContent/xnaldetails.dita b/specification/archSpec/technicalContent/xnaldetails.dita deleted file mode 100644 index 973e2759..00000000 --- a/specification/archSpec/technicalContent/xnaldetails.dita +++ /dev/null @@ -1,254 +0,0 @@ - - - - xNAL usage guidelines - Extended information and usage examples for DITA bookmap metadata - elements associated with OASIS xNAL Standard (extensible Name and Address - Language). - -

DITA bookmaps use a set of - elements associated with a subset of the - OASIS extensible - Name and Address Language (xNAL) specification (Version 2) to denote - name and address information related to persons and organizations.

-

While the elements share element names, and the - expectation is that content written using this type of metadata is be straightforward to transform, the element name - pairs do not share content models. The difference in content models reflects the - different purposes of the two standards. The purpose of the name and address elements in - DITA is to identify persons or organizations associated with the creation of a document; - the purpose of the name and address elements in xNAL is to support customer resource - management.

-

The examples shown after the - table provide sample tagging methods for name and address information, using - the DITA elements associated with xNAL.

-
- DITA elements associated with xNAL elements -

The set of bookmap elements - associated with elements from the - OASIS extensible - Name and Address Language (xNAL) standard are listed in the table below.

- - DITA elements associated with xNAL elements - - - - addressdetails - - honorific - - otherinfo - - - - administrativearea - - lastname - - person - - - - authorinformation - - locality - - personinfo - - - - contactnumber - - localityname - - personname - - - - contactnumbers - - middlename - - postalcode - - - - country - - namedetails - - thoroughfare - - - - emailaddress - - organization - - url - - - - emailaddresses - - organizationinfo - - urls - - - - firstname - - organizationname - - - - - generationidentifier - - organizationnamedetails - - - - - -
-
- - Example 1: Tagging personal information in DITA -

This example shows a way to - tag the following personal name and description.

- Mr. Ram V. Kumar Jr. -Chief Technologist -MSI Business Solutions - <authorinformation> - <personinfo> - <namedetails> - <personname> - <honorific>Mr.</honorific> - <firstname>Ram</firstname> - <middlename>V.</middlename> - <lastname>Kumar</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>Chief Technologist</otherinfo> - </personname> - </namedetails> - </personinfo> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>MSI Business Solutions</organizationname> - </organizationnamedetails> - </namedetails> - </organizationinfo> -</authorinformation> - - - Example 2: Tagging address information in DITA -

This example shows a way to - tag the following address.

- 23 Archer St. -Chatsworth -NSW 2067 -Australia - <addressdetails> - <thoroughfare>123 Archer St.</thoroughfare> - <locality> - <localityname>Chatsworth</localityname> - <postalcode>2067</postalcode> - </locality> - <administrativearea>NSW</administrativearea> - <country>Australia</country> -</addressdetails> - - - - Example 3: Tagging complex name and address information in - DITA -

This example shows two ways to - tag a fairly complex collection of personal, organizational, and address - information.

- Mr. Samuel L. Johnson Jr. -Chief Technologist -c/o XYZ Corporation -52 New Main St. -Carrboro, NC 27510 USA -email: johnson@example.com -phone: 919-555-7987 -

This method tags all the - organizational information as associated with the identified person.

- <personinfo> - <namedetails> - <personname> - <firstname>Samuel</firstname> - <middlename>L.</middlename> - <lastname>Johnson</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>Chief Technologist</otherinfo> - <otherinfo>c/o XYZ Corporation </otherinfo> - </personname> - </namedetails> - <addressdetails> - <thoroughfare>52 New Main St.</thoroughfare> - <locality> - <localityname>Carrboro</localityname> - <postalcode>27510</postalcode> - </locality> - <administrativearea>NC</administrativearea> - <country>USA</country> - </addressdetails> - <contactnumbers> - <contactnumber>919-555-7987</contactnumber> - </contactnumbers> - <emailaddresses> - <emailaddress>johnson@example.com</emailaddress> - </emailaddresses> -</personinfo> -

The following method separates - the person and organization information. It might be used if it were necessary - to associate address information with organizations rather than persons.

- <authorinformation> - <personinfo> - <namedetails> - <personname> - <firstname>Samuel</firstname> - <middlename>L.</middlename> - <lastname>Johnson</lastname> - <generationidentifier>Jr.</generationidentifier> - <otherinfo>Chief Technologist</otherinfo> - </personname> - </namedetails> - <contactnumbers> - <contactnumber>919-555-7987</contactnumber> - </contactnumbers> - <emailaddresses> - <emailaddress>johnson@example.com</emailaddress> - </emailaddresses> - </personinfo> - <organizationinfo> - <namedetails> - <organizationnamedetails> - <organizationname>XYZ Corporation</organizationname> - <otherinfo>c/o </otherinfo> - </organizationnamedetails> - </namedetails> - <addressdetails> - <thoroughfare>52 New Main St.</thoroughfare> - <locality> - <localityname>Carrboro</localityname> - <postalcode>27510</postalcode> - </locality> - <administrativearea>NC</administrativearea> - <country>USA</country> - </addressdetails> - </organizationinfo> -</authorinformation> - - - From f63d2742a48aa5b4b1edf195e817ca07cdbba306 Mon Sep 17 00:00:00 2001 From: Robert D Anderson Date: Tue, 4 Apr 2023 12:37:53 -0500 Subject: [PATCH 4/4] Remove XNAL from non-normative references oasis-tcs/dita#898 --- specification/introduction/non-normative-references.dita | 8 -------- 1 file changed, 8 deletions(-) diff --git a/specification/introduction/non-normative-references.dita b/specification/introduction/non-normative-references.dita index 20e6b7bd..38886cfc 100644 --- a/specification/introduction/non-normative-references.dita +++ b/specification/introduction/non-normative-references.dita @@ -14,14 +14,6 @@
- -
[ciq-v3.0]
-
OASIS Committee Specification 02, Customer Information Quality - Specifications Version 3.0. Name (xNL), Address (xAL), Name and Address - (xNAL) and Party (xPIL), , 20 September 2008.
-
[ISO 8601]
ISO/TC 154, Data elements and interchange formats—Information