legalxml-econtracts message

Subject: Clause Model - jharrop input

From: Jason Harrop <jharrop@speedlegal.com>
To: 'Legalxml-Econtracts' <legalxml-econtracts@lists.oasis-open.org>
Date: Mon, 07 Jul 2003 15:51:21 +1000

Hi all

Please find attached a PDF document describing and exploring the key 
pattern i believe we need to model in order to deliver a simple solution 
to our Clause Model Requirements document.

I've also attached a Word .doc which can be used as a template to assess 
fit by anyone  who has (John McC, Dr Leff) or intends to submit a 
proposal (by the 9th please iirc).

Finally, i've been working on a survey of various DTDs (including XHTML, 
WordML, OpenOffice, DocBook, DITA) to see what they can contribute to 
this effort, a rough draft of which i hope to post over the next day or so.

cheers,

Jason

Clause Model Input Proposal Template.doc

jharrop_clause_model_input.pdf

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE clausemodel_jharrop_proposal [
	<!-- root element -->
	<!ELEMENT clausemodel_jharrop_proposal (Clause)+>
	<!-- the model proper -->
	<!ELEMENT Clause ((ClauseNumber?, Heading, Subclauses) | (ClauseNumber?, Heading?, ClauseBodyPara*, Subclauses?))>
	<!ATTLIST Clause
	ID ID #REQUIRED
>
	<!ELEMENT ClauseNumber (#PCDATA)>
	<!ATTLIST ClauseNumber
	FullForm CDATA #REQUIRED
>
	<!ELEMENT Heading (#PCDATA)>
	<!ELEMENT Subclauses (Clause)+>
	<!ELEMENT ClauseBodyPara (#PCDATA | List)*>
	<!-- Lists  -->
	<!ELEMENT List (ListEntry)+>
	<!ELEMENT ListEntry (ListNumber?, Heading?, ListBodyPara*)>
	<!ATTLIST ListEntry
	ID ID #REQUIRED
>
	<!ELEMENT ListNumber (#PCDATA)>
	<!ATTLIST ListNumber
	FullForm CDATA #REQUIRED
>
	<!ELEMENT ListBodyPara (#PCDATA | List)*>
]>
<clausemodel_jharrop_proposal>
	<!-- 1.	Provisions about the specification of colours in contracts -->
	<Clause ID="colour_specs">
		<ClauseNumber FullForm="1">1.</ClauseNumber>
		<Heading>Provisions about the specification of colours in contracts</Heading>
		<Subclauses>
			<!--1.1	Spectrum colours-->
			<Clause ID="colour_spectrum">
				<ClauseNumber FullForm="1.1">1.1</ClauseNumber>
				<Heading>Spectrum colours</Heading>
				<ClauseBodyPara>Here is a contrived, complex list structure using the spectrum colours and one or two others:			
					<List>
						<ListEntry ID="colours_inc_red">
							<ListNumber FullForm="1.1.1">(a)</ListNumber>
							<ListBodyPara>red,</ListBodyPara>
						</ListEntry>
						<ListEntry ID="colours_inc_orange">
							<ListNumber FullForm="1.1.2">(b)</ListNumber>
							<ListBodyPara>orange,</ListBodyPara>
						</ListEntry>
						<ListEntry ID="colours_inc_yellow">
							<ListNumber FullForm="1.1.3">(c)</ListNumber>
							<ListBodyPara>yellow,</ListBodyPara>
						</ListEntry>
						<ListEntry ID="colours_inc_green">
							<ListNumber FullForm="1.1.4">(d)</ListNumber>
							<ListBodyPara>green,</ListBodyPara>
						</ListEntry>
						<ListEntry ID="colours_inc_blue">
							<ListNumber FullForm="1.1.5">(e)</ListNumber>
							<ListBodyPara>blue, including:
								<List>
									<ListEntry ID="colours_inc_blue_pale">
										<ListNumber FullForm="1.1.5.1">(i)</ListNumber>
										<ListBodyPara>pale blue,</ListBodyPara>
									</ListEntry>
									<ListEntry ID="colours_inc_blue_dark">
										<ListNumber FullForm="1.1.5.2">(ii)</ListNumber>
										<ListBodyPara>dark blue,</ListBodyPara>
									</ListEntry>
								</List>
								but excluding violet,
							</ListBodyPara>
						</ListEntry>
						<ListEntry ID="colours_inc_indigo">
							<ListNumber FullForm="1.1.6">(f)</ListNumber>
							<ListBodyPara>indigo, and </ListBodyPara>
						</ListEntry>
						<ListEntry ID="colours_inc_violet">
							<ListNumber FullForm="1.1.7">(g)</ListNumber>
							<ListBodyPara>violet,</ListBodyPara>
						</ListEntry>
					</List>
					from which all colours can be derived.
				</ClauseBodyPara>
			</Clause>
			<!-- 1.2	CMYK colours -->
			<Clause ID="colours_cmyk">
				<ClauseNumber FullForm="1.2">1.2</ClauseNumber>
				<Heading>CMYK colours</Heading>
				<ClauseBodyPara>CMYK colours (cyan, magenta, yellow and black) are normally specified for inputs to colour printing processes.
				</ClauseBodyPara>
			</Clause>
			<!-- 1.3	RGB colours -->
			<Clause ID="colours_rgb">
				<ClauseNumber FullForm="1.3">1.3</ClauseNumber>
				<Heading>RGB colours</Heading>
				<Subclauses>
					<Clause ID="colours_rgb1">
						<ClauseNumber FullForm="1.3.1">1.3.1</ClauseNumber>
						<ClauseBodyPara>RGB colour (red, green, brown) specifications are used for computer screen displays.</ClauseBodyPara>
					</Clause>
					<Clause ID="colours_rgb2">
						<ClauseNumber FullForm="1.3.2">1.3.2</ClauseNumber>
						<ClauseBodyPara>Using only these 3 colours, you can specify any colour.</ClauseBodyPara>
					</Clause>
					<Clause ID="colours_rgb3">
						<ClauseNumber FullForm="1.3.3">1.3.3</ClauseNumber>
						<ClauseBodyPara>The number of colours you can specify depends on the colour depth available. For example:
							<List>
								<ListEntry ID="colours_rgb31">
									<ListNumber FullForm="1.3.3.1">(a)</ListNumber>
									<ListBodyPara>8 bit colour can render 256 colours</ListBodyPara>
								</ListEntry>
								<ListEntry ID="colours_rgb32">
									<ListNumber FullForm="1.3.3.2">(b)</ListNumber>
									<ListBodyPara>16 bit colour can render 65,536 colours.</ListBodyPara>
								</ListEntry>
							</List>
						</ClauseBodyPara>
					</Clause>
				</Subclauses>
			</Clause>
			<!-- 1.4	Using black and white -->
			<Clause ID="colours_blackwhite">
				<ClauseNumber FullForm="1.4">1.4</ClauseNumber>
				<Heading>Using black and white</Heading>
				<Subclauses>
					<Clause ID="colours_greyscale">
						<ClauseNumber FullForm="1.4.1">1.4.1</ClauseNumber>
						<Heading>Greyscale</Heading>
						<ClauseBodyPara>The number of greys depends on the available colour depth, as for other colours.
					</ClauseBodyPara>
					</Clause>
					<Clause ID="colours_mono">
						<ClauseNumber FullForm="1.4.2">1.4.2</ClauseNumber>
						<Heading>Black and white</Heading>
						<ClauseBodyPara>This is really called monochrome. You can specify either:
							<List>
								<ListEntry ID="colours_mono_black">
									<ListBodyPara>black, or</ListBodyPara>
								</ListEntry>
								<ListEntry ID="colours_mono_white">
									<ListBodyPara>white.</ListBodyPara>
								</ListEntry>
							</List>
						</ClauseBodyPara>
					</Clause>
				</Subclauses>
			</Clause>
		</Subclauses>
	</Clause>
	<!-- 2.	Colour profiles-->
	<Clause ID="colour_profiles">
		<ClauseNumber FullForm="2">2.</ClauseNumber>
		<Heading>Colour profiles</Heading>
		<ClauseBodyPara>One thing to remember is that when working with colours, always use a colour profile that is available for your display or output device. 			This will ensure you achieve the most consistent results. 
		</ClauseBodyPara>
	</Clause>
</clausemodel_jharrop_proposal>