Bug 582462 Character encodings for output and input files

Add help

Task-Url: https://bugs.eclipse.org/bugs/show_bug.cgi?id=582260
Change-Id: I69f2e09b56bd9cf81421c724e012013bee144d3d
diff --git a/plugins/org.eclipse.mat.ui.help/tasks/configure_mat.dita b/plugins/org.eclipse.mat.ui.help/tasks/configure_mat.dita
index 134d6af..9929a0a 100644
--- a/plugins/org.eclipse.mat.ui.help/tasks/configure_mat.dita
+++ b/plugins/org.eclipse.mat.ui.help/tasks/configure_mat.dita
@@ -20,10 +20,10 @@
 			<copyryear year=""></copyryear>

 			<copyrholder>

 				Copyright (c) 2008, 2023 SAP AG and others.

-			    All rights reserved. This program and the accompanying materials

-			    are made available under the terms of the Eclipse Public License 2.0

-			    which accompanies this distribution, and is available at

-			    https://www.eclipse.org/legal/epl-2.0/

+				All rights reserved. This program and the accompanying materials

+				are made available under the terms of the Eclipse Public License 2.0

+				which accompanies this distribution, and is available at

+				https://www.eclipse.org/legal/epl-2.0/

 			</copyrholder>

 		</copyright>

 	</prolog>

@@ -598,6 +598,36 @@
 					<userinput>nautilus "${selected_resource_parent_loc}"</userinput>

 				</dd>

 			</dlentry>

+			<dlentry>

+				<dt>

+					<menucascade>

+						<uicontrol>General</uicontrol>

+						<uicontrol>Workspace</uicontrol>

+						<uicontrol>Text file encoding</uicontrol>

+					</menucascade>

+				</dt>

+				<dd>This configures the file encoding used for the following:

+					<ul>

+						<li>Report HTML/CSV/Text file output</li>

+						<li>Export HTML/CSV/Text file output</li>

+						<li>

+							<menucascade>

+								<uicontrol>Copy</uicontrol>

+								<uicontrol>Save Value to File</uicontrol>

+							</menucascade>

+						</li>

+						<li>Queries reading settings from files:

+							<ul>

+								<li>Customized Retained Set -xfile</li>

+								<li>Compare Tables and Trees</li>

+								<li>Find Leaks between Snapshots</li>

+							</ul>

+						</li>

+					</ul>

+					The initial setting is UTF-8, but this may be changed, for example to windows-1252.

+					However, some characters in HTML reports might then not be properly displayed.

+				</dd>

+			</dlentry>

 			</dl>

 			</p>

 		</context>

diff --git a/plugins/org.eclipse.mat.ui.help/tasks/configure_mat.html b/plugins/org.eclipse.mat.ui.help/tasks/configure_mat.html
index 46d3775..0c7572c 100644
--- a/plugins/org.eclipse.mat.ui.help/tasks/configure_mat.html
+++ b/plugins/org.eclipse.mat.ui.help/tasks/configure_mat.html
@@ -639,6 +639,40 @@
 				</dd>
 
 			
+			
+				<dt class="dt dlterm">
+					<span class="ph menucascade"><span class="ph uicontrol">General</span><abbr title="and then"> &gt; </abbr><span class="ph uicontrol">Workspace</span><abbr title="and then"> &gt; </abbr><span class="ph uicontrol">Text file encoding</span></span>
+				</dt>
+
+				<dd class="dd">This configures the file encoding used for the following:
+					<ul class="ul">
+						<li class="li">Report HTML/CSV/Text file output</li>
+
+						<li class="li">Export HTML/CSV/Text file output</li>
+
+						<li class="li">
+							<span class="ph menucascade"><span class="ph uicontrol">Copy</span><abbr title="and then"> &gt; </abbr><span class="ph uicontrol">Save Value to File</span></span>
+						</li>
+
+						<li class="li">Queries reading settings from files:
+							<ul class="ul">
+								<li class="li">Customized Retained Set -xfile</li>
+
+								<li class="li">Compare Tables and Trees</li>
+
+								<li class="li">Find Leaks between Snapshots</li>
+
+							</ul>
+
+						</li>
+
+					</ul>
+
+					The initial setting is UTF-8, but this may be changed, for example to windows-1252.
+					However, some characters in HTML reports might then not be properly displayed.
+				</dd>
+
+			
 			</dl>
 
 			</div>