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

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 @@ The size of a stack frame is estimated as 8 bytes times the maximum number of ob
 					<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>

plugins/org.eclipse.mat.ui.help/tasks/configure_mat.html

@@ -639,6 +639,40 @@ <h1 class="title topictitle1" id="ariaid-title1">Memory Analyzer Configuration</
 				</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>