From c6f11ec0f73d2d3170db0350b121796701c9d3c8 Mon Sep 17 00:00:00 2001
From: dln <dln@opencascade.com>
Date: Tue, 2 Sep 2014 11:21:21 +0400
Subject: [PATCH] 0024927: Getting rid of "Persistent" functionality --
 Documentation

First version of upgrade manual (new developer guide) added, describing methods that can be used to convert data files written with old persistence, to formats supported by OCCT 7.0
---
 dox/FILES_HTML.txt                |  2 ++
 dox/dev_guides/dev_guides.md      |  6 +++-
 dox/dev_guides/upgrade/upgrade.md | 57 +++++++++++++++++++++++++++++++
 3 files changed, 64 insertions(+), 1 deletion(-)
 create mode 100644 dox/dev_guides/upgrade/upgrade.md

diff --git a/dox/FILES_HTML.txt b/dox/FILES_HTML.txt
index 3e7f0e7559..49221ccda8 100644
--- a/dox/FILES_HTML.txt
+++ b/dox/FILES_HTML.txt
@@ -60,4 +60,6 @@ dev_guides/building/code_blocks.md
 dev_guides/building/msvc.md
 dev_guides/building/xcode.md
 
+dev_guides/upgrade/upgrade.md
+
 license.md
diff --git a/dox/dev_guides/dev_guides.md b/dox/dev_guides/dev_guides.md
index f35fff8130..44f43bf5ab 100644
--- a/dox/dev_guides/dev_guides.md
+++ b/dox/dev_guides/dev_guides.md
@@ -11,8 +11,12 @@ The following documents provide information on OCCT building, development and te
 * @subpage occt_dev_guides__tests "Automatic Testing system"
 * @subpage occt_dev_guides__debug "Debugging tools and hints"
 
-Two other documents provide details on obsolete technologies used by OCCT, 
+These two documents provide details on obsolete technologies used by OCCT, 
 to be removed in future releases:
 
 * @subpage occt_dev_guides__wok "Workshop Organization Kit (WOK)"
 * @subpage occt_dev_guides__cdl "Component Definition Language (CDL)"
+
+The following guide provides information relevant to upgrading applications developed with previous versions of OCCT, to recent one:
+
+* @subpage occt_dev_guides__upgrade "Upgrade from previous OCCT versions"
diff --git a/dox/dev_guides/upgrade/upgrade.md b/dox/dev_guides/upgrade/upgrade.md
new file mode 100644
index 0000000000..ce86f5457a
--- /dev/null
+++ b/dox/dev_guides/upgrade/upgrade.md
@@ -0,0 +1,57 @@
+Upgrade from older OCCT versions  {#occt_dev_guides__upgrade}
+================================
+
+@tableofcontents
+
+@section occt_upgrade_intro Introduction
+
+This document provides technical details on upgrading user applications using previous versions of OCCT, to the current one.
+
+@subsection occt_upgrade_700 Upgrade to OCCT 7.0.0
+
+@subsubsection occt_upgrade_700_persist Removal of legacy persistence
+
+Legacy persistence for shapes and OCAF data based on Storage_Schema (toolkits TKShapeShcema, TLStdLSchema, TKStdSchema, TKXCAFSchema) has been removed in OCCT 7.0.0.
+Applications that used these persistence tools for their data need to be updated to use other persistence mechanisms.
+
+The existing data files in standard formats can be converted using OCCT 6.9.0 or previous, as follows.
+
+#### CSFDB files
+
+Files in CSFDB format (usually with extension .csfdb) contain OCCT shape data that can be converted to BRep format. 
+The easiest way to do that is to use ImportExport sample provided with OCCT 6.9.0 (or earlier):
+
+- Start ImportExport sample
+- Select File / New
+- Select File / Import / CSFDB... and specify the file to be converted
+- Drag mouse with right button pressed across the view to select all shapes by rectangle
+- Select File / Export / BREP... and specify location and name for the resulting file
+
+#### OCAF and XCAF documents
+
+Files containing OCAF data saved in old format usually have extensions .std or .sgd or .dxc (XDE documents).
+These files can be converted to XML or binary OCAF formats using DRAW Test Harness commands available in OCCT 6.9.0 or earlier.
+
+For that, start *DRAWEXE* and perform the following commands: 
+
+  * for the conversion of the "*.std" and "*.sgd" file formats to the binary format "*.cbf" (Created document should be in **BinOcaf** format instead of **MDTV-Standard**):
+
+  @code
+  Draw[]> pload ALL
+  Draw[]> Open [path to *.std or *.sgd file] Doc
+  Draw[]> Format Doc BinOcaf
+  Draw[]> SaveAs Doc [path to the new file]
+  @endcode
+
+  * for the conversion of the "*.dxc" file format to the binary format "*.xbf" (Created document should be in **BinXCAF** format instead of **MDTV-XCAF**):
+
+  @code
+  Draw[]> pload ALL
+  Draw[]> XOpen [path to *.dxc file] Doc
+  Draw[]> Format Doc BinXCAF
+  Draw[]> XSave Doc [path to the new file]
+  @endcode
+
+On Windows, be careful to replace back slashes in the file path by either direct slash or pairs of back slashes.
+Use "XmlOcaf" or "XmlXCAF" instead of "BinOcaf" and "BinXCAF", respectively, to save in XML format instead of binary one.
+
-- 
2.20.1