plugins/org.eclipse.oomph.setup.ui/html/RecorderHelp.html - oomph/org.eclipse.oomph - Git at Google

 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>

 <head>
 <title>Preference Recording</title>

 <link rel="stylesheet" href="book.css">

 <noscript></noscript>
 <script type="text/javascript">
 function windowTitle()
 {
     if (location.href.indexOf('is-external=true') == -1) {
         parent.document.title="Preference Recording)";
     }
 }
 </script>
 </head>
 <body bgcolor="white" onload="windowTitle();">

 <h1>Preference Recorder Dialog</h1>

 <p>
   The preference recorder detects all preferences that were changed while the Preferences dialog was open.
   It provides the ability to selectively record each changed preference.
   The impact of a recorded preference depends on where it's recorded:
 </p>

 <ul>
 <li>
 If it's recorded into the <em>user setup</em>,
 it has global impact, i.e., it applies to all workspaces of all installations, not just the current workspace.
 </li>
 <li>
 If it's recorded into the <em>installation setup</em>,
 it has more restricted impact, i.e., it applies to all workspaces of the current installation, not just the current workspace.
 </li>
 <li>
 If it's recorded into the <em>workspace setup</em>,
 it has even more restricted impact, i.e., it applies only to the current workspace.
 This might not seem useful, because that's the default behavior of Eclipse's preferences,
 but it's useful if you would like the current workspace's preference to be different from the preferences you've recorded in the broader impacting resources mentioned above.
 </li>
 </ul>

 <p>
   All recorded preferences are automatically applied on startup.
   They can be manually applied to an already-running IDE via <span class="selectstep">Help &rarr; Perform Setup Tasks&hellip;</span>
 </p>

 <h2>Preference Selection and Local Policies</h2>

 <p>
   Preference selection determines not only what's recorded, but also how future changes to that preference are handled:
 </p>

 <table border="0">
   <tr>
     <td width="45" valign="top"><img src="../icons/sync/Right.gif"></img>&nbsp;<img src="../icons/sync/User.gif"></img></td>
     <td>Each preference with an <span style="border:1px solid gray; background:#eeeeee;"><b>&nbsp;Always&nbsp;record&nbsp;into...&nbsp;</b></span>&nbsp; policy will be recorded.
       In the future, any change to that preference will simply be recorded without prompting.</td>
   </tr>
   <tr>
     <td width="45" valign="top"><img src="../icons/sync/Exclude.gif"></img>&nbsp;<img src="../icons/sync/UserDisabled.gif"></img></td>
     <td>Each preference with a <span style="border:1px solid gray; background:#eeeeee;"><b>&nbsp;Never&nbsp;record&nbsp;into...&nbsp;</b></span>&nbsp; policy will not be recorded.
       In the future, any change to that preference will simply be ignored without prompting.</td>
   </tr>
   <tr>
     <td width="45" valign="top"><img src="../icons/sync/Skip.gif"></img>&nbsp;<img src="../icons/sync/UserDisabled.gif"></img></td>
     <td>Each preference with a <span style="border:1px solid gray; background:#eeeeee;"><b>&nbsp;Skip&nbsp;this&nbsp;time&nbsp;</b></span>&nbsp; policy will not be recorded.
       In the future, any change to that preference will lead to further prompting.</td>
   </tr>
 </table>

 <p>
 In other words, not only are preferences selectively recorded, but also preference handling policies are maintained.
 As such, this dialog will appear less often as you train it to either record or ignore each specific preference.
 Use <span class="selectstep">Window &rarr; Oomph &rarr; Setup Tasks &rarr; Preference Recorder</span> to view or modify these policies.
 </p>

 <p>
 Recorded preferences, as well as the associated policies, are maintained in your <em>setups</em>,
 which you can view or modify using, for example, <span class="selectstep">Navigate &rarr; Open Setup &rarr; Open User</span>.
 </p>

 <h2>How to Proceed</h2>

 <p>
 The preference recorder dialog prompts you to take the following actions:
 </p>

 <ul>
 <li>
 Press Cancel to record nothing and to leave the policies unchanged.  In this case, the preference selections have no impact on other workspaces.
 </li>
 <li>
 Choose the policy for the handling of each preference, i.e., always record, never record, decide later.
 </li>
 <li>
 Press OK, to selectively record the preferences and to update the policies.
 </li>
 <li>
 Uncheck the "Recorder enabled" button to disable preference recording and to avoid seeing this dialog the next time.
 Note that you can also enable or disable the preference recorder via the tool bar button in the Preferences dialog itself.
 </li>
 <ul>

 </body>
 </html>
	<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	<html>

	<head>
	<title>Preference Recording</title>

	<link rel="stylesheet" href="book.css">

	<noscript></noscript>
	<script type="text/javascript">
	function windowTitle()
	{
	if (location.href.indexOf('is-external=true') == -1) {
	parent.document.title="Preference Recording)";
	}
	}
	</script>
	</head>
	<body bgcolor="white" onload="windowTitle();">

	<h1>Preference Recorder Dialog</h1>

	<p>
	The preference recorder detects all preferences that were changed while the Preferences dialog was open.
	It provides the ability to selectively record each changed preference.
	The impact of a recorded preference depends on where it's recorded:
	</p>

	<ul>
	<li>
	If it's recorded into the <em>user setup</em>,
	it has global impact, i.e., it applies to all workspaces of all installations, not just the current workspace.
	</li>
	<li>
	If it's recorded into the <em>installation setup</em>,
	it has more restricted impact, i.e., it applies to all workspaces of the current installation, not just the current workspace.
	</li>
	<li>
	If it's recorded into the <em>workspace setup</em>,
	it has even more restricted impact, i.e., it applies only to the current workspace.
	This might not seem useful, because that's the default behavior of Eclipse's preferences,
	but it's useful if you would like the current workspace's preference to be different from the preferences you've recorded in the broader impacting resources mentioned above.
	</li>
	</ul>

	<p>
	All recorded preferences are automatically applied on startup.
	They can be manually applied to an already-running IDE via <span class="selectstep">Help → Perform Setup Tasks…</span>
	</p>

	<h2>Preference Selection and Local Policies</h2>

	<p>
	Preference selection determines not only what's recorded, but also how future changes to that preference are handled:
	</p>

	<table border="0">
	<tr>
	<td width="45" valign="top"><img src="../icons/sync/Right.gif"></img> <img src="../icons/sync/User.gif"></img></td>
	<td>Each preference with an <span style="border:1px solid gray; background:#eeeeee;"><b> Always record into... </b></span>  policy will be recorded.
	In the future, any change to that preference will simply be recorded without prompting.</td>
	</tr>
	<tr>
	<td width="45" valign="top"><img src="../icons/sync/Exclude.gif"></img> <img src="../icons/sync/UserDisabled.gif"></img></td>
	<td>Each preference with a <span style="border:1px solid gray; background:#eeeeee;"><b> Never record into... </b></span>  policy will not be recorded.
	In the future, any change to that preference will simply be ignored without prompting.</td>
	</tr>
	<tr>
	<td width="45" valign="top"><img src="../icons/sync/Skip.gif"></img> <img src="../icons/sync/UserDisabled.gif"></img></td>
	<td>Each preference with a <span style="border:1px solid gray; background:#eeeeee;"><b> Skip this time </b></span>  policy will not be recorded.
	In the future, any change to that preference will lead to further prompting.</td>
	</tr>
	</table>

	<p>
	In other words, not only are preferences selectively recorded, but also preference handling policies are maintained.
	As such, this dialog will appear less often as you train it to either record or ignore each specific preference.
	Use <span class="selectstep">Window → Oomph → Setup Tasks → Preference Recorder</span> to view or modify these policies.
	</p>

	<p>
	Recorded preferences, as well as the associated policies, are maintained in your <em>setups</em>,
	which you can view or modify using, for example, <span class="selectstep">Navigate → Open Setup → Open User</span>.
	</p>

	<h2>How to Proceed</h2>

	<p>
	The preference recorder dialog prompts you to take the following actions:
	</p>

	<ul>
	<li>
	Press Cancel to record nothing and to leave the policies unchanged. In this case, the preference selections have no impact on other workspaces.
	</li>
	<li>
	Choose the policy for the handling of each preference, i.e., always record, never record, decide later.
	</li>
	<li>
	Press OK, to selectively record the preferences and to update the policies.
	</li>
	<li>
	Uncheck the "Recorder enabled" button to disable preference recording and to avoid seeing this dialog the next time.
	Note that you can also enable or disable the preference recorder via the tool bar button in the Preferences dialog itself.
	</li>
	<ul>

	</body>
	</html>