<?xml version="1.0" encoding="ISO-8859-1"?><!-- OPML generated by Radio UserLand v8.0.8 on Wed, 28 Jan 2004 06:09:04 GMT -->
<opml version="1.1">	<head>		<title>aRtrace.opml</title>		<dateCreated>Sun, 14 Jul 2002 18:13:29 GMT</dateCreated>		<dateModified>Wed, 28 Jan 2004 06:09:04 GMT</dateModified>		<ownerName>Marc Barrot</ownerName>		<ownerEmail>info@prec-it.com</ownerEmail>		<expansionState></expansionState>		<vertScrollState>1</vertScrollState>		<windowTop>67</windowTop>		<windowLeft>18</windowLeft>		<windowBottom>774</windowBottom>		<windowRight>707</windowRight>		</head>	<body>		<outline text="#title &quot;Tracing activeRenderer code&quot;"/>		<outline text="#opmlStory &quot;http://www.activerenderer.com/opml/aR/aRtrace.opml&quot;"/>		<outline text="Last updated: 1/28/04; 1:07:27 AM by MB"/>		<outline text="The following is a list of what activeRenderer's code does at installation and uninstallation time, as well as when weblog template modifications are requested.">			<outline text="It is intended as a debugging aid in the (very unlikely now, but let's face it, still possible) event that aR does something unexpected to your weblog. All these steps are identified with comments in activeRenderer's code, the relevant part, folder and file names are in &lt;i&gt;italic&lt;/i&gt;."/>			</outline>		<outline text="When Radio starts : &lt;i&gt;activeRendererSuite.instal&lt;/i&gt;.">			<outline text="1: Instals a &lt;i&gt;prefs.activeRenderer&lt;/i&gt; user preferences table in weblogData.root."/>			<outline text="2: Instals a call to the activeRenderer rendering code in &lt;i&gt;user.html.renderers&lt;/i&gt; (Radio.root)."/>			<outline text="3: Checks Radio's application Macros subfolder for any installation of pre-1.0 aR related macros and deletes those."/>			<outline text="4: Instals calls to all aR macros in &lt;i&gt;user.html.macros&lt;/i&gt; (Radio.root). Those macros currently are :">				<outline text="activeRendererHeader,"/>				<outline text="activeRendererFunctions,"/>				<outline text="espressoCup,"/>				<outline text="storyBox, "/>				<outline text="nodeFormat, "/>				<outline text="nodeState, "/>				<outline text="daySwitch,"/>				<outline text="opmlRender,"/>				<outline text="activeRoll,"/>				<outline text="activeRendererLogo,"/>				<outline text="rssBox."/>				</outline>			<outline text="5: Makes sure there is a &lt;i&gt;mySubscriptions.opml&lt;/i&gt; file creates in the &lt;i&gt;gems&lt;/i&gt; folder."/>			<outline text="6: Instals all callbacks necessary to maintain an opml image of the aggregator:">				<outline text="postScan"/>				<outline text="subscribeService"/>				<outline text="unsubscribeService"/>				</outline>			<outline text="7: Creates a complete &lt;i&gt;activeRenderer&lt;/i&gt; folder in the &lt;i&gt;www&lt;/i&gt; folder."/>			<outline text="8: Creates a complete &lt;i&gt;outlines&lt;/i&gt; folder in &lt;i&gt;www&lt;/i&gt;."/>			<outline text="9: Creates a complete &lt;i&gt;opml&lt;/i&gt; folder in &lt;i&gt;www&lt;/i&gt;."/>			<outline text="10: Creates &lt;i&gt;activeRenderer, outlines&lt;/i&gt; and &lt;i&gt;opml&lt;/i&gt; folders for all categories upstreamed to a site different from the main weblog public site."/>			<outline text="11: If it finds it and the autoUpstream preference is checked, copies the instant outline OPML file to &lt;i&gt;www/outlines&lt;/i&gt; for immediate rendering."/>			<outline text="12: Synchronizes bookmarks outline if bookmarks.keepSynched is checked."/>			<outline text="13: Creates or updates &lt;i&gt;myOutlines.opml&lt;/i&gt; if autoDir is checked."/>			<outline text="14: Creates a specialized copy of &lt;i&gt;mySubscriptions.opml&lt;/i&gt; in &lt;i&gt;activeRenderer/local&lt;/i&gt; if it is missing."/>			<outline text="15: Creates &lt;i&gt;aggregator.opml&lt;/i&gt; in &lt;i&gt;activeRenderer/local&lt;/i&gt; if it is missing and outlineAggregator is checked."/>			<outline text="16: Downloads topicsRoll file from the W4 server into &lt;i&gt;activeRenderer/local/w4&lt;/i&gt;."/>			<outline text="NB: Up to this point, none of the templates involved in weblog publication have been modified."/>			<outline text="17: Only if outlineWeblog is checked (it is not by default), modifies the main weblog's templates if needed.">				<outline text="17.1: Updates &lt;i&gt;www/#homeTemplate.txt&lt;/i&gt; to insert calls to the activeRendererHeader and daySwitch macro.">					<outline text="If the displayLatest preference is false, the call to daySwitch is commented out."/>					<outline text="The previous version is archived in &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt;."/>					<outline text="this is all part of &lt;i&gt;activeRendererSuite.utils.checkHomeTemplate&lt;/i&gt;."/>					</outline>				<outline text="17.2: Updates &lt;i&gt;www/#dayTemplate.txt&lt;/i&gt; if a newer version is available and the current #dayTemplate.txt is already an aR generated template.">					<outline text="The previous version is archived in &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt;."/>					</outline>				<outline text="17.3: Updates &lt;i&gt;www/#itemTemplate.txt&lt;/i&gt; if a newer version is available and the current #itemTemplate.txt is already an aR generated template.">					<outline text="The previous version is archived in &lt;i&gt;www/activeRenderer/backup&lt;/i&gt;."/>					</outline>				</outline>			<outline text="18: Updates the desktop website templates according to the activeMenu pref."/>			<outline text="19: Instals the uninstallation code in &lt;i&gt;scratchpad.activeRenderer&lt;/i&gt; (Radio.root)."/>			<outline text="20: Instals a &lt;i&gt;user.rootUpdates.servers.activeRenderer&lt;/i&gt; update parameters table in Radio.root."/>			<outline text="21: Instals a distribution repository if autoDist pref is set."/>			<outline text="22: Updates activeRenderer if the tool is registered and if autoUpdate is checked."/>			<outline text="Most iinstallation steps are logged into Radio's Event Log."/>			</outline>		<outline text="When you check the 'Outline publication dates' option in aR's preferences page : &lt;i&gt;activeRendererSuite.ui.preferences.edit&lt;/i&gt;.">			<outline text="1: A call to the &lt;i&gt;activeRendererHeader&lt;/i&gt; and &lt;i&gt;daySwitch&lt;/i&gt; macros are inserted in the  &lt;i&gt;www/#homeTemplate.txt&lt;/i&gt; template if they are not already there.">				<outline text="If &lt;i&gt;#homeTemplate.txt&lt;/i&gt; must be modified at all, the original version is first backed up to &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt;."/>				<outline text="The call to daySwitch is commented out if the displayLatest preference is false."/>				<outline text="Steps 1 is part of &lt;i&gt;activeRendererSuite.utils.checkHomeTemplate&lt;/i&gt;."/>				</outline>			<outline text="2: A number of global variable declarations are added to &lt;i&gt;www/#prefs.txt&lt;/i&gt; if they are missing. ">				<outline text="If &lt;i&gt;#prefs.txt&lt;/i&gt; must be modified at all, the original version is first backed up to &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt;."/>				<outline text="Steps 2 is part of &lt;i&gt;activeRendererSuite.utils.checkPrefs&lt;/i&gt;."/>				</outline>			<outline text="3: Any non outlined version of &lt;i&gt;www/#dayTemplate.txt&lt;/i&gt; is backed up to &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt;, then replaced by an outlined style version.">				<outline text="The new version is either the tool's default, or your customized version if it is found in &lt;i&gt;www/activeRenderer/local/backup/custom&lt;/i&gt;."/>				</outline>			</outline>		<outline text="When you check the 'Outline individual posts' preference (it's possible only if 'Outline publication dates' is already checked) : &lt;i&gt;activeRendererSuite.ui.preferences.edit&lt;/i&gt;.">			<outline text="Any non outlined version of &lt;i&gt;www/#itemTemplate.txt&lt;/i&gt; is backed up to &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt;, then replaced by an outlined style version.">				<outline text="The new version is either the tool's default, or your customized version if it is found in &lt;i&gt;www/activeRenderer/local/backup/custom&lt;/i&gt;."/>				</outline>			</outline>		<outline text="When you uncheck the 'Outline individual posts' preference : &lt;i&gt;activeRendererSuite.ui.preferences.edit&lt;/i&gt;.">			<outline text="1: If the current &lt;i&gt;www/#itemTemplate.txt&lt;/i&gt; file is an outlined style version, and its version number is higher than aR's default, it is backed up to &lt;i&gt;www/activeRenderer/local/backup/custom&lt;/i&gt;."/>			<outline text="2: If a non outlined version of &lt;i&gt;#itemTemplate.txt&lt;/i&gt; exists in &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt;, it is copied to &lt;i&gt;www&lt;/i&gt; and replaces the current version."/>			</outline>		<outline text="When you uncheck the 'Outline publication dates' option in aR's preferences page : &lt;i&gt;activeRendererSuite.ui.preferences.edit&lt;/i&gt;.">			<outline text="1: If the current &lt;i&gt;www/#dayTemplate.txt&lt;/i&gt; file is an outlined style version, and its version number is higher than aR's default, it is backed up to &lt;i&gt;www/gems/activeRenderer/local/backup/custom&lt;/i&gt;."/>			<outline text="2: If a non outlined version of &lt;i&gt;#dayTemplate.txt&lt;/i&gt; exists in &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt;, it is copied to &lt;i&gt;www&lt;/i&gt; and replaces the current version."/>			<outline text="3: Same thing happens for &lt;i&gt;#itemTemplate.txt&lt;/i&gt;."/>			<outline text="4: The 'Outline individual posts' option is automatically unckecked."/>			<outline text="5: The daySwitch macro call in &lt;i&gt;www/#homeTemplate.txt&lt;/i&gt; is commented out if it was not."/>			</outline>		<outline text="When you select the Tools / activeRenderer / Uninstal menu option, or if you deselect activeRenderer in Radio's local Tools page, or if you move the &lt;i&gt;activeRenderer.root&lt;/i&gt; file out of Radio's &lt;i&gt;Tools&lt;/i&gt; folder.">			<outline text="Restores the original, non outlined templates in &lt;i&gt;www&lt;/i&gt; if any outline weblog style was in use and if the original non outlined templates are found in &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt;."/>			</outline>		<outline text="When you move the &lt;i&gt;activeRenderer.root&lt;/i&gt; file out of Radio's &lt;i&gt;Tools&lt;/i&gt; folder: &lt;i&gt;scratchpad.activeRenderer.uninstal&lt;/i&gt; and &lt;i&gt;scratchpad.activeRenderer.cleanup&lt;/i&gt;.">			<outline text="1: Restores the original &lt;i&gt;#prefs.txt&lt;/i&gt; from &lt;i&gt;www/activeRenderer/local/backup&lt;/i&gt; to &lt;i&gt;www&lt;/i&gt; if it finds it."/>			<outline text="2: Moves the &lt;i&gt;activeRenderer&lt;/i&gt; folder out of the &lt;i&gt;www&lt;/i&gt; folder and into the &lt;i&gt;Radio Userland/activeRendererUninstalled&lt;/i&gt; folder."/>			<outline text="3: Deletes links to aR macros in &lt;i&gt;user.html.macros&lt;/i&gt; (Radio.root)"/>			<outline text="4: Deletes link to activeRenderer's rendering code in &lt;i&gt;user.html.renderer&lt;/i&gt; (Radio.root)"/>			<outline text="5: Deletes aR's update parameters table from u&lt;i&gt;ser.rootUpdates.servers&lt;/i&gt; (Radio.root)"/>			<outline text="6: Removes aR's preferences table from &lt;i&gt;prefs&lt;/i&gt; in webLogData.root."/>			<outline text="7: Remove uninstallation code from &lt;i&gt;scratchpad&lt;/i&gt; in Radio.root."/>			</outline>		</body>	</opml>