Skip to main content
summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authornhauge2007-05-04 19:55:48 +0000
committernhauge2007-05-04 19:55:48 +0000
commitbc72d754f082fe30ef0d7aeff54f29c64553f02a (patch)
treed69c3c3f38ea93ee78ce6d4529f80d928ee88030
parentd8139fbb848c9509ae592b5477c85f5fd34b8ceb (diff)
downloadwebtools.dali-bc72d754f082fe30ef0d7aeff54f29c64553f02a.tar.gz
webtools.dali-bc72d754f082fe30ef0d7aeff54f29c64553f02a.tar.xz
webtools.dali-bc72d754f082fe30ef0d7aeff54f29c64553f02a.zip
178911 - Initial check-in for user.doc plugin for Dali 1.0.
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/.project22
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/META-INF/MANIFEST.MF7
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/about.htm48
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/build.properties2
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/add_persistence.xml53
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/create_entity.xml48
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/map_entity.xml62
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/concept_mapping.htm51
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/concept_persistence.htm46
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/concepts.htm65
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/concepts001.htm49
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/concepts002.htm49
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/concepts003.htm50
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/contexts.xml411
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/dcommon/css/blafdoc.css21
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/dcommon/html/cpyr.htm11
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started.htm54
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started001.htm65
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started002.htm59
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started003.htm91
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started004.htm111
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started005.htm140
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started006.htm48
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started007.htm215
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started008.htm52
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started009.htm68
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started010.htm63
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started011.htm85
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started012.htm60
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started013.htm64
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started014.htm132
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started015.htm133
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started016.htm92
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started017.htm71
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started018.htm89
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started019.htm67
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/add_persistence_dialog_xml.pngbin0 -> 7513 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/address_java_open.pngbin0 -> 5702 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/address_jpa_details.pngbin0 -> 8055 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/address_jpa_structure.pngbin0 -> 4099 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/button_jpa_perspective.pngbin0 -> 318 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/database_explorer.pngbin0 -> 4645 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/details_entitymappings.pngbin0 -> 5647 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/edit_join_column_dialog.pngbin0 -> 3128 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/error_sample.pngbin0 -> 13762 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl.pngbin0 -> 6080 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_objects.pngbin0 -> 6430 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_options.pngbin0 -> 6609 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_save.pngbin0 -> 7546 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_summary.pngbin0 -> 11426 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/generate_entities.pngbin0 -> 6223 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_11mapping.pngbin0 -> 244 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_1mmapping.pngbin0 -> 303 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_basicmapping.pngbin0 -> 476 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddable.pngbin0 -> 354 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddedidmapping.pngbin0 -> 213 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddedmapping.pngbin0 -> 400 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_idmapping.pngbin0 -> 521 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_m1mapping.pngbin0 -> 301 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_mmmapping.pngbin0 -> 255 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_nonpersistent.pngbin0 -> 210 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_persistent.pngbin0 -> 649 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_superclass.pngbin0 -> 632 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_transientmapping.pngbin0 -> 224 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/icon_versionmapping.pngbin0 -> 443 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_join.pngbin0 -> 11615 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_single.pngbin0 -> 3359 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_tab.pngbin0 -> 4236 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/java_editor_address.pngbin0 -> 7823 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/jpa_facet_dialog.pngbin0 -> 11714 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/new_jpa_project_dialog.pngbin0 -> 23157 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelc.pngbin0 -> 667 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelr.pngbin0 -> 615 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelt.pngbin0 -> 568 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/open_persistence_editor.pngbin0 -> 12962 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_address.pngbin0 -> 7215 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_empid.pngbin0 -> 6734 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_entity.pngbin0 -> 2090 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_fields.pngbin0 -> 4307 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_fname.pngbin0 -> 6658 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_owner.pngbin0 -> 6409 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_phone.pngbin0 -> 7292 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_version.pngbin0 -> 6923 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_view.pngbin0 -> 8746 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_perspective.pngbin0 -> 43141 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_address.pngbin0 -> 8307 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_addressid.pngbin0 -> 7390 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_embedded.pngbin0 -> 8080 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_empid.pngbin0 -> 4734 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_empid_pk.pngbin0 -> 9839 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_employee.pngbin0 -> 8609 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_entity.pngbin0 -> 8013 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_firstname.pngbin0 -> 4580 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_manytoone.pngbin0 -> 10356 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_mappedsprc.pngbin0 -> 8293 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_onetomany.pngbin0 -> 11536 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_onetoone.pngbin0 -> 8167 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_version.pngbin0 -> 5901 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_xml_editor.pngbin0 -> 2899 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/properties_persistence.pngbin0 -> 18245 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/quickstart_project.pngbin0 -> 9094 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/synchornize_classes.pngbin0 -> 16378 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/table_entity.pngbin0 -> 9169 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/img/tutorial_object_model.pngbin0 -> 7632 bytes
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/index.xml540
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/legal.htm45
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/plugin.xml37
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_jpa_facet.htm84
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_mapping_general.htm213
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project.htm91
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project_wizard.htm54
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_map_view.htm57
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_outline.htm55
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_perspective.htm59
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_prop_view.htm51
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_primary_key.htm144
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/ref_project_properties.htm81
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference.htm65
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference001.htm48
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference002.htm57
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference003.htm115
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference004.htm108
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference005.htm84
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference006.htm73
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference007.htm52
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference008.htm100
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference009.htm102
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference010.htm48
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference011.htm54
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference012.htm70
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference013.htm73
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference014.htm51
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference015.htm116
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference016.htm65
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference017.htm44
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/reference018.htm58
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/task_add_persistence.htm60
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/task_create_new_project.htm90
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/task_generate_ddl.htm82
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/task_generate_entities.htm74
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/task_inheritance.htm143
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence.htm68
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence001.htm68
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/task_mapping.htm78
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks.htm74
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks001.htm67
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks002.htm66
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks003.htm68
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks004.htm79
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks005.htm70
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks006.htm84
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks007.htm206
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks008.htm119
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks009.htm94
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks010.htm191
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm162
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks012.htm162
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks013.htm186
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks014.htm169
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks015.htm72
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks016.htm129
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks017.htm74
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks018.htm59
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks019.htm123
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks020.htm55
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm88
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tips_and_tricks.htm71
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/toc.xml117
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/whats_new.htm53
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/whats_new001.htm54
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/whats_new002.htm54
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/whats_new003.htm56
172 files changed, 9113 insertions, 0 deletions
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/.project b/jpa/plugins/org.eclipse.jpt.doc.user/.project
new file mode 100644
index 0000000000..61670ff4fc
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/.project
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+ <name>org.eclipse.jpt.doc.user</name>
+ <comment></comment>
+ <projects>
+ </projects>
+ <buildSpec>
+ <buildCommand>
+ <name>org.eclipse.pde.ManifestBuilder</name>
+ <arguments>
+ </arguments>
+ </buildCommand>
+ <buildCommand>
+ <name>org.eclipse.pde.SchemaBuilder</name>
+ <arguments>
+ </arguments>
+ </buildCommand>
+ </buildSpec>
+ <natures>
+ <nature>org.eclipse.pde.PluginNature</nature>
+ </natures>
+</projectDescription>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/META-INF/MANIFEST.MF b/jpa/plugins/org.eclipse.jpt.doc.user/META-INF/MANIFEST.MF
new file mode 100644
index 0000000000..f5e7343a89
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/META-INF/MANIFEST.MF
@@ -0,0 +1,7 @@
+Manifest-Version: 1.0
+Bundle-ManifestVersion: 2
+Bundle-Name: %pluginName
+Bundle-SymbolicName: org.eclipse.jpt.doc.user;singleton:=true
+Bundle-Version: 1.0.0.qualifier
+Bundle-Localization: plugin
+Bundle-Vendor: %providerName
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/about.htm b/jpa/plugins/org.eclipse.jpt.doc.user/about.htm
new file mode 100644
index 0000000000..a8f36368ae
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/about.htm
@@ -0,0 +1,48 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:14 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>About this content</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="About this content" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<div class="sect1"><!-- infolevel="all" infotype="General" --><a id="sthref257" name="sthref257"></a>
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>About this content</h1>
+</td>
+</tr>
+</table>
+<p>May 2, 2006</p>
+<a id="sthref258" name="sthref258"></a>
+<p class="subhead2">License</p>
+<p>The Eclipse Foundation makes available all content in this plug-in ("Content"). Unless otherwise indicated below, the Content is provided to you under the terms and conditions of the Eclipse Public License Version 1.0 ("EPL"). A copy of the EPL is available at <code><a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></code>. For purposes of the EPL, "Program" will mean the Content.</p>
+<p>If you did not receive this Content directly from the Eclipse Foundation, the Content is being redistributed by another party ("Redistributor") and different terms and conditions may apply to your use of any object code in the Content. Check the Redistributor's license that was provided with the Content. If no such license exists, contact the Redistributor. Unless otherwise indicated below, the terms and conditions of the EPL still apply to any source code in the Content and such source code may be obtained at <code><a href="http://www.eclipse.org">http://www.eclipse.org</a></code>.</p>
+</div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/build.properties b/jpa/plugins/org.eclipse.jpt.doc.user/build.properties
new file mode 100644
index 0000000000..8ad51cb85c
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/build.properties
@@ -0,0 +1,2 @@
+bin.includes = META-INF/,\
+ plugin.xml
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/add_persistence.xml b/jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/add_persistence.xml
new file mode 100644
index 0000000000..8434065a1e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/add_persistence.xml
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<cheatsheet title="Create a JPA Project">
+ <intro href="/org.eclipse.platform.doc.user/reference/ref-cheatsheets.htm">
+ <description>
+This cheat sheet will automatically launch wizards, perform actions, and guide you through the steps to create a JPA project.
+To learn more about using cheat sheets, or to see a list of available cheat sheets, click Help (?).
+To start work working on this cheat sheet click the "Click to Begin" button below.
+Let's get started!
+ </description>
+ </intro>
+ <item title="Setup the enviroment" skip="true">
+ <description>Your environment must be set up before you can perform the steps in this cheat sheet.
+ Create a database connection.
+ informationPending
+ </description>
+ </item>
+ <item href="/org.eclipse.jdt.doc.user/tasks/tasks-12.htm" title="Create a JPA Project" skip="true">
+ <action pluginId="org.eclipse.jdt.ui" class="org.eclipse.jdt.internal.ui.wizards.OpenProjectWizardAction" />
+ <description>
+First, you will need to create a JPA project.
+If you already have a JPA project in your workspace that you would like to use, you may skip this step by clicking the "Click to Skip" button. If not, select File->New->Project... and choose JPA->JPA Project in the list.
+Complete the subsequent pages as required.
+The "New JPA Project" wizard is automatically displayed when you click the "Click to Perform" button.
+ </description>
+ </item>
+ <item href="/org.eclipse.dali.doc.user/ref_add_persistence.htm" title="Adding Persistence">
+ <action pluginId="org.eclipse.dali.ui" class="org.eclipse.dali.ui.actions.AddPersistenceNatureToIJavaProjectActionDelegate" param1=" " />
+ <description>
+Now you will "add persistence" to the project.
+Right-click the Java project and select Java Persistence->Add Java Persistence.
+Complete the Add Persistence dialog by specifying your database connection information. If you do not have an active database connection, click "Add Connections" to create one.
+The "Add Java Persistence" dialog is automatically displayed when you click the "Click to Perform" button.
+If you do not use the "Click to Perform" button below, click the "Click to Skip" button to advance to the next step.
+ </description>
+ </item>
+ <item title="Adding JPA Libraries">
+ <description>
+To add your JPA library JARs, click "Configure the project build path." The Java Build Path" page of the Properties dialog appears.
+Add the JAP library JARs to your project.
+After adding the necessary libraries, click the "Click to Complete" button to advance to the next step.
+ </description>
+ </item>
+ <item title="Creating a persistence.xml File" skip="true">
+ <description>
+To create a persistence.xml file for your project, select the "Create persistence.xml" option. Complete the remaining fields on the the Add Persistence dialog and click "Finish." If you do not want to create a persistence.xml file, unselect the option and click the "Click to Skip" button to advance to the next step.
+ </description>
+ </item>
+ <item title="Finish">
+ <description>
+Congratulations! You have successfully added persistence to your Java project. Complete the additional cheat sheets to add Java persistent entities and map those entities to database tables.
+ </description>
+ </item>
+</cheatsheet>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/create_entity.xml b/jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/create_entity.xml
new file mode 100644
index 0000000000..5d275f6485
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/create_entity.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- edited with XMLSpy v2006 sp2 U (http://www.altova.com) by FREDERICK (RICK) SAPIR (ORACLE BELMONT) -->
+<cheatsheet title="Create a Persistent Entity">
+ <intro href="/org.eclipse.platform.doc.user/reference/ref-cheatsheets.htm">
+ <description>
+This cheat sheet will automatically launch wizards, perform actions, and guide you through the steps to add a Java persistent entity to your Java project.
+To learn more about using cheat sheets or to see a list of available cheat sheets, click Help (?).
+To start work working on this cheat sheet, click the "Click to Begin" button below.
+Let's get started!
+ </description>
+ </intro>
+ <item href="/org.eclipse.dali.doc.user/ref_persistence_perspective.htm" title="Open the Persistence Perspective" skip="true">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+When working with Java persistence, you should use the Persistence perspective. If you already have the Persistence perspective active, you may skip this step by clicking the "Click to Skip" button.
+If not, Select Window->Open Perspective->Other in the menubar at the top of the workbench. In the Select Perspectives dialog, select Persistence and click OK. This step changes the perspective to set up the Eclipse workbench for Java persistence development.
+You can click the "Click to Perform" button to have the "Persistence" perspective opened automatically.
+ </description>
+ </item>
+ <item href="/org.eclipse.dali.doc.user/create_new_entity.htm" title="Create a Persistent Entity" skip="true">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+To create a new Java persistent entity, use the Create Java Persistent Entity wizard.
+If you already have a Java persistent entity that you would like to use, you may skip this step by clicking the "Click to Skip" button. If not, select File->New->Other in the menubar at the top of the workbench.
+In the Select a Wizard dialog, select Java Persistence->Entity and click Next.
+The "Java Persistent Entity" wizard is automatically displayed when you click the "Click to Perform" button.
+ </description>
+ </item>
+ <item href="/org.eclipse.wst.datatools.connection.ui.doc.user/topics/ruidbconn_connpage.html" title="Add Database Connection" skip="true">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+If you already have a database connection in your workspace that you would like to use, you may skip this step by clicking the "Click to Skip" button. If not, create a new database connection.
+ </description>
+ </item>
+ <item href="/org.eclipse.dali.doc.user/ref_persistence_prop_view.htm" title="Specifying Persistence Properties">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+Now you will associate the entity with a database table.
+In the Persistence Properties view of the selected entity, use the "Table Name" field to select the database table to which the entity maps.
+The "Persistence Properties" view is automatically displayed when you click the "Click to Perform" button.
+ </description>
+ </item>
+ <item title="Finish">
+ <description>
+Congratulations! You have successfully added an Java persistent entity to your Java project. Complete the additional cheat sheets to map the entity's fields to database tables.
+ </description>
+ </item>
+</cheatsheet>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/map_entity.xml b/jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/map_entity.xml
new file mode 100644
index 0000000000..ed16679483
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/cheatsheets/map_entity.xml
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- edited with XMLSpy v2006 sp2 U (http://www.altova.com) by FREDERICK (RICK) SAPIR (ORACLE BELMONT) -->
+<cheatsheet title="Map a Java Persistent Entity">
+ <intro href="/org.eclipse.platform.doc.user/reference/ref-cheatsheets.htm">
+ <description>
+This cheat sheet will automatically launch wizards, perform actions, and guide you through the steps to map the fields of Java persistent entity to your database..
+To learn more about using cheat sheets or to see a list of available cheat sheets, click Help (?).
+To start work working on this cheat sheet, click the "Click to Begin" button below.
+Let's get started!
+ </description>
+ </intro>
+ <item href="/org.eclipse.dali.doc.user/ref_persistence_perspective.htm" title="Open the Persistence Perspective" skip="true">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+First, you need to use the Persistence Perspective. If you are already viewing the Persistence Perspective, you may skip this step by clicking the "Click to Skip" button. If not, select Window->Open Perspective->Other in the menubar at the top of the workbench
+In the Select Perspectives dialog, select Persistence and click OK.
+This step changes the perspective to set up the Eclipse workbench for Java persistence development.
+You can click the "Click to Perform" button to have the "Persistence" perspective opened automatically.
+ </description>
+ </item>
+ <item href="/org.eclipse.dali.doc.user/create_new_entity.htm" title="Create a Persistent Entity" skip="true">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+To create a new Java persistent entity, use the Create Java Persistent Entity wizard.
+If you already have a Java persistent entity that you would like to use, you may skip this step by clicking the "Click to Skip" button. If not, select File->New->Other in the menubar at the top of the workbench.
+In the Select a Wizard dialog, select Java Persistence->Entity and click Next.
+The "Java Persistent Entity" wizard is automatically displayed when you click the "Click to Perform" button.
+ </description>
+ </item>
+ <item href="org.eclipse.wst.datatools.connection.ui.doc.user/topics/ruidbconn_connpage.html" title="Add Database Connection" skip="true">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+If you already have a database connection in your workspace that you would like to use, you may skip this step by clicking the "Click to Skip" button. If not, create a new database connection.
+ </description>
+ </item>
+ <item href="/org.eclipse.dali.doc.user/ref_persistence_prop_view.htm" title="Specifying Persistence Properties" skip="true">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+Now you will associate the entity with a database table. If you already have associated the entity with a database table, you may skip this step by clicking the "Click to Skip" button.
+If not, in the Persistence Properties view of the selected entity, use the "Table Name" field to select the database table to which the entity maps.
+The "Persistence Properties" view of the wizard is automatically displayed when you click the "Click to Perform" button.
+ </description>
+ </item>
+ <item href="" title="Add Fields to the Class" skip="true">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+Now you will add some fields to the entity to map to rows in the database table.
+If your persistent entity already has fields to map, you may skip this step by clicking the "Click to Skip" button. If not, use the Java editor to add fields to the entity.
+ </description>
+ </item>
+ <item href="/org.eclipse.dali.doc.user/ref_entity_page.htm" title="Create the Mapping">
+ <action pluginId="org.eclipse.ui.cheatsheets" class="org.eclipse.ui.internal.cheatsheets.actions.OpenPerspective" param1="org.eclipse.dali.ui.PersistencePerspective"/>
+ <description>
+Now you are ready to map the entity fields to columns in the database table. In the Package Explorer, select the Java class. In the Persistence Outline view, expand the persistent entity to display the fields. Select a field. The Persistence Properties view displays the information for the field. Use the Map As field to select the Basic mapping. Use the Column field to select a column from the database table.
+ </description>
+ </item>
+ <item title="Finish">
+ <description>
+Congratulations! You have successfully mapped the fields from a Java persistent entity to a column in a database table.
+ </description>
+ </item>
+</cheatsheet>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concept_mapping.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concept_mapping.htm
new file mode 100644
index 0000000000..d66eb6735b
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/concept_mapping.htm
@@ -0,0 +1,51 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Understanding OR mappings</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Understanding OR mappings" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABBDJFI" name="BABBDJFI"></a></p>
+<div class="sect1">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Understanding OR mappings</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref44" name="sthref44"></a><a id="sthref45" name="sthref45"></a>The Dali OR (object-relational) Mapping Tool allows you to describe how your entity objects <span class="italic">map</span> to the data source (or other objects). This approach isolates persistence information from the object model&ndash;developers are free to design their ideal object model, and DBAs are free to design their ideal schema.</p>
+<p>These mappings transform an object data member type to a corresponding relational database data source representation. These OR mappings can also transform object data members that reference other domain objects stored in other tables in the database and are related through foreign keys.</p>
+<p>You can use these mappings to map simple data types including primitives (such as <code>int</code>), JDK classes (such as <code>String</code>), and large object (LOB) values. You can also use them to transform object data members that reference other domain objects by way of association where data source representations require object identity maintenance (such as sequencing and back references) and possess various types of multiplicity and navigability. The appropriate mapping class is chosen primarily by the cardinality of the relationship.</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+</div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concept_persistence.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concept_persistence.htm
new file mode 100644
index 0000000000..31cae4208e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/concept_persistence.htm
@@ -0,0 +1,46 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Understanding Java persistence</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Understanding Java persistence" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABCAHIC" name="BABCAHIC"></a></p>
+<div class="sect1">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Understanding Java persistence</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref42" name="sthref42"></a><span class="italic">Persistence</span> refers to the ability to store objects in a database and use those objects with transactional integrity. In a J2EE application, data is typically stored and persisted in the data tier, in a relational database.</p>
+<p><a id="sthref43" name="sthref43"></a><span class="italic">Entity beans</span> are enterprise beans that contain persistent data and that can be saved in various persistent data stores. The entity beans represent data from a database; each entity bean carries its own identity. Entity beans can be deployed using <span class="italic">application-managed persistence</span> or <span class="italic">container-managed persistence</span>.</p>
+</div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concepts.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concepts.htm
new file mode 100644
index 0000000000..ee626f0da3
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/concepts.htm
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Concepts</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content=" Concepts" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="sthref41" name="sthref41"></a></p>
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Concepts</h1>
+</td>
+</tr>
+</table>
+<p>This section contains an overview of concepts you should be familiar with when using Dali to create mappings for Java persistent entities.</p>
+<ul>
+<li type="disc">
+<p><a href="concept_persistence.htm#BABCAHIC">Understanding Java persistence</a></p>
+</li>
+<li type="disc">
+<p><a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a></p>
+</li>
+<li type="disc">
+<p><a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></p>
+</li>
+</ul>
+<p>In addition to these sections, you should review the following resources for additional information:</p>
+<ul>
+<li type="disc">
+<p>Eclipse Dali project: <code><a href="http://www.eclipse.org/dali">http://www.eclipse.org/dali</a></code></p>
+</li>
+<li type="disc">
+<p>Eclipse Web Tools Platform project: <code><a href="http://www.eclipse.org/webtools">http://www.eclipse.org/webtools</a></code></p>
+</li>
+<li type="disc">
+<p>JSR 220 EJB 3.0 specification: <code><a href="http://www.jcp.org/en/jsr/detail?id=220">http://www.jcp.org/en/jsr/detail?id=220</a></code></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concepts001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concepts001.htm
new file mode 100644
index 0000000000..3089c43a5a
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/concepts001.htm
@@ -0,0 +1,49 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Understanding EJB 3.0 Java Persistence API</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Understanding EJB 3.0 Java Persistence API" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABBGFJG" name="BABBGFJG"></a></p>
+<div class="sect1">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Understanding EJB 3.0 Java Persistence API</h1>
+</td>
+</tr>
+</table>
+<p>The Java 2 Enterprise Edition(J2EE) Enterprise JavaBeans (EJB) are a component architecture that you use to develop and deploy object-oriented, distributed, enterprise-scale applications. An application written according to the Enterprise JavaBeans architecture is scalable, transactional, and secure.</p>
+<p>The EJB 3.0 Java Persistence API (JPA) improves the EJB architecture by reducing its complexity through the use of metadata (annotations) and specifying programmatic defaults of that metadata.</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concepts002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concepts002.htm
new file mode 100644
index 0000000000..dc0f17a757
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/concepts002.htm
@@ -0,0 +1,49 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>The persistence.xml file</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="The persistence.xml file" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CHDHAGIH" name="CHDHAGIH"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1><a id="sthref46" name="sthref46"></a>The persistence.xml file</h1>
+</td>
+</tr>
+</table>
+<p>The JPA specification requires the use of a <code>persistence.xml</code> file for deployment. This file defines the database and entity manager options, and may contain more than one persistence unit. Dali can use the Eclipse XML Editor to create and maintain this information. See <a href="task_manage_persistence.htm#CIHDAJID">"Managing the persistence.xml file"</a> for more information.</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a><br />
+<p>&nbsp;</p>
+</div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concepts003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concepts003.htm
new file mode 100644
index 0000000000..a0277ed3c4
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/concepts003.htm
@@ -0,0 +1,50 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>The orm.xml file</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="The orm.xml file" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CHDBIJAC" name="CHDBIJAC"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1><a id="sthref47" name="sthref47"></a>The orm.xml file</h1>
+</td>
+</tr>
+</table>
+<p>Although the JPA specification emphasizes the use of annotations to specify persistence, you can also the <code>orm.xml</code> file to store this metadata. Dali can use the Eclipse XML Editor to create and maintain this information. The metadata must match the XSD specification of your selected JPA implementation. See <a href="task_manage_persistence001.htm#CIHDGDCD">"Managing the orm.xml file"</a> for more information.</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a><br />
+<p>&nbsp;</p>
+</div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/contexts.xml b/jpa/plugins/org.eclipse.jpt.doc.user/contexts.xml
new file mode 100644
index 0000000000..d9b21d4b85
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/contexts.xml
@@ -0,0 +1,411 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?NLS TYPE="org.eclipse.help.contexts"?>
+<contexts>
+ <context id="entity_accessType">
+ <description>Specify how the variable is accessed: Property (default) or Field.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="entity_name">
+ <description>The name of this entity. By default, the class name is used as the entity name.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="entity_table">
+ <description>The database table assigned to this entity. By default, the class name is used as the database table name.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="entity_attributeOverrides">
+ <description>Specify a property or field to be overridden (from the default mappings).</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="entity_attributeOverridesName">
+ <description>Name of the database column.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="entity_attributeOverridesColumn">
+ <description>The database column that overrides a property or field.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="entity_attributeOverridesInsertable">
+ <description>Specifies if the column is always included in SQL INSERT statements.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="entity_attributeOverridesUpdatable">
+ <description>Specifies if the column is always included in SQL UPDATE statements.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="mapping_mapAs">
+ <description>Specify how this attribute maps to the database.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_column">
+ <description>The database column that contains the value for the attribute.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_columnTable">
+ <description>Name of the database table that contains the selected column.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_columnInsertable">
+ <description>Specifies if the column is always included in SQL INSERT statements.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_columnUpdatable">
+ <description>Specifies if the column is always included in SQL UPDATE statements.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_fetchType">
+ <description>Defines how data is loaded from the database: Eager (default) or Lazy</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_optional">
+ <description>Specifies if this field is can be null.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_generatedValueStrategy">
+ <description>Determines how the primary key is generated: Auto (default), Sequence, Identity, or Table.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_generatedValueGeneratorName">
+ <description>Unique name of the generator.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_targetEntity">
+ <description>The entity to which this attribute is mapped. </description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_cascadeType">
+ <description>Specify which operations are propagated throughout the entity: All, Persist, Merge, or Move.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_mappedBy">
+ <description>The field in the database table that owns the relationship.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_joinColumnName">
+ <description>The name of the database column that contains the foreign key reference for the entity association.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_joinReferencedColumn">
+ <description>Name of the join table that contains the foreign key column.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_embeddedAttributeOverrides">
+ <description>Specify to override the default mapping of an entity’s attribute.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="mapping_embeddedAttributeOverridesColumn">
+ <description>The database column that is being mapped to the entity’s attribute.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ <topic label="Understanding OR mappings" href="concept_mapping.htm"/>
+ </context>
+ <context id="entity_mapAs">
+ <description>Specify the type of persistent domain object for the Java class: Persistent, Embedded, or Mapped Superclass.</description>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="entity_inheritanceStrategy">
+ <description>Specify how an entity may inherit properties from other entities: Single table, One table per class, or Joined tables.</description>
+ <topic label="Specifying inheritance" href="task_inheritance.htm"/>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="entity_inheritanceDiscriminatorColumn">
+ <description>Use to specify the name of the discriminator column when using a Single or Joined inheritance strategy.</description>
+ <topic label="Specifying inheritance" href="task_inheritance.htm"/>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="entity_inheritanceDiscriminatorType">
+ <description>Use this field to set the discriminator type to CHAR or INTEGER (instead of its default: String). The discriminator value must conform to this type.</description>
+ <topic label="Specifying inheritance" href="task_inheritance.htm"/>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="entity_inheritanceDiscriminatorValue">
+ <description>Specify the discriminator value used to differentiate an entity in this inheritance hierarchy. The value must conform to the specified discriminator type.</description>
+ <topic label="Specifying inheritance" href="task_inheritance.htm"/>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="mapping_orderBy">
+ <description>Specify the default order for objects returned from a query.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Mapping an Entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_joinTableName">
+ <description>Specify the name of the database table that defines the foreign key for a many-to-many or a unidirectional one-to-many association. You can configure the join table with a specific catalog or schema, configure one or more join table columns with a unique constraint, and use multiple join columns per entity.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_joinTableJoinColumns">
+ <description>Specify two or more join columns (that is, a composite primary key).</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_joinTableInverseJoinColumns">
+ <description>Specify the join column on the owned (or inverse side) of the association: the owned entity's primary key column. </description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="properties_javaPersistence">
+ <description>Use the Java Persistence options on the Properties page to select the database connection to use with the project.</description>
+ <topic label="Project properties" href="ref_project_properties"/>
+ <topic label="Adding persistence" href="ref_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="properties_javaPersistenceConnection">
+ <description>The database connection used to map the persistent entities.</description>
+ <topic label="Project properties" href="ref_project_properties"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="properties_javaPersistenceSchema">
+ <description>The database schema used to map the persistent entities.</description>
+ <topic label="Project properties" href="ref_project_properties"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="dialog_addPersistence">
+ <description>Use the Add Persistence dialog to define the database connection use to store the persistence entities.</description>
+ <topic label="Adding persistence" href="ref_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="persistenceOutline">
+ <description>The JPA Structure view displays an outline of the structure (its attributes and mappings) of the entity that is currently selected or opened in the editor.</description>
+ <topic label="JPA Structure view" href="ref_persistence_outline.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="dialog_generateEntities">
+ <description>Use the Generate Entities dialog to create Java persistent entities based on your database tables.</description>
+ <topic label="Generating entities from tables" href="task_generate_entities.htm.htm" />
+ <topic label="Project properties" href="ref_project_properties"/>
+ </context>
+ <context id="dialog_generateEntities_source">
+ <description>The project folder name in which to generate the Java persistent entities. Click Browse to select an existing folder.</description>
+ <topic label="Generating entities from tables" href="task_generate_entities.htm"/>
+ </context>
+ <context id="dialog_generateEntities_package">
+ <description>The package in which to generate the Java persistent entities, or click Browse to select an existing package.</description>
+ <topic label="Generating entities from tables" href="task_generate_entities.htm"/>
+ </context>
+ <context id="dialog_generateEntities_tables">
+ <description>Select the tables from which to create Java persistent entities.</description>
+ <topic label="Generating entities from tables" href="task_generate_entities.htm"/>
+ <topic label="Project properties" href="ref_project_properties"/>
+ </context>
+ <context id="dialog_addJavaPersistence">
+ <description>Use this dialog to define the database connection used to store the persistence entities and to create the persistence.xml file.</description>
+ <topic label="Add Persistence dialog" href="ref_add_persistence.htm" />
+ <topic label="Adding persistence to a project" href="task_add_persistence" />
+ <topic label="Managing the persistence.xml file" href="task_manage_persistence.htm" />
+ </context>
+ <context id="dialog_newJPAProject">
+ <description>Use this dialog to define the new JPA project name, its location, target runtime, and other configuration settings.</description>
+ <topic label="New JPA Project page" href="ref_new_jpa_project.htm" />
+ <topic label="New JPA Project wizard" href="ref_new_jpa_project_wizard" />
+ <topic label="Adding persistence to a project" href="task_add_persistence" />
+ <topic label="Creating a new JPA project" href="task_create_new_project.htm" />
+ </context>
+ <context id="dialog_addJavaPersistence_database">
+ <description>Use these fields to define the database connection used to store the persistent entities.</description>
+ <topic label="Add Persistence dialog" href="ref_add_persistence.htm" />
+ <topic label="Adding persistence to a project" href="task_add_persistence" />
+ </context>
+ <context id="dialog_addJavaPersistence_classpath">
+ <description>Use this option to add libraries or JARs that contain the Java Persistence API (JPA) and entities to the project’s Java Build Path.</description>
+ <topic label="Add Persistence dialog" href="ref_add_persistence.htm" />
+ <topic label="Adding persistence to a project" href="task_add_persistence" />
+ </context>
+ <context id="dialog_addJavaPersistence_packaging">
+ <description>Use these fields to create the persistence.xml file. Select the persistence version, the name of the JPA provider, and a unique name to identify the persistence unit.</description>
+ <topic label="Add Persistence dialog" href="ref_add_persistence.htm" />
+ <topic label="Managing the persistence.xml file" href="task_manage_persistence.htm" />
+ </context>
+ <context id="wizard_generateDDL_options ">
+ <description>Use this page to select which script options will be included in the generated script.</description>
+ <topic label="Generating tables (DDL) from entities " href="task_generate_ddl.htm" />
+ <topic label="Options page " href="ref_options.htm" />
+ </context>
+ <context id="wizard_generateDDL_objects ">
+ <description>Use this page to select which elements will be included in the generated script.</description>
+ <topic label="Generating tables (DDL) from entities " href="task_generate_ddl.htm" />
+ <topic label="Objects page " href="ref_objects.htm" />
+ </context>
+ <context id="wizard_generateDDL_save ">
+ <description>Use this page to select the filename and location of the generated script. You can also preview the script and specify to run or continue editing the script after generation.</description>
+ <topic label="Generating tables (DDL) from entities " href="task_generate_ddl.htm" />
+ <topic label="Save and Run DDL page " href="ref_save_and_run.htm" />
+ </context>
+ <context id="wizard_generateDDL_summary ">
+ <description>This page shows the settings that you selected for the generated DDL. To change any option click "Back" or click "Finish" to continue.</description>
+ <topic label="Generating tables (DDL) from entities " href="task_generate_ddl.htm" />
+ </context>
+ <context id="mapping_tableGeneratorName">
+ <description>The name of the table sequence generator. This name is global to to the persistence unit (across all generator types).</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_tableGeneratorTable">
+ <description>The database table that stores the generated ID values. </description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_tableGeneratorPrimaryKeyColumn">
+ <description>The database column of the generator table that stores the generated ID values.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_tableGeneratorValueColumn">
+ <description>The name for the column that stores the generated ID values.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_tableGeneratorPrimaryKeyColumnValue">
+ <description>The database column of the generator table that defines the primary key value.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="dialog_databaseAuthorization">
+ <description>Use to connect (log in) to a database connection to use with your Java persistent entities.
+ You must have a defined database connection (and be connected) to add persistence. </description>
+ <topic label="Add persistence to a Java project" href="task_add_persistence_project.htm"/>
+ </context>
+ <context id="mapping_temporal">
+ <description>Specify if the mapped field contains a Date (java.sql.Date), Time (java.sql.Time), or Timestamp (java.sql.Timestamp) value.</description>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_primaryKeyGeneration">
+ <description>Define how the primary key is generated</description>
+ <topic label="Primary Key Generation information" href="ref_primary_key.htm"/>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_tableGenerator">
+ <description>Specify to use a specific database table for generating the primary key.</description>
+ <topic label="Primary Key Generation information" href="ref_primary_key.htm"/>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_sequenceGenerator">
+ <description>Specify to use a specific sequence for generating the primary key.</description>
+ <topic label="Primary Key Generation information" href="ref_primary_key.htm"/>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_sequenceGeneratorName">
+ <description>Name of the sequence.</description>
+ <topic label="Primary Key Generation information" href="ref_primary_key.htm"/>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_sequenceGeneratorSequence">
+ <description> </description>
+ <topic label="Primary Key Generation information" href="ref_primary_key.htm"/>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_lob">
+ <description>Specify if the field is mapped to java.sql.Clob or java.sql.Blob.</description>
+ <topic label="General information" href="ref_mapping_general.htm"/>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="mapping_enumerated">
+ <description>Specify how to persist enumerated constraints if the String value suits your application requirements or to match an existing database schema.</description>
+ <topic label="General information" href="ref_mapping_general.htm"/>
+ <topic label="JPA Details" href="ref_persistence_map_view.htm"/>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="dialog_editInverseJoinColumn">
+ <description>.</description>
+ <topic label="Mapping an entity" href="task_mapping.htm"/>
+ </context>
+ <context id="entity_catalog">
+ <description>The database catalog that contains the Table. This field overrides the defaults in the orm.xml file.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="entity_schema">
+ <description>The database schema that contains the Table. This field overrides the defaults in the orm.xml file.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ <topic label="Adding persistence to a class" href="task_add_persistence.htm"/>
+ <topic label="Understanding persistence" href="concept_persistence.htm"/>
+ </context>
+ <context id="orm_package">
+ <description>.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="orm_package">
+ <description>.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="orm_schema">
+ <description>.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="orm_catalog">
+ <description>.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="orm_access">
+ <description>.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="orm_cascade">
+ <description>.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+ <context id="orm_xml">
+ <description>.</description>
+ <topic label="JPA Details" href="ref_persistence_prop_view.htm"/>
+ </context>
+
+
+
+
+</contexts>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/css/blafdoc.css b/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/css/blafdoc.css
new file mode 100644
index 0000000000..4fa017b8b0
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/css/blafdoc.css
@@ -0,0 +1,21 @@
+@import "../../../PRODUCT_PLUGIN/book.css";
+
+span.control, span.gui-object-action, p.subhead2, span.bold, p.notep1 {
+ font-weight: bold;
+}
+
+span.name, p.titleinfigure, span.italic {
+ font-style: italic;
+}
+
+p.titleinfigure, p.subhead2 {
+ padding-top: 10px;
+}
+
+span.code {
+ font-family: monospace;
+}
+
+span.copyrightlogo {font-size: 75%}
+
+.footer {padding-top: 2em;} \ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/html/cpyr.htm b/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/html/cpyr.htm
new file mode 100644
index 0000000000..382ec67619
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/html/cpyr.htm
@@ -0,0 +1,11 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
+<head>
+<!-- <meta http-equiv="refresh" content="0;url=../../legal.htm"> -->
+</head>
+<body>
+<p><a href="../../legal.htm">License Information</a></p>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started.htm
new file mode 100644
index 0000000000..70f49d8fca
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started.htm
@@ -0,0 +1,54 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:06 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Getting started</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content=" Getting started" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="sthref2" name="sthref2"></a></p>
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Getting started</h1>
+</td>
+</tr>
+</table>
+<p>This section provides information on getting started with the Java Persistence Tools.</p>
+<ul>
+<li type="disc">
+<p><a href="getting_started001.htm#BABEFHCD">Requirements and installation</a></p>
+</li>
+<li type="disc">
+<p><a href="getting_started002.htm#BABIGCJA">Dali quick start</a></p>
+</li>
+<li type="disc">
+<p><a href="getting_started006.htm#BABCDECJ">Dali basic tutorial</a></p>
+</li>
+</ul>
+<p>For additional information, please visit the Dali home page at: <code><a href="http://www.eclipse.org/webtools/dali/main.php/">http://www.eclipse.org/webtools/dali/main.php/</a></code>.</p>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started001.htm
new file mode 100644
index 0000000000..44a260e947
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started001.htm
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:06 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Requirements and installation</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Requirements and installation" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABEFHCD" name="BABEFHCD"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Requirements and installation<a id="sthref3" name="sthref3"></a><a id="sthref4" name="sthref4"></a></h1>
+</td>
+</tr>
+</table>
+<p>Before installing Dali, ensure that your environment meets the following <span class="italic">minimum</span> requirements:</p>
+<ul>
+<li type="disc">
+<p>Eclipse 3.3 (<code><a href="http://www.eclipse.org/downloads">http://www.eclipse.org/downloads</a></code>)</p>
+</li>
+<li type="disc">
+<p>Java Runtime Environment (JRE) 1.5 (<code><a href="http://java.com">http://java.com</a></code>)</p>
+</li>
+<li type="disc">
+<p>Eclipse Web Tools Platform (WTP) 2.0 (<code><a href="http://www.eclipse.org/webtools">http://www.eclipse.org/webtools</a></code>)</p>
+</li>
+<li type="disc">
+<p>Java Persistence API (JPA) for Java EE 5. The reference implementation can be obtained from:</p>
+</li>
+</ul>
+<pre xml:space="preserve" class="oac_no_warn">
+<code><a href="https://glassfish.dev.java.net/downloads/persistence/JavaPersistence.html">https://glassfish.dev.java.net/downloads/persistence/JavaPersistence.html</a></code>
+
+</pre>
+<p>Refer to <code><a href="http://www.eclipse.org/webtools/dali/gettingstarted_main.html">http://www.eclipse.org/webtools/dali/gettingstarted_main.html</a></code> for additional installation information.</p>
+<p>Review the <a href="getting_started002.htm#BABIGCJA">Dali quick start</a> and <a href="getting_started006.htm#BABCDECJ">Dali basic tutorial</a> to build your first Dali project.</p>
+</div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started002.htm
new file mode 100644
index 0000000000..96cbcdfcc2
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started002.htm
@@ -0,0 +1,59 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:06 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Dali quick start</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Dali quick start" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABIGCJA" name="BABIGCJA"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Dali quick start</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref5" name="sthref5"></a>This section includes information to help you quickly start using Dali to create relational mappings between Java persistent entities and database tables.</p>
+<ul>
+<li type="disc">
+<p><a href="getting_started003.htm#BABDFHDA">Creating a new project</a></p>
+</li>
+<li type="disc">
+<p><a href="getting_started004.htm#BABFGDDG">Creating a Java persistent entity</a></p>
+</li>
+<li type="disc">
+<p><a href="getting_started005.htm#BABHACAF">Mapping an entity</a></p>
+</li>
+</ul>
+<p>The <a href="getting_started006.htm#BABCDECJ">Dali basic tutorial</a> contains detailed procedures for building you first Dali project.</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="getting_started006.htm#BABCDECJ">Dali basic tutorial</a><br />
+<a href="tips_and_tricks.htm#CHDHGHBF">Tips and tricks</a><br />
+<a href="whats_new.htm#BGGEDBGF">What's new</a> <!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started003.htm
new file mode 100644
index 0000000000..c263d68c50
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started003.htm
@@ -0,0 +1,91 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:06 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Creating a new project</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Creating a new project" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABDFHDA" name="BABDFHDA"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Creating a new project</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref6" name="sthref6"></a>This quick start shows how to create a new JPA project.</p>
+<ol type="1" start="1">
+<li>
+<p>Select <span class="gui-object-action">File &gt; New &gt; Project</span>. The New Project dialog appears.</p>
+</li>
+<li>
+<p>On the <span class="gui-object-title">New Project</span> dialog, select <span class="gui-object-action">JPA &gt; JPA Project</span> and click <span class="gui-object-action">Next</span>. The Create a Java Project dialog appears.</p>
+<div class="figure"><a id="sthref7" name="sthref7"></a>
+<p class="titleinfigure">New JPA Project</p>
+<img src="img/new_jpa_project_dialog.png" alt="Using the Java Persistence &gt; Add Java Persistence menu option." title="Using the Java Persistence &gt; Add Java Persistence menu option." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>On the <span class="gui-object-title">Create a JPA Project</span> dialog, enter a <span class="gui-object-action">Project name</span> (such as <code>QuickStart</code>).</p>
+</li>
+<li>
+<p>Select your <span class="bold">Target Runtime</span> (such as <code>Apache Tomcat</code>) and click <span class="bold">Next</span>. The Project Facets dialog appears.</p>
+</li>
+<li>
+<p>Verify that the Java Persistence facet is selected and click <span class="bold">Next</span>. The JPA Facet dialog appears.</p>
+<div align="center">
+<div class="inftblnote"><br />
+<table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
+<tbody>
+<tr>
+<td align="left">
+<p class="notep1">Note:</p>
+You must configure your project to use Java version 5.0 (or higher). See <a href="getting_started001.htm#BABEFHCD">"Requirements and installation"</a> for more information.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblnote" --></div>
+</li>
+<li>
+<p>On the JPA Facet dialog, select your database connection (or create a new connection) and JPA implementation library (such as TopLink Essentials), and click <span class="bold">Finish</span>.</p>
+<p><span class="italic">INFORMATION_PENDING</span></p>
+<div class="figure"><a id="sthref8" name="sthref8"></a>
+<p class="titleinfigure">JPA Facet Dialog</p>
+<img src="img/jpa_facet_dialog.png" alt="" title="" /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<p>Eclipse adds the project to the workbench and opens the JPA perspective.</p>
+<div class="figure"><a id="sthref9" name="sthref9"></a>
+<p class="titleinfigure">Project in Package Explorer</p>
+<img src="img/quickstart_project.png" alt="Package Explorer showing the Java persistent project." title="Package Explorer showing the Java persistent project." /><br /></div>
+<!-- class="figure" -->
+<p>Now that you have created a project with persistence, you can continue with <a href="getting_started004.htm#BABFGDDG">Creating a Java persistent entity</a>.</p>
+</div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started004.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started004.htm
new file mode 100644
index 0000000000..eee2ce891e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started004.htm
@@ -0,0 +1,111 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Creating a Java persistent entity</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Creating a Java persistent entity" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABFGDDG" name="BABFGDDG"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Creating a Java persistent entity</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref10" name="sthref10"></a>This quick start shows how to create a new persistent Java entity. We will create an entity to associate with a database table. You will also need to add the ADDRESS table to your database.</p>
+<ol type="1" start="1">
+<li>
+<p>Right-click the project in the Package Explorer and select <span class="bold">New &gt; Class</span>. The New Java Class page appears.</p>
+</li>
+<li>
+<p>On the Java Class page, enter a package name (such as <code>quickstart.demo.model</code>), class name (such as <code>Address</code>), and click <span class="bold">Finish</span>.</p>
+</li>
+<li>
+<p>synchronize <code>persistence.xml</code></p>
+<p><span class="italic">informationPending...</span></p>
+</li>
+<li>
+<p>Right-click the <code>Address.java</code> file in the Package Explorer and select <span class="bold">Open</span>.</p>
+<div class="figure"><a id="sthref11" name="sthref11"></a>
+<p class="titleinfigure">Open Address.java</p>
+<img src="img/address_java_open.png" alt="" title="" /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Select the <code>Address</code> entity in the JPA Structure view.</p>
+<div class="figure"><a id="sthref12" name="sthref12"></a>
+<p class="titleinfigure">Address Class in JPA Structure View</p>
+<img src="img/address_jpa_structure.png" alt="" title="" /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>In the JPA Details view, in the Map As field, select <span class="bold">Entity</span>. In the Table field, select the <span class="bold">ADDRESS</span> database table.</p>
+<div class="figure"><a id="sthref13" name="sthref13"></a>
+<p class="titleinfigure">Address Entity in JPA Details View</p>
+<img src="img/address_jpa_details.png" alt="" title="" /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<p>Eclipse creates the persistent entity and adds the <code>@Entity</code> annotation to the class.</p>
+<div class="figure"><a id="sthref14" name="sthref14"></a>
+<p class="titleinfigure">Address Entity</p>
+<img src="img/java_editor_address.png" alt="This figure shows the Java editor with the Address entity." title="This figure shows the Java editor with the Address entity." /><br /></div>
+<!-- class="figure" -->
+<p>Eclipse also displays the <span class="bold">Address</span> entity in the JPA Structure view:</p>
+<div class="figure"><a id="sthref15" name="sthref15"></a>
+<p class="titleinfigure">Address Entity</p>
+<img src="img/persistence_outline_entity.png" alt="This figure shows the Address entity in the Persistence Outline view." title="This figure shows the Address entity in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>After creating the entity, you must associate it with a database table.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="gui-object-action">Address</span> class in the Explorer view.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Persistence Properties</span> view, notice that Dali has automatically associated the ADDRESS database table with the entity because they are named identically.</p>
+<div align="center">
+<div class="inftblnote"><br />
+<table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
+<tbody>
+<tr>
+<td align="left">
+<p class="notep1">Note:</p>
+Depending on your database connection type, you may need to specify the <span class="bold">Schema</span>.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblnote" --></div>
+<div class="figure"><a id="sthref16" name="sthref16"></a>
+<p class="titleinfigure">Persistence Properties View for Address Entity</p>
+<img src="img/persistence_view_address.png" alt="This figure shows the Table selection for the Address entity in the Persistence Properties view." title="This figure shows the Table selection for the Address entity in the Persistence Properties view." /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<p>Now that you have created a persistent entity, you can continue with <a href="getting_started005.htm#BABHACAF">Mapping an entity</a> to map the entity's fields to columns on the database table.</p>
+</div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started005.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started005.htm
new file mode 100644
index 0000000000..12374b121f
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started005.htm
@@ -0,0 +1,140 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Mapping an entity</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Mapping an entity" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABHACAF" name="BABHACAF"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Mapping an entity</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref17" name="sthref17"></a><a id="sthref18" name="sthref18"></a>This quick start shows how to map fields in a Java persistent entity. Before beginning, add the following fields to the Address class:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+private Long id;
+private String city;
+private String country;
+private String stateOrProvince;
+private String postalCode;
+private String street;
+
+</pre>
+<p>Eclipse updates the Address entity in the JPA Structure view to show its fields:</p>
+<div class="figure"><a id="sthref19" name="sthref19"></a>
+<p class="titleinfigure">Address Entity and Fields</p>
+<img src="img/persistence_outline_fields.png" alt="This figure shows the Address entity and its fields in the Persistence Outline view." title="This figure shows the Address entity and its fields in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>You will also need to add the following columns to the ADDRESS database table:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+NUMBER(10,0) ADDRESS_ID (primary key)
+VARCHAR2(80) PROVINCE
+VARCHAR2(80) COUNTRY
+VARCHAR2(20) P_CODE
+VARCHAR2(80) STREET
+VARCHAR2(80) CITY
+</pre>
+<pre xml:space="preserve" class="oac_no_warn">
+</pre>
+<p>Now we are ready to map each fields in the Address class to a column in the database table.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="gui-object-action">id</span> field in the JPA Details view.</p>
+</li>
+<li>
+<p>In the JPA Details view:</p>
+<ul>
+<li type="disc">
+<p>For the Map As field, select <span class="bold">Id</span></p>
+</li>
+<li type="disc">
+<p>For the Column field, select <span class="bold">ADDRESS_ID</span>.</p>
+</li>
+</ul>
+<div class="figure"><a id="sthref20" name="sthref20"></a>
+<p class="titleinfigure">Persistence Properties View for addressId Field</p>
+<img src="img/persistence_view_addressid.png" alt="This figure shows the Persistence Properties view for the id field." title="This figure shows the Persistence Properties view for the id field." /><br /></div>
+<!-- class="figure" -->
+<p>Eclipse adds the following annotations to the Address entity:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@Id
+@Column(name="ADDRESS_ID")
+
+</pre></li>
+<li>
+<p>Map each of the following fields (as <span class="bold">Basic</span> mappings) to the appropriate database column:</p>
+<div class="inftblhruleinformal">
+<table class="HRuleInformal" title="This table describes the mappings for each of the fields in the Address entity." summary="This table describes the mappings for each of the fields in the Address entity." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t4">Field</th>
+<th align="left" valign="bottom" id="r1c2-t4">Map As</th>
+<th align="left" valign="bottom" id="r1c3-t4">Database Column</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t4" headers="r1c1-t4">city</td>
+<td align="left" headers="r2c1-t4 r1c2-t4">Basic</td>
+<td align="left" headers="r2c1-t4 r1c3-t4">CITY</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t4" headers="r1c1-t4">country</td>
+<td align="left" headers="r3c1-t4 r1c2-t4">Basic</td>
+<td align="left" headers="r3c1-t4 r1c3-t4">COUNTRY</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t4" headers="r1c1-t4">postalCode</td>
+<td align="left" headers="r4c1-t4 r1c2-t4">Basic</td>
+<td align="left" headers="r4c1-t4 r1c3-t4">P_CODE</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t4" headers="r1c1-t4">provinceOrState</td>
+<td align="left" headers="r5c1-t4 r1c2-t4">Basic</td>
+<td align="left" headers="r5c1-t4 r1c3-t4">PROVINCE</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t4" headers="r1c1-t4">street</td>
+<td align="left" headers="r6c1-t4 r1c2-t4">Basic</td>
+<td align="left" headers="r6c1-t4 r1c3-t4">STREET</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblhruleinformal" --></li>
+</ol>
+<p>Notice that Dali will automatically map some fields to the correct database column (such as the <span class="bold">city</span> field to the CITY column) if the names are identical.</p>
+<p>Refer to the <a href="getting_started006.htm#BABCDECJ">Dali basic tutorial</a> to map a complete object model using basic and relational mappings.</p>
+</div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started006.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started006.htm
new file mode 100644
index 0000000000..f231c0d7c8
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started006.htm
@@ -0,0 +1,48 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Dali basic tutorial</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Dali basic tutorial" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABCDECJ" name="BABCDECJ"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Dali basic tutorial<a id="sthref21" name="sthref21"></a></h1>
+</td>
+</tr>
+</table>
+<p>In this tutorial, you will use Dali to map the object model of a company's HR application to track its employees. <a href="#BABIDCBA">Figure: Tutorial Object Model</a> illustrates the object model for the tutorial.</p>
+<div class="figure"><a id="BABIDCBA" name="BABIDCBA"></a>
+<p class="titleinfigure">Tutorial Object Model</p>
+<img src="img/tutorial_object_model.png" alt="This figure shows the object model for the tutorial." title="This figure shows the object model for the tutorial." /><br /></div>
+<!-- class="figure" -->
+<p>Next, you will <a href="getting_started007.htm#BABBBBID">Generate the tutorial database schema</a>.</p>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started007.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started007.htm
new file mode 100644
index 0000000000..22888904ed
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started007.htm
@@ -0,0 +1,215 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Generate the tutorial database schema</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Generate the tutorial database schema" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABBBBID" name="BABBBBID"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Generate the tutorial database schema</h1>
+</td>
+</tr>
+</table>
+<p>The tutorial application uses three database tables to store each employee's information: EMPLOYEE, ADDRESS and PHONE. <a href="#BABDEFDF">Table: Tutorial Database Schema</a> describes the columns for each table.</p>
+<p>You can download SQL scripts to build and populate the database tables with sample data from <code><a href="http://www.eclipse.org/webtools/dali/docs/dbscripts.zip">http://www.eclipse.org/webtools/dali/docs/dbscripts.zip</a></code>.</p>
+<div class="tblhruleformal"><a id="sthref22" name="sthref22"></a><a id="BABDEFDF" name="BABDEFDF"></a>
+<p class="titleintable">Tutorial Database Schema</p>
+<table class="HRuleFormal" title="Tutorial Database Schema" summary="This table lists the database schema." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t5">Table</th>
+<th align="left" valign="bottom" id="r1c2-t5">Column</th>
+<th align="left" valign="bottom" id="r1c3-t5">Type</th>
+<th align="left" valign="bottom" id="r1c4-t5">Details</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t5" headers="r1c1-t5" rowspan="5">
+<p>EMPLOYEE</p>
+</td>
+<td align="left" headers="r2c1-t5 r1c2-t5">
+<p>EMP_ID</p>
+</td>
+<td align="left" headers="r2c1-t5 r1c3-t5">
+<p>NUMBER(15)</p>
+</td>
+<td align="left" headers="r2c1-t5 r1c4-t5">
+<p>Primary Key</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t5" headers="r2c1-t5 r1c1-t5">
+<p>F_NAME</p>
+</td>
+<td align="left" headers="r2c1-t5 r3c1-t5 r1c2-t5">
+<p>VARCHAR(40)</p>
+</td>
+<td align="left" headers="r2c1-t5 r3c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t5" headers="r2c1-t5 r1c1-t5">
+<p>L_NAME</p>
+</td>
+<td align="left" headers="r2c1-t5 r4c1-t5 r1c2-t5">
+<p>VARCHAR(40)</p>
+</td>
+<td align="left" headers="r2c1-t5 r4c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t5" headers="r2c1-t5 r1c1-t5">
+<p>ADDR_ID</p>
+</td>
+<td align="left" headers="r2c1-t5 r5c1-t5 r1c2-t5">
+<p>NUMBER(15)</p>
+</td>
+<td align="left" headers="r2c1-t5 r5c1-t5 r1c3-t5">
+<p>Foreign Key, references ADDRESS.ADDRES_ID</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t5" headers="r2c1-t5 r1c1-t5">
+<p>VERSION</p>
+</td>
+<td align="left" headers="r2c1-t5 r6c1-t5 r1c2-t5">
+<p>NUMBER(15)</p>
+</td>
+<td align="left" headers="r2c1-t5 r6c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r7c1-t5" headers="r1c1-t5" rowspan="6">
+<p>ADDRESS</p>
+</td>
+<td align="left" headers="r7c1-t5 r1c2-t5">
+<p>ADDRESS_ID</p>
+</td>
+<td align="left" headers="r7c1-t5 r1c3-t5">
+<p>NUMBER(15)</p>
+</td>
+<td align="left" headers="r7c1-t5 r1c4-t5">
+<p>Primary Key</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r8c1-t5" headers="r7c1-t5 r1c1-t5">
+<p>PROVINCE</p>
+</td>
+<td align="left" headers="r7c1-t5 r8c1-t5 r1c2-t5">
+<p>VARCHAR(80)</p>
+</td>
+<td align="left" headers="r7c1-t5 r8c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r9c1-t5" headers="r7c1-t5 r1c1-t5">
+<p>COUNTRY</p>
+</td>
+<td align="left" headers="r7c1-t5 r9c1-t5 r1c2-t5">
+<p>VARCHAR(80)</p>
+</td>
+<td align="left" headers="r7c1-t5 r9c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r10c1-t5" headers="r7c1-t5 r1c1-t5">
+<p>STREET</p>
+</td>
+<td align="left" headers="r7c1-t5 r10c1-t5 r1c2-t5">
+<p>VARCHAR(80)</p>
+</td>
+<td align="left" headers="r7c1-t5 r10c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r11c1-t5" headers="r7c1-t5 r1c1-t5">
+<p>P_CODE</p>
+</td>
+<td align="left" headers="r7c1-t5 r11c1-t5 r1c2-t5">
+<p>VARCHAR(20)</p>
+</td>
+<td align="left" headers="r7c1-t5 r11c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r12c1-t5" headers="r7c1-t5 r1c1-t5">
+<p>CITY</p>
+</td>
+<td align="left" headers="r7c1-t5 r12c1-t5 r1c2-t5">
+<p>VARCHAR(80)</p>
+</td>
+<td align="left" headers="r7c1-t5 r12c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r13c1-t5" headers="r1c1-t5" rowspan="4">
+<p>PHONE</p>
+</td>
+<td align="left" headers="r13c1-t5 r1c2-t5">
+<p>EMP_ID</p>
+</td>
+<td align="left" headers="r13c1-t5 r1c3-t5">
+<p>NUMBER(15)</p>
+</td>
+<td align="left" headers="r13c1-t5 r1c4-t5">
+<p>Foreign Key, reference to EMPLOYEE.EMP_ID</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r14c1-t5" headers="r13c1-t5 r1c1-t5">
+<p>AREA_CODE</p>
+</td>
+<td align="left" headers="r13c1-t5 r14c1-t5 r1c2-t5">
+<p>VARCHAR(3)</p>
+</td>
+<td align="left" headers="r13c1-t5 r14c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r15c1-t5" headers="r13c1-t5 r1c1-t5">
+<p>P_NUMBER</p>
+</td>
+<td align="left" headers="r13c1-t5 r15c1-t5 r1c2-t5">
+<p>VARCHAR(7)</p>
+</td>
+<td align="left" headers="r13c1-t5 r15c1-t5 r1c3-t5">
+<p>Primary key</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r16c1-t5" headers="r13c1-t5 r1c1-t5">
+<p>TYPE</p>
+</td>
+<td align="left" headers="r13c1-t5 r16c1-t5 r1c2-t5">
+<p>VARCHAR(15)</p>
+</td>
+<td align="left" headers="r13c1-t5 r16c1-t5 r1c3-t5"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="tblhruleformal" -->
+<p>Next, you will <a href="getting_started008.htm#BABDHFCD">Create a database connection</a>.</p>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started008.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started008.htm
new file mode 100644
index 0000000000..0860ff17c3
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started008.htm
@@ -0,0 +1,52 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create a database connection</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create a database connection" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABDHFCD" name="BABDHFCD"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create a database connection</h1>
+</td>
+</tr>
+</table>
+<p>After creating the database you will need to create a database connection to use with the tutorial application. An active database connection is required to complete tutorial application.</p>
+<p>Use the <a href="../org.eclipse.wst.datatools.connection.ui.doc.user/topics/tconnecting_wiz.html">New Connection wizard</a> to create a database connection.</p>
+<div class="figure"><a id="sthref23" name="sthref23"></a>
+<p class="titleinfigure">Database Explorer</p>
+<img src="img/database_explorer.png" alt="This figure shows the Database Explorer." title="This figure shows the Database Explorer." /><br /></div>
+<!-- class="figure" -->
+<p>Now you're ready to <a href="getting_started009.htm#BABBBAIG">Create a JPA project</a>.</p>
+</div>
+<!-- class="sect3" -->
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started009.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started009.htm
new file mode 100644
index 0000000000..469f2debe3
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started009.htm
@@ -0,0 +1,68 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create a JPA project</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create a JPA project" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABBBAIG" name="BABBBAIG"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create a JPA project</h1>
+</td>
+</tr>
+</table>
+<p>In order to begin, you must create a new Java project.</p>
+<ol type="1" start="1">
+<li>
+<p>Select <span class="gui-object-action">File &gt; New &gt; Project</span>. The New Project dialog appears.</p>
+</li>
+<li>
+<p>On the <span class="gui-object-title">New Project</span> dialog, select <span class="gui-object-action">JPA &gt; JPA Project</span> and click <span class="gui-object-action">OK</span>. The New JPA Project dialog appears.</p>
+</li>
+<li>
+<p>On the <span class="gui-object-title">New JPA Project</span> dialog, enter <code>Employee</code> as the <span class="gui-object-action">Project name</span> and click <span class="gui-object-action">Next</span>. The Project Facets page appears.</p>
+</li>
+<li>
+<p>Verify that you have selected a Java 5.0 (or higher) and JPA 1.0 facet, and click <span class="bold">Next</span>. The JPA Facet page appears.</p>
+</li>
+<li>
+<p>Select your vender-specific platform, database connection, and JPA implementation library, and click <span class="bold">Finish</span>.</p>
+</li>
+</ol>
+<p>Eclipse adds the project to the workbench and opens the Java perspective.</p>
+<div class="figure"><a id="sthref24" name="sthref24"></a>
+<p class="titleinfigure">Persistence Perspective</p>
+<img src="img/persistence_perspective.png" alt="This figure shows the main parts of the Persistence Perspective: The Persistence Outline and Persistence Properties views." title="This figure shows the main parts of the Persistence Perspective: The Persistence Outline and Persistence Properties views." /><br /></div>
+<!-- class="figure" -->
+<p>The next step is to <a href="getting_started010.htm#BABIJIGF">Create persistent Java entities</a>.</p>
+</div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started010.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started010.htm
new file mode 100644
index 0000000000..8969dbef97
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started010.htm
@@ -0,0 +1,63 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create persistent Java entities</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create persistent Java entities" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABIJIGF" name="BABIJIGF"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create persistent Java entities</h1>
+</td>
+</tr>
+</table>
+<p>The <a href="getting_started006.htm#BABIDCBA">Tutorial Object Model</a> contains three entities: <span class="bold">Employee</span>, <span class="bold">Address</span>, and <span class="bold">PhoneNumber</span>. Use this procedure to add the entities to the project.</p>
+<ol type="1" start="1">
+<li>
+<p>Right-click the <span class="bold">Employee</span> project in the <span class="gui-object-title">Package Explorer</span> and select <span class="gui-object-action">New &gt; Class</span>. The New Java Class dialog appears.</p>
+</li>
+<li>
+<p>On the <span class="gui-object-title">Java Class</span> dialog, enter a package name (such as <code>dali.tutorial.model</code>), class name (such as <code>Employee</code>), and click <span class="gui-object-action">Finish</span>. Eclipse adds the Employee entity to the Package Explorer.</p>
+</li>
+<li>
+<p>Select the <code>Employee</code> entity in the JPA Structure view.</p>
+</li>
+<li>
+<p>In the JPA Details view, in the Map As field, select <span class="bold">Entity</span>. In the Table field, select the <span class="bold">EMPLOYEE</span> database table.</p>
+<div class="figure"><a id="sthref25" name="sthref25"></a>
+<p class="titleinfigure">Employee Entity in JPA Details View</p>
+<img src="img/address_jpa_details.png" alt="" title="" /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<p>Eclipse adds the <code>@Entity</code> annotation to the class. Repeat this procedure to add the <span class="bold">PhoneNumber</span> and <span class="bold">Address</span> entities.</p>
+<p>Notice that the Problems view reports several errors for each entity. We'll address these shortly.</p>
+<p>Next, you will <a href="getting_started011.htm#BABDCBDD">Add fields to the entities</a>.</p>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started011.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started011.htm
new file mode 100644
index 0000000000..ff4d793cb3
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started011.htm
@@ -0,0 +1,85 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Add fields to the entities</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Add fields to the entities" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABDCBDD" name="BABDCBDD"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Add fields to the entities</h1>
+</td>
+</tr>
+</table>
+<p>Before mapping the entities to the database, you must add the necessary fields to each entity.</p>
+<ol type="1" start="1">
+<li>
+<p>Add the following fields to the <span class="bold">Employee</span> entity:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+private Long id;
+private String firstNname;
+private String lastName;
+private String address;
+private List&lt;PhoneNumber&gt; phoneNumbers;
+private Long version;
+
+</pre></li>
+<li>
+<p>Import <span class="bold">java.util.List</span>.</p>
+</li>
+<li>
+<p>Generate Getters and Setters for each field.</p>
+</li>
+<li>
+<p>Add the following fields to the <span class="bold">Address</span> entity:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+private Long id;
+private String street;
+private String city;
+private String stateOrProvince;
+private String country;
+private String postalCode;
+
+</pre></li>
+<li>
+<p>Add the following fields to the <span class="bold">PhoneNumber</span> entity:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+private String type;
+private String areaCode;
+private String number;
+private Employee owner;
+
+</pre></li>
+</ol>
+<p>Next, you will <a href="getting_started012.htm#BABIHGGD">Associate the entity with a database table</a>.</p>
+</div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started012.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started012.htm
new file mode 100644
index 0000000000..74ec6ba02b
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started012.htm
@@ -0,0 +1,60 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Associate the entity with a database table</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Associate the entity with a database table" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABIHGGD" name="BABIHGGD"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Associate the entity with a database table</h1>
+</td>
+</tr>
+</table>
+<p>Now you must associate each entity with its primary database table.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="gui-object-action">Employee</span> class in the Explorer view.</p>
+</li>
+<li>
+<p>In the JPA Details view, notice that Dali has automatically selected the EMPLOYEE table as the table name.</p>
+<div class="figure"><a id="sthref26" name="sthref26"></a>
+<p class="titleinfigure">JPA Details View for the Employee Entity</p>
+<img src="img/persistence_view_employee.png" alt="This figure shows the Persistence Properties view for the Employee entity." title="This figure shows the Persistence Properties view for the Employee entity." /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<p>By default, Dali attempts to associate each entity with a similarly named database table. Notice that although you have not explicitly associated the <span class="bold">Address</span> entity yet, there is no error in the Problems view because the entity name, Address, is identical to the table name (ADDRESS).</p>
+<p>For the <span class="bold">PhoneNumber</span> entity, however, there is an error. This is because the entity name (PhoneNumber) is different than the database table (PHONE). You must explicitly associate the entity with the PHONE table. Dali adds the <code>@Table(name="PHONE")</code> annotation to the entity.</p>
+<p>Now you are ready to <a href="getting_started013.htm#BABEBGBC">Create OR mappings</a>.</p>
+</div>
+<!-- class="sect3" -->
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started013.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started013.htm
new file mode 100644
index 0000000000..739a55b50e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started013.htm
@@ -0,0 +1,64 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create OR mappings</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create OR mappings" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABEBGBC" name="BABEBGBC"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create OR mappings</h1>
+</td>
+</tr>
+</table>
+<p>Now you're ready to map the attributes of each persistent entity to columns in the appropriate database table. For the tutorial application, you will use the following mapping types:</p>
+<ul>
+<li type="disc">
+<p>ID mappings</p>
+</li>
+<li type="disc">
+<p>Basic mappings</p>
+</li>
+<li type="disc">
+<p>One-to-one mappings</p>
+</li>
+<li type="disc">
+<p>Many-to-one mappings</p>
+</li>
+<li type="disc">
+<p>One-to-many mappings</p>
+</li>
+<li type="disc">
+<p>Version mappings</p>
+</li>
+</ul>
+<p>Next, you will <a href="getting_started014.htm#BABGEFDI">Create ID mappings</a>.</p>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started014.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started014.htm
new file mode 100644
index 0000000000..7375f12d1f
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started014.htm
@@ -0,0 +1,132 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create ID mappings</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create ID mappings" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABGEFDI" name="BABGEFDI"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create ID mappings</h1>
+</td>
+</tr>
+</table>
+<p>Use an <span class="bold">ID Mapping</span> to specify the primary key of an entity. Each persistent entity must have an ID. Notice that the Problems view reports that each entity is missing an ID.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="bold">Employee</span> entity in the Package Explorer view.</p>
+</li>
+<li>
+<p>Expand the <span class="bold">Employee</span> entity in the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a> and select the <span class="bold">id</span> field. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">ID</span>.</p>
+<div class="figure"><a id="sthref27" name="sthref27"></a>
+<p class="titleinfigure">ID Mapping for emp_id Field</p>
+<img src="img/persistence_view_empid.png" alt="This figure shows the Persistence Properties page for the emp_id field." title="This figure shows the Persistence Properties page for the emp_id field." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Use this table to complete the remaining fields in the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t6">Property</th>
+<th align="left" valign="bottom" id="r1c2-t6">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t6" headers="r1c1-t6">Map As</td>
+<td align="left" headers="r2c1-t6 r1c2-t6">Defines this mapping as an <span class="bold">ID Mapping</span>. Dali adds the <code>@Id</code> annotation to the entity.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t6" headers="r1c1-t6">Column</td>
+<td align="left" headers="r3c1-t6 r1c2-t6">The database column for the primary key of the table associated with the entity. Select <span class="bold">EMP_ID</span>.
+<p>Because the database column (EMP_ID) is named differently than the entity field (id), Dali adds the <code>@Column(name="EMP_ID"</code>) annotation.</p>
+</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+<li>
+<p>Leave all other fields on the tab as their defaults. Expand the <span class="bold">Primary Key Generation</span> area.</p>
+<div class="figure"><a id="sthref28" name="sthref28"></a>
+<p class="titleinfigure">Primary Key Generation for emp_id Field</p>
+<img src="img/persistence_view_empid_pk.png" alt="This figure shows the Persistence Properties page for the emp_id field." title="This figure shows the Persistence Properties page for the emp_id field." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Use this table to complete the Primary Key Generation fields in the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t7">Property</th>
+<th align="left" valign="bottom" id="r1c2-t7">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t7" headers="r1c1-t7">Generated Value</td>
+<td align="left" headers="r2c1-t7 r1c2-t7">These fields define how the primary key is generated.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t7" headers="r1c1-t7">&nbsp;&nbsp;Strategy</td>
+<td align="left" headers="r3c1-t7 r1c2-t7">For the tutorial project, use the <span class="bold">Auto</span> option.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t7" headers="r1c1-t7">&nbsp;&nbsp;Generator&nbsp;Name</td>
+<td align="left" headers="r4c1-t7 r1c2-t7">Leave this field blank.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>In the JPA Structure view, the <span class="bold">id</span> field is identified as the primary key by the following icon:</p>
+<div class="figure"><a id="sthref29" name="sthref29"></a>
+<p class="titleinfigure">JPA Structure for Employee Entity</p>
+<img src="img/persistence_outline_empid.png" alt="This figure shows the emp_id attribute of the Employee entity in the Persistence Outline view." title="This figure shows the emp_id attribute of the Employee entity in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>Repeat this procedure to map the following primary keys (as shown in <a href="getting_started007.htm#BABDEFDF">Table: Tutorial Database Schema</a>):</p>
+<ul>
+<li type="disc">
+<p>The <span class="bold">id</span> field of the <span class="bold">Address</span> entity to the ADDRESS_ID column of the ADDRESS table.</p>
+</li>
+<li type="disc">
+<p>The <span class="bold">number</span> field of the <span class="bold">PhoneNumber</span> entity to the P_NUMBER column of the PHONE table.</p>
+</li>
+</ul>
+<p>Next, you will <a href="getting_started015.htm#BABEEFJA">Create basic mappings</a>.</p>
+</div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started015.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started015.htm
new file mode 100644
index 0000000000..7c6f4b69c2
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started015.htm
@@ -0,0 +1,133 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create basic mappings</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create basic mappings" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABEEFJA" name="BABEEFJA"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create basic mappings</h1>
+</td>
+</tr>
+</table>
+<p>Use a <span class="bold">Basic Mapping</span> to map an attribute directly to a database column. In the <a href="getting_started006.htm#BABIDCBA">Tutorial Object Model</a>, the <span class="bold">firstName</span> field of the <span class="bold">Employee</span> class maps directly to the F_NAME column of the EMPLOYEE database table.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="bold">Employee</span> entity in the Package Explorer view.</p>
+</li>
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the <span class="bold">firstName</span> field of the <span class="bold">Employee</span> entity. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Basic</span>. In the Column field, select <span class="bold">F_NAME</span>.</p>
+<div class="figure"><a id="sthref30" name="sthref30"></a>
+<p class="titleinfigure">Basic Mapping for firstName</p>
+<img src="img/persistence_view_firstname.png" alt="This figure shows the Persistence Properties page for the firstName field." title="This figure shows the Persistence Properties page for the firstName field." /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<p>Dali adds the <code>@Column(name="F_NAME")</code> annotation to the entity. In the JPA Structure, the <span class="bold">firstName</span> field is identified as a basic mapping as shown in the following figure:</p>
+<div class="figure"><a id="sthref31" name="sthref31"></a>
+<p class="titleinfigure">JPA Structure for Employee Entity</p>
+<img src="img/persistence_outline_fname.png" alt="This figure shows the firstName attribute of the Employee entity in the Persistence Outline view." title="This figure shows the firstName attribute of the Employee entity in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>Repeat this procedure to map each of the following fields as <span class="bold">Basic</span> mappings:</p>
+<ul>
+<li type="disc">
+<p>Employee entity</p>
+<ul>
+<li type="circle">
+<p><span class="bold">lastName</span> field to L_NAME column</p>
+</li>
+</ul>
+</li>
+<li type="disc">
+<p>Address Entity</p>
+<ul>
+<li type="circle">
+<p><span class="bold">city</span> field to CITY column</p>
+</li>
+<li type="circle">
+<p><span class="bold">country</span> field to COUNTRY column</p>
+</li>
+<li type="circle">
+<p><span class="bold">postalCode</span> field to P_CODE column</p>
+</li>
+<li type="circle">
+<p><span class="bold">stateOrProvice</span> field to PROVINCE column</p>
+</li>
+<li type="circle">
+<p><span class="bold">street</span> field to STREET column</p>
+</li>
+</ul>
+<div align="center">
+<div class="inftblnote"><br />
+<table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
+<tbody>
+<tr>
+<td align="left">
+<p class="notep1">Note:</p>
+Because the <span class="bold">city</span>, <span class="bold">country</span>, and <span class="bold">street</span> fields are named identically to their database columns, Dali automatically maps the fields; no annotations are required.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblnote" --></div>
+</li>
+<li type="disc">
+<p>Phone Entity</p>
+<ul>
+<li type="circle">
+<p><span class="bold">areaCode</span> field to AREA_CODE column</p>
+</li>
+<li type="circle">
+<p><span class="bold">type</span> field to TYPE column</p>
+</li>
+</ul>
+<div align="center">
+<div class="inftblnote"><br />
+<table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
+<tbody>
+<tr>
+<td align="left">
+<p class="notep1">Note:</p>
+Because the <span class="bold">type</span> field is named identically to its database column, Dali automatically maps the field. No annotation is required.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblnote" --></div>
+</li>
+</ul>
+<p>Next, you will <a href="getting_started016.htm#BABGBGHF">Create one-to-one mappings</a>.</p>
+</div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started016.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started016.htm
new file mode 100644
index 0000000000..6b407d710c
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started016.htm
@@ -0,0 +1,92 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create one-to-one mappings</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create one-to-one mappings" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABGBGHF" name="BABGBGHF"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create one-to-one mappings</h1>
+</td>
+</tr>
+</table>
+<p>Use a <span class="bold">One-to-One Mapping</span> to define a relationship from an attribute to another class, with one-to-one multiplicity to a database column. In the <a href="getting_started006.htm#BABIDCBA">Tutorial Object Model</a>, the <span class="bold">address</span> field of the <span class="bold">Employee</span> class has a one-to-one relationship to the <span class="bold">Address</span> class; each employee may have a single address.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="bold">Employee</span> entity in the Package Explorer view.</p>
+</li>
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the <span class="bold">address</span> field of the <span class="bold">Employee</span> entity. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">One-to-One</span>.</p>
+<div class="figure"><a id="sthref32" name="sthref32"></a>
+<p class="titleinfigure">One-to-one Mapping for address</p>
+<img src="img/persistence_view_onetoone.png" alt="This figure shows the Persistence Properties page for the address field." title="This figure shows the Persistence Properties page for the address field." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>For the Target Entity, click <span class="bold">Browse</span> and select the <span class="bold">Address</span> persistent entity. Dali adds the <code>@OneToOne(targetEntity=dali.tutorial.model.Address.class)</code> entity to the class.</p>
+<p>Leave the other fields with their default values.</p>
+</li>
+<li>
+<p>Select the <span class="bold">Join Columns</span> tab to specify the relationship between the Employee and Address entities. Because you had to explicitly define the ID field for the Address entity in its ID mapping, you will need to edit the default join relationship.</p>
+</li>
+<li>
+<p>Select the <span class="bold">Override Default</span> option.</p>
+</li>
+<li>
+<p>Select the <span class="bold">address_ADDRESS_ID -&gt; ADDRESS_ID</span> relationship in the <span class="gui-object-title">Join Columns</span> area and click <span class="bold">Edit</span>.</p>
+</li>
+<li>
+<p>In the Edit Join Column dialog, select the following options and click <span class="bold">OK</span>.</p>
+<ul>
+<li type="disc">
+<p>Name: <span class="bold">ADDR_ID</span> (from the EMPLOYEE table)</p>
+</li>
+<li type="disc">
+<p>Referenced Column Name: <span class="bold">ADDRESS_ID</span> (from the ADDRESS table)</p>
+</li>
+</ul>
+<div class="figure"><a id="sthref33" name="sthref33"></a>
+<p class="titleinfigure">Editing Join Column for Address Mapping</p>
+<img src="img/edit_join_column_dialog.png" alt="This figure shows the Edit Join Column dialog for the address 1:1 mapping." title="This figure shows the Edit Join Column dialog for the address 1:1 mapping." /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<p>In the JPA Structure, the <span class="bold">address</span> field is identified as a one-to-one mapping, as shown in the following figure:</p>
+<div class="figure"><a id="sthref34" name="sthref34"></a>
+<p class="titleinfigure">JPA Structure for Employee Entity</p>
+<img src="img/persistence_outline_address.png" alt="This figure shows the address attribute of the Employee entity in the Persistence Outline view." title="This figure shows the address attribute of the Employee entity in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>Next, you will <a href="getting_started017.htm#BABBEHEG">Create one-to-many mappings</a>.</p>
+</div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started017.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started017.htm
new file mode 100644
index 0000000000..b32513556c
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started017.htm
@@ -0,0 +1,71 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create one-to-many mappings</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create one-to-many mappings" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABBEHEG" name="BABBEHEG"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create one-to-many mappings</h1>
+</td>
+</tr>
+</table>
+<p>Use a <span class="bold">One-to-Many Mapping</span> to define a relationship from an attribute to another class, with one-to-many multiplicity to a database column. In the <a href="getting_started006.htm#BABIDCBA">Tutorial Object Model</a>, the <span class="bold">phoneNumbers</span> field of the <span class="bold">Employee</span> class has a one-to-many relationship to the <span class="bold">Phone</span> class; each employee may have many phone numbers.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="bold">Employee</span> entity in the Package Explorer view.</p>
+</li>
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the <span class="bold">phoneNumber</span> field of the <span class="bold">Employee</span> entity. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">One-to-Many</span>.</p>
+<div class="figure"><a id="sthref35" name="sthref35"></a>
+<p class="titleinfigure">One-to-many Mapping for phoneNumbers</p>
+<img src="img/persistence_view_onetomany.png" alt="This figure shows the Persistence Properties page for the phoneNumbers field." title="This figure shows the Persistence Properties page for the phoneNumbers field." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Select <span class="bold">PhoneNumber</span> as the Target Entity. Leave the other fields with their default values.</p>
+</li>
+<li>
+<p>In the Join Table area, notice that Dali has selected the correct joins, based on the foreign key associations in the database tables.</p>
+</li>
+</ol>
+<p>In the JPA Structure, the <span class="bold">phoneNumbers</span> field is identified as a one-to-many mapping as shown in the following figure:</p>
+<div class="figure"><a id="sthref36" name="sthref36"></a>
+<p class="titleinfigure">JPA Structure for Employee Entity</p>
+<img src="img/persistence_outline_phone.png" alt="This figure shows the phoneNumbers attribute of the Employee entity in the Persistence Outline view." title="This figure shows the phoneNumbers attribute of the Employee entity in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>Next, you will <a href="getting_started018.htm#BABCHIHI">Create many-to-one mappings</a>.</p>
+</div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started018.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started018.htm
new file mode 100644
index 0000000000..93ea9d8163
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started018.htm
@@ -0,0 +1,89 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create many-to-one mappings</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create many-to-one mappings" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABCHIHI" name="BABCHIHI"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create many-to-one mappings</h1>
+</td>
+</tr>
+</table>
+<p>Use a <span class="bold">May-to-One Mapping</span> to define a relationship from an attribute to another class, with many-to-one multiplicity to a database column. In the <a href="getting_started006.htm#BABIDCBA">Tutorial Object Model</a>, the <span class="bold">owner</span> field of the <span class="bold">PhoneNumber</span> class has a one-to-many relationship to the <span class="bold">Employee</span> class; there are many phone numbers that each employee may have.</p>
+<p>This is the "back mapping" of the one-to-many mapping you previously defined.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="bold">PhoneNumber</span> entity in the Package Explorer view.</p>
+</li>
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the <span class="bold">owner</span> field of the <span class="bold">PhoneNumber</span> entity. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Many to One</span>.</p>
+<div class="figure"><a id="sthref37" name="sthref37"></a>
+<p class="titleinfigure">Many to One Mapping for owner</p>
+<img src="img/persistence_view_manytoone.png" alt="This figure shows the Persistence Properties page for the owner field." title="This figure shows the Persistence Properties page for the owner field." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Leave the other fields with their default values. Dali correctly completes the information based on the database structure and previously defined mappings.</p>
+</li>
+<li>
+<p>Use the <span class="bold">Join Columns</span> area to specify the relationship between the PhoneNumber and Employee entities. Because you had to explicitly define the ID field for the Employee entity in its ID mapping, you will need to edit the default join relationship.</p>
+</li>
+<li>
+<p>Select the <span class="bold">Override Default</span> option.</p>
+</li>
+<li>
+<p>Select the <span class="bold">owner_EMP_ID -&gt; EMP_ID</span> relationship in the <span class="gui-object-title">Join Columns</span> area and click <span class="bold">Edit</span>.</p>
+</li>
+<li>
+<p>In the Edit Join Column dialog, select the following options and click <span class="bold">OK</span>.</p>
+<ul>
+<li type="disc">
+<p>Name: <span class="bold">EMP_ID</span> (from the PHONE table)</p>
+</li>
+<li type="disc">
+<p>Referenced Column Name: <span class="bold">EMP_ID</span> (from the EMPLOYEE table)</p>
+</li>
+</ul>
+</li>
+</ol>
+<p>In the JPA Structure, the <span class="bold">owner</span> field is identified as a many-to-one mapping as shown in the following figure:</p>
+<div class="figure"><a id="sthref38" name="sthref38"></a>
+<p class="titleinfigure">JPA Structure for PhoneNumber Entity</p>
+<img src="img/persistence_outline_owner.png" alt="This figure shows the owner attribute of the PhoneNumber entity in the Persistence Outline view." title="This figure shows the owner attribute of the PhoneNumber entity in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>Next, you will <a href="getting_started019.htm#BABIDFFG">Create version mappings</a></p>
+</div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started019.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started019.htm
new file mode 100644
index 0000000000..152da137af
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started019.htm
@@ -0,0 +1,67 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create version mappings</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create version mappings" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABIDFFG" name="BABIDFFG"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create version mappings</h1>
+</td>
+</tr>
+</table>
+<p>Use a <span class="bold">Version Mapping</span> to specify the database field used by a persistent entity for optimistic locking.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="bold">Employee</span> entity in the Package Explorer view.</p>
+</li>
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the <span class="bold">version</span> field of the <span class="bold">Employee</span> entity. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Version</span>.</p>
+<div class="figure"><a id="sthref39" name="sthref39"></a>
+<p class="titleinfigure">Version Mapping for version</p>
+<img src="img/persistence_view_version.png" alt="This figure shows the Persistence Properties page for the version field." title="This figure shows the Persistence Properties page for the version field." /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<p>Dali automatically selects the Version column in the EMPLOYEE database table. In the JPA Structure, the <span class="bold">Version</span> field is identified as a version mapping, as shown in the following figure:</p>
+<div class="figure"><a id="sthref40" name="sthref40"></a>
+<p class="titleinfigure">JPA Structure for Employee Entity</p>
+<img src="img/persistence_outline_version.png" alt="This figure shows the version attribute of the Employee entity in the Persistence Outline view." title="This figure shows the version attribute of the Employee entity in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>Congratulations! All of the entities have been successfully mapped.</p>
+</div>
+<!-- class="sect3" -->
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/add_persistence_dialog_xml.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/add_persistence_dialog_xml.png
new file mode 100644
index 0000000000..fd53486c09
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/add_persistence_dialog_xml.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/address_java_open.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/address_java_open.png
new file mode 100644
index 0000000000..7da0417133
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/address_java_open.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/address_jpa_details.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/address_jpa_details.png
new file mode 100644
index 0000000000..00e25f78fb
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/address_jpa_details.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/address_jpa_structure.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/address_jpa_structure.png
new file mode 100644
index 0000000000..a18a65652c
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/address_jpa_structure.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/button_jpa_perspective.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/button_jpa_perspective.png
new file mode 100644
index 0000000000..e0a957185e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/button_jpa_perspective.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/database_explorer.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/database_explorer.png
new file mode 100644
index 0000000000..435be3dcc1
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/database_explorer.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/details_entitymappings.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/details_entitymappings.png
new file mode 100644
index 0000000000..5bd48850fd
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/details_entitymappings.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/edit_join_column_dialog.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/edit_join_column_dialog.png
new file mode 100644
index 0000000000..46c5d5ca0b
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/edit_join_column_dialog.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/error_sample.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/error_sample.png
new file mode 100644
index 0000000000..3a4964632c
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/error_sample.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl.png
new file mode 100644
index 0000000000..3040dba5d1
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_objects.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_objects.png
new file mode 100644
index 0000000000..f81031fdc7
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_objects.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_options.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_options.png
new file mode 100644
index 0000000000..cea3a6ca20
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_options.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_save.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_save.png
new file mode 100644
index 0000000000..e5963955ff
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_save.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_summary.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_summary.png
new file mode 100644
index 0000000000..5ead4a82b0
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_ddl_summary.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_entities.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_entities.png
new file mode 100644
index 0000000000..e3cb22b69a
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/generate_entities.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_11mapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_11mapping.png
new file mode 100644
index 0000000000..6944826370
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_11mapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_1mmapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_1mmapping.png
new file mode 100644
index 0000000000..69d3193a5e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_1mmapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_basicmapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_basicmapping.png
new file mode 100644
index 0000000000..b193753e98
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_basicmapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddable.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddable.png
new file mode 100644
index 0000000000..645922c306
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddable.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddedidmapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddedidmapping.png
new file mode 100644
index 0000000000..0587544e2d
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddedidmapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddedmapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddedmapping.png
new file mode 100644
index 0000000000..4bef3567ed
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_embeddedmapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_idmapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_idmapping.png
new file mode 100644
index 0000000000..2b2a94becd
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_idmapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_m1mapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_m1mapping.png
new file mode 100644
index 0000000000..a77a01ba6d
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_m1mapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_mmmapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_mmmapping.png
new file mode 100644
index 0000000000..5d5fd1c145
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_mmmapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_nonpersistent.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_nonpersistent.png
new file mode 100644
index 0000000000..001ef86ee2
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_nonpersistent.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_persistent.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_persistent.png
new file mode 100644
index 0000000000..7ea0b1d53e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_persistent.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_superclass.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_superclass.png
new file mode 100644
index 0000000000..952f11d131
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_superclass.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_transientmapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_transientmapping.png
new file mode 100644
index 0000000000..1a70dd9e68
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_transientmapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_versionmapping.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_versionmapping.png
new file mode 100644
index 0000000000..aa7e0a6f15
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/icon_versionmapping.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_join.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_join.png
new file mode 100644
index 0000000000..22b6875f4d
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_join.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_single.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_single.png
new file mode 100644
index 0000000000..3146482609
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_single.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_tab.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_tab.png
new file mode 100644
index 0000000000..a9d721fcc4
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/inheritance_tab.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/java_editor_address.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/java_editor_address.png
new file mode 100644
index 0000000000..ff7eaa63b0
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/java_editor_address.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/jpa_facet_dialog.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/jpa_facet_dialog.png
new file mode 100644
index 0000000000..a5478f2079
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/jpa_facet_dialog.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/new_jpa_project_dialog.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/new_jpa_project_dialog.png
new file mode 100644
index 0000000000..0fb14b17e1
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/new_jpa_project_dialog.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelc.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelc.png
new file mode 100644
index 0000000000..88381a5a80
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelc.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelr.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelr.png
new file mode 100644
index 0000000000..4bbc744806
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelr.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelt.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelt.png
new file mode 100644
index 0000000000..60af21f5ea
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/ngrelt.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/open_persistence_editor.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/open_persistence_editor.png
new file mode 100644
index 0000000000..b37937c5b4
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/open_persistence_editor.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_address.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_address.png
new file mode 100644
index 0000000000..bd9351ce90
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_address.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_empid.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_empid.png
new file mode 100644
index 0000000000..90d889fb4f
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_empid.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_entity.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_entity.png
new file mode 100644
index 0000000000..bbcbb52d28
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_entity.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_fields.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_fields.png
new file mode 100644
index 0000000000..5a41682f77
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_fields.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_fname.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_fname.png
new file mode 100644
index 0000000000..3b8b032dc2
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_fname.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_owner.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_owner.png
new file mode 100644
index 0000000000..f24fe486b9
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_owner.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_phone.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_phone.png
new file mode 100644
index 0000000000..25aca17350
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_phone.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_version.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_version.png
new file mode 100644
index 0000000000..4ba483ed2a
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_version.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_view.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_view.png
new file mode 100644
index 0000000000..769aa825e5
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_outline_view.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_perspective.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_perspective.png
new file mode 100644
index 0000000000..f92ea6422b
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_perspective.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_address.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_address.png
new file mode 100644
index 0000000000..4d40d2be80
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_address.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_addressid.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_addressid.png
new file mode 100644
index 0000000000..2e03fab562
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_addressid.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_embedded.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_embedded.png
new file mode 100644
index 0000000000..91affa5e47
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_embedded.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_empid.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_empid.png
new file mode 100644
index 0000000000..7fe19fa16e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_empid.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_empid_pk.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_empid_pk.png
new file mode 100644
index 0000000000..6df4466f59
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_empid_pk.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_employee.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_employee.png
new file mode 100644
index 0000000000..26ec279d21
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_employee.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_entity.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_entity.png
new file mode 100644
index 0000000000..0a7685ae3f
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_entity.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_firstname.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_firstname.png
new file mode 100644
index 0000000000..71b7c2603a
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_firstname.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_manytoone.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_manytoone.png
new file mode 100644
index 0000000000..afc9cd5f88
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_manytoone.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_mappedsprc.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_mappedsprc.png
new file mode 100644
index 0000000000..ceb79d9623
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_mappedsprc.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_onetomany.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_onetomany.png
new file mode 100644
index 0000000000..7ffd15c094
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_onetomany.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_onetoone.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_onetoone.png
new file mode 100644
index 0000000000..d976f89dce
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_onetoone.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_version.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_version.png
new file mode 100644
index 0000000000..de548de4e1
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_view_version.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_xml_editor.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_xml_editor.png
new file mode 100644
index 0000000000..b14dc15936
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/persistence_xml_editor.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/properties_persistence.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/properties_persistence.png
new file mode 100644
index 0000000000..525e918221
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/properties_persistence.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/quickstart_project.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/quickstart_project.png
new file mode 100644
index 0000000000..c7c066427e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/quickstart_project.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/synchornize_classes.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/synchornize_classes.png
new file mode 100644
index 0000000000..bede63b968
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/synchornize_classes.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/table_entity.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/table_entity.png
new file mode 100644
index 0000000000..1aa1dbe059
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/table_entity.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/tutorial_object_model.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/tutorial_object_model.png
new file mode 100644
index 0000000000..eb25d7d6fb
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/tutorial_object_model.png
Binary files differ
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/index.xml b/jpa/plugins/org.eclipse.jpt.doc.user/index.xml
new file mode 100644
index 0000000000..61597df154
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/index.xml
@@ -0,0 +1,540 @@
+<?xml version='1.0' encoding='iso-8859-1'?>
+<index version="1.0">
+ <entry keyword="@Basic">
+ <entry keyword="Basic mapping"><topic href="tasks007.htm#sthref112" />
+ </entry>
+ <entry keyword="@Column">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref207" />
+ </entry>
+ <entry keyword="@DiscriminatorColumn">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref99" />
+ </entry>
+ <entry keyword="@DiscriminatorValue">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref101" />
+ </entry>
+ <entry keyword="@Embeddable">
+ <entry keyword="Embeddable"><topic href="tasks005.htm#sthref86" />
+ </entry>
+ <entry keyword="@Embedded">
+ <entry keyword="Embedded mapping"><topic href="tasks008.htm#sthref116" />
+ </entry>
+ <entry keyword="@EmbeddedId">
+ <entry keyword="Embedded ID mapping"><topic href="tasks009.htm#sthref120" />
+ </entry>
+ <entry keyword="@Entity">
+ <entry keyword="Entity"><topic href="tasks004.htm#sthref80" />
+ </entry>
+ <entry keyword="@GeneratedValue">
+ <entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref223" />
+ </entry>
+ <entry keyword="@Id">
+ <entry keyword="ID mapping"><topic href="tasks010.htm#sthref124" />
+ </entry>
+ <entry keyword="@Inheritance">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref97" />
+ </entry>
+ <entry keyword="@JoinColumn">
+ <entry keyword="Many-to-one mapping"><topic href="tasks012.htm#sthref135" />
+ <entry keyword="One-to-one mapping"><topic href="tasks014.htm#sthref145" />
+ <entry keyword="Join Table Information"><topic href="reference005.htm#sthref220" />
+ <entry keyword="Join Columns Information"><topic href="reference006.htm#sthref222" />
+ </entry>
+ <entry keyword="@Lob">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref212" />
+ </entry>
+ <entry keyword="@ManyToMany">
+ <entry keyword="Many-to-many mapping"><topic href="tasks011.htm#sthref128" />
+ </entry>
+ <entry keyword="@ManyToOne">
+ <entry keyword="Many-to-one mapping"><topic href="tasks012.htm#sthref133" />
+ </entry>
+ <entry keyword="@MappedSuperclass">
+ <entry keyword="Mapped superclass"><topic href="tasks006.htm#sthref92" />
+ </entry>
+ <entry keyword="@OneToMany">
+ <entry keyword="One-to-many mapping"><topic href="tasks013.htm#sthref138" />
+ </entry>
+ <entry keyword="@OneToOne">
+ <entry keyword="One-to-one mapping"><topic href="tasks014.htm#sthref142" />
+ </entry>
+ <entry keyword="@SequenceGenerator">
+ <entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref225" />
+ </entry>
+ <entry keyword="@Transient">
+ <entry keyword="Transient mapping"><topic href="tasks015.htm#sthref148" />
+ </entry>
+ <entry keyword="@Version">
+ <entry keyword="Version mapping"><topic href="tasks016.htm#sthref152" />
+ </entry>
+ <entry keyword="@Temporal">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref214" />
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref216" />
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref218" />
+ </entry>
+ <entry keyword="architecture of Dali feature">
+ <entry keyword="Dali Developer Documentation"><topic href="reference018.htm#sthref249" />
+ </entry>
+ <entry keyword="attributes">
+ <entry keyword="mapping">
+ <entry keyword="Understanding OR mappings"><topic href="concept_mapping.htm#sthref44" />
+ </entry>
+ <entry keyword="Persistence Properties view">
+ <entry keyword="JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref206" />
+ </entry>
+ </entry>
+ <entry keyword="basic mapping">
+ <entry keyword="@Basic">
+ <entry keyword="Basic mapping"><topic href="tasks007.htm#sthref113" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Basic mapping"><topic href="tasks007.htm#sthref111" />
+ </entry>
+ </entry>
+ <entry keyword="classes">
+ <entry keyword="adding persistence to">
+ <entry keyword="Adding persistence to a class"><topic href="task_add_persistence.htm#sthref75" />
+ </entry>
+ <entry keyword="embeddable">
+ <entry keyword="Embeddable"><topic href="tasks005.htm#sthref85" />
+ </entry>
+ <entry keyword="entity">
+ <entry keyword="Entity"><topic href="tasks004.htm#sthref78" />
+ </entry>
+ <entry keyword="synchronizing">
+ <entry keyword="Synchronizing classes"><topic href="tasks002.htm#sthref65" />
+ </entry>
+ </entry>
+ <entry keyword="columns">
+ <entry keyword="discriminator">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref100" />
+ </entry>
+ <entry keyword="join">
+ <entry keyword="Many-to-one mapping"><topic href="tasks012.htm#sthref134" />
+ <entry keyword="One-to-one mapping"><topic href="tasks014.htm#sthref144" />
+ <entry keyword="Join Table Information"><topic href="reference005.htm#sthref219" />
+ <entry keyword="Join Columns Information"><topic href="reference006.htm#sthref221" />
+ </entry>
+ <entry keyword="mapping to">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref208" />
+ </entry>
+ <entry keyword="value">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref102" />
+ </entry>
+ </entry>
+ <entry keyword="Database Connection dialog">
+ <entry keyword="Database Connection Dialog"><topic href="reference013.htm#sthref243" />
+ </entry>
+ <entry keyword="database tables">
+ <entry keyword="generating entities from">
+ <entry keyword="Generating entities from tables"><topic href="tasks017.htm#sthref158" />
+ </entry>
+ <entry keyword="generating from entities">
+ <entry keyword="Generating tables (DDL scripts) from entities"><topic href="task_generate_ddl.htm#sthref161" />
+ </entry>
+ </entry>
+ <entry keyword="database - persistence">
+ <entry keyword="connection">
+ <entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref235" />
+ </entry>
+ <entry keyword="schema">
+ <entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref237" />
+ </entry>
+ </entry>
+ <entry keyword="developer documentation">
+ <entry keyword="Dali Developer Documentation"><topic href="reference018.htm#sthref248" />
+ </entry>
+ <entry keyword="eager fetch">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref210" />
+ </entry>
+ <entry keyword="embeddable class">
+ <entry keyword="@Embeddable">
+ <entry keyword="Embeddable"><topic href="tasks005.htm#sthref87" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Embeddable"><topic href="tasks005.htm#sthref84" />
+ </entry>
+ </entry>
+ <entry keyword="embedded ID mapping">
+ <entry keyword="@EmbeddedId">
+ <entry keyword="Embedded ID mapping"><topic href="tasks009.htm#sthref121" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Embedded ID mapping"><topic href="tasks009.htm#sthref119" />
+ </entry>
+ </entry>
+ <entry keyword="embedded mapping">
+ <entry keyword="@Embedded">
+ <entry keyword="Embedded mapping"><topic href="tasks008.htm#sthref117" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Embedded mapping"><topic href="tasks008.htm#sthref115" />
+ </entry>
+ </entry>
+ <entry keyword="entities">
+ <entry keyword="@Entity annotation">
+ <entry keyword="Entity"><topic href="tasks004.htm#sthref81" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Understanding Java persistence"><topic href="concept_persistence.htm#sthref43" />
+ </entry>
+ <entry keyword="creating tables from">
+ <entry keyword="Generating tables (DDL scripts) from entities"><topic href="task_generate_ddl.htm#sthref160" />
+ </entry>
+ <entry keyword="embeddable">
+ <entry keyword="Embeddable"><topic href="tasks005.htm#sthref88" />
+ </entry>
+ <entry keyword="from tables">
+ <entry keyword="Generating entities from tables"><topic href="tasks017.htm#sthref154" />
+ <entry keyword="Generate Entities from Tables dialog"><topic href="task_generate_entities.htm#sthref241" />
+ </entry>
+ <entry keyword="mapped superclass">
+ <entry keyword="Mapped superclass"><topic href="tasks006.htm#sthref93" />
+ </entry>
+ <entry keyword="mapping">
+ <entry keyword="Mapping an entity"><topic href="getting_started005.htm#sthref18" />
+ </entry>
+ <entry keyword="persistence">
+ <entry keyword="Creating a Java persistent entity"><topic href="getting_started004.htm#sthref10" />
+ </entry>
+ <entry keyword="Persistence Properties view">
+ <entry keyword="JPA Details view (for entities)"><topic href="ref_persistence_prop_view.htm#sthref201" />
+ </entry>
+ <entry keyword="persistent">
+ <entry keyword="Entity"><topic href="tasks004.htm#sthref76" />
+ <entry keyword="Entity"><topic href="tasks004.htm#sthref82" />
+ </entry>
+ </entry>
+ <entry keyword="enumerated">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref215" />
+ </entry>
+ <entry keyword="error messages - Dali">
+ <entry keyword="Validating mappings and reporting problems"><topic href="tasks018.htm#sthref166" />
+ <entry keyword="Error messages"><topic href="tasks019.htm#sthref171" />
+ </entry>
+ <entry keyword="extension points - Dali feature">
+ <entry keyword="Dali Developer Documentation"><topic href="reference018.htm#sthref250" />
+ </entry>
+ <entry keyword="fetch type">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref209" />
+ </entry>
+ <entry keyword="Generate Entities from Tables dialog">
+ <entry keyword="Generating entities from tables"><topic href="tasks017.htm#sthref157" />
+ <entry keyword="Generate Entities from Tables dialog"><topic href="task_generate_entities.htm#sthref240" />
+ </entry>
+ <entry keyword="generated values">
+ <entry keyword="ID mappings">
+ <entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref224" />
+ </entry>
+ <entry keyword="sequence">
+ <entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref226" />
+ </entry>
+ </entry>
+ <entry keyword="ID mapping">
+ <entry keyword="@Id">
+ <entry keyword="ID mapping"><topic href="tasks010.htm#sthref125" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="ID mapping"><topic href="tasks010.htm#sthref123" />
+ </entry>
+ </entry>
+ <entry keyword="inheritance">
+ <entry keyword="entity">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref96" />
+ <entry keyword="Inheritance information"><topic href="reference004.htm#sthref203" />
+ </entry>
+ <entry keyword="joined tables">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref108" />
+ </entry>
+ <entry keyword="single table">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref103" />
+ </entry>
+ </entry>
+ <entry keyword="Inheritance tab">
+ <entry keyword="Inheritance information"><topic href="reference004.htm#sthref202" />
+ </entry>
+ <entry keyword="installation - Dali">
+ <entry keyword="Requirements and installation"><topic href="getting_started001.htm#sthref3" />
+ </entry>
+ <entry keyword="joined tables - inheritance">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref109" />
+ </entry>
+ <entry keyword="JPA">
+ <entry keyword="platform">
+ <entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref234" />
+ </entry>
+ </entry>
+ <entry keyword="JPA Facet dialog">
+ <entry keyword="Creating a new JPA project"><topic href="task_create_new_project.htm#sthref56" />
+ </entry>
+ <entry keyword="JPA perspective">
+ <entry keyword="JPA perspective"><topic href="ref_persistence_perspective.htm#sthref244" />
+ </entry>
+ <entry keyword="JPA project">
+ <entry keyword="creating new">
+ <entry keyword="Creating a new JPA project"><topic href="task_create_new_project.htm#sthref50" />
+ </entry>
+ </entry>
+ <entry keyword="JPA Project dialog">
+ <entry keyword="Creating a new JPA project"><topic href="task_create_new_project.htm#sthref54" />
+ </entry>
+ <entry keyword="lazy fetch">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref211" />
+ </entry>
+ <entry keyword="many-to-many mapping">
+ <entry keyword="@ManyToMany">
+ <entry keyword="Many-to-many mapping"><topic href="tasks011.htm#sthref129" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Many-to-many mapping"><topic href="tasks011.htm#sthref127" />
+ </entry>
+ </entry>
+ <entry keyword="many-to-one mapping">
+ <entry keyword="@ManyToOne">
+ <entry keyword="Many-to-one mapping"><topic href="tasks012.htm#sthref132" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Many-to-one mapping"><topic href="tasks012.htm#sthref131" />
+ </entry>
+ </entry>
+ <entry keyword="mapped superclass">
+ <entry keyword="@MappedSuperclass">
+ <entry keyword="Mapped superclass"><topic href="tasks006.htm#sthref91" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Mapped superclass"><topic href="tasks006.htm#sthref90" />
+ </entry>
+ </entry>
+ <entry keyword="mapping entities">
+ <entry keyword="Mapping an entity"><topic href="getting_started005.htm#sthref17" />
+ </entry>
+ <entry keyword="mappings">
+ <entry keyword="about">
+ <entry keyword="Understanding OR mappings"><topic href="concept_mapping.htm#sthref45" />
+ </entry>
+ <entry keyword="basic">
+ <entry keyword="Basic mapping"><topic href="tasks007.htm#sthref110" />
+ </entry>
+ <entry keyword="embedded">
+ <entry keyword="Embedded mapping"><topic href="tasks008.htm#sthref114" />
+ </entry>
+ <entry keyword="embedded ID">
+ <entry keyword="Embedded ID mapping"><topic href="tasks009.htm#sthref118" />
+ </entry>
+ <entry keyword="ID">
+ <entry keyword="ID mapping"><topic href="tasks010.htm#sthref122" />
+ </entry>
+ <entry keyword="many-to-many">
+ <entry keyword="Many-to-many mapping"><topic href="tasks011.htm#sthref126" />
+ </entry>
+ <entry keyword="many-to-one">
+ <entry keyword="Many-to-one mapping"><topic href="tasks012.htm#sthref130" />
+ </entry>
+ <entry keyword="one-to-many">
+ <entry keyword="One-to-many mapping"><topic href="tasks013.htm#sthref136" />
+ </entry>
+ <entry keyword="one-to-one">
+ <entry keyword="One-to-one mapping"><topic href="tasks014.htm#sthref140" />
+ </entry>
+ <entry keyword="problems">
+ <entry keyword="Validating mappings and reporting problems"><topic href="tasks018.htm#sthref169" />
+ </entry>
+ <entry keyword="transient">
+ <entry keyword="Transient mapping"><topic href="tasks015.htm#sthref146" />
+ </entry>
+ <entry keyword="version">
+ <entry keyword="Version mapping"><topic href="tasks016.htm#sthref150" />
+ </entry>
+ </entry>
+ <entry keyword="New JPA Project wizard">
+ <entry keyword="Creating a new JPA project"><topic href="task_create_new_project.htm#sthref52" />
+ </entry>
+ <entry keyword="nonpersistent">
+ <entry keyword="classes">
+ <entry keyword="Adding persistence to a class"><topic href="task_add_persistence.htm#sthref74" />
+ </entry>
+ <entry keyword="fields. See transient"></entry>
+ </entry>
+ <entry keyword="one-to-many mapping">
+ <entry keyword="@OneToMany">
+ <entry keyword="One-to-many mapping"><topic href="tasks013.htm#sthref139" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="One-to-many mapping"><topic href="tasks013.htm#sthref137" />
+ </entry>
+ </entry>
+ <entry keyword="one-to-one mapping">
+ <entry keyword="@OneToOne">
+ <entry keyword="One-to-one mapping"><topic href="tasks014.htm#sthref143" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="One-to-one mapping"><topic href="tasks014.htm#sthref141" />
+ </entry>
+ </entry>
+ <entry keyword="ordering">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref217" />
+ </entry>
+ <entry keyword="orm.xml file">
+ <entry keyword="about">
+ <entry keyword="The orm.xml file"><topic href="concepts003.htm#sthref47" />
+ </entry>
+ <entry keyword="managing">
+ <entry keyword="Managing the orm.xml file"><topic href="task_manage_persistence001.htm#sthref68" />
+ </entry>
+ <entry keyword="sample">
+ <entry keyword="Managing the orm.xml file"><topic href="task_manage_persistence001.htm#sthref69" />
+ </entry>
+ </entry>
+ <entry keyword="outline - persistence">
+ <entry keyword="JPA Structure view"><topic href="ref_persistence_outline.htm#sthref229" />
+ </entry>
+ <entry keyword="persistence">
+ <entry keyword="about">
+ <entry keyword="Understanding Java persistence"><topic href="concept_persistence.htm#sthref42" />
+ </entry>
+ <entry keyword="database connection">
+ <entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref236" />
+ </entry>
+ <entry keyword="database schema">
+ <entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref239" />
+ </entry>
+ <entry keyword="entity class">
+ <entry keyword="Adding persistence to a class"><topic href="task_add_persistence.htm#sthref73" />
+ </entry>
+ <entry keyword="options">
+ <entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref231" />
+ </entry>
+ </entry>
+ <entry keyword="Persistence Outline view">
+ <entry keyword="JPA Structure view"><topic href="ref_persistence_outline.htm#sthref228" />
+ </entry>
+ <entry keyword="Persistence Properties view">
+ <entry keyword="attributes">
+ <entry keyword="JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref204" />
+ </entry>
+ <entry keyword="entities">
+ <entry keyword="JPA Details view (for entities)"><topic href="ref_persistence_prop_view.htm#sthref199" />
+ </entry>
+ </entry>
+ <entry keyword="Persistence XML Editor">
+ <entry keyword="Working with persistence.xml file"><topic href="tasks001.htm#sthref62" />
+ </entry>
+ <entry keyword="persistence.xml">
+ <entry keyword="managing">
+ <entry keyword="Working with persistence.xml file"><topic href="tasks001.htm#sthref60" />
+ <entry keyword="Working with orm.xml file"><topic href="tasks003.htm#sthref71" />
+ </entry>
+ </entry>
+ <entry keyword="persistence.xml file">
+ <entry keyword="about">
+ <entry keyword="The persistence.xml file"><topic href="concepts002.htm#sthref46" />
+ </entry>
+ <entry keyword="editor">
+ <entry keyword="Working with persistence.xml file"><topic href="tasks001.htm#sthref63" />
+ </entry>
+ <entry keyword="managing">
+ <entry keyword="Managing the persistence.xml file"><topic href="task_manage_persistence.htm#sthref57" />
+ </entry>
+ <entry keyword="sample">
+ <entry keyword="Managing the persistence.xml file"><topic href="task_manage_persistence.htm#sthref58" />
+ </entry>
+ <entry keyword="synchronizing with classes">
+ <entry keyword="Synchronizing classes"><topic href="tasks002.htm#sthref66" />
+ </entry>
+ </entry>
+ <entry keyword="persistent entity">
+ <entry keyword="Entity"><topic href="tasks004.htm#sthref77" />
+ </entry>
+ <entry keyword="perspective - JPA">
+ <entry keyword="JPA perspective"><topic href="ref_persistence_perspective.htm#sthref245" />
+ </entry>
+ <entry keyword="platform - JPA">
+ <entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref233" />
+ </entry>
+ <entry keyword="problems">
+ <entry keyword="Validating mappings and reporting problems"><topic href="tasks018.htm#sthref168" />
+ </entry>
+ <entry keyword="projects">
+ <entry keyword="creating new">
+ <entry keyword="Creating a new project"><topic href="getting_started003.htm#sthref6" />
+ <entry keyword="Creating a new JPA project"><topic href="task_create_new_project.htm#sthref49" />
+ </entry>
+ <entry keyword="options">
+ <entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref232" />
+ </entry>
+ </entry>
+ <entry keyword="quick start">
+ <entry keyword="Dali quick start"><topic href="getting_started002.htm#sthref5" />
+ </entry>
+ <entry keyword="requirements">
+ <entry keyword="persistent entities">
+ <entry keyword="Entity"><topic href="tasks004.htm#sthref79" />
+ </entry>
+ </entry>
+ <entry keyword="requirements - Dali">
+ <entry keyword="Requirements and installation"><topic href="getting_started001.htm#sthref4" />
+ </entry>
+ <entry keyword="schema - database">
+ <entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref238" />
+ </entry>
+ <entry keyword="single table inheritance">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref104" />
+ </entry>
+ <entry keyword="superclass">
+ <entry keyword="Mapped superclass"><topic href="tasks006.htm#sthref94" />
+ </entry>
+ <entry keyword="tables">
+ <entry keyword="creating entities from">
+ <entry keyword="Generating entities from tables"><topic href="tasks017.htm#sthref155" />
+ <entry keyword="Generate Entities from Tables dialog"><topic href="task_generate_entities.htm#sthref242" />
+ </entry>
+ <entry keyword="from entities">
+ <entry keyword="Generating tables (DDL scripts) from entities"><topic href="task_generate_ddl.htm#sthref159" />
+ </entry>
+ <entry keyword="inheritance">
+ <entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref105" />
+ </entry>
+ </entry>
+ <entry keyword="temporal">
+ <entry keyword="General information"><topic href="ref_mapping_general.htm#sthref213" />
+ </entry>
+ <entry keyword="transient mapping">
+ <entry keyword="@Transient">
+ <entry keyword="Transient mapping"><topic href="tasks015.htm#sthref149" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Transient mapping"><topic href="tasks015.htm#sthref147" />
+ </entry>
+ </entry>
+ <entry keyword="tutorial - Dali">
+ <entry keyword="Dali basic tutorial"><topic href="getting_started006.htm#sthref21" />
+ </entry>
+ <entry keyword="version mapping">
+ <entry keyword="@Version">
+ <entry keyword="Version mapping"><topic href="tasks016.htm#sthref153" />
+ </entry>
+ <entry keyword="about">
+ <entry keyword="Version mapping"><topic href="tasks016.htm#sthref151" />
+ </entry>
+ </entry>
+ <entry keyword="views">
+ <entry keyword="Persistence Outline view">
+ <entry keyword="JPA Structure view"><topic href="ref_persistence_outline.htm#sthref227" />
+ </entry>
+ <entry keyword="Persistence Properties view">
+ <entry keyword="JPA Details view (for entities)"><topic href="ref_persistence_prop_view.htm#sthref200" />
+ <entry keyword="JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref205" />
+ </entry>
+ </entry>
+ <entry keyword="warning messages - Dali">
+ <entry keyword="Validating mappings and reporting problems"><topic href="tasks018.htm#sthref167" />
+ </entry>
+ <entry keyword="wizards">
+ <entry keyword="New JPA Project wizard">
+ <entry keyword="Creating a new JPA project"><topic href="task_create_new_project.htm#sthref51" />
+ </entry>
+ </entry>
+ <entry keyword="XML editor">
+ <entry keyword="Working with persistence.xml file"><topic href="tasks001.htm#sthref59" />
+ <entry keyword="Working with orm.xml file"><topic href="tasks003.htm#sthref70" />
+ </entry>
+</index>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/legal.htm b/jpa/plugins/org.eclipse.jpt.doc.user/legal.htm
new file mode 100644
index 0000000000..5094707297
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/legal.htm
@@ -0,0 +1,45 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:14 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Legal</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content=" Legal" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="sthref255" name="sthref255"></a></p>
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Legal</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref256" name="sthref256"></a></p>
+<p class="subhead2">Notices</p>
+<p>The material in this guide is copyright &copy; 2006, 2007 by Oracle.</p>
+<p><a href="about.htm">Terms and conditions regarding the use of this guide.</a></p>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/plugin.xml b/jpa/plugins/org.eclipse.jpt.doc.user/plugin.xml
new file mode 100644
index 0000000000..ae22ab174b
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/plugin.xml
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?eclipse version="3.0"?>
+<plugin name="JPA Documentation Plug-in" id="org.eclipse.jpt.doc.user" version="1.0.0" provider-name="Oracle">
+ <!-- =========== -->
+ <!-- Define TOC -->
+ <!-- =========== -->
+ <extension point="org.eclipse.help.toc">
+ <toc file="toc.xml" primary="true"/>
+ </extension>
+ <!-- =========== -->
+ <!-- Define F1 -->
+ <!-- =========== -->
+ <extension point="org.eclipse.help.contexts">
+ <contexts file="contexts.xml" plugin="org.eclipse.jpt.ui"/>
+ </extension>
+ <!-- ==================== -->
+ <!-- Define Keyword Index -->
+ <!-- ==================== -->
+ <extension point="org.eclipse.help.index">
+ <index file="index.xml"/>
+ </extension>
+ <!-- =========== -->
+ <!-- Cheatsheets -->
+ <!-- =========== -->
+ <extension point="org.eclipse.ui.cheatsheets.cheatSheetContent">
+ <category name="Persistence" id="com.jpa.category"/>
+ <cheatsheet name="Add persistence to a project" category="com.jpa.category" contentFile="$nl$/cheatsheets/add_persistence.xml" id="org.eclipse.jpa.cheatsheet.createproject1">
+ <description>This cheat sheet helps you add persistence to a Java project.</description>
+ </cheatsheet>
+ <cheatsheet name="Create a persistent entity" category="com.jpa.category" contentFile="$nl$/cheatsheets/create_entity.xml" id="org.eclipse.jpa.cheatsheet.addentity">
+ <description>This cheat sheet helps you create a Java persistent entity.</description>
+ </cheatsheet>
+ <cheatsheet name="Map a persistent entity" category="com.jpa.category" contentFile="$nl$/cheatsheets/map_entity.xml" id="org.eclipse.jpa.cheatsheet.mapentity">
+ <description>This cheat sheet helps you map the a Java persistent entity to a database table.</description>
+ </cheatsheet>
+ </extension>
+</plugin>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_jpa_facet.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_jpa_facet.htm
new file mode 100644
index 0000000000..7517624e44
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_jpa_facet.htm
@@ -0,0 +1,84 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>JPA Facet page</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="JPA Facet page" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACIFDIF" name="CACIFDIF"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>JPA Facet page</h1>
+</td>
+</tr>
+</table>
+<p>This table lists the properties available on the JPA Facet page of the <a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a>.</p>
+<div class="inftblinformal">
+<table class="Informal" title="This table describes the options on the Generate DDL - Objects page." summary="This table describes the options on the Generate DDL - Objects page." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t3">Property</th>
+<th align="left" valign="bottom" id="r1c2-t3">Description</th>
+<th align="left" valign="bottom" id="r1c3-t3">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t3" headers="r1c1-t3">Platform</td>
+<td align="left" headers="r2c1-t3 r1c2-t3">Vendor-specific JPA implementation.</td>
+<td align="left" headers="r2c1-t3 r1c3-t3">Generic</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t3" headers="r1c1-t3">Connection</td>
+<td align="left" headers="r3c1-t3 r1c2-t3">Select the database connection to use with the project. Dali requires an active database connection to use and validate the persistent entities and mappings.
+<p>Click <span class="bold">Add connection</span> to create a new database connection.</p>
+</td>
+<td align="left" headers="r3c1-t3 r1c3-t3"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t3" headers="r1c1-t3">JPA Implementation Library</td>
+<td align="left" headers="r4c1-t3 r1c2-t3">Select the libraries or JARs that contain the Java Persistence API (JPA) and entities to be added to the project's Java Build Path.
+<p>Click <span class="bold">Configure default JPA implementation library</span> to create a default library for the project or click <span class="bold">Configure user libraries</span> to define additional libraries.</p>
+</td>
+<td align="left" headers="r4c1-t3 r1c3-t3"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t3" headers="r1c1-t3">Create orm.xml</td>
+<td align="left" headers="r5c1-t3 r1c2-t3">Specify if Dali should create a default <code>orm.xml</code> file for your entity mappings and persistence unit defaults.</td>
+<td align="left" headers="r5c1-t3 r1c3-t3">Selected</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblinformal" --></div>
+<!-- class="sect3" -->
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_mapping_general.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_mapping_general.htm
new file mode 100644
index 0000000000..ede4020932
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_mapping_general.htm
@@ -0,0 +1,213 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>General information</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="General information" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACBHFIJ" name="CACBHFIJ"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>General information</h1>
+</td>
+</tr>
+</table>
+<p>This table lists the General properties available in the <span class="gui-object-title">Java Details view</span> for each mapping type.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the options on the Persistence Properties view." summary="This table describes the options on the Persistence Properties view." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t6">Property</th>
+<th align="left" valign="bottom" id="r1c2-t6">Description</th>
+<th align="left" valign="bottom" id="r1c3-t6">Default</th>
+<th align="left" valign="bottom" id="r1c4-t6">Available for Mapping Type</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t6" headers="r1c1-t6">Map As</td>
+<td align="left" headers="r2c1-t6 r1c2-t6">Define the mapping type for the attribute</td>
+<td align="left" headers="r2c1-t6 r1c3-t6">Basic</td>
+<td align="left" headers="r2c1-t6 r1c4-t6">All mapping types</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t6" headers="r1c1-t6"><a id="CACGCBHB" name="CACGCBHB"></a>Column</td>
+<td align="left" headers="r3c1-t6 r1c2-t6"><a id="sthref207" name="sthref207"></a><a id="sthref208" name="sthref208"></a>The database column that contains the value for the attribute. This field corresponds to the <code>@Column</code> annotation.</td>
+<td align="left" headers="r3c1-t6 r1c3-t6">By default, the Column is assumed to be named identically to the attribute.</td>
+<td align="left" headers="r3c1-t6 r1c4-t6"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks008.htm#BABCBHDF">Embedded mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a>, <a href="tasks016.htm#BABHIBII">Version mapping</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t6" headers="r1c1-t6">&nbsp;&nbsp;Name</td>
+<td align="left" headers="r4c1-t6 r1c2-t6">Name of the database column.
+<p>This field corresponds to the <code>@Column</code> annotation.</p>
+</td>
+<td align="left" headers="r4c1-t6 r1c3-t6"><br /></td>
+<td align="left" headers="r4c1-t6 r1c4-t6"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks008.htm#BABCBHDF">Embedded mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t6" headers="r1c1-t6">&nbsp;&nbsp;Table</td>
+<td align="left" headers="r5c1-t6 r1c2-t6">Name of the database table that contains the selected column.</td>
+<td align="left" headers="r5c1-t6 r1c3-t6"><br /></td>
+<td align="left" headers="r5c1-t6 r1c4-t6"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks008.htm#BABCBHDF">Embedded mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t6" headers="r1c1-t6"><a id="CACGGGHB" name="CACGGGHB"></a><a id="sthref209" name="sthref209"></a><a id="sthref210" name="sthref210"></a><a id="sthref211" name="sthref211"></a>Fetch Type</td>
+<td align="left" headers="r6c1-t6 r1c2-t6">Defines how data is loaded from the database:
+<ul>
+<li type="disc">
+<p>Eager &ndash; Data is loaded in before it is actually needed.</p>
+</li>
+<li type="disc">
+<p>Lazy &ndash; Data is loaded only when required by the transaction.</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r6c1-t6 r1c3-t6">Eager</td>
+<td align="left" headers="r6c1-t6 r1c4-t6"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r7c1-t6" headers="r1c1-t6">Optional</td>
+<td align="left" headers="r7c1-t6 r1c2-t6">Specifies if this field is can be null.</td>
+<td align="left" headers="r7c1-t6 r1c3-t6">Yes</td>
+<td align="left" headers="r7c1-t6 r1c4-t6"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r8c1-t6" headers="r1c1-t6"><a id="CACBBIBI" name="CACBBIBI"></a><a id="sthref212" name="sthref212"></a>Lob</td>
+<td align="left" headers="r8c1-t6 r1c2-t6">Specify if the field is mapped to <code>java.sql.Clob</code> or <code>java.sql.Blob</code>.
+<p>This field corresponds to the <code>@Lob</code> annotation.</p>
+</td>
+<td align="left" headers="r8c1-t6 r1c3-t6"><br /></td>
+<td align="left" headers="r8c1-t6 r1c4-t6"><a href="tasks007.htm#BABBABCE">Basic mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r9c1-t6" headers="r1c1-t6"><a id="CACEAJGD" name="CACEAJGD"></a><a id="sthref213" name="sthref213"></a><a id="sthref214" name="sthref214"></a>Temporal</td>
+<td align="left" headers="r9c1-t6 r1c2-t6">Specifies if this field is one of the following:
+<ul>
+<li type="disc">
+<p>Date &ndash; <code>java.sql.Date</code></p>
+</li>
+<li type="disc">
+<p>Time &ndash; <code>java.sql.Time</code></p>
+</li>
+<li type="disc">
+<p>Timestamp &ndash; <code>java.sql.Timestamp</code></p>
+</li>
+</ul>
+<p>This field corresponds to the <code>@Temporal</code> annotation.</p>
+</td>
+<td align="left" headers="r9c1-t6 r1c3-t6"><br /></td>
+<td align="left" headers="r9c1-t6 r1c4-t6"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r10c1-t6" headers="r1c1-t6"><a id="sthref215" name="sthref215"></a><a id="sthref216" name="sthref216"></a>Enumerated</td>
+<td align="left" headers="r10c1-t6 r1c2-t6">Specify how to persist enumerated constraints if the <code>String</code> value suits your application requirements or to match an existing database schema.
+<ul>
+<li type="disc">
+<p>ordinal</p>
+</li>
+<li type="disc">
+<p><code>String</code></p>
+</li>
+</ul>
+<p>This field corresponds to the <code>@Enumerated</code> annotation.</p>
+</td>
+<td align="left" headers="r10c1-t6 r1c3-t6">Ordinal</td>
+<td align="left" headers="r10c1-t6 r1c4-t6"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r11c1-t6" headers="r1c1-t6">Target Entity</td>
+<td align="left" headers="r11c1-t6 r1c2-t6">The persistent entity to which the attribute is mapped.</td>
+<td align="left" headers="r11c1-t6 r1c3-t6"><br /></td>
+<td align="left" headers="r11c1-t6 r1c4-t6"><a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a>,, <a href="tasks013.htm#BABHGEBD">One-to-many mapping</a> <a href="tasks011.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r12c1-t6" headers="r1c1-t6"><a id="CACJAIHB" name="CACJAIHB"></a>Cascade Type</td>
+<td align="left" headers="r12c1-t6 r1c2-t6">Specify which operations are propagated throughout the entity.
+<ul>
+<li type="disc">
+<p>All &ndash; All operations</p>
+</li>
+<li type="disc">
+<p>Persist</p>
+</li>
+<li type="disc">
+<p>Merge</p>
+</li>
+<li type="disc">
+<p>Move</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r12c1-t6 r1c3-t6"><br /></td>
+<td align="left" headers="r12c1-t6 r1c4-t6"><a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r13c1-t6" headers="r1c1-t6"><a id="CACJDJJA" name="CACJDJJA"></a>Mapped By</td>
+<td align="left" headers="r13c1-t6 r1c2-t6">The field in the database table that "owns" the relationship. This field is required only on the non-owning side of the relationship.</td>
+<td align="left" headers="r13c1-t6 r1c3-t6"><br /></td>
+<td align="left" headers="r13c1-t6 r1c4-t6"><a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a>, <a href="tasks013.htm#BABHGEBD">One-to-many mapping</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r14c1-t6" headers="r1c1-t6"><a id="CACDADIH" name="CACDADIH"></a><a id="sthref217" name="sthref217"></a><a id="sthref218" name="sthref218"></a>Order By</td>
+<td align="left" headers="r14c1-t6 r1c2-t6">Specify the default order for objects returned from a query:
+<ul>
+<li type="disc">
+<p>No ordering</p>
+</li>
+<li type="disc">
+<p>Primary key</p>
+</li>
+<li type="disc">
+<p>Custom ordering</p>
+</li>
+</ul>
+<p>This field corresponds to the <code>@OrderBy</code> annotation.</p>
+</td>
+<td align="left" headers="r14c1-t6 r1c3-t6">Primary key</td>
+<td align="left" headers="r14c1-t6 r1c4-t6"><a href="tasks013.htm#BABHGEBD">One-to-many mapping</a>. <a href="tasks011.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r15c1-t6" headers="r1c1-t6">Attribute Overrides</td>
+<td align="left" headers="r15c1-t6 r1c2-t6">Overrides the column mappings from the mapped, entity tabled. (for example, if the inherited column name is incompatible with a pre-existing data model, or invalid as a column name in your database).</td>
+<td align="left" headers="r15c1-t6 r1c3-t6"><br /></td>
+<td align="left" headers="r15c1-t6 r1c4-t6"><a href="tasks008.htm#BABCBHDF">Embedded mapping</a>
+<p><a href="tasks008.htm#BABCBHDF">Embedded mapping</a></p>
+<br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project.htm
new file mode 100644
index 0000000000..74f3b061b0
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project.htm
@@ -0,0 +1,91 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>New JPA Project page</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="New JPA Project page" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACBJAGC" name="CACBJAGC"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>New JPA Project page</h1>
+</td>
+</tr>
+</table>
+<p>This table lists the properties available on the New JPA Project page of the <a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a>.</p>
+<div class="inftblinformal">
+<table class="Informal" title="This table describes the options on the Generate DDL - Objects page." summary="This table describes the options on the Generate DDL - Objects page." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t2">Property</th>
+<th align="left" valign="bottom" id="r1c2-t2">Description</th>
+<th align="left" valign="bottom" id="r1c3-t2">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t2" headers="r1c1-t2">Project name</td>
+<td align="left" headers="r2c1-t2 r1c2-t2">Name of the Eclipse JPA project.</td>
+<td align="left" headers="r2c1-t2 r1c3-t2"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t2" headers="r1c1-t2">Project contents</td>
+<td align="left" headers="r3c1-t2 r1c2-t2">Location of the workspace in which to save the project.
+<p>Unselect The <span class="bold">Use Default</span> option and click <span class="bold">Browse</span> to select a new location.</p>
+</td>
+<td align="left" headers="r3c1-t2 r1c3-t2">Current workspace</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t2" headers="r1c1-t2">Target runtime</td>
+<td align="left" headers="r4c1-t2 r1c2-t2">Select a pre-defined target for the project.
+<p>Click <span class="bold">New</span> to create a new environment with the New Server Runtime wizard.</p>
+</td>
+<td align="left" headers="r4c1-t2 r1c3-t2"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t2" headers="r1c1-t2">Configurations</td>
+<td align="left" headers="r5c1-t2 r1c2-t2">Select a project configuration with pre-defined facets.
+<p>Select <span class="bold">&lt;custom&gt;</span> to manually select the facets for this project.</p>
+</td>
+<td align="left" headers="r5c1-t2 r1c3-t2">Utility JPA project with Java 5.0</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t2" headers="r1c1-t2">EAR membership</td>
+<td align="left" headers="r6c1-t2 r1c2-t2">Specify if this project should be included in an EAR file for deployment.
+<p>Select the <span class="bold">EAR Project Name</span>, or click <span class="bold">New</span> to create a new EAR project.</p>
+</td>
+<td align="left" headers="r6c1-t2 r1c3-t2"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblinformal" --></div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project_wizard.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project_wizard.htm
new file mode 100644
index 0000000000..475f6e0488
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project_wizard.htm
@@ -0,0 +1,54 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create New JPA Project wizard</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create New JPA Project wizard" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACBJGBG" name="CACBJGBG"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create New JPA Project wizard</h1>
+</td>
+</tr>
+</table>
+<p>The Create New JPA Project wizard allows you to create a new Java project using JPA. The wizard consists of the following pages:</p>
+<ul>
+<li type="disc">
+<p><a href="ref_new_jpa_project.htm#CACBJAGC">New JPA Project page</a></p>
+</li>
+<li type="disc">
+<p>Project Facets page</p>
+</li>
+<li type="disc">
+<p><a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_map_view.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_map_view.htm
new file mode 100644
index 0000000000..67275dd877
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_map_view.htm
@@ -0,0 +1,57 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>JPA Details view (for attributes)</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="JPA Details view (for attributes)" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABIFBAF" name="BABIFBAF"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>JPA Details view (for attributes)</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref204" name="sthref204"></a><a id="sthref205" name="sthref205"></a><a id="sthref206" name="sthref206"></a>The <span class="gui-object-title">JPA Details</span> view displays the persistence information for the currently selected mapped attribute and contains the following areas:</p>
+<ul>
+<li type="disc">
+<p><a href="ref_mapping_general.htm#CACBHFIJ">General information</a></p>
+</li>
+<li type="disc">
+<p><a href="reference005.htm#CACBAEBC">Join Table Information</a></p>
+</li>
+<li type="disc">
+<p><a href="reference006.htm#CACFCEJC">Join Columns Information</a></p>
+</li>
+<li type="disc">
+<p><a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_outline.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_outline.htm
new file mode 100644
index 0000000000..a3d25124a8
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_outline.htm
@@ -0,0 +1,55 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>JPA Structure view</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="JPA Structure view" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABEGGFE" name="BABEGGFE"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>JPA Structure view</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref227" name="sthref227"></a><a id="sthref228" name="sthref228"></a><a id="sthref229" name="sthref229"></a>The <span class="gui-object-title">JPA Structure</span> view displays an outline of the structure (its attributes and mappings) of the entity that is currently selected or opened in the editor. The structural elements shown in the outline are the entity and its fields.</p>
+<div class="figure"><a id="sthref230" name="sthref230"></a>
+<p class="titleinfigure">Sample JPA Structure View</p>
+<img src="img/persistence_outline_view.png" alt="This figure shows a sample Persistence Outline view for an entity." title="This figure shows a sample Persistence Outline view for an entity." /><br /></div>
+<!-- class="figure" -->
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_perspective.htm#BABIFBDB">JPA perspective</a>
+<p>&nbsp;</p>
+</div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_perspective.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_perspective.htm
new file mode 100644
index 0000000000..b87c6c3c1e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_perspective.htm
@@ -0,0 +1,59 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>JPA perspective</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="JPA perspective" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABIFBDB" name="BABIFBDB"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>JPA perspective</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref244" name="sthref244"></a><a id="sthref245" name="sthref245"></a>The <span class="bold">JPA perspective</span> defines the initial set and layout of views in the Workbench window when using Dali. By default, the <span class="gui-object-title">JPA perspective</span> includes the following vies:</p>
+<ul>
+<li type="disc">
+<p><a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a></p>
+</li>
+<li type="disc">
+<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p>
+</li>
+</ul>
+<div class="figure"><a id="sthref246" name="sthref246"></a>
+<p class="titleinfigure">Sample JPA Perspective</p>
+<img src="img/persistence_perspective.png" alt="This figure shows the Persistence perspective with the Persistence Properties and Outline views." title="This figure shows the Persistence perspective with the Persistence Properties and Outline views." /><br /></div>
+<!-- class="figure" -->
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<p><a href="../org.eclipse.platform.doc.user/concepts/concepts-4.htm">Perspectives</a></p>
+</div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_prop_view.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_prop_view.htm
new file mode 100644
index 0000000000..45891656dc
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_prop_view.htm
@@ -0,0 +1,51 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>JPA Details view (for entities)</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="JPA Details view (for entities)" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABFAEBB" name="BABFAEBB"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>JPA Details view (for entities)</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref199" name="sthref199"></a><a id="sthref200" name="sthref200"></a><a id="sthref201" name="sthref201"></a>The <span class="gui-object-title">JPA Details</span> view displays the persistence information for the currently selected entity and contains the following tabs:</p>
+<ul>
+<li type="disc">
+<p><a href="reference003.htm#CACCAGGC">General information</a></p>
+</li>
+<li type="disc">
+<p><a href="reference004.htm#CACFHGHE">Inheritance information</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_primary_key.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_primary_key.htm
new file mode 100644
index 0000000000..c590f4e50f
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_primary_key.htm
@@ -0,0 +1,144 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Primary Key Generation information</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Primary Key Generation information" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACFCCAB" name="CACFCCAB"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Primary Key Generation information</h1>
+</td>
+</tr>
+</table>
+<p>This table lists the fields available in the <span class="gui-object-title">Primary Key Generation</span> area in JPA Details view for <a href="tasks010.htm#BABGCBHG">ID mapping</a> types.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the options on the Join Columns tab." summary="This table describes the options on the Join Columns tab." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t9">Property</th>
+<th align="left" valign="bottom" id="r1c2-t9">Description</th>
+<th align="left" valign="bottom" id="r1c3-t9">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t9" headers="r1c1-t9"><a id="CACBAJBC" name="CACBAJBC"></a>Primary Key Generation</td>
+<td align="left" headers="r2c1-t9 r1c2-t9"><a id="sthref223" name="sthref223"></a><a id="sthref224" name="sthref224"></a>These fields define how the primary key is generated. These fields correspond to the <code>@GeneratedValue</code> annotation.</td>
+<td align="left" headers="r2c1-t9 r1c3-t9">Generated Value</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t9" headers="r1c1-t9"><a id="CACJEEEC" name="CACJEEEC"></a>&nbsp;&nbsp;&nbsp;Strategy</td>
+<td align="left" headers="r3c1-t9 r1c2-t9">
+<ul>
+<li type="disc">Auto</li>
+<li type="disc">
+<p>Identity &ndash; Values are assigned by the database's <span class="bold">Identity</span> column.</p>
+</li>
+<li type="disc">
+<p>Sequence &ndash; Values are assigned by a sequence table (see <a href="#CACFFHEH">Sequence&nbsp;Generator</a>).</p>
+</li>
+<li type="disc">
+<p>Table &ndash; Values are assigned by a database table (see <a href="#CACGFEAH">Table Generator</a>).</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r3c1-t9 r1c3-t9">Auto</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t9" headers="r1c1-t9"><a id="BABEEAHJ" name="BABEEAHJ"></a>&nbsp;&nbsp;Generator Name</td>
+<td align="left" headers="r4c1-t9 r1c2-t9">Unique name of the generated value.</td>
+<td align="left" headers="r4c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t9" headers="r1c1-t9"><a id="CACGFEAH" name="CACGFEAH"></a>Table Generator</td>
+<td align="left" headers="r5c1-t9 r1c2-t9">These fields define the database table used for generating the primary key and correspond to the <code>@TableGenerator</code> annotation.
+<p>These fields apply only when <span class="bold">Strategy</span>&nbsp;=&nbsp;<span class="bold">Table</span>.</p>
+</td>
+<td align="left" headers="r5c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t9" headers="r1c1-t9">&nbsp;&nbsp;Name</td>
+<td align="left" headers="r6c1-t9 r1c2-t9">Unique name of the generator.</td>
+<td align="left" headers="r6c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r7c1-t9" headers="r1c1-t9">&nbsp;&nbsp;Table</td>
+<td align="left" headers="r7c1-t9 r1c2-t9">Database table that stores the generated ID values.</td>
+<td align="left" headers="r7c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r8c1-t9" headers="r1c1-t9">&nbsp;&nbsp;Primary Key Column</td>
+<td align="left" headers="r8c1-t9 r1c2-t9">The column in the table generator's <span class="bold">Table</span> that contains the primary key.</td>
+<td align="left" headers="r8c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r9c1-t9" headers="r1c1-t9">&nbsp;&nbsp;Value Column</td>
+<td align="left" headers="r9c1-t9 r1c2-t9">The column that stores the generated ID values.</td>
+<td align="left" headers="r9c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r10c1-t9" headers="r1c1-t9">&nbsp;&nbsp;Primary Key Column Value</td>
+<td align="left" headers="r10c1-t9 r1c2-t9">The value for the <span class="bold">Primary Key Column</span> in the generator table.</td>
+<td align="left" headers="r10c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r11c1-t9" headers="r1c1-t9"><a id="CACFFHEH" name="CACFFHEH"></a>Sequence&nbsp;Generator</td>
+<td align="left" headers="r11c1-t9 r1c2-t9"><a id="sthref225" name="sthref225"></a><a id="sthref226" name="sthref226"></a>These fields define the specific sequence used for generating the primary key and correspond to the <code>@SequenceGenerator</code> annotation.
+<p>These fields apply only when <span class="bold">Strategy</span> = <span class="bold">Sequence</span>.</p>
+</td>
+<td align="left" headers="r11c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r12c1-t9" headers="r1c1-t9">&nbsp;&nbsp;Name</td>
+<td align="left" headers="r12c1-t9 r1c2-t9">Name of the sequence table to use for defining primary key values.</td>
+<td align="left" headers="r12c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r13c1-t9" headers="r1c1-t9">&nbsp;&nbsp;Sequence</td>
+<td align="left" headers="r13c1-t9 r1c2-t9">Unique name of the sequence.</td>
+<td align="left" headers="r13c1-t9 r1c3-t9"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="tasks010.htm#BABGCBHG">ID mapping</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></div>
+<!-- class="sect3" -->
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_project_properties.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_project_properties.htm
new file mode 100644
index 0000000000..593e7ed982
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_project_properties.htm
@@ -0,0 +1,81 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Project Properties page - JPA Options</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Project Properties page - JPA Options" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABJHBCI" name="BABJHBCI"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Project Properties page &ndash; JPA Options</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref231" name="sthref231"></a><a id="sthref232" name="sthref232"></a>Use the <span class="gui-object-title">JPA</span> options on the <span class="gui-object-title">Properties</span> page to select the database connection to use with the project.</p>
+<p>This table lists the properties available in the <span class="gui-object-title">Persistence Properties page</span>.</p>
+<div class="inftblinformal">
+<table class="Informal" title="This table describes the options on the Persistence Properties page." summary="This table describes the options on the Persistence Properties page." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t12">Property</th>
+<th align="left" valign="bottom" id="r1c2-t12">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t12" headers="r1c1-t12"><a id="sthref233" name="sthref233"></a><a id="sthref234" name="sthref234"></a><a id="sthref235" name="sthref235"></a><a id="sthref236" name="sthref236"></a>Platform</td>
+<td align="left" headers="r2c1-t12 r1c2-t12">Select the vendor-specific platform.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t12" headers="r1c1-t12"><a id="sthref237" name="sthref237"></a><a id="sthref238" name="sthref238"></a><a id="sthref239" name="sthref239"></a>Connection</td>
+<td align="left" headers="r3c1-t12 r1c2-t12">The database connection used to map the persistent entities.
+<ul>
+<li type="disc">
+<p>To create a new connection, click <span class="bold">Add Connections</span>.</p>
+</li>
+<li type="disc">
+<p>To reconnect to an existing connection, click <span class="bold">Reconnect</span>.</p>
+</li>
+</ul>
+</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblinformal" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<br />
+<a href="tasks021.htm#BABDBCBI">Modifying persistent project properties</a></div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference.htm
new file mode 100644
index 0000000000..04af0ce95b
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference.htm
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Reference</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content=" Reference" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="sthref198" name="sthref198"></a></p>
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Reference</h1>
+</td>
+</tr>
+</table>
+<p>This section includes detailed help information for each of the following elements in the Dali OR Mapping Tool:</p>
+<ul>
+<li type="disc">
+<p><a href="reference001.htm#CACJJJJH">Wizards</a></p>
+</li>
+<li type="disc">
+<p><a href="reference002.htm#CACDJIIG">Property pages</a></p>
+</li>
+<li type="disc">
+<p><a href="reference010.htm#CACDEIEE">Preferences</a></p>
+</li>
+<li type="disc">
+<p><a href="reference011.htm#CACGEJDA">Dialogs</a></p>
+</li>
+<li type="disc">
+<p><a href="ref_persistence_perspective.htm#BABIFBDB">JPA perspective</a></p>
+</li>
+<li type="disc">
+<p><a href="reference014.htm#CACDHCIA">Icons and buttons</a></p>
+</li>
+<li type="disc">
+<p><a href="reference018.htm#CACBBDIB">Dali Developer Documentation</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference001.htm
new file mode 100644
index 0000000000..41f8b45475
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference001.htm
@@ -0,0 +1,48 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Wizards</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Wizards" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACJJJJH" name="CACJJJJH"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Wizards</h1>
+</td>
+</tr>
+</table>
+<p>This section includes information on the following wizards:</p>
+<ul>
+<li type="disc">
+<p><a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference002.htm
new file mode 100644
index 0000000000..4171532a71
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference002.htm
@@ -0,0 +1,57 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Property pages</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Property pages" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACDJIIG" name="CACDJIIG"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Property pages</h1>
+</td>
+</tr>
+</table>
+<p>This section includes information on the following property pages:</p>
+<ul>
+<li type="disc">
+<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p>
+</li>
+<li type="disc">
+<p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p>
+</li>
+<li type="disc">
+<p><a href="reference007.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p>
+</li>
+<li type="disc">
+<p><a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference003.htm
new file mode 100644
index 0000000000..079990f493
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference003.htm
@@ -0,0 +1,115 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>General information</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="General information" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACCAGGC" name="CACCAGGC"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>General information</h1>
+</td>
+</tr>
+</table>
+<p>This table lists the General information fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p>
+<div class="inftblinformal">
+<table class="Informal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t4">Property</th>
+<th align="left" valign="bottom" id="r1c2-t4">Description</th>
+<th align="left" valign="bottom" id="r1c3-t4">Default</th>
+<th align="left" valign="bottom" id="r1c4-t4">Available for Entity&nbsp;Type</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t4" headers="r1c1-t4">Map As</td>
+<td align="left" headers="r2c1-t4 r1c2-t4">Specify the type of entity: <span class="bold">Entity</span>, Mapped Superclass, Embeddable.</td>
+<td align="left" headers="r2c1-t4 r1c3-t4">Entity</td>
+<td align="left" headers="r2c1-t4 r1c4-t4"><a href="tasks004.htm#BABGBIEE">Entity</a>, <a href="tasks005.htm#BABFEICE">Embeddable</a>, and <a href="tasks006.htm#BABDAGCI">Mapped superclass</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t4" headers="r1c1-t4">Name</td>
+<td align="left" headers="r3c1-t4 r1c2-t4">The name of this entity. By default, the class name is used as the entity name.</td>
+<td align="left" headers="r3c1-t4 r1c3-t4"><br /></td>
+<td align="left" headers="r3c1-t4 r1c4-t4"><a href="tasks004.htm#BABGBIEE">Entity</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t4" headers="r1c1-t4">Table</td>
+<td align="left" headers="r4c1-t4 r1c2-t4">The primary database table associated with the entity.</td>
+<td align="left" headers="r4c1-t4 r1c3-t4"><br /></td>
+<td align="left" headers="r4c1-t4 r1c4-t4"><a href="tasks004.htm#BABGBIEE">Entity</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t4" headers="r1c1-t4">Catalog</td>
+<td align="left" headers="r5c1-t4 r1c2-t4">The database catalog that contains the <span class="bold">Table</span>.</td>
+<td align="left" headers="r5c1-t4 r1c3-t4">As defined in <code>orm.xml</code>.</td>
+<td align="left" headers="r5c1-t4 r1c4-t4"><a href="tasks004.htm#BABGBIEE">Entity</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t4" headers="r1c1-t4">Schema</td>
+<td align="left" headers="r6c1-t4 r1c2-t4">The database schema that contains the <span class="bold">Table</span>.</td>
+<td align="left" headers="r6c1-t4 r1c3-t4">As defined in <code>orm.xml</code>.</td>
+<td align="left" headers="r6c1-t4 r1c4-t4"><a href="tasks004.htm#BABGBIEE">Entity</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r7c1-t4" headers="r1c1-t4">Attribute Overrides</td>
+<td align="left" headers="r7c1-t4 r1c2-t4">Specify a property or field to be overridden (from the default mappings). Select <span class="bold">Override Default</span>.</td>
+<td align="left" headers="r7c1-t4 r1c3-t4"><br /></td>
+<td align="left" headers="r7c1-t4 r1c4-t4"><a href="tasks004.htm#BABGBIEE">Entity</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r8c1-t4" headers="r1c1-t4">&nbsp;&nbsp;Column</td>
+<td align="left" headers="r8c1-t4 r1c2-t4">The database column (from the <span class="bold">Table Name</span>) mapped to the entity.</td>
+<td align="left" headers="r8c1-t4 r1c3-t4"><br /></td>
+<td align="left" headers="r8c1-t4 r1c4-t4"><a href="tasks004.htm#BABGBIEE">Entity</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r9c1-t4" headers="r1c1-t4">&nbsp;&nbsp;Table</td>
+<td align="left" headers="r9c1-t4 r1c2-t4">Name of the database table that contains the selected column.</td>
+<td align="left" headers="r9c1-t4 r1c3-t4"><br /></td>
+<td align="left" headers="r9c1-t4 r1c4-t4"><a href="tasks004.htm#BABGBIEE">Entity</a><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblinformal" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference004.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference004.htm
new file mode 100644
index 0000000000..5f778e518a
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference004.htm
@@ -0,0 +1,108 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Inheritance information</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Inheritance information" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACFHGHE" name="CACFHGHE"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Inheritance information</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref202" name="sthref202"></a><a id="sthref203" name="sthref203"></a>This table lists the fields available on the <span class="gui-object-title">Inheritance</span> area in the <span class="gui-object-title">Java Details</span> view for each entity type.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the options on the Persistence Properties view, Inheritance tab." summary="This table describes the options on the Persistence Properties view, Inheritance tab." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t5">Property</th>
+<th align="left" valign="bottom" id="r1c2-t5">Description</th>
+<th align="left" valign="bottom" id="r1c3-t5">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t5" headers="r1c1-t5">Strategy</td>
+<td align="left" headers="r2c1-t5 r1c2-t5">Specify the strategy to use when mapping a class or class hierarchy:
+<ul>
+<li type="disc">
+<p>Single table &ndash; All classes in the hierarchy are mapped to a single table.</p>
+</li>
+<li type="disc">
+<p>Joined &ndash; The root of the hierarchy is mapped to a single table; each child maps to its own table.</p>
+</li>
+<li type="disc">
+<p>Table per class &ndash; Each class is mapped to a separate table.</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r2c1-t5 r1c3-t5">Single table</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t5" headers="r1c1-t5">Discriminator Column</td>
+<td align="left" headers="r3c1-t5 r1c2-t5">Use to specify the name of the discriminator column when using a <span class="bold">Single</span> or <span class="bold">Joined</span> inheritance strategy.</td>
+<td align="left" headers="r3c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t5" headers="r1c1-t5">Discriminator Type</td>
+<td align="left" headers="r4c1-t5 r1c2-t5">Set this field to set the discriminator type to <code>Char</code> or <code>Integer</code> (instead of its default: <code>String</code>). The <span class="bold">Discriminator Value</span> must conform to this type.</td>
+<td align="left" headers="r4c1-t5 r1c3-t5">String</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t5" headers="r1c1-t5">Discriminator Value</td>
+<td align="left" headers="r5c1-t5 r1c2-t5">Specify the discriminator value used to differentiate an entity in this inheritance hierarchy. The value must conform to the specified <span class="bold">Discriminator Type</span>.</td>
+<td align="left" headers="r5c1-t5 r1c3-t5"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t5" headers="r1c1-t5">Primary Key Join Columns</td>
+<td align="left" headers="r6c1-t5 r1c2-t5">
+<p>Select <span class="bold">Override Default</span>.</p>
+<p>This field corresponds with @PrimaryKeyJoinColumn annotation.</p>
+</td>
+<td align="left" headers="r6c1-t5 r1c3-t5"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a><br />
+<a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></div>
+<!-- class="sect3" -->
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference005.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference005.htm
new file mode 100644
index 0000000000..a18ca1d738
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference005.htm
@@ -0,0 +1,84 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Join Table Information</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Join Table Information" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACBAEBC" name="CACBAEBC"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Join Table Information</h1>
+</td>
+</tr>
+</table>
+<p>Use area to specify a mapped column for joining an entity association. By default, the mapping is assumed to have a single join.</p>
+<p>This table lists the fields available on the <span class="gui-object-title">Join Table</span> area in <span class="gui-object-title">the JPA Details</span> view for <a href="tasks013.htm#BABHGEBD">One-to-many mapping</a> and <a href="tasks011.htm#BABEIEGD">Many-to-many mapping</a> mapping types.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the options on the Join Table tab." summary="This table describes the options on the Join Table tab." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t7">Property</th>
+<th align="left" valign="bottom" id="r1c2-t7">Description</th>
+<th align="left" valign="bottom" id="r1c3-t7">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t7" headers="r1c1-t7">Name</td>
+<td align="left" headers="r2c1-t7 r1c2-t7">Name of the join table that contains the foreign key column.</td>
+<td align="left" headers="r2c1-t7 r1c3-t7">By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t7" headers="r1c1-t7"><a id="CACBBDFG" name="CACBBDFG"></a>Join Columns</td>
+<td align="left" headers="r3c1-t7 r1c2-t7"><a id="sthref219" name="sthref219"></a><a id="sthref220" name="sthref220"></a>Specify a mapped column for joining an entity association. This field corresponds to the <code>@JoinColum</code> attribute.
+<p>Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</p>
+</td>
+<td align="left" headers="r3c1-t7 r1c3-t7">By default, the mapping is assumed to have a single join.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t7" headers="r1c1-t7">Inverse Join Columns</td>
+<td align="left" headers="r4c1-t7 r1c2-t7">Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</td>
+<td align="left" headers="r4c1-t7 r1c3-t7"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="reference012.htm#CACCGEHC">Edit Join Columns Dialog</a></div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference006.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference006.htm
new file mode 100644
index 0000000000..f8e1499c1c
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference006.htm
@@ -0,0 +1,73 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Join Columns Information</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Join Columns Information" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACFCEJC" name="CACFCEJC"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Join Columns Information</h1>
+</td>
+</tr>
+</table>
+<p>This table lists the fields available in the <span class="gui-object-title">Join Table</span> area in <span class="gui-object-title">JPA Details</span> view for <a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a> and <a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a> mapping types.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the options on the Join Columns tab." summary="This table describes the options on the Join Columns tab." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t8">Property</th>
+<th align="left" valign="bottom" id="r1c2-t8">Description</th>
+<th align="left" valign="bottom" id="r1c3-t8">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t8" headers="r1c1-t8">Join Column</td>
+<td align="left" headers="r2c1-t8 r1c2-t8"><a id="sthref221" name="sthref221"></a><a id="sthref222" name="sthref222"></a>Specify a mapped column for joining an entity association. This field corresponds to the <code>@JoinColum</code> attribute.
+<p>Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</p>
+</td>
+<td align="left" headers="r2c1-t8 r1c3-t8">By default, the mapping is assumed to have a single join.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="reference012.htm#CACCGEHC">Edit Join Columns Dialog</a></div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference007.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference007.htm
new file mode 100644
index 0000000000..13d22e8470
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference007.htm
@@ -0,0 +1,52 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>JPA Details view (for orm.xml)</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="JPA Details view (for orm.xml)" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACGDGHC" name="CACGDGHC"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>JPA Details view (for orm.xml)</h1>
+</td>
+</tr>
+</table>
+<p>The <span class="gui-object-title">JPA Details</span> view displays the default mapping and persistence information for the project and contains the following areas:</p>
+<ul>
+<li type="disc">
+<p><a href="reference008.htm#CACCACGH">General information</a></p>
+</li>
+<li type="disc">
+<p><a href="reference009.htm#CACEAGBG">Persistence Unit information</a></p>
+</li>
+</ul>
+<p>These defaults can be overridden by the settings on a specific entity or mapping.</p>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference008.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference008.htm
new file mode 100644
index 0000000000..61b3deffca
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference008.htm
@@ -0,0 +1,100 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>General information</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="General information" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACCACGH" name="CACCACGH"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>General information</h1>
+</td>
+</tr>
+</table>
+<p>This table lists the General information fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t10">Property</th>
+<th align="left" valign="bottom" id="r1c2-t10">Description</th>
+<th align="left" valign="bottom" id="r1c3-t10">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t10" headers="r1c1-t10">Package</td>
+<td align="left" headers="r2c1-t10 r1c2-t10">The Java package that contains the persistent entities. Click <span class="bold">Browse</span> and select the package</td>
+<td align="left" headers="r2c1-t10 r1c3-t10"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t10" headers="r1c1-t10">Schema</td>
+<td align="left" headers="r3c1-t10 r1c2-t10">The database schema that contains the <span class="bold">Table</span>.
+<p>This field corresponds to the <code>&lt;schema&gt;</code> element in the <code>orm.xml</code> file.</p>
+</td>
+<td align="left" headers="r3c1-t10 r1c3-t10"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t10" headers="r1c1-t10">Catalog</td>
+<td align="left" headers="r4c1-t10 r1c2-t10">The database catalog that contains the <span class="bold">Table</span>.
+<p>This field corresponds to the <code>&lt;catalog&gt;</code> element in the <code>orm.xml</code> file.</p>
+</td>
+<td align="left" headers="r4c1-t10 r1c3-t10"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t10" headers="r1c1-t10">Access</td>
+<td align="left" headers="r5c1-t10 r1c2-t10">Specify the default access method for the variables in the project:
+<ul>
+<li type="disc">
+<p>Property</p>
+</li>
+<li type="disc">
+<p>Field</p>
+</li>
+</ul>
+<p>This field corresponds to the <code>&lt;access&gt;</code> element in the <code>orm.xml</code> file.</p>
+</td>
+<td align="left" headers="r5c1-t10 r1c3-t10"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference009.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference009.htm
new file mode 100644
index 0000000000..62cd4f30e6
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference009.htm
@@ -0,0 +1,102 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Persistence Unit information</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Persistence Unit information" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACEAGBG" name="CACEAGBG"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Persistence Unit information</h1>
+</td>
+</tr>
+</table>
+<p>This table lists the Persistence Unit information fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type. These fields are contained in the <code>&lt;persistence-unit-metadata&gt;</code> element in the <code>orm.xml</code> file.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t11">Property</th>
+<th align="left" valign="bottom" id="r1c2-t11">Description</th>
+<th align="left" valign="bottom" id="r1c3-t11">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t11" headers="r1c1-t11">XML Mapping Data Complete</td>
+<td align="left" headers="r2c1-t11 r1c2-t11">
+<p>This field corresponds to the <code>&lt;xml-mapping-metadata-complete&gt;</code> element in the <code>orm.xml</code> file.</p>
+</td>
+<td align="left" headers="r2c1-t11 r1c3-t11"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t11" headers="r1c1-t11">Package</td>
+<td align="left" headers="r3c1-t11 r1c2-t11">The Java package that contains the persistent entities for this persistence unit.
+<p>Click <span class="bold">Browse</span> and select the package</p>
+</td>
+<td align="left" headers="r3c1-t11 r1c3-t11"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t11" headers="r1c1-t11">Schema</td>
+<td align="left" headers="r4c1-t11 r1c2-t11">The database schema that contains the <span class="bold">Table</span>.
+<p>This field corresponds to the <code>&lt;schema&gt;</code> element in the <code>orm.xml</code> file.</p>
+</td>
+<td align="left" headers="r4c1-t11 r1c3-t11"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t11" headers="r1c1-t11">Catalog</td>
+<td align="left" headers="r5c1-t11 r1c2-t11">The database catalog that contains the <span class="bold">Table</span>.
+<p>This field corresponds to the <code>&lt;catalog&gt;</code> element in the <code>orm.xml</code> file.</p>
+</td>
+<td align="left" headers="r5c1-t11 r1c3-t11"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t11" headers="r1c1-t11">Cascade Persist</td>
+<td align="left" headers="r6c1-t11 r1c2-t11">Adds cascade-persist to the set of cascade options in entity relationships of the persistence unit.
+<p>This field corresponds to the <code>&lt;cascade-persist&gt;</code> element in the <code>orm.xml</code> file.</p>
+</td>
+<td align="left" headers="r6c1-t11 r1c3-t11"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></div>
+<!-- class="sect3" -->
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference010.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference010.htm
new file mode 100644
index 0000000000..b95c8808de
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference010.htm
@@ -0,0 +1,48 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Preferences</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Preferences" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACDEIEE" name="CACDEIEE"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Preferences</h1>
+</td>
+</tr>
+</table>
+<p>This section includes information on the following preference pages:</p>
+<ul>
+<li type="disc">
+<p><a href="ref_project_properties.htm#BABJHBCI">Project Properties page &ndash; JPA Options</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference011.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference011.htm
new file mode 100644
index 0000000000..250ed86092
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference011.htm
@@ -0,0 +1,54 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Dialogs</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Dialogs" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACGEJDA" name="CACGEJDA"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Dialogs</h1>
+</td>
+</tr>
+</table>
+<p>This section includes information on the following preference pages:</p>
+<ul>
+<li type="disc">
+<p><a href="task_generate_entities.htm#CACDAFJD">Generate Entities from Tables dialog</a></p>
+</li>
+<li type="disc">
+<p><a href="reference012.htm#CACCGEHC">Edit Join Columns Dialog</a></p>
+</li>
+<li type="disc">
+<p><a href="reference013.htm#CACHJAGB">Database Connection Dialog</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference012.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference012.htm
new file mode 100644
index 0000000000..52b7587ea8
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference012.htm
@@ -0,0 +1,70 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Edit Join Columns Dialog</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Edit Join Columns Dialog" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACCGEHC" name="CACCGEHC"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Edit Join Columns Dialog</h1>
+</td>
+</tr>
+</table>
+<p>Use the <span class="gui-object-title">Join Columns</span> dialog to create or modify the join tables and columns in relationship mappings.</p>
+<p>This table lists the properties available in the <span class="gui-object-title">Join Columns</span> dialog.</p>
+<div class="inftblinformal">
+<table class="Informal" title="This table describes the options on the Join Columns dialog." summary="This table describes the options on the Join Columns dialog." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t14">Property</th>
+<th align="left" valign="bottom" id="r1c2-t14">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t14" headers="r1c1-t14">Name</td>
+<td align="left" headers="r2c1-t14 r1c2-t14">Name of the joint table column that contains the foreign key column.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t14" headers="r1c1-t14">Referenced Column Name</td>
+<td align="left" headers="r3c1-t14 r1c2-t14">Name of the database column that contains the foreign key reference for the entity relationship.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblinformal" -->
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="reference005.htm#CACBAEBC">Join Table Information</a><br />
+<a href="reference006.htm#CACFCEJC">Join Columns Information</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference013.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference013.htm
new file mode 100644
index 0000000000..ca4d9b36c9
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference013.htm
@@ -0,0 +1,73 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Database Connection Dialog</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Database Connection Dialog" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACHJAGB" name="CACHJAGB"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Database Connection Dialog</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref243" name="sthref243"></a>Use the <span class="gui-object-title">Database Connection</span> dialog to create a new database connection or reconnect to an existing database connection.</p>
+<p>This table lists the properties available in the <span class="gui-object-title">Database Connection</span> dialog.</p>
+<div class="inftblinformal">
+<table class="Informal" title="This table describes the options on the Join Columns dialog." summary="This table describes the options on the Join Columns dialog." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t15">Property</th>
+<th align="left" valign="bottom" id="r1c2-t15">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t15" headers="r1c1-t15">Connection</td>
+<td align="left" headers="r2c1-t15 r1c2-t15">.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t15" headers="r1c1-t15">Schema</td>
+<td align="left" headers="r3c1-t15 r1c2-t15">.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblinformal" -->
+<p>Click <span class="bold">Add Connection</span> to create a new database connection.</p>
+<p>Click <span class="bold">Reconnect</span> to connect to the selected database connection</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="tasks017.htm#BABBAGFI">Generating entities from tables</a><br />
+<a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference014.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference014.htm
new file mode 100644
index 0000000000..a59edab238
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference014.htm
@@ -0,0 +1,51 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Icons and buttons</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Icons and buttons" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACDHCIA" name="CACDHCIA"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Icons and buttons</h1>
+</td>
+</tr>
+</table>
+<p>This section includes information on each of the icons and buttons used in the Dali OR Mapping Tool.</p>
+<ul>
+<li type="disc">
+<p><a href="reference015.htm#CACGEACG">Icons</a></p>
+</li>
+<li type="disc">
+<p><a href="reference016.htm#CACDJCEI">Buttons</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference015.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference015.htm
new file mode 100644
index 0000000000..e168f5ee9f
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference015.htm
@@ -0,0 +1,116 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Icons</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Icons" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACGEACG" name="CACGEACG"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Icons</h1>
+</td>
+</tr>
+</table>
+<p>The following icons are used throughout the Dali OR Mapping Tool.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the icons used in the Dali plug-in." summary="This table describes the icons used in the Dali plug-in." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t16">Icon</th>
+<th align="left" valign="bottom" id="r1c2-t16">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t16" headers="r1c1-t16"><img src="img/icon_nonpersistent.png" alt="Nonpersistent class icon" title="Nonpersistent class icon" /><br /></td>
+<td align="left" headers="r2c1-t16 r1c2-t16">Nonpersistent class</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t16" headers="r1c1-t16"><img src="img/icon_persistent.png" alt="Persistent entity icon" title="Persistent entity icon" /><br /></td>
+<td align="left" headers="r3c1-t16 r1c2-t16"><a href="tasks004.htm#BABGBIEE">Entity</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t16" headers="r1c1-t16"><img src="img/icon_embeddable.png" alt="Embeddable entity icon" title="Embeddable entity icon" /><br /></td>
+<td align="left" headers="r4c1-t16 r1c2-t16"><a href="tasks005.htm#BABFEICE">Embeddable</a> entity</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t16" headers="r1c1-t16"><img src="img/icon_superclass.png" alt="Mapped superclass icon" title="Mapped superclass icon" /><br /></td>
+<td align="left" headers="r5c1-t16 r1c2-t16"><a href="tasks006.htm#BABDAGCI">Mapped superclass</a></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t16" headers="r1c1-t16"><img src="img/icon_basicmapping.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td>
+<td align="left" headers="r6c1-t16 r1c2-t16"><a href="tasks007.htm#BABBABCE">Basic mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r7c1-t16" headers="r1c1-t16"><img src="img/icon_embeddedmapping.png" alt="Embedded mapping icon" title="Embedded mapping icon" /><br /></td>
+<td align="left" headers="r7c1-t16 r1c2-t16"><a href="tasks008.htm#BABCBHDF">Embedded mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r8c1-t16" headers="r1c1-t16"><img src="img/icon_embeddedidmapping.png" alt="Embedded ID mapping icon" title="Embedded ID mapping icon" /><br /></td>
+<td align="left" headers="r8c1-t16 r1c2-t16"><a href="tasks009.htm#CIHDIAEE">Embedded ID mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r9c1-t16" headers="r1c1-t16"><img src="img/icon_idmapping.png" alt="ID mapping icon" title="ID mapping icon" /><br /></td>
+<td align="left" headers="r9c1-t16 r1c2-t16"><a href="tasks010.htm#BABGCBHG">ID mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r10c1-t16" headers="r1c1-t16"><img src="img/icon_mmmapping.png" alt="Many-to-many mapping icon" title="Many-to-many mapping icon" /><br /></td>
+<td align="left" headers="r10c1-t16 r1c2-t16"><a href="tasks011.htm#BABEIEGD">Many-to-many mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r11c1-t16" headers="r1c1-t16"><img src="img/icon_m1mapping.png" alt="Many-to-one mapping icon" title="Many-to-one mapping icon" /><br /></td>
+<td align="left" headers="r11c1-t16 r1c2-t16"><a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r12c1-t16" headers="r1c1-t16"><img src="img/icon_1mmapping.png" alt="One-to-many mapping icon" title="One-to-many mapping icon" /><br /></td>
+<td align="left" headers="r12c1-t16 r1c2-t16"><a href="tasks013.htm#BABHGEBD">One-to-many mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r13c1-t16" headers="r1c1-t16"><img src="img/icon_11mapping.png" alt="One-to-one mapping icon" title="One-to-one mapping icon" /><br /></td>
+<td align="left" headers="r13c1-t16 r1c2-t16"><a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r14c1-t16" headers="r1c1-t16"><img src="img/icon_transientmapping.png" alt="Transient mapping icon" title="Transient mapping icon" /><br /></td>
+<td align="left" headers="r14c1-t16 r1c2-t16"><a href="tasks015.htm#BABHFHEI">Transient mapping</a><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r15c1-t16" headers="r1c1-t16"><img src="img/icon_versionmapping.png" alt="Version mapping icon" title="Version mapping icon" /><br /></td>
+<td align="left" headers="r15c1-t16 r1c2-t16"><a href="tasks016.htm#BABHIBII">Version mapping</a><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<p><a href="reference014.htm#CACDHCIA">Icons and buttons</a></p>
+</div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference016.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference016.htm
new file mode 100644
index 0000000000..911fefb9e6
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference016.htm
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Buttons</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Buttons" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACDJCEI" name="CACDJCEI"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Buttons</h1>
+</td>
+</tr>
+</table>
+<p>The following buttons are used throughout the Dali OR Mapping Tool.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the buttons used in the Dali plug-in." summary="This table describes the buttons used in the Dali plug-in." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t17">Icon</th>
+<th align="left" valign="bottom" id="r1c2-t17">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t17" headers="r1c1-t17"><img src="img/button_jpa_perspective.png" alt="Persistence Perspective button" title="Persistence Perspective button" /><br /></td>
+<td align="left" headers="r2c1-t17 r1c2-t17">JPA perspective</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<p><a href="reference014.htm#CACDHCIA">Icons and buttons</a></p>
+</div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference017.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference017.htm
new file mode 100644
index 0000000000..e0059a8af8
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference017.htm
@@ -0,0 +1,44 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Javadoc</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Javadoc" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<div class="sect1"><!-- infolevel="all" infotype="General" --><a id="sthref247" name="sthref247"></a>
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Javadoc</h1>
+</td>
+</tr>
+</table>
+<p>There is no public API for Release 1.0.0. Please refer to the <a href="reference018.htm#CACBBDIB">Dali Developer Documentation</a> for additional information.</p>
+</div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference018.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference018.htm
new file mode 100644
index 0000000000..ae52e9bcc5
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference018.htm
@@ -0,0 +1,58 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:14 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Dali Developer Documentation</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Dali Developer Documentation" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACBBDIB" name="CACBBDIB"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Dali Developer Documentation</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref248" name="sthref248"></a><a id="sthref249" name="sthref249"></a><a id="sthref250" name="sthref250"></a>Additional Dali documentation is available online at:</p>
+<p><code><a href="http://wiki.eclipse.org/index.php/Dali_Developer_Documentation">http://wiki.eclipse.org/index.php/Dali_Developer_Documentation</a></code></p>
+<p>This developer documentation includes information about:</p>
+<ul>
+<li type="disc">
+<p>Dali architecture</p>
+</li>
+<li type="disc">
+<p>Plugins that comprise the Dali JPA Eclipse feature</p>
+</li>
+<li type="disc">
+<p>Extension points</p>
+</li>
+</ul>
+</div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_add_persistence.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_add_persistence.htm
new file mode 100644
index 0000000000..e0f639f1d6
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_add_persistence.htm
@@ -0,0 +1,60 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:09 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Adding persistence to a class</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Adding persistence to a class" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABHICAI" name="BABHICAI"></a></p>
+<div class="sect1">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Adding persistence to a class</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref73" name="sthref73"></a><a id="sthref74" name="sthref74"></a><a id="sthref75" name="sthref75"></a>You can make a Java class into one of the following persistent types:</p>
+<ul>
+<li type="disc">
+<p><a href="tasks004.htm#BABGBIEE">Entity</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks005.htm#BABFEICE">Embeddable</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks006.htm#BABDAGCI">Mapped superclass</a></p>
+</li>
+</ul>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related tasks" title="Related tasks" /><br />
+<br />
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_persistence.htm#BABCAHIC">Understanding Java persistence</a> <!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_create_new_project.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_create_new_project.htm
new file mode 100644
index 0000000000..ef83c69ef1
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_create_new_project.htm
@@ -0,0 +1,90 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Creating a new JPA project</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Creating a new JPA project" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHHEJCJ" name="CIHHEJCJ"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Creating a new JPA project</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref49" name="sthref49"></a><a id="sthref50" name="sthref50"></a>Use this procedure to create a new JPA project.</p>
+<p><a href="viewlets/CreateProject/CreateProject.swf">Show me...</a></p>
+<ol type="1" start="1">
+<li>
+<p>Select <span class="bold">File &gt; New &gt; Other</span>. The New Project dialog appears.</p>
+</li>
+<li>
+<p><a id="sthref51" name="sthref51"></a><a id="sthref52" name="sthref52"></a>On the New Project dialog, select <span class="bold">JPA &gt; JPA Project</span> and click <span class="bold">Next</span>. The New JPA Project wizard appears.</p>
+<div class="figure"><a id="sthref53" name="sthref53"></a>
+<p class="titleinfigure"><a id="sthref54" name="sthref54"></a>New JPA Project</p>
+<img src="img/new_jpa_project_dialog.png" alt="Using the Java Persistence &gt; Add Java Persistence menu option." title="Using the Java Persistence &gt; Add Java Persistence menu option." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Complete the fields on the <a href="ref_new_jpa_project.htm#CACBJAGC">New JPA Project page</a> to specify the project name and location, target runtime, and pre-defined configuration.</p>
+</li>
+<li>
+<p>Click <span class="bold">Next</span>. The Project Facets page appears.</p>
+</li>
+<li>
+<p>Select.... informationPending</p>
+<p>The JPA Facet page appears.</p>
+<div class="figure"><a id="sthref55" name="sthref55"></a>
+<p class="titleinfigure"><a id="sthref56" name="sthref56"></a>New JPA Project</p>
+<img src="img/jpa_facet_dialog.png" alt="Using the Java Persistence &gt; Add Java Persistence menu option." title="Using the Java Persistence &gt; Add Java Persistence menu option." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Complete the fields on the <a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a> to specify your vender-specific platform, database connection, and JPA implementation library.</p>
+</li>
+<li>
+<p>Click <span class="bold">Finish</span>. You should now open the <a href="ref_persistence_perspective.htm#BABIFBDB">JPA perspective</a>.</p>
+</li>
+</ol>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<br />
+<a href="ref_persistence_perspective.htm#BABIFBDB">JPA perspective</a>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related tasks" title="Related tasks" /><br />
+<br />
+<a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a><br />
+<a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_persistence.htm#BABCAHIC">Understanding Java persistence</a><br />
+<a href="concepts002.htm#CHDHAGIH">The persistence.xml file</a><br /></div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_generate_ddl.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_generate_ddl.htm
new file mode 100644
index 0000000000..023a872c1a
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_generate_ddl.htm
@@ -0,0 +1,82 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:11 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Generating tables (DDL scripts) from entities</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Generating tables (DDL scripts) from entities" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABJJIAA" name="BABJJIAA"></a></p>
+<div class="sect1">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Generating tables (DDL scripts) from entities</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref159" name="sthref159"></a><a id="sthref160" name="sthref160"></a><a id="sthref161" name="sthref161"></a>Use this procedure to generate DDL script (for database tables) from your persistent entities. You must establish a database connection <span class="italic">before</span> generating DDL files.</p>
+<ol type="1" start="1">
+<li>
+<p>Right-click the persistent project in the <span class="gui-object-title">Package Explorer</span> and select <span class="gui-object-action">Java Persistence &gt; Generate DDL</span>.</p>
+<div class="figure"><a id="sthref162" name="sthref162"></a>
+<p class="titleinfigure">Generating DDL from Entities</p>
+<img src="img/generate_ddl.png" alt="Using the Java Persistence &gt; Add Java Persistence menu option." title="Using the Java Persistence &gt; Add Java Persistence menu option." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Complete the information on each page of the .</p>
+<p>Refer to the "Using web tools" section of the Web Application Development Guide for additional information.</p>
+<div class="figure"><a id="sthref163" name="sthref163"></a>
+<p class="titleinfigure">Generate DDL &ndash; Options page</p>
+<img src="img/generate_ddl_options.png" alt="This figure shows the Options page of the Generate DDL wizard." title="This figure shows the Options page of the Generate DDL wizard." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Complete the information on the page of the and click <span class="bold">Next</span>.</p>
+<div class="figure"><a id="sthref164" name="sthref164"></a>
+<p class="titleinfigure">Generate DDL &ndash; Objects page</p>
+<img src="img/generate_ddl_objects.png" alt="This figure shows the Objects page of the Generate DDL wizard." title="This figure shows the Objects page of the Generate DDL wizard." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Complete the information on the page of the and click <span class="bold">Next</span>.</p>
+<div class="figure"><a id="sthref165" name="sthref165"></a>
+<p class="titleinfigure">Generate DDL &ndash; Save and Run page</p>
+<img src="img/generate_ddl_save.png" alt="This figure shows the Save and Run page of the Generate DDL wizard." title="This figure shows the Save and Run page of the Generate DDL wizard." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Review the information on the Summary page. If the information is correct, click <span class="bold">Finish</span> to generate the script. If not, click <span class="bold">Back</span> to change the necessary information.</p>
+</li>
+</ol>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="../org.eclipse.wst.datatools.fe.ui.doc.user/topics/tddl_wiz.htm">Generating a DDL Script</a><br />
+<a href="tasks017.htm#BABBAGFI">Generating entities from tables</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br /></div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_generate_entities.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_generate_entities.htm
new file mode 100644
index 0000000000..7b1ccc3f6b
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_generate_entities.htm
@@ -0,0 +1,74 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:13 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Generate Entities from Tables dialog</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Generate Entities from Tables dialog" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CACDAFJD" name="CACDAFJD"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Generate Entities from Tables dialog</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref240" name="sthref240"></a><a id="sthref241" name="sthref241"></a><a id="sthref242" name="sthref242"></a>Use the <span class="gui-object-title">Generate Entities</span> dialog to create Java persistent entities from your database tables and columns.</p>
+<p>This table lists the properties available in the <span class="gui-object-title">Generate Entities dialog</span>.</p>
+<div class="inftblinformal">
+<table class="Informal" title="This table describes the options on the Generate Entities dialog." summary="This table describes the options on the Generate Entities dialog." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t13">Property</th>
+<th align="left" valign="bottom" id="r1c2-t13">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t13" headers="r1c1-t13">Source Folder</td>
+<td align="left" headers="r2c1-t13 r1c2-t13">Enter a project folder name in which to generate the Java persistent entities, or click <span class="bold">Browse</span> to select an existing folder.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t13" headers="r1c1-t13">Package</td>
+<td align="left" headers="r3c1-t13 r1c2-t13">Enter a package name in which to generate the Java persistent entities, or click <span class="bold">Browse</span> to select an existing package.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t13" headers="r1c1-t13">Tables</td>
+<td align="left" headers="r4c1-t13 r1c2-t13">Select the tables from which to create Java persistent entities. The tables shown are determined by the database connection that you defined in the <a href="ref_project_properties.htm#BABJHBCI">Project Properties page &ndash; JPA Options</a>.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblinformal" -->
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<p><a href="tasks017.htm#BABBAGFI">Generating entities from tables</a></p>
+<p>&nbsp;</p>
+</div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_inheritance.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_inheritance.htm
new file mode 100644
index 0000000000..dd54deb3e8
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_inheritance.htm
@@ -0,0 +1,143 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:09 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Specifying entity inheritance</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Specifying entity inheritance" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHCCCJD" name="CIHCCCJD"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Specifying entity inheritance</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref96" name="sthref96"></a><a id="sthref97" name="sthref97"></a>An entity may inherit properties from other entities. You can specify a specific strategy to use for inheritance.</p>
+<p>Use this procedure to specify inheritance (<code>@Inheritance)</code> for an existing entity (<code>@Entity</code>):</p>
+<ol type="1" start="1">
+<li>
+<p>Select the entity in the <span class="gui-object-title">Package Explorer</span>.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">JPA Details</span> view, select the <span class="gui-object-action">Inheritance</span> information.</p>
+<div class="figure"><a id="sthref98" name="sthref98"></a>
+<p class="titleinfigure">Specifying Inheritance</p>
+<img src="img/inheritance_tab.png" alt="Selecting the Inheritance tab on the Persistence Properties view." title="Selecting the Inheritance tab on the Persistence Properties view." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>In the <span class="bold">Strategy</span> list, select one of the following the inheritance strategies:</p>
+<ul>
+<li type="disc">
+<p>A single table (default)</p>
+</li>
+<li type="disc">
+<p>Joined table</p>
+</li>
+<li type="disc">
+<p>One table per class</p>
+</li>
+</ul>
+</li>
+<li>
+<p>Use the following table to complete the remaining fields on the tab. See <a href="reference004.htm#CACFHGHE">"Inheritance information"</a> for additional details.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table describes the options on the Persistence Properties view, Inheritance tab." summary="This table describes the options on the Persistence Properties view, Inheritance tab." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t2">Property</th>
+<th align="left" valign="bottom" id="r1c2-t2">Description</th>
+<th align="left" valign="bottom" id="r1c3-t2">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t2" headers="r1c1-t2"><a id="sthref99" name="sthref99"></a><a id="sthref100" name="sthref100"></a>Discriminator Column</td>
+<td align="left" headers="r2c1-t2 r1c2-t2">Name of the discriminator column when using a <span class="bold">Single</span> or <span class="bold">Joined</span> inheritance strategy.
+<p>This field corresponds to the <code>@DiscriminatorColumn</code> annotation.</p>
+</td>
+<td align="left" headers="r2c1-t2 r1c3-t2"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t2" headers="r1c1-t2">Discriminator Type</td>
+<td align="left" headers="r3c1-t2 r1c2-t2">Set the discriminator type to <code>Char</code> or <code>Integer</code> (instead of its default: <code>String</code>). The <span class="bold">Discriminator Value</span> must conform to this type.</td>
+<td align="left" headers="r3c1-t2 r1c3-t2">String</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t2" headers="r1c1-t2"><a id="sthref101" name="sthref101"></a><a id="sthref102" name="sthref102"></a>Discriminator Value</td>
+<td align="left" headers="r4c1-t2 r1c2-t2">Specify the discriminator value used to differentiate an entity in this inheritance hierarchy. The value must conform to the specified <span class="bold">Discriminator Type</span>.
+<p>This field corresponds to the <code>@DiscriminatorValue</code> annotation.</p>
+</td>
+<td align="left" headers="r4c1-t2 r1c3-t2"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t2" headers="r1c1-t2">Override Default</td>
+<td align="left" headers="r5c1-t2 r1c2-t2">Use this field to specify custom primary key join columns.
+<p>This field corresponds to the <code>@PrimaryKeyJoinClumn</code> annotation.</p>
+</td>
+<td align="left" headers="r5c1-t2 r1c3-t2"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>Eclipse adds the following annotations the entity field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@Inheritance(strategy=InheritanceType.<span class="italic">&lt;INHERITANCE_STRATEGY&gt;</span>)
+@DiscriminatorColumn(name="<span class="italic">&lt;DISCRIMINATOR_COLUMN&gt;</span>",
+ discriminatorType=<span class="italic">&lt;DISCRIMINATOR_TYPE&gt;</span>)
+@DiscriminatorValue(value-"<span class="italic">&lt;DISCRIMINATOR_VALUE&gt;</span>")
+@PrimaryKeyJoinColumn(name="<span class="italic">&lt;JOIN_COLUMN_NAME&gt;</span>",
+ referencedColumnName = "<span class="italic">&lt;REFERENCED_COLUMN_NAME&gt;</span>")
+
+
+</pre>
+<p><a id="sthref103" name="sthref103"></a><a id="sthref104" name="sthref104"></a><a id="sthref105" name="sthref105"></a>The following figures illustrates the different inheritance strategies.</p>
+<div class="figure"><a id="sthref106" name="sthref106"></a>
+<p class="titleinfigure">Single Table Inheritance</p>
+<img src="img/inheritance_single.png" alt="This figure illustrates entity inheritance in a single table." title="This figure illustrates entity inheritance in a single table." /><br /></div>
+<!-- class="figure" -->
+<div class="figure"><a id="sthref107" name="sthref107"></a>
+<p class="titleinfigure"><a id="sthref108" name="sthref108"></a><a id="sthref109" name="sthref109"></a>Joined Table Inheritance</p>
+<img src="img/inheritance_join.png" alt="This figure shows a sample joined inheritance table strategy." title="This figure shows a sample joined inheritance table strategy." /><br /></div>
+<!-- class="figure" -->
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_persistence.htm#BABCAHIC">Understanding Java persistence</a><br /></div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence.htm
new file mode 100644
index 0000000000..b040173e26
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence.htm
@@ -0,0 +1,68 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Managing the persistence.xml file</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Managing the persistence.xml file" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHDAJID" name="CIHDAJID"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1><a id="sthref57" name="sthref57"></a>Managing the persistence.xml file</h1>
+</td>
+</tr>
+</table>
+<p>When creating a JPA project, (see <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a>) you can also create the <code>persistence.xml</code> file.</p>
+<p><a id="sthref58" name="sthref58"></a>Eclipse creates the <code>META-INF\persistence.xml</code> file in your project's directory:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;persistence version="<span class="italic">&lt;PERSISTENCE_VERSION&gt;</span>"
+ xmlns="http://java.sun.com/xml/ns/persistence"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
+ http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"&gt;
+ &lt;persistence-unit name="<span class="italic">&lt;PERSISTENCE_UNIT_NAME&gt;</span>"&gt;
+ &lt;provider="<span class="italic">&lt;PERSISTENCE_PROVIDER&gt;</span>" /&gt;
+ &lt;/persistence-unit&gt;
+&lt;/persistence&gt;
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="tasks001.htm#CIHEJAIE">Working with persistence.xml file</a><br />
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concepts002.htm#CHDHAGIH">The persistence.xml file</a><br />
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence001.htm
new file mode 100644
index 0000000000..5ab188e1e7
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence001.htm
@@ -0,0 +1,68 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:09 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Managing the orm.xml file</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Managing the orm.xml file" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHDGDCD" name="CIHDGDCD"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1><a id="sthref68" name="sthref68"></a>Managing the orm.xml file</h1>
+</td>
+</tr>
+</table>
+<p>When creating a JPA project, (see <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a>) you can also create the <code>orm.xml</code> file that defines the mapping metadata and defaults.</p>
+<p><a id="sthref69" name="sthref69"></a>Eclipse creates the <code>META-INF\orm.xml</code> file in your project's directory:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;persistence version="<span class="italic">&lt;PERSISTENCE_VERSION&gt;</span>"
+ xmlns="http://java.sun.com/xml/ns/persistence"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
+ http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"&gt;
+ &lt;persistence-unit name="<span class="italic">&lt;PERSISTENCE_UNIT_NAME&gt;</span>"&gt;
+ &lt;provider="<span class="italic">&lt;PERSISTENCE_PROVIDER&gt;</span>" /&gt;
+ &lt;/persistence-unit&gt;
+&lt;/persistence&gt;
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="tasks003.htm#CIHBCDCE">Working with orm.xml file</a><br />
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concepts003.htm#CHDBIJAC">The orm.xml file</a><br />
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_mapping.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_mapping.htm
new file mode 100644
index 0000000000..ff32861280
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_mapping.htm
@@ -0,0 +1,78 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:10 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Mapping an entity</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Mapping an entity" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABDGBIJ" name="BABDGBIJ"></a></p>
+<div class="sect1">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Mapping an entity</h1>
+</td>
+</tr>
+</table>
+<p>Dali supports the following mapping types for Java persistent entities:</p>
+<ul>
+<li type="disc">
+<p><a href="tasks007.htm#BABBABCE">Basic mapping</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks008.htm#BABCBHDF">Embedded mapping</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks009.htm#CIHDIAEE">Embedded ID mapping</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks010.htm#BABGCBHG">ID mapping</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks011.htm#BABEIEGD">Many-to-many mapping</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks013.htm#BABHGEBD">One-to-many mapping</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks015.htm#BABHFHEI">Transient mapping</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks016.htm#BABHIBII">Version mapping</a></p>
+</li>
+</ul>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a> <!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks.htm
new file mode 100644
index 0000000000..925b683c32
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks.htm
@@ -0,0 +1,74 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Tasks</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content=" Tasks" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="sthref48" name="sthref48"></a></p>
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Tasks</h1>
+</td>
+</tr>
+</table>
+<p>This section includes detailed step-by-step procedures for accessing the Dali OR mapping tool functionality.</p>
+<ul>
+<li type="disc">
+<p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p>
+</li>
+<li type="disc">
+<p><a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a></p>
+</li>
+<li type="disc">
+<p><a href="task_manage_persistence001.htm#CIHDGDCD">Managing the orm.xml file</a></p>
+</li>
+<li type="disc">
+<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p>
+</li>
+<li type="disc">
+<p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p>
+</li>
+<li type="disc">
+<p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks017.htm#BABBAGFI">Generating entities from tables</a></p>
+</li>
+<li type="disc">
+<p><a href="task_generate_ddl.htm#BABJJIAA">Generating tables (DDL scripts) from entities</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks018.htm#BABFAIBA">Validating mappings and reporting problems</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks021.htm#BABDBCBI">Modifying persistent project properties</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks001.htm
new file mode 100644
index 0000000000..015ee3eebc
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks001.htm
@@ -0,0 +1,67 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Working with persistence.xml file</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Working with persistence.xml file" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHEJAIE" name="CIHEJAIE"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Working with persistence.xml file</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref59" name="sthref59"></a><a id="sthref60" name="sthref60"></a>You can work with the <code>persistence.xml</code> by using the XML Editor.</p>
+<p>Use this procedure to work with the <code>persistence.xml</code> file:</p>
+<ol type="1" start="1">
+<li>
+<p>Right-click the <code>persistence.xml</code> file in the <span class="gui-object-title">Package Explorer</span> and select <span class="gui-object-action">Open With &gt; XML Editor</span>.</p>
+<div class="figure"><a id="sthref61" name="sthref61"></a>
+<p class="titleinfigure">Opening the Persistence XML Editor</p>
+<img src="img/open_persistence_editor.png" alt="This figure shows the Open &gt; Persistence XML Editor option for the persistence.xml file." title="This figure shows the Open &gt; Persistence XML Editor option for the persistence.xml file." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p><a id="sthref62" name="sthref62"></a><a id="sthref63" name="sthref63"></a>Use the <span class="gui-object-title">Persistence XML Editor</span> to edit the <code>persistence.xml</code> file.</p>
+<div class="figure"><a id="sthref64" name="sthref64"></a>
+<p class="titleinfigure">Persistence XML Editor</p>
+<img src="img/persistence_xml_editor.png" alt="This figure shows the Persistence XML Editor." title="This figure shows the Persistence XML Editor." /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="#CIHEJAIE">Working with persistence.xml file</a><br />
+<a href="../org.eclipse.wst.xmleditor.doc.user/topics/cworkXML.html">Working with XML Files</a><br />
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concepts002.htm#CHDHAGIH">The persistence.xml file</a><br /></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks002.htm
new file mode 100644
index 0000000000..1a244be3e0
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks002.htm
@@ -0,0 +1,66 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:09 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Synchronizing classes</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Synchronizing classes" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHFEBAI" name="CIHFEBAI"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Synchronizing classes</h1>
+</td>
+</tr>
+</table>
+<p>As you work with the classes in your Java project, you will need to update the <code>persistence.xml</code> file to reflect the changes. <a id="sthref65" name="sthref65"></a><a id="sthref66" name="sthref66"></a></p>
+<p>Use this procedure to synchronize the <code>persistence.xml</code> file:</p>
+<ol type="1" start="1">
+<li>
+<p>Right-click the <code>persistence.xml</code> file in the <span class="gui-object-title">Package Explorer</span> and select <span class="gui-object-action">JPA Tools &gt; Synchronize Classes</span>.</p>
+<div class="figure"><a id="sthref67" name="sthref67"></a>
+<p class="titleinfigure">Synchronizing the persistence.xml File</p>
+<img src="img/synchornize_classes.png" alt="This figure shows the Java Persistence &gt; Synchronize Classes option." title="This figure shows the Java Persistence &gt; Synchronize Classes option." /><br /></div>
+<!-- class="figure" -->
+<p>Dali adds the necessary <code>&lt;class&gt;</code> elements to the <code>persistence.xml</code> file.</p>
+</li>
+<li>
+<p>Use the <span class="gui-object-title">Persistence XML Editor</span> to continue editing the <code>persistence.xml</code> file.</p>
+</li>
+</ol>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="tasks001.htm#CIHEJAIE">Working with persistence.xml file</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concepts002.htm#CHDHAGIH">The persistence.xml file</a><br /></div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks003.htm
new file mode 100644
index 0000000000..c6ba430d93
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks003.htm
@@ -0,0 +1,68 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:09 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Working with orm.xml file</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Working with orm.xml file" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHBCDCE" name="CIHBCDCE"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Working with orm.xml file</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref70" name="sthref70"></a><a id="sthref71" name="sthref71"></a>You can work with the <code>orm.xml</code> by using the JPA Details view.</p>
+<p>Use this procedure to work with the <code>orm.xml</code> file:</p>
+<ol type="1" start="1">
+<li>
+<p>Right-click the <code>orm.xml</code> file in the <span class="gui-object-title">Package Explorer</span> and select <span class="gui-object-action">Open</span>.</p>
+</li>
+<li>
+<p>In the JPA Structure view, select <span class="bold">EntityMappings</span>.</p>
+</li>
+<li>
+<p>Use the JPA Details view to configure the entity mapping and persistence unit defaults.</p>
+<div class="figure"><a id="sthref72" name="sthref72"></a>
+<p class="titleinfigure">JPA Details view for EntityMappings (orm.xml)</p>
+<img src="img/details_entitymappings.png" alt="This figure shows the Persistence XML Editor." title="This figure shows the Persistence XML Editor." /><br /></div>
+<!-- class="figure" --></li>
+</ol>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="#CIHBCDCE">Working with orm.xml file</a><br />
+<a href="../org.eclipse.wst.xmleditor.doc.user/topics/cworkXML.html">Working with XML Files</a><br />
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concepts003.htm#CHDBIJAC">The orm.xml file</a><br /></div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks004.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks004.htm
new file mode 100644
index 0000000000..d2beafee6e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks004.htm
@@ -0,0 +1,79 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:09 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Entity</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Entity" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABGBIEE" name="BABGBIEE"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Entity</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref76" name="sthref76"></a><a id="sthref77" name="sthref77"></a><a id="sthref78" name="sthref78"></a><a id="sthref79" name="sthref79"></a>An <span class="bold">Entity</span> is a persistent domain object.</p>
+<p>An entity <span class="italic">can be</span>:</p>
+<ul>
+<li type="disc">
+<p>Abstract or concrete classes. Entities may also extend non-entity classes as well as entity classes, and non-entity classes may extend entity classes.</p>
+</li>
+</ul>
+<p>An entity <span class="italic">must have</span>:</p>
+<ul>
+<li type="disc">
+<p>A no-arg constructor (public or protected); the entity class may have other constructors as well.</p>
+</li>
+</ul>
+<p><a id="sthref80" name="sthref80"></a><a id="sthref81" name="sthref81"></a><a id="sthref82" name="sthref82"></a>Each persistent entity must be mapped to a database table and contain a primary key. Persistent entities are identified by the <code>@Entity</code> annotation.</p>
+<p>Use this procedure to add persistence to an existing entity:</p>
+<ol type="1" start="1">
+<li>
+<p>Open the Java class in the <span class="gui-object-title">Package Explorer.</span></p>
+</li>
+<li>
+<p>Select the class in the JPA Structure view.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">JPA Details</span> view, use the <span class="gui-object-action">Map As</span> field to select <span class="gui-object-action">Entity</span>.</p>
+<div class="figure"><a id="sthref83" name="sthref83"></a>
+<p class="titleinfigure">Selecting Entity Persistence</p>
+<img src="img/persistence_view_entity.png" alt="Selecting entity persistence on the Persistence Properties view." title="Selecting entity persistence on the Persistence Properties view." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Complete the remaining <a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a>.</p>
+</li>
+</ol>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related tasks" title="Related tasks" /><br />
+<br />
+<a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks005.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks005.htm
new file mode 100644
index 0000000000..768d565c88
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks005.htm
@@ -0,0 +1,70 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:09 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Embeddable</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Embeddable" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABFEICE" name="BABFEICE"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Embeddable</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref84" name="sthref84"></a><a id="sthref85" name="sthref85"></a>An <span class="bold">Embedded</span> class is a class whose instances are stored as part of an owning entity; it shares the identity of the owning entity. Each field of the embedded class is mapped to the database table associated with the owning entity.</p>
+<p>To override the mapping information for a specific subclass, use the <code>@AttributeOverride</code> annotation for that specific class.</p>
+<p><a id="sthref86" name="sthref86"></a><a id="sthref87" name="sthref87"></a><a id="sthref88" name="sthref88"></a>An embeddable entity is identified by the <code>@Embeddable</code> annotation.</p>
+<p>Use this procedure to add embeddable persistence to an existing entity:</p>
+<ol type="1" start="1">
+<li>
+<p>Open the Java class in the <span class="gui-object-title">Package Explorer</span>.</p>
+</li>
+<li>
+<p>Select the class in the JPA Structure view.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">JPA Details</span> view, use the <span class="gui-object-action">Map As</span> drop-list to select <span class="gui-object-action">Embeddable</span>.</p>
+<div class="figure"><a id="sthref89" name="sthref89"></a>
+<p class="titleinfigure">Selecting Embeddable Persistence</p>
+<img src="img/persistence_view_embedded.png" alt="Selecting embedded persistence on the Persistence Properties view." title="Selecting embedded persistence on the Persistence Properties view." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Complete the remaining <a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a>.</p>
+</li>
+</ol>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related tasks" title="Related tasks" /><br />
+<dl>
+<dd><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></dd>
+</dl>
+</div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks006.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks006.htm
new file mode 100644
index 0000000000..2161753f16
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks006.htm
@@ -0,0 +1,84 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:09 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Mapped superclass</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Mapped superclass" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABDAGCI" name="BABDAGCI"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Mapped superclass</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref90" name="sthref90"></a>An entities that extend a <span class="bold">Mapped Superclass</span> class inherit the persistent state and mapping information from a superclass. You should use a mapped superclass to define mapping information that is common to multiple entity classes.</p>
+<p>A mapped superclass <span class="italic">can be</span>:</p>
+<ul>
+<li type="disc">
+<p>Abstract or concrete classes</p>
+</li>
+</ul>
+<p>A mapped superclass <span class="italic">cannot be</span>:</p>
+<ul>
+<li type="disc">
+<p>Be queried or passed as an argument to Entity-Manager or Query operations</p>
+</li>
+<li type="disc">
+<p>Be the target of a persistent relationship</p>
+</li>
+</ul>
+<p>A mapped superclass does not have a defined database table. Instead, its mapping information is derived from its superclass. To override the mapping information for a specific subclass, use the <code>@AttributeOverride</code> annotation for that specific class.</p>
+<p><a id="sthref91" name="sthref91"></a><a id="sthref92" name="sthref92"></a><a id="sthref93" name="sthref93"></a><a id="sthref94" name="sthref94"></a>A mapped superclass is identified by the <code>@MappedSuperclass</code> annotation.</p>
+<p>Use this procedure to add Mapped Superclass persistence to an existing entity:</p>
+<ol type="1" start="1">
+<li>
+<p>Open the Java class in the <span class="gui-object-title">Package Explorer</span>.</p>
+</li>
+<li>
+<p>Select the class in the JPA Structure view.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">JPA Details</span> view, use the <span class="gui-object-action">Map As</span> drop-list to select <span class="gui-object-action">Mapped Superclass</span>.</p>
+<div class="figure"><a id="sthref95" name="sthref95"></a>
+<p class="titleinfigure">Selecting Mapped Superclass Persistence</p>
+<img src="img/persistence_view_mappedsprc.png" alt="Selecting embedded persistence on the Persistence Properties view." title="Selecting embedded persistence on the Persistence Properties view." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Complete the remaining <a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a>.</p>
+</li>
+</ol>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related tasks" title="Related tasks" /><br />
+<br />
+<a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks007.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks007.htm
new file mode 100644
index 0000000000..2dbfc37566
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks007.htm
@@ -0,0 +1,206 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:10 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Basic mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Basic mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABBABCE" name="BABBABCE"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Basic mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref110" name="sthref110"></a><a id="sthref111" name="sthref111"></a><a id="sthref112" name="sthref112"></a><a id="sthref113" name="sthref113"></a>Use a <span class="bold">Basic Mapping</span> to map an attribute directly to a database column. Basic mappings may be used only with the following attribute types:</p>
+<ul>
+<li type="disc">
+<p>Java primitive types and wrappers of the primitive types</p>
+</li>
+<li type="disc">
+<p><code>java.lang.String, java.math.BigInteger</code></p>
+</li>
+<li type="disc">
+<p><code>java.math.BigDecimal</code></p>
+</li>
+<li type="disc">
+<p><code>java.util.Date</code></p>
+</li>
+<li type="disc">
+<p><code>java.util.Calendar, java.sql.Date</code></p>
+</li>
+<li type="disc">
+<p><code>java.sql.Time</code></p>
+</li>
+<li type="disc">
+<p><code>java.sql.Timestamp</code></p>
+</li>
+<li type="disc">
+<p><code>byte[]</code></p>
+</li>
+<li type="disc">
+<p><code>Byte[]</code></p>
+</li>
+<li type="disc">
+<p><code>char[]</code></p>
+</li>
+<li type="disc">
+<p><code>Character[]</code></p>
+</li>
+<li type="disc">
+<p>enums</p>
+</li>
+<li type="disc">
+<p>any other type that implements <code>Serializable</code></p>
+</li>
+</ul>
+<p>To create a basic mapping:</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Basic</span>.</p>
+</li>
+<li>
+<p>Use this table to complete the remaining fields on the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t3">Property</th>
+<th align="left" valign="bottom" id="r1c2-t3">Description</th>
+<th align="left" valign="bottom" id="r1c3-t3">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t3" headers="r1c1-t3">Map As</td>
+<td align="left" headers="r2c1-t3 r1c2-t3">Defines this mapping as a <span class="bold">Basic Mapping</span>.
+<p>This field corresponds to the <code>@Basic</code> annotation.</p>
+</td>
+<td align="left" headers="r2c1-t3 r1c3-t3">Basic</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t3" headers="r1c1-t3">Column</td>
+<td align="left" headers="r3c1-t3 r1c2-t3">The database column mapped to the entity attribute. See <a href="ref_mapping_general.htm#CACGCBHB">"Column"</a> for details.
+<ul>
+<li type="disc">
+<p>Name &ndash; Name of the database column.</p>
+</li>
+<li type="disc">
+<p>Table &ndash; Name of the database table.</p>
+</li>
+<li type="disc">
+<p>Insertable &ndash; Specify if the column is always included in <code>SQL INSERT</code> statements.</p>
+</li>
+<li type="disc">
+<p>Updatable &ndash; Specify if the column is always included in <code>SQL UPDATE</code> statements.</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r3c1-t3 r1c3-t3">By default, the Column is assumed to be named identically to the attribute and always included in the <code>INSERT</code> and <code>UPDATE</code> statements.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t3" headers="r1c1-t3">Table</td>
+<td align="left" headers="r4c1-t3 r1c2-t3">Name of the database table.</td>
+<td align="left" headers="r4c1-t3 r1c3-t3"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t3" headers="r1c1-t3">Fetch</td>
+<td align="left" headers="r5c1-t3 r1c2-t3">Defines how data is loaded from the database. See <a href="ref_mapping_general.htm#CACGGGHB">"Fetch Type"</a> for details.
+<ul>
+<li type="disc">
+<p>Eager</p>
+</li>
+<li type="disc">
+<p>Lazy</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r5c1-t3 r1c3-t3">Eager</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t3" headers="r1c1-t3">Optional</td>
+<td align="left" headers="r6c1-t3 r1c2-t3">Specifies if this field is can be null.</td>
+<td align="left" headers="r6c1-t3 r1c3-t3">Yes</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r7c1-t3" headers="r1c1-t3">Lob</td>
+<td align="left" headers="r7c1-t3 r1c2-t3">Specifies if this is a large objects (BLOB or CLOB). See <a href="ref_mapping_general.htm#CACBBIBI">"Lob"</a> for details.</td>
+<td align="left" headers="r7c1-t3 r1c3-t3"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r8c1-t3" headers="r1c1-t3">Temporal</td>
+<td align="left" headers="r8c1-t3 r1c2-t3">Specifies the type of data. See <a href="ref_mapping_general.htm#CACEAJGD">"Temporal"</a> for details.
+<ul>
+<li type="disc">
+<p>Date</p>
+</li>
+<li type="disc">
+<p>Time</p>
+</li>
+<li type="disc">
+<p>Timestamp</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r8c1-t3 r1c3-t3"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>Eclipse adds the following annotations to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@Column(name="<span class="italic">&lt;COLUMN_NAME&gt;</span>", table="<span class="italic">&lt;COLUMN_TABLE&gt;</span>",
+ insertable=<span class="italic">&lt;INSERTABLE&gt;</span>, updatable=<span class="italic">&lt;UPDATABLE&gt;</span>)
+@Basic(fetch=FetchType.<span class="italic">&lt;FETCH_TYPE&gt;</span>, optional = <span class="italic">&lt;OPTIONAL&gt;</span>)
+@Temporal(TemporalType.<span class="italic">&lt;TEMPORAL&gt;</span>)
+
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks008.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks008.htm
new file mode 100644
index 0000000000..f90e5d11d1
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks008.htm
@@ -0,0 +1,119 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:10 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Embedded mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Embedded mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABCBHDF" name="BABCBHDF"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Embedded mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref114" name="sthref114"></a><a id="sthref115" name="sthref115"></a><a id="sthref116" name="sthref116"></a><a id="sthref117" name="sthref117"></a>Use an <span class="bold">Embedded Mapping</span> to specify a persistent field or property of an entity whose value is an instance of an embeddable class.</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Embedded</span>.</p>
+</li>
+<li>
+<p>Use this table to complete the remaining fields on the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t4">Property</th>
+<th align="left" valign="bottom" id="r1c2-t4">Description</th>
+<th align="left" valign="bottom" id="r1c3-t4">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t4" headers="r1c1-t4">Map As</td>
+<td align="left" headers="r2c1-t4 r1c2-t4">Defines this mapping as a <span class="bold">Embedded</span>.
+<p>This field corresponds to the <code>@Embedded</code> annotation.</p>
+</td>
+<td align="left" headers="r2c1-t4 r1c3-t4">Embedded</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t4" headers="r1c1-t4">Attribute Overrides</td>
+<td align="left" headers="r3c1-t4 r1c2-t4">Specify to override the default mapping of an entity's attribute. Select <span class="bold">Override Default</span>.</td>
+<td align="left" headers="r3c1-t4 r1c3-t4"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t4" headers="r1c1-t4">Columns</td>
+<td align="left" headers="r4c1-t4 r1c2-t4">The database column (and its table) mapped to the entity attribute. See <a href="ref_mapping_general.htm#CACGCBHB">"Column"</a> for details.
+<ul>
+<li type="disc">
+<p>Name &ndash; Name of the database column.</p>
+</li>
+<li type="disc">
+<p>Table &ndash; Name of the database table.</p>
+</li>
+<li type="disc">
+<p>Insertable &ndash; Specify if the column is always included in <code>SQL INSERT</code> statements.</p>
+</li>
+<li type="disc">
+<p>Updatable &ndash; Specify if the column is always included in <code>SQL UPDATE</code> statements.</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r4c1-t4 r1c3-t4">By default, the Column is assumed to be named identically to the attribute and always included in the <code>INSERT</code> and <code>UPDATE</code> statements.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>Eclipse adds the following annotations to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@Embedded
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks009.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks009.htm
new file mode 100644
index 0000000000..b27efd9c49
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks009.htm
@@ -0,0 +1,94 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:10 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Embedded ID mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Embedded ID mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHDIAEE" name="CIHDIAEE"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Embedded ID mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref118" name="sthref118"></a><a id="sthref119" name="sthref119"></a><a id="sthref120" name="sthref120"></a><a id="sthref121" name="sthref121"></a>Use an <span class="bold">Embedded ID Mapping</span> to specify the primary key of an embedded ID. These mappings may be used with a <a href="tasks005.htm#BABFEICE">Embeddable</a> entities.</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Embedded Id</span>.</p>
+</li>
+<li>
+<p>Use this table to complete the remaining fields on the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t5">Property</th>
+<th align="left" valign="bottom" id="r1c2-t5">Description</th>
+<th align="left" valign="bottom" id="r1c3-t5">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t5" headers="r1c1-t5">Map As</td>
+<td align="left" headers="r2c1-t5 r1c2-t5">Defines this mapping as a <span class="bold">Embedded Id</span>.
+<p>This field corresponds to the <code>@EmbeddedId</code> annotation.</p>
+</td>
+<td align="left" headers="r2c1-t5 r1c3-t5">Embedded Id</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>Eclipse adds the following annotations to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@EmbeddedId
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks010.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks010.htm
new file mode 100644
index 0000000000..aef8ffb35c
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks010.htm
@@ -0,0 +1,191 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:10 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>ID mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="ID mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABGCBHG" name="BABGCBHG"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>ID mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref122" name="sthref122"></a><a id="sthref123" name="sthref123"></a><a id="sthref124" name="sthref124"></a><a id="sthref125" name="sthref125"></a>Use an <span class="bold">ID Mapping</span> to specify the primary key of an entity. ID mappings may be used with a <a href="tasks004.htm#BABGBIEE">Entity</a> or <a href="tasks006.htm#BABDAGCI">Mapped superclass</a>. Each <a href="tasks004.htm#BABGBIEE">Entity</a> must have an ID mapping.</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">ID</span>.</p>
+</li>
+<li>
+<p>Use this table to complete the <a href="ref_mapping_general.htm#CACBHFIJ">General information</a> fields in the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t6">Property</th>
+<th align="left" valign="bottom" id="r1c2-t6">Description</th>
+<th align="left" valign="bottom" id="r1c3-t6">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t6" headers="r1c1-t6">Map As</td>
+<td align="left" headers="r2c1-t6 r1c2-t6">Defines this mapping as an <span class="bold">ID Mapping</span>.
+<p>This field corresponds to the <code>@Id</code> annotation.</p>
+</td>
+<td align="left" headers="r2c1-t6 r1c3-t6">ID</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t6" headers="r1c1-t6">Column</td>
+<td align="left" headers="r3c1-t6 r1c2-t6">The database column (and its table) mapped to the entity attribute. See <a href="ref_mapping_general.htm#CACGCBHB">"Column"</a> for details.
+<ul>
+<li type="disc">
+<p>Name &ndash; Name of the database column.</p>
+</li>
+<li type="disc">
+<p>Table &ndash; Name of the database table.</p>
+</li>
+<li type="disc">
+<p>Insertable &ndash; Specify if the column is always included in <code>SQL INSERT</code> statements.</p>
+</li>
+<li type="disc">
+<p>Updatable &ndash; Specify if the column is always included in <code>SQL UPDATE</code> statements.</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r3c1-t6 r1c3-t6">By default, the Column is assumed to be named identically to the attribute and always included in the <code>INSERT</code> and <code>UPDATE</code> statements.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t6" headers="r1c1-t6">Table</td>
+<td align="left" headers="r4c1-t6 r1c2-t6"><br /></td>
+<td align="left" headers="r4c1-t6 r1c3-t6"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t6" headers="r1c1-t6">Temporal</td>
+<td align="left" headers="r5c1-t6 r1c2-t6">Specifies the type of data. See <a href="ref_mapping_general.htm#CACEAJGD">"Temporal"</a> for details.
+<ul>
+<li type="disc">
+<p>Date</p>
+</li>
+<li type="disc">
+<p>Time</p>
+</li>
+<li type="disc">
+<p>Timestamp</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r5c1-t6 r1c3-t6"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+<li>
+<p>Use this table to complete the fields in <a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a> area in the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the PK Generation tab." summary="This table lists the fields in the PK Generation tab." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t7">Property</th>
+<th align="left" valign="bottom" id="r1c2-t7">Description</th>
+<th align="left" valign="bottom" id="r1c3-t7">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t7" headers="r1c1-t7">Primary Key Generation</td>
+<td align="left" headers="r2c1-t7 r1c2-t7">These fields define how the primary key is generated.</td>
+<td align="left" headers="r2c1-t7 r1c3-t7"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t7" headers="r1c1-t7">&nbsp;&nbsp;Strategy</td>
+<td align="left" headers="r3c1-t7 r1c2-t7">See <a href="ref_primary_key.htm#CACBAJBC">"Primary Key Generation"</a> for details.
+<ul>
+<li type="disc">
+<p>Auto</p>
+</li>
+<li type="disc">
+<p>Sequence</p>
+</li>
+<li type="disc">
+<p>Identity</p>
+</li>
+<li type="disc">
+<p>Table</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r3c1-t7 r1c3-t7">Auto</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t7" headers="r1c1-t7">&nbsp;&nbsp;Generator&nbsp;Name</td>
+<td align="left" headers="r4c1-t7 r1c2-t7">Name of the primary key generator specified in the <span class="bold">Strategy</span></td>
+<td align="left" headers="r4c1-t7 r1c3-t7"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>Additional fields will appear in the <a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a> area, depending on the selected Strategy. See <a href="ref_persistence_map_view.htm#BABIFBAF">"JPA Details view (for attributes)"</a> for additional information.</p>
+<p>Eclipse adds the following annotations to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@Id
+@Column(name="<span class="italic">&lt;COLUMN_NAME&gt;</span>", table="<span class="italic">&lt;TABLE_NAME&gt;</span>", insertable=<span class="italic">&lt;INSERTABLE&gt;</span>,
+ updatable=<span class="italic">&lt;UPDATABLE&gt;</span>)
+@Temporal(TemporalType.<span class="italic">&lt;TEMPORAL&gt;</span>)
+@GeneratedValue(strategy=GeneratorType.<span class="italic">&lt;STRATEGY&gt;</span>, generator="<span class="italic">&lt;GENERATOR_NAME&gt;</span>")@TableGenerator(name="<span class="italic">&lt;TABLE_GENERATOR_NAME&gt;</span>", table = "<span class="italic">&lt;TABLE_GENERATOR_TABLE&gt;</span>",
+ pkColumnName = "<span class="italic">&lt;TABLE_GENERATOR_PK&gt;</span>",
+ valueColumnName = "<span class="italic">&lt;TABLE_GENERATOR_VALUE_COLUMN&gt;</span>",
+ pkColumnValue = "<span class="italic">&lt;TABLE_GENERATOR_PK_COLUMN_VALUE&gt;</span>")@SequenceGenerator(name="<span class="italic">&lt;SEQUENCE_GENERATOR_NAME&gt;</span>",
+ sequenceName="<span class="italic">&lt;SEQUENCE_GENERATOR_SEQUENCE&gt;</span>")
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm
new file mode 100644
index 0000000000..cb21d3e933
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm
@@ -0,0 +1,162 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:10 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Many-to-many mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Many-to-many mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABEIEGD" name="BABEIEGD"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Many-to-many mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref126" name="sthref126"></a><a id="sthref127" name="sthref127"></a><a id="sthref128" name="sthref128"></a><a id="sthref129" name="sthref129"></a>Use a <span class="bold">Many-to-Many Mapping</span> to define a many-valued association with many-to-many multiplicity. A many-to-many mapping has two sides: the <span class="italic">owning side</span> and <span class="italic">non-owning side</span>. You must specify the join table on the owning side. For bidirectional mappings, either side may be the owning side.</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Many-to-Many</span>.</p>
+</li>
+<li>
+<p>Use this table to complete the <a href="ref_mapping_general.htm#CACBHFIJ">General information</a> fields of the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t8">Property</th>
+<th align="left" valign="bottom" id="r1c2-t8">Description</th>
+<th align="left" valign="bottom" id="r1c3-t8">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t8" headers="r1c1-t8">Map As</td>
+<td align="left" headers="r2c1-t8 r1c2-t8">Defines this mapping as a <span class="bold">Many to Many Mapping</span>.
+<p>This field corresponds to the <code>@ManyToMany</code> annotation.</p>
+</td>
+<td align="left" headers="r2c1-t8 r1c3-t8">Many to Many</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t8" headers="r1c1-t8">Target Entity</td>
+<td align="left" headers="r3c1-t8 r1c2-t8">The entity to which this attribute is mapped.</td>
+<td align="left" headers="r3c1-t8 r1c3-t8">null
+<p>You do not need to explicitly specify the target entity, since it can be inferred from the type of object being referenced.</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t8" headers="r1c1-t8">Fetch</td>
+<td align="left" headers="r4c1-t8 r1c2-t8">Defines how data is loaded from the database. See <a href="ref_mapping_general.htm#CACGGGHB">"Fetch Type"</a> for details.
+<ul>
+<li type="disc">
+<p>Eager</p>
+</li>
+<li type="disc">
+<p>Lazy</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r4c1-t8 r1c3-t8">Eager</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t8" headers="r1c1-t8">Mapped By</td>
+<td align="left" headers="r5c1-t8 r1c2-t8">The database field that owns the relationship.</td>
+<td align="left" headers="r5c1-t8 r1c3-t8"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+<li>
+<p>Use this table to complete the fields in the <a href="reference005.htm#CACBAEBC">Join Table Information</a> area in the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Join Table tab of the Persistence Properties view for this mapping." summary="This table lists the fields in the Join Table tab of the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t9">Property</th>
+<th align="left" valign="bottom" id="r1c2-t9">Description</th>
+<th align="left" valign="bottom" id="r1c3-t9">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t9" headers="r1c1-t9">Name</td>
+<td align="left" headers="r2c1-t9 r1c2-t9">Name of the join table that contains the foreign key column.</td>
+<td align="left" headers="r2c1-t9 r1c3-t9">You must specify the join table on the owning side.
+<p>By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t9" headers="r1c1-t9">Join Columns</td>
+<td align="left" headers="r3c1-t9 r1c2-t9">Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</td>
+<td align="left" headers="r3c1-t9 r1c3-t9">By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t9" headers="r1c1-t9">Inverse Join Columns</td>
+<td align="left" headers="r4c1-t9 r1c2-t9">Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</td>
+<td align="left" headers="r4c1-t9 r1c3-t9">By default, the mapping is assumed to have a single join.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+<li>
+<p>To add a new Join or Inverse Join Column, click <span class="gui-object-action">Add</span>.</p>
+<p>To edit an existing Join or Inverse Join Column, select the field to and click <span class="gui-object-action">Edit</span>.</p>
+</li>
+</ol>
+<p>Eclipse adds the following annotations to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@JoinTable(joinColumns=@JoinColumn(name="<span class="italic">&lt;JOIN_COLUMN&gt;</span>"),
+ name = "<span class="italic">&lt;JOIN_TABLE_NAME&gt;</span>")
+@ManyToMany(cascade=CascadeType.<span class="italic">&lt;CASCADE_TYPE&gt;</span>, fetch=FetchType.<span class="italic">&lt;FETCH_TYPE&gt;</span>,
+ targetEntity=<span class="italic">&lt;TARGET_ENTITY&gt;</span>, mappedBy = "<span class="italic">&lt;MAPPED_BY&gt;</span>")
+@OrderBy("<span class="italic">&lt;ORDER_BY&gt;</span>")
+
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks012.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks012.htm
new file mode 100644
index 0000000000..15bcd589b9
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks012.htm
@@ -0,0 +1,162 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:10 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Many-to-one mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Many-to-one mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABHFAFJ" name="BABHFAFJ"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Many-to-one mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref130" name="sthref130"></a><a id="sthref131" name="sthref131"></a><a id="sthref132" name="sthref132"></a><a id="sthref133" name="sthref133"></a>Use a <span class="bold">Many-to-One</span> mapping to defines a single-valued association to another entity class that has many-to-one multiplicity.</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Many-to-One</span>.</p>
+</li>
+<li>
+<p>Use this table to complete the <a href="ref_mapping_general.htm#CACBHFIJ">General information</a> fields JPA Details view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields ion the General tab for this mapping." summary="This table lists the fields ion the General tab for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t10">Property</th>
+<th align="left" valign="bottom" id="r1c2-t10">Description</th>
+<th align="left" valign="bottom" id="r1c3-t10">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t10" headers="r1c1-t10">Target Entity</td>
+<td align="left" headers="r2c1-t10 r1c2-t10">The entity to which this attribute is mapped.</td>
+<td align="left" headers="r2c1-t10 r1c3-t10">null
+<p>You do not need to explicitly specify the target entity, since it can be inferred from the type of object being referenced.</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t10" headers="r1c1-t10">Fetch Type</td>
+<td align="left" headers="r3c1-t10 r1c2-t10">Defines how data is loaded from the database. See <a href="ref_mapping_general.htm#CACGGGHB">"Fetch Type"</a> for details.
+<ul>
+<li type="disc">
+<p>Eager</p>
+</li>
+<li type="disc">
+<p>Lazy</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r3c1-t10 r1c3-t10">Eager</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t10" headers="r1c1-t10">Cascade Type</td>
+<td align="left" headers="r4c1-t10 r1c2-t10">See <a href="ref_mapping_general.htm#CACJAIHB">"Cascade Type"</a> for details.
+<ul>
+<li type="disc">
+<p>Default</p>
+</li>
+<li type="disc">
+<p>All</p>
+</li>
+<li type="disc">
+<p>Persist</p>
+</li>
+<li type="disc">
+<p>Merge</p>
+</li>
+<li type="disc">
+<p>Remove</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r4c1-t10 r1c3-t10">Default</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t10" headers="r1c1-t10">Optional</td>
+<td align="left" headers="r5c1-t10 r1c2-t10">Specifies if this field is can be null.</td>
+<td align="left" headers="r5c1-t10 r1c3-t10">Yes</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+<li>
+<p>Use this table to complete the fields on the <a href="reference006.htm#CACFCEJC">Join Columns Information</a> tab in the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t11">Property</th>
+<th align="left" valign="bottom" id="r1c2-t11">Description</th>
+<th align="left" valign="bottom" id="r1c3-t11">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t11" headers="r1c1-t11">Join Column</td>
+<td align="left" headers="r2c1-t11 r1c2-t11"><a id="sthref134" name="sthref134"></a><a id="sthref135" name="sthref135"></a>Specify a mapped column for joining an entity association. This field corresponds to the <code>@JoinColum</code> attribute.
+<p>Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</p>
+</td>
+<td align="left" headers="r2c1-t11 r1c3-t11">By default, the mapping is assumed to have a single join.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>Eclipse adds the following annotations to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@JoinTable(joinColumns=@JoinColumn(name="<span class="italic">&lt;JOIN_COLUMN&gt;</span>"),
+ name = "<span class="italic">&lt;JOIN_TABLE_NAME&gt;</span>")
+@ManyToOne(targetEntity=<span class="italic">&lt;TARGET_ENTITY&gt;</span>, fetch=<span class="italic">&lt;FETCH_TYPE&gt;</span>,
+ cascade=<span class="italic">&lt;CASCADE_TYPE&gt;</span>)
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks013.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks013.htm
new file mode 100644
index 0000000000..b115ef0ff5
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks013.htm
@@ -0,0 +1,186 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:10 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>One-to-many mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="One-to-many mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABHGEBD" name="BABHGEBD"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>One-to-many mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref136" name="sthref136"></a><a id="sthref137" name="sthref137"></a><a id="sthref138" name="sthref138"></a><a id="sthref139" name="sthref139"></a>Use a <span class="bold">One-to-Many Mapping</span> to define a relationship with one-to-many multiplicity.</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">One-to-many</span>.</p>
+</li>
+<li>
+<p>Use this table to complete the <a href="ref_mapping_general.htm#CACBHFIJ">General information</a> fields JPA Details view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the General tab of the Persistence Properties view for this mapping." summary="This table lists the fields in the General tab of the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t12">Property</th>
+<th align="left" valign="bottom" id="r1c2-t12">Description</th>
+<th align="left" valign="bottom" id="r1c3-t12">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t12" headers="r1c1-t12">Target Entity</td>
+<td align="left" headers="r2c1-t12 r1c2-t12">The entity to which this attribute is mapped.</td>
+<td align="left" headers="r2c1-t12 r1c3-t12"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t12" headers="r1c1-t12">Cascade Type</td>
+<td align="left" headers="r3c1-t12 r1c2-t12">See <a href="ref_mapping_general.htm#CACJAIHB">"Cascade Type"</a> for details.
+<ul>
+<li type="disc">
+<p>Default</p>
+</li>
+<li type="disc">
+<p>All</p>
+</li>
+<li type="disc">
+<p>Persist</p>
+</li>
+<li type="disc">
+<p>Merge</p>
+</li>
+<li type="disc">
+<p>Remove</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r3c1-t12 r1c3-t12"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t12" headers="r1c1-t12">Fetch Type</td>
+<td align="left" headers="r4c1-t12 r1c2-t12">Defines how data is loaded from the database. See <a href="ref_mapping_general.htm#CACGGGHB">"Fetch Type"</a> for details.
+<ul>
+<li type="disc">
+<p>Eager</p>
+</li>
+<li type="disc">
+<p>Lazy</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r4c1-t12 r1c3-t12">Eager</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t12" headers="r1c1-t12">Mapped By</td>
+<td align="left" headers="r5c1-t12 r1c2-t12">The database field that owns the relationship.</td>
+<td align="left" headers="r5c1-t12 r1c3-t12"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t12" headers="r1c1-t12">Order By</td>
+<td align="left" headers="r6c1-t12 r1c2-t12">Specify the default order for objects returned from a query. See <a href="ref_mapping_general.htm#CACDADIH">"Order By"</a> for details.
+<ul>
+<li type="disc">
+<p>Primary key</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r6c1-t12 r1c3-t12">Primary key</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+<li>
+<p>Use this table to complete the <a href="reference005.htm#CACBAEBC">Join Table Information</a> fields in the JPA Details view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Join Table tab of the Persistence Properties view for this mapping." summary="This table lists the fields in the Join Table tab of the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t13">Property</th>
+<th align="left" valign="bottom" id="r1c2-t13">Description</th>
+<th align="left" valign="bottom" id="r1c3-t13">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t13" headers="r1c1-t13">Name</td>
+<td align="left" headers="r2c1-t13 r1c2-t13">Name of the join table</td>
+<td align="left" headers="r2c1-t13 r1c3-t13">By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t13" headers="r1c1-t13">Join Columns</td>
+<td align="left" headers="r3c1-t13 r1c2-t13">Specify two or more join columns (that is, a primary key).</td>
+<td align="left" headers="r3c1-t13 r1c3-t13"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t13" headers="r1c1-t13">Inverse Join Columns</td>
+<td align="left" headers="r4c1-t13 r1c2-t13">The join column on the owned (or inverse) side of the association: the owned entity's primary key column.</td>
+<td align="left" headers="r4c1-t13 r1c3-t13"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>Eclipse adds the following annotations to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@OneToMany(targetEntity=<span class="italic">&lt;TARGET_ENTITY&gt;</span>)
+@Column(name="<span class="italic">&lt;COLUMN&gt;</span>")
+
+
+@OneToMany(targetEntity=<span class="italic">&lt;TARGET_ENTITY&gt;</span>.class, cascade=CascadeType.<span class="italic">&lt;CASCADE_TYPE&gt;</span>,
+ fetch = FetchType.<span class="italic">&lt;FETCH_TYPE&gt;</span>, mappedBy = "<span class="italic">&lt;MAPPED_BY&gt;</span>")@OrderBy("<span class="italic">&lt;ORDER_BY&gt;</span>")
+@JoinTable(name="<span class="italic">&lt;JOIN_TABLE_NAME&gt;</span>", joinColumns=@JoinColumn(name=
+ "<span class="italic">&lt;JOIN_COLUMN_NAME&gt;</span>", referencedColumnName="<span class="italic">&lt;JOIN_COLUMN_REFERENCED_COLUMN&gt;</span>"),
+ inverseJoinColumns=@JoinColumn(name="<span class="italic">&lt;INVERSE_JOIN_COLUMN_NAME&gt;</span>",
+ referencedColumnName="<span class="italic">&lt;INVERSE_JOIN_COLUMN_REFERENCED_COLUMN&gt;</span>"))
+
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks014.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks014.htm
new file mode 100644
index 0000000000..a02c8fe0e4
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks014.htm
@@ -0,0 +1,169 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:11 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>One-to-one mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="One-to-one mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABFHBCJ" name="BABFHBCJ"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>One-to-one mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref140" name="sthref140"></a><a id="sthref141" name="sthref141"></a><a id="sthref142" name="sthref142"></a><a id="sthref143" name="sthref143"></a>Use a <span class="bold">One-to-One Mapping</span> to define a relationship with one-to-many multiplicity.</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">One-to-one</span>.</p>
+</li>
+<li>
+<p>Use this table to complete the <a href="ref_mapping_general.htm#CACBHFIJ">General information</a> fields in the JPA Details view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t14">Property</th>
+<th align="left" valign="bottom" id="r1c2-t14">Description</th>
+<th align="left" valign="bottom" id="r1c3-t14">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t14" headers="r1c1-t14">Target Entity</td>
+<td align="left" headers="r2c1-t14 r1c2-t14">The entity to which this attribute is mapped.</td>
+<td align="left" headers="r2c1-t14 r1c3-t14">null
+<p>You do not need to explicitly specify the target entity, since it can be inferred from the type of object being referenced.</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t14" headers="r1c1-t14">Cascade Type</td>
+<td align="left" headers="r3c1-t14 r1c2-t14">See <a href="ref_mapping_general.htm#CACJAIHB">"Cascade Type"</a> for details.
+<ul>
+<li type="disc">
+<p>Default</p>
+</li>
+<li type="disc">
+<p>All</p>
+</li>
+<li type="disc">
+<p>Persist</p>
+</li>
+<li type="disc">
+<p>Merge</p>
+</li>
+<li type="disc">
+<p>Remove</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r3c1-t14 r1c3-t14">Default</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r4c1-t14" headers="r1c1-t14">Fetch Type</td>
+<td align="left" headers="r4c1-t14 r1c2-t14">Defines how data is loaded from the database. See <a href="ref_mapping_general.htm#CACGGGHB">"Fetch Type"</a> for details.
+<ul>
+<li type="disc">
+<p>Eager</p>
+</li>
+<li type="disc">
+<p>Lazy</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r4c1-t14 r1c3-t14">Eager</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r5c1-t14" headers="r1c1-t14">Optional</td>
+<td align="left" headers="r5c1-t14 r1c2-t14">Specifies if this field is can be null.</td>
+<td align="left" headers="r5c1-t14 r1c3-t14">Yes</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t14" headers="r1c1-t14">Mapped By</td>
+<td align="left" headers="r6c1-t14 r1c2-t14">The database field that owns the relationship.</td>
+<td align="left" headers="r6c1-t14 r1c3-t14"><br /></td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+<li>
+<p>Use this table to complete the <a href="reference006.htm#CACFCEJC">Join Columns Information</a> fields in the <span class="gui-object-title">JPA Details</span> view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t15">Property</th>
+<th align="left" valign="bottom" id="r1c2-t15">Description</th>
+<th align="left" valign="bottom" id="r1c3-t15">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t15" headers="r1c1-t15">Join Column</td>
+<td align="left" headers="r2c1-t15 r1c2-t15"><a id="sthref144" name="sthref144"></a><a id="sthref145" name="sthref145"></a>Specify a mapped column for joining an entity association. This field corresponds to the <code>@JoinColum</code> attribute.
+<p>Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</p>
+</td>
+<td align="left" headers="r2c1-t15 r1c3-t15">By default, the mapping is assumed to have a single join.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>Eclipse adds the following annotations to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@OneToOne(targetEntity=<span class="italic">&lt;TARGET_ENTITY&gt;</span>, cascade=CascadeType.<span class="italic">&lt;CASCADE_TYPE&gt;</span>,
+ fetch = FetchType.<span class="italic">&lt;FETCH_TYPE&gt;</span>, mappedBy = "<span class="italic">&lt;MAPPED_BY&gt;</span>")
+@JoinColumn(name="<span class="italic">&lt;JOIN_COLUMN_NAME&gt;</span>", referencedColumnName=
+ "<span class="italic">&lt;JOIN_COLUMN_REFERENCED_COLUMN&gt;</span>", insertable = <span class="italic">&lt;INSERTABLE&gt;</span>,
+ updatable = <span class="italic">&lt;UPDATABLE&gt;</span>)
+
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks015.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks015.htm
new file mode 100644
index 0000000000..c0ce649c80
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks015.htm
@@ -0,0 +1,72 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:11 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Transient mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Transient mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABHFHEI" name="BABHFHEI"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Transient mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref146" name="sthref146"></a><a id="sthref147" name="sthref147"></a><a id="sthref148" name="sthref148"></a><a id="sthref149" name="sthref149"></a>Use the Transient Mapping to specify a or field of the entity class that <span class="italic">is not</span> persistent.</p>
+<p>To create a version mapping:</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Transient</span>.</p>
+</li>
+</ol>
+<p>Eclipse adds the following annotation to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@Transient
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks016.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks016.htm
new file mode 100644
index 0000000000..bdd0b205fc
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks016.htm
@@ -0,0 +1,129 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:11 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Version mapping</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Version mapping" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABHIBII" name="BABHIBII"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Version mapping</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref150" name="sthref150"></a><a id="sthref151" name="sthref151"></a><a id="sthref152" name="sthref152"></a><a id="sthref153" name="sthref153"></a>Use a <span class="bold">Version Mapping</span> to specify the field used for optimistic locking. If the entity is associated with multiple tables, you should use a version mapping only with the primary table. You should have only a single version mapping per persistent entity. Version mappings may be used only with the following attribute types:</p>
+<ul>
+<li type="disc">
+<p><code>int</code></p>
+</li>
+<li type="disc">
+<p><code>Integer</code></p>
+</li>
+<li type="disc">
+<p><code>short, Short</code></p>
+</li>
+<li type="disc">
+<p><code>long, Long</code></p>
+</li>
+<li type="disc">
+<p><code>Timestamp</code></p>
+</li>
+</ul>
+<p>To create a version mapping:</p>
+<ol type="1" start="1">
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Version</span>.</p>
+</li>
+<li>
+<p>Use this table to complete the remaining fields in the JPA Details view.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t16">Property</th>
+<th align="left" valign="bottom" id="r1c2-t16">Description</th>
+<th align="left" valign="bottom" id="r1c3-t16">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t16" headers="r1c1-t16">Column</td>
+<td align="left" headers="r2c1-t16 r1c2-t16">The database column (and its table) mapped to the entity attribute. See <a href="ref_mapping_general.htm#CACGCBHB">"Column"</a> for details.
+<ul>
+<li type="disc">
+<p>Name &ndash; Name of the database column.</p>
+</li>
+<li type="disc">
+<p>Table &ndash; Name of the database table. This must be the primary table associated with the attribute's entity.</p>
+</li>
+<li type="disc">
+<p>Insertable &ndash; Specify if the column is always included in <code>SQL INSERT</code> statements.</p>
+</li>
+<li type="disc">
+<p>Updatable &ndash; Specify if the column is always included in <code>SQL UPDATE</code> statements.</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r2c1-t16 r1c3-t16">By default, the Column is assumed to be named identically to the attribute and always included in the <code>INSERT</code> and <code>UPDATE</code> statements.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>Eclipse adds the following annotations to the field:</p>
+<pre xml:space="preserve" class="oac_no_warn">
+@Version
+@Column(table="<span class="italic">&lt;COLUMN_TABLE&gt;</span>", name="&lt;<span class="italic">COLUMN_NAME</span>&gt;", insertable=false,
+ updatable=false)
+
+
+</pre>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a>
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a><br />
+<a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a><br />
+<a href="concepts001.htm#BABBGFJG">Understanding EJB 3.0 Java Persistence API</a></div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks017.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks017.htm
new file mode 100644
index 0000000000..f78f1a6eff
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks017.htm
@@ -0,0 +1,74 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:11 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Generating entities from tables</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Generating entities from tables" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABBAGFI" name="BABBAGFI"></a></p>
+<div class="sect1">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Generating entities from tables</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref154" name="sthref154"></a><a id="sthref155" name="sthref155"></a>Use this procedure to generate Java persistent entities from database tables. You must create a JPA project and establish a database connection <span class="italic">before</span> generating persistent entities. See <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a> for more information.</p>
+<ol type="1" start="1">
+<li>
+<p>Right-click the JPA project in the <span class="gui-object-title">Package Explorer</span> and select <span class="gui-object-action">JPA Tools &gt; Generate Entities</span>.</p>
+<div class="figure"><a id="sthref156" name="sthref156"></a>
+<p class="titleinfigure">Generating Entities</p>
+<img src="img/generate_entities.png" alt="Using the Java Persistence &gt; Generate Entities menu option." title="Using the Java Persistence &gt; Generate Entities menu option." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>If you are not currently connected to the database, the Database Connection page appears. Select your database connection and schema, and click <span class="bold">Reconnect</span>.</p>
+<p>To create a new database connection, click <span class="bold">Add connection</span>.</p>
+<p>After connecting to the database, click <span class="bold">Next</span>.</p>
+</li>
+<li>
+<p><a id="sthref157" name="sthref157"></a><a id="sthref158" name="sthref158"></a>On the <a href="task_generate_entities.htm#CACDAFJD">Generate Entities from Tables dialog</a> dialog, select the tables from which to generate Java persistent entities and click <span class="bold">Finish</span>.</p>
+</li>
+</ol>
+<p>Eclipse creates a Java persistent entity for each database table. Each entity contains fields based on the table's columns. Eclipse will also generate entity relationships (such as one-to-one) based on the table constraints. <a href="#CIHJIJJC">Figure: Generating Entities from Tables</a> illustrates how Eclipse generates entities from tables.</p>
+<div class="figure"><a id="CIHJIJJC" name="CIHJIJJC"></a>
+<p class="titleinfigure">Generating Entities from Tables</p>
+<img src="img/table_entity.png" alt="This figure shows the EMPLOYEE and ADDRESS entities generated from database tabels." title="This figure shows the EMPLOYEE and ADDRESS entities generated from database tabels." /><br /></div>
+<!-- class="figure" -->
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br /></div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks018.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks018.htm
new file mode 100644
index 0000000000..1835c972c1
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks018.htm
@@ -0,0 +1,59 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:11 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Validating mappings and reporting problems</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Validating mappings and reporting problems" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABFAIBA" name="BABFAIBA"></a></p>
+<div class="sect1">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Validating mappings and reporting problems</h1>
+</td>
+</tr>
+</table>
+<p><a id="sthref166" name="sthref166"></a><a id="sthref167" name="sthref167"></a><a id="sthref168" name="sthref168"></a><a id="sthref169" name="sthref169"></a>Errors and warnings on persistent entities and mappings are indicated with a red error or yellow warning next to the resource with the error, as well as the parent containers up to the project.</p>
+<div class="figure"><a id="sthref170" name="sthref170"></a>
+<p class="titleinfigure">Sample Errors and Warnings</p>
+<img src="img/error_sample.png" alt="This figure shows sample error and warning icons in the Explorer view." title="This figure shows sample error and warning icons in the Explorer view." /><br /></div>
+<!-- class="figure" -->
+<p>This section contains information on the following:</p>
+<ul>
+<li type="disc">
+<p><a href="tasks019.htm#CIHFEDEI">Error messages</a></p>
+</li>
+<li type="disc">
+<p><a href="tasks020.htm#CIHGEAIJ">Warning messages</a></p>
+</li>
+</ul>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<p><a href="../org.eclipse.platform.doc.user/concepts/cprbview.htm">Problems view</a></p>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" --></div>
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks019.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks019.htm
new file mode 100644
index 0000000000..7122d145dc
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks019.htm
@@ -0,0 +1,123 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:11 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Error messages</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Error messages" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHFEDEI" name="CIHFEDEI"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Error messages<a id="sthref171" name="sthref171"></a></h1>
+</td>
+</tr>
+</table>
+<p>This section contains information on error messages (including how to resolve the issue) you may encounter while working with Dali.</p>
+<a id="sthref172" name="sthref172"></a>
+<p class="subhead2">Attribute "<span class="italic">&lt;ATTRIBUTE__NAME&gt;</span>" has invalid mapping type in this context</p>
+<p>Meaning</p>
+<a id="sthref173" name="sthref173"></a>
+<p class="subhead2">Attribute "<span class="italic">&lt;ATTRIBUTE_NAME&gt;</span>" cannot be resolved.</p>
+<p>Meaning</p>
+<a id="sthref174" name="sthref174"></a>
+<p class="subhead2">Class "<span class="italic">&lt;CLASS_NAME&gt;</span>" cannot be resolved.</p>
+<p>Meaning</p>
+<a id="sthref175" name="sthref175"></a>
+<p class="subhead2">Class "<span class="italic">&lt;CLASS_NAME&gt;</span>" is not annotated as a persistent class.</p>
+<p>The class has not been identified as a persistent class. Configure the class as an Entity, Mapped Superclass, or Embeddable persistent entity.</p>
+<p>See <a href="task_add_persistence.htm#BABHICAI">"Adding persistence to a class"</a>.</p>
+<a id="sthref176" name="sthref176"></a>
+<p class="subhead2">Column "<span class="italic">&lt;COLUMN_NAME&gt;</span>" cannot be resolved.</p>
+<p>You mapped an entity's field to an incorrect or invalid column in the database table. By default, Dali will attempt to map each field in the entity with an identically named row in the database table. If the field's name differs from the row's name, you must explicitly create the mapping.</p>
+<p>Map the field to a valid row in the database table as shown in <a href="task_mapping.htm#BABDGBIJ">"Mapping an entity"</a>.</p>
+<a id="sthref177" name="sthref177"></a>
+<p class="subhead2">Duplicate class "<span class="italic">&lt;CLASS_NAME&gt;</span>".</p>
+<p>You created to persistence classes with the same name. Each Java class must have a unique name. See <a href="task_add_persistence.htm#BABHICAI">"Adding persistence to a class"</a> for more information.</p>
+<a id="sthref178" name="sthref178"></a>
+<p class="subhead2">Duplicate mapping file "<span class="italic">&lt;FILE_NAME&gt;</span>".</p>
+<p>Meaning</p>
+<a id="sthref179" name="sthref179"></a>
+<p class="subhead2">Entity does not have an Id or Embedded Id.</p>
+<p>You created a persistent entity without identifying its primary key. A persistent entity must have a primary key field designated with an <code>@Id</code> or <code>@EmbeddedId</code> annotation.</p>
+<p>Add an ID mapping to the entity as shown in <a href="tasks010.htm#BABGCBHG">"ID mapping"</a> or <a href="tasks009.htm#CIHDIAEE">"Embedded ID mapping"</a>.</p>
+<a id="sthref180" name="sthref180"></a>
+<p class="subhead2">In virtual association override "<span class="italic">&lt;ITEM&gt;</span>" cannot be resolved.</p>
+<p>Meaning</p>
+<a id="sthref181" name="sthref181"></a>
+<p class="subhead2">In virtual attribute "<span class="italic">&lt;ITEM&gt;</span>" cannot be resolved.</p>
+<p>Meaning</p>
+<a id="sthref182" name="sthref182"></a>
+<p class="subhead2">Invalid content (no root node).</p>
+<p>Meaning</p>
+<a id="sthref183" name="sthref183"></a>
+<p class="subhead2">Join column/table "<span class="italic">&lt;COLUMN/TABLE_NAME&gt;</span>" cannot be resolved.</p>
+<p>Meaning</p>
+<a id="sthref184" name="sthref184"></a>
+<p class="subhead2">Mapping file "<span class="italic">&lt;MAPPING_FILE&gt;</span>" cannot be resolved.</p>
+<p>Meaning</p>
+<a id="sthref185" name="sthref185"></a>
+<p class="subhead2">Mapping file "<span class="italic">&lt;MAPPING_FILE&gt;</span>" does not have ORM content.</p>
+<p>Meaning</p>
+<a id="sthref186" name="sthref186"></a>
+<p class="subhead2">Metadata for persistence unit "<span class="italic">&lt;PERSISTENCE_UNIT&gt;</span>" specified in multiple mapping files.</p>
+<p>Meaning</p>
+<a id="sthref187" name="sthref187"></a>
+<p class="subhead2">Multiple persistence units defined.</p>
+<p>informationPending</p>
+<a id="sthref188" name="sthref188"></a>
+<p class="subhead2">Multiple persistence.xml files in project.</p>
+<p>You created a JPA project with more than one <code>persistence.xml</code> file. Each JPA project must contain a <span class="italic">single</span> <code>persistence.xml</code> file.</p>
+<p>See <a href="task_manage_persistence.htm#CIHDAJID">"Managing the persistence.xml file"</a> for more information.</p>
+<a id="sthref189" name="sthref189"></a>
+<p class="subhead2">No generator named "<span class="italic">&lt;GENERATOR_NAME&gt;</span>" is defined in persistence unit.</p>
+<p>You created a persistence entity that uses sequencing, but did not define include the sequence generator in the <code>psersistence.xml</code> file. Synchronize the <code>persistence.xml</code> file with your current project. See <a href="tasks002.htm#CIHFEBAI">"Synchronizing classes"</a> for more information.</p>
+<a id="sthref190" name="sthref190"></a>
+<p class="subhead2">No persistence unit defined.</p>
+<p>informationPending</p>
+<a id="sthref191" name="sthref191"></a>
+<p class="subhead2">No persistence.xml file in project.</p>
+<p>You created a JPA project without a <code>persistence.xml</code> file. Each JPA project must contain a <span class="italic">single</span> <code>persistence.xml</code> file.</p>
+<p>See <a href="task_manage_persistence.htm#CIHDAJID">"Managing the persistence.xml file"</a> for more information.</p>
+<a id="sthref192" name="sthref192"></a>
+<p class="subhead2">Referenced column "<span class="italic">&lt;COLUMN_NAME&gt;</span>" in join column "<span class="italic">&lt;COLUMN_NAME&gt;</span>" cannot be resolved.</p>
+<p>The column that you selected to join a relationship mapping does not exist on the database table. Either select a different column on the <a href="reference005.htm#CACBAEBC">Join Table Information</a> or create the necessary column on the database table.</p>
+<p>See <a href="ref_persistence_map_view.htm#BABIFBAF">"JPA Details view (for attributes)"</a> for more information.</p>
+<a id="sthref193" name="sthref193"></a>
+<p class="subhead2">Schema "&lt;<span class="italic">SCHEMA_NAME</span>&gt;" cannot be resolved for table/join table "&lt;<span class="italic">TABLE_NAME</span>&gt;".</p>
+<p>informationPending</p>
+<a id="sthref194" name="sthref194"></a>
+<p class="subhead2">Table "<span class="italic">&lt;TABLE_NAME&gt;</span>" cannot be resolved.</p>
+<p>You associated a persistent entity to an incorrect or invalid database table. By default, Dali will attempt to associate each persistent entity with an identically named database table. If the entity's name differs from the table's name, you must explicitly create the association.</p>
+<p>Associate the entity with a valid database table as shown in <a href="task_add_persistence.htm#BABHICAI">"Adding persistence to a class"</a>.</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<p><a href="../org.eclipse.platform.doc.user/concepts/cprbview.htm">Problems view</a></p>
+</div>
+<!-- class="sect2" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks020.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks020.htm
new file mode 100644
index 0000000000..c1f404a110
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks020.htm
@@ -0,0 +1,55 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Warning messages</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Warning messages" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CIHGEAIJ" name="CIHGEAIJ"></a></p>
+<div class="sect2"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Warning messages</h1>
+</td>
+</tr>
+</table>
+<p>This section contains information on warning messages (including how to resolve the issue) you may encounter while working with Dali.</p>
+<a id="sthref195" name="sthref195"></a>
+<p class="subhead2">Connection "<span class="italic">&lt;CONNECTION_NAME&gt;</span>" is not active. No validation will be done against the data source.</p>
+<p>The database connection you specified to use with the JPA project is not active. The JPA project requires an active connection.</p>
+<a id="sthref196" name="sthref196"></a>
+<p class="subhead2">No connection specified for the project. No data-specific validation will be performed.</p>
+<p>You created a JPA project without specifying a database connection. The JPA project requires an active connection.</p>
+<p>See <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a> or <a href="tasks021.htm#BABDBCBI">"Modifying persistent project properties"</a> for information on specifying a database connection.</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<p><a href="../org.eclipse.platform.doc.user/concepts/cprbview.htm">Problems view</a></p>
+</div>
+<!-- class="sect2" -->
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm
new file mode 100644
index 0000000000..401313a003
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm
@@ -0,0 +1,88 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:12 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Modifying persistent project properties</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Modifying persistent project properties" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABDBCBI" name="BABDBCBI"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Modifying persistent project properties</h1>
+</td>
+</tr>
+</table>
+<p>Each persistent project must be associated with a database connection. To create a new database connection, click <span class="gui-object-action">Database Connection</span> use the New Connection wizard.</p>
+<p>Use this procedure to modify the vender-specific platform and database connection associated with your JPA project.</p>
+<ol type="1" start="1">
+<li>
+<p>Right-click the project in the <span class="gui-object-title">Explorer</span> view and select <span class="gui-object-action">Properties</span>. The Properties page appears.</p>
+<div class="figure"><a id="sthref197" name="sthref197"></a>
+<p class="titleinfigure">Properties &ndash; Persistence Page</p>
+<img src="img/properties_persistence.png" alt="This figure shows the Java Persistence options on the Properties dialog." title="This figure shows the Java Persistence options on the Properties dialog." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Use this table to complete the remaining fields on the Properties &ndash; JPA page and click <span class="bold">OK</span>.</p>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the fields in the Properties - Java Persistence dialog." summary="This table lists the fields in the Properties - Java Persistence dialog." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t17">Property</th>
+<th align="left" valign="bottom" id="r1c2-t17">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t17" headers="r1c1-t17">Platform</td>
+<td align="left" headers="r2c1-t17 r1c2-t17">Select the vendor-specific platform for the JPA implementation.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t17" headers="r1c1-t17">Database Connection</td>
+<td align="left" headers="r3c1-t17 r1c2-t17">Database connection to use to store the persistent entities. To create a new connection, click <span class="bold">Add Connection</span>.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" --></li>
+</ol>
+<p>To create a new connection, click <span class="bold">Add connections</span>.</p>
+<p>&nbsp;</p>
+<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<p>&nbsp;</p>
+<img src="img/ngrelr.png" alt="Related reference" title="Related reference" /><br />
+<br />
+<a href="ref_project_properties.htm#BABJHBCI">Project Properties page &ndash; JPA Options</a>
+<p>&nbsp;</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="concept_persistence.htm#BABCAHIC">Understanding Java persistence</a></div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tips_and_tricks.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tips_and_tricks.htm
new file mode 100644
index 0000000000..5fe7ef6e8e
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tips_and_tricks.htm
@@ -0,0 +1,71 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:14 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Tips and tricks</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content=" Tips and tricks" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CHDHGHBF" name="CHDHGHBF"></a></p>
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Tips and tricks</h1>
+</td>
+</tr>
+</table>
+<p>The following tips and tricks give some helpful ideas for increasing your productivity.</p>
+<ul>
+<li type="disc">
+<p><a href="#BABFIIHA"><span class="bold">Database Connections</span></a></p>
+</li>
+<li type="disc">
+<p><a href="#BABCHAHF"><span class="bold">Schema-based persistence.xml</span></a></p>
+</li>
+</ul>
+<div class="inftblruleinformal">
+<table class="RuleInformal" title="This table lists the tips and tricks in this category." summary="This table lists the tips and tricks in this category." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
+<thead>
+<tr align="left" valign="top">
+<th align="left" valign="bottom" id="r1c1-t2">Tip</th>
+<th align="left" valign="bottom" id="r1c2-t2">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr align="left" valign="top">
+<td align="left" id="r2c1-t2" headers="r1c1-t2"><a id="BABFIIHA" name="BABFIIHA"></a><span class="bold">Database Connections</span></td>
+<td align="left" headers="r2c1-t2 r1c2-t2">When starting a new workbench session, be sure to <a href="../org.eclipse.wst.datatools.connection.ui.doc.user/topics/tdbconn_recon.html">reconnect to your database</a> (if you are working online). This allows Dali to provide database-related mapping assistance and validation.</td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r3c1-t2" headers="r1c1-t2"><a id="BABCHAHF" name="BABCHAHF"></a><span class="bold">Schema-based persistence.xml</span></td>
+<td align="left" headers="r3c1-t2 r1c2-t2">If you are behind a firewall, you may need to configure your Eclipse workspace proxy in the <a href="../org.eclipse.platform.doc.user/reference/ref-72.htm">Preferences dialog</a> (<span class="gui-object-action">Preferences &gt; Internet &gt; Proxy Settings</span>) to properly validate a schema-based <code>persistence.xml</code> file.</td>
+</tr>
+</tbody>
+</table>
+<br /></div>
+<!-- class="inftblruleinformal" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/toc.xml b/jpa/plugins/org.eclipse.jpt.doc.user/toc.xml
new file mode 100644
index 0000000000..665a299bf7
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/toc.xml
@@ -0,0 +1,117 @@
+<?xml version='1.0' encoding='iso-8859-1'?>
+<!-- User Guide -->
+ <toc label="Dali Java Persistence Tools User Guide"><topic label="Dali Java Persistence Tools User Guide">
+ <topic href="getting_started.htm" label="Getting started">
+ <topic href="getting_started001.htm#BABEFHCD" label="Requirements and installation" />
+ <topic href="getting_started002.htm#BABIGCJA" label="Dali quick start">
+ <topic href="getting_started003.htm#BABDFHDA" label="Creating a new project" />
+ <topic href="getting_started004.htm#BABFGDDG" label="Creating a Java persistent entity" />
+ <topic href="getting_started005.htm#BABHACAF" label="Mapping an entity" />
+ </topic>
+ <topic href="getting_started006.htm#BABCDECJ" label="Dali basic tutorial">
+ <topic href="getting_started007.htm#BABBBBID" label="Generate the tutorial database schema">
+ <topic href="getting_started008.htm#BABDHFCD" label="Create a database connection" />
+ </topic>
+ <topic href="getting_started009.htm#BABBBAIG" label="Create a JPA project" />
+ <topic href="getting_started010.htm#BABIJIGF" label="Create persistent Java entities">
+ <topic href="getting_started011.htm#BABDCBDD" label="Add fields to the entities" />
+ <topic href="getting_started012.htm#BABIHGGD" label="Associate the entity with a database table" />
+ </topic>
+ <topic href="getting_started013.htm#BABEBGBC" label="Create OR mappings">
+ <topic href="getting_started014.htm#BABGEFDI" label="Create ID mappings" />
+ <topic href="getting_started015.htm#BABEEFJA" label="Create basic mappings" />
+ <topic href="getting_started016.htm#BABGBGHF" label="Create one-to-one mappings" />
+ <topic href="getting_started017.htm#BABBEHEG" label="Create one-to-many mappings" />
+ <topic href="getting_started018.htm#BABCHIHI" label="Create many-to-one mappings" />
+ <topic href="getting_started019.htm#BABIDFFG" label="Create version mappings" />
+ </topic>
+ </topic>
+ </topic>
+ <topic href="concepts.htm" label=" Concepts">
+ <topic href="concept_persistence.htm#BABCAHIC" label="Understanding Java persistence" />
+ <topic href="concept_mapping.htm#BABBDJFI" label="Understanding OR mappings" />
+ <topic href="concepts001.htm#BABBGFJG" label="Understanding EJB 3.0 Java Persistence API">
+ <topic href="concepts002.htm#CHDHAGIH" label="The persistence.xml file" />
+ <topic href="concepts003.htm#CHDBIJAC" label="The orm.xml file" />
+ </topic>
+ </topic>
+ <topic href="tasks.htm" label=" Tasks">
+ <topic href="task_create_new_project.htm#CIHHEJCJ" label="Creating a new JPA project" />
+ <topic href="task_manage_persistence.htm#CIHDAJID" label="Managing the persistence.xml file">
+ <topic href="tasks001.htm#CIHEJAIE" label="Working with persistence.xml file" />
+ <topic href="tasks002.htm#CIHFEBAI" label="Synchronizing classes" />
+ </topic>
+ <topic href="task_manage_persistence001.htm#CIHDGDCD" label="Managing the orm.xml file">
+ <topic href="tasks003.htm#CIHBCDCE" label="Working with orm.xml file" />
+ </topic>
+ <topic href="task_add_persistence.htm#BABHICAI" label="Adding persistence to a class">
+ <topic href="tasks004.htm#BABGBIEE" label="Entity" />
+ <topic href="tasks005.htm#BABFEICE" label="Embeddable" />
+ <topic href="tasks006.htm#BABDAGCI" label="Mapped superclass" />
+ </topic>
+ <topic href="task_inheritance.htm#CIHCCCJD" label="Specifying entity inheritance" />
+ <topic href="task_mapping.htm#BABDGBIJ" label="Mapping an entity">
+ <topic href="tasks007.htm#BABBABCE" label="Basic mapping" />
+ <topic href="tasks008.htm#BABCBHDF" label="Embedded mapping" />
+ <topic href="tasks009.htm#CIHDIAEE" label="Embedded ID mapping" />
+ <topic href="tasks010.htm#BABGCBHG" label="ID mapping" />
+ <topic href="tasks011.htm#BABEIEGD" label="Many-to-many mapping" />
+ <topic href="tasks012.htm#BABHFAFJ" label="Many-to-one mapping" />
+ <topic href="tasks013.htm#BABHGEBD" label="One-to-many mapping" />
+ <topic href="tasks014.htm#BABFHBCJ" label="One-to-one mapping" />
+ <topic href="tasks015.htm#BABHFHEI" label="Transient mapping" />
+ <topic href="tasks016.htm#BABHIBII" label="Version mapping" />
+ </topic>
+ <topic href="tasks017.htm#BABBAGFI" label="Generating entities from tables" />
+ <topic href="task_generate_ddl.htm#BABJJIAA" label="Generating tables (DDL scripts) from entities" />
+ <topic href="tasks018.htm#BABFAIBA" label="Validating mappings and reporting problems">
+ <topic href="tasks019.htm#CIHFEDEI" label="Error messages" />
+ <topic href="tasks020.htm#CIHGEAIJ" label="Warning messages" />
+ </topic>
+ <topic href="tasks021.htm#BABDBCBI" label="Modifying persistent project properties" />
+ </topic>
+ <topic label=" Reference">
+ <topic label="Wizards">
+ <topic href="ref_new_jpa_project_wizard.htm#CACBJGBG" label="Create New JPA Project wizard">
+ <topic href="ref_new_jpa_project.htm#CACBJAGC" label="New JPA Project page" />
+ <topic href="ref_jpa_facet.htm#CACIFDIF" label="JPA Facet page" />
+ </topic>
+ </topic>
+ <topic label="Property pages">
+ <topic href="ref_persistence_prop_view.htm#BABFAEBB" label="JPA Details view (for entities)">
+ <topic href="reference003.htm#CACCAGGC" label="General information" />
+ <topic href="reference004.htm#CACFHGHE" label="Inheritance information" />
+ </topic>
+ <topic href="ref_persistence_map_view.htm#BABIFBAF" label="JPA Details view (for attributes)">
+ <topic href="ref_mapping_general.htm#CACBHFIJ" label="General information" />
+ <topic href="reference005.htm#CACBAEBC" label="Join Table Information" />
+ <topic href="reference006.htm#CACFCEJC" label="Join Columns Information" />
+ <topic href="ref_primary_key.htm#CACFCCAB" label="Primary Key Generation information" />
+ </topic>
+ <topic href="reference007.htm#CACGDGHC" label="JPA Details view (for orm.xml)">
+ <topic href="reference008.htm#CACCACGH" label="General information" />
+ <topic href="reference009.htm#CACEAGBG" label="Persistence Unit information" />
+ </topic>
+ <topic href="ref_persistence_outline.htm#BABEGGFE" label="JPA Structure view" />
+ </topic>
+ <topic label="Preferences">
+ <topic href="ref_project_properties.htm#BABJHBCI" label="Project Properties page - JPA Options" />
+ </topic>
+ <topic label="Dialogs">
+ <topic href="task_generate_entities.htm#CACDAFJD" label="Generate Entities from Tables dialog" />
+ <topic href="reference012.htm#CACCGEHC" label="Edit Join Columns Dialog" />
+ <topic href="reference013.htm#CACHJAGB" label="Database Connection Dialog" />
+ </topic>
+ <topic href="ref_persistence_perspective.htm#BABIFBDB" label="JPA perspective" />
+ <topic label="Icons and buttons">
+ <topic href="reference015.htm#CACGEACG" label="Icons" />
+ <topic href="reference016.htm#CACDJCEI" label="Buttons" />
+ </topic>
+ <topic href="reference017.htm#sthref247" label="Javadoc" />
+ <topic href="reference018.htm#CACBBDIB" label="Dali Developer Documentation" />
+ </topic>
+ <topic href="tips_and_tricks.htm" label="Tips and tricks" />
+ <topic href="whats_new.htm" label=" What's new" />
+ <topic href="legal.htm" label=" Legal" />
+ </topic>
+</toc>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new.htm
new file mode 100644
index 0000000000..c8928739b8
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new.htm
@@ -0,0 +1,53 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:14 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>What's new</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content=" What's new" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BGGEDBGF" name="BGGEDBGF"></a></p>
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>What's new</h1>
+</td>
+</tr>
+</table>
+<p>This section contains descriptions of the following new feature and significant changes made to the Dali OR Mapping Tool for Release 1.0.0:</p>
+<ul>
+<li type="disc">
+<p><a href="whats_new001.htm#BGGCJJBD">Generate Persistent Entities from Tables wizard</a></p>
+</li>
+<li type="disc">
+<p><a href="whats_new002.htm#CEGIDCCE">Generate DDL from Entities wizard</a></p>
+</li>
+<li type="disc">
+<p><a href="whats_new003.htm#CEGBCIBB">Create and Manage the persistence.xml file</a></p>
+</li>
+</ul>
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new001.htm
new file mode 100644
index 0000000000..464046314a
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new001.htm
@@ -0,0 +1,54 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:14 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Generate Persistent Entities from Tables wizard</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Generate Persistent Entities from Tables wizard" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BGGCJJBD" name="BGGCJJBD"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Generate Persistent Entities from Tables wizard</h1>
+</td>
+</tr>
+</table>
+<p>Use the <span class="gui-object-title">Generate Entities from Tables</span> wizard to quickly create Java persistent entities from your database tables.</p>
+<div class="figure"><a id="sthref251" name="sthref251"></a>
+<p class="titleinfigure">Generating Entities</p>
+<img src="img/generate_entities.png" alt="This figure shows selecting the Java Persistence &gt; Generate Entities option." title="This figure shows selecting the Java Persistence &gt; Generate Entities option." /><br /></div>
+<!-- class="figure" -->
+<p>Dali automatically creates the necessary OR mappings, based on your database table constraints.</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="whats_new.htm#BGGEDBGF">What's new</a> <img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="tasks017.htm#BABBAGFI">Generating entities from tables</a></div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new002.htm
new file mode 100644
index 0000000000..89342852e0
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new002.htm
@@ -0,0 +1,54 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:14 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Generate DDL from Entities wizard</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Generate DDL from Entities wizard" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CEGIDCCE" name="CEGIDCCE"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Generate DDL from Entities wizard</h1>
+</td>
+</tr>
+</table>
+<p>Use the <span class="gui-object-title">Generate DDL</span> wizard to quickly create DDL scripts from your persistent entities.</p>
+<div class="figure"><a id="sthref252" name="sthref252"></a>
+<p class="titleinfigure">Generating DDL</p>
+<img src="img/generate_ddl_summary.png" alt="This figure shows the Summary page from the Generating DDL wizard." title="This figure shows the Summary page from the Generating DDL wizard." /><br /></div>
+<!-- class="figure" -->
+<p>Dali automatically creates the necessary primary and foreign keys, based on your entity mappings.</p>
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="whats_new.htm#BGGEDBGF">What's new</a> <img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
+<br />
+<a href="task_generate_ddl.htm#BABJJIAA">Generating tables (DDL scripts) from entities</a></div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new003.htm
new file mode 100644
index 0000000000..28165d7f27
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new003.htm
@@ -0,0 +1,56 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<!-- Run date = May 3, 2007 9:19:14 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create and Manage the persistence.xml file</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create and Manage the persistence.xml file" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="CEGBCIBB" name="CEGBCIBB"></a></p>
+<div class="sect1"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create and Manage the persistence.xml file</h1>
+</td>
+</tr>
+</table>
+<p>When adding persistence to a Java project, you can also create the <code>perssistence.xml</code> file.</p>
+<div class="figure"><a id="sthref253" name="sthref253"></a>
+<p class="titleinfigure">Add Java Persistence Dialog</p>
+<img src="img/add_persistence_dialog_xml.png" alt="This figure shows the Add Java Persistence dialog." title="This figure shows the Add Java Persistence dialog." /><br /></div>
+<!-- class="figure" -->
+<p>Use the Packaging Settings options to create the <code>persistence.xml</code> file. After adding your persistent classes, use the <span class="gui-object-action">Java Persistence &gt; Synchronize Classes</span> option to add the classes to the <code>persistence.xml</code> file.</p>
+<div class="figure"><a id="sthref254" name="sthref254"></a>
+<p class="titleinfigure">Synchronizing the persistence.xml File.</p>
+<img src="img/synchornize_classes.png" alt="This figure shows the Java Persistence &gt; Synchronize Classes option." title="This figure shows the Java Persistence &gt; Synchronize Classes option." /><br /></div>
+<!-- class="figure" -->
+<img src="img/ngrelc.png" alt="Related concept" title="Related concept" /><br />
+<br />
+<a href="whats_new.htm#BGGEDBGF">What's new</a></div>
+<!-- class="sect1" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>

Back to the top