Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
auberginehill authored Feb 19, 2017
1 parent 6f624e9 commit 24f8b4f
Showing 1 changed file with 6 additions and 7 deletions.
13 changes: 6 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,13 +32,13 @@
</tr>
<tr>
<td style="padding:6px"><strong>Description:</strong></td>
<td style="padding:6px">Update-MozillaFirefox downloads a list of the most recent Firefox version numbers against which it compares the Firefox version numbers found on the system and displays, whether a Firefox update is needed or not. The actual update process naturally requires elevated rights, and if a working Internet connection is not found, Update-MozillaFirefox will exit at Step 6. Update-MozillaFirefox detects the installed Firefox(es) by querying the Windows registry for installed programs. The keys from <code>HKLM:\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\</code> and <code>HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\</code> are read on 64-bit computers and on the 32-bit computers only the latter path is accessed. When run in a 'normal' PowerShell window, and all the detected Firefox versions are up-to-date, Update-MozillaFirefox will just check that everything is OK and leave without further ceremony at Step 11 (before trying to determine, whether it is run elevated or not).
<td style="padding:6px">Update-MozillaFirefox downloads a list of the most recent Firefox version numbers against which it compares the Firefox version numbers found on the system and displays, whether a Firefox update is needed or not. The actual update process naturally requires elevated rights and a working Internet connection. Update-MozillaFirefox detects the installed Firefox(es) by querying the Windows registry for installed programs. The keys from <code>HKLM:\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\</code> and <code>HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\</code> are read on 64-bit computers and on the 32-bit computers only the latter path is accessed. When run in a 'normal' PowerShell window, when all the detected Firefox versions are up-to-date, Update-MozillaFirefox will just check that everything is OK and leave without further ceremony at Step 11 (before trying to determine, whether it is run elevated or not).
<br />
<br />Update-MozillaFirefox tries to write several Firefox-related files, namely "<code>firefox_current_versions.json</code>", "<code>firefox_release_history.json</code>", "<code>firefox_languages.json</code>" and "<code>firefox_regions.json</code>" at Step 7. If the script has advanced to the updating phase, at Step 14 an Install Configuration File (<code>firefox_configuration.ini</code>) is also written to <code>$path</code>, where, for instance, the automatic Mozilla Maintenance service is disabled and the default shortcuts are enabled.
<br />
<br />If Update-MozillaFirefox is run without elevated rights (but with a working Internet connection) in a machine with an old Firefox version, it will be shown that a Firefox update is needed, but Update-MozillaFirefox will exit at Step 12 before downloading any files. To perform an update with Update-MozillaFirefox, PowerShell has to be run in an elevated window (run as an administrator).
<br />
<br />If Update-MozillaFirefox is run in an elevated PowerShell window and no Firefox is detected, the script offers the option to install Firefox in the "<strong>Admin Corner</strong>", where, in contrary to the main autonomous nature of Update-MozillaFirefox, an end-user input is required for selecting the bit-version and the language. In the "Admin Corner", one instance of either 32-bit or 64-bit version in the selected language is installable with Update-MozillaFirefox – the language selection covers over 30 languages.
<br />If Update-MozillaFirefox is run in an elevated PowerShell window and no Firefox is detected, the script offers the option to install Firefox in the "<strong>Admin Corner</strong>" (step 11), where, in contrary to the main autonomous nature of Update-MozillaFirefox, an end-user input is required for selecting the bit-version and the language. In the "Admin Corner", one instance of either 32-bit or 64-bit version in the selected language is installable with Update-MozillaFirefox – the language selection covers over 30 languages.
<br />
<br />In the update procedure itself Update-MozillaFirefox downloads a full Firefox installer from Mozilla, which is equal to the type that is already installed on the system (same bit version and language). After writing the Install Configuration File (<code>firefox_configuration.ini</code> at Step 14) and stopping several Firefox-related processes Update-MozillaFirefox installs the downloaded Firefox on top of the existing Firefox installation, which triggers the in-built update procedure.</td>
</tr>
Expand Down Expand Up @@ -144,8 +144,7 @@
</tr>
</table>
</p>
<p>The <code>%TEMP%</code> location represents the current Windows temporary file folder. Please see the Notes-section below, how to determine where the current Windows
temporary file folder is located. In PowerShell the command <code>$env:temp</code> displays the temp-folder path.</p>
<p>The <code>%TEMP%</code> location represents the current Windows temporary file folder. In PowerShell, for instance the command <code>$env:temp</code> displays the temp-folder path.</p>
</ol>
<p>
<li>To see the actual values that are being written to the Install Configuration File (<code>firefox_configuration.ini</code>), please see the Step 14 in the <a href="https://raw.githubusercontent.com/auberginehill/update-mozilla-firefox/master/Update-MozillaFirefox.ps1">script</a> itself, where the following value is written:</li>
Expand Down Expand Up @@ -194,7 +193,7 @@
</tr>
</table>
</p>
<p>The <code>%TEMP%</code> location represents the current Windows temporary file folder. Please see the Notes-section below, how to determine where the current Windows temporary file folder is located. In PowerShell the command <code>$env:temp</code> displays the temp-folder path.</p>
<p>The <code>%TEMP%</code> location represents the current Windows temporary file folder. In PowerShell, for instance the command <code>$env:temp</code> displays the temp-folder path.</p>
</ol>
<p>
<li>To open these file locations in a Resource Manager Window, for instance a command
Expand Down Expand Up @@ -231,13 +230,13 @@
<li>Requires a working Internet connection for downloading a list of the most recent Firefox version numbers and for downloading a complete Firefox installer from Mozilla (but the latter procedure is not initiated, if the system is deemed up-to-date).</li>
</p>
<p>
<li>For performing any actual updates with Update-MozillaFirefox, it's mandatory to run this script in an elevated PowerShell window (where PowerShell has been started with the 'run as an administrator' option). The elevated rights are needed for installing Firefox on top of the exising Firefox installation.</li>
<li>For performing any actual updates with Update-MozillaFirefox, it's mandatory to run this script in an elevated PowerShell window (where PowerShell has been started with the 'run as an administrator' option). The elevated rights are needed for installing Firefox on top of the existing Firefox installation.</li>
</p>
<p>
<li>Update-MozillaFirefox is designed to update only one instance of Firefox. If more than one instances of Firefox are detected, the script will notify the user at Step 5, and furthermore, if old Firefox(es) are detected, the script will exit before downloading the installation file at Step 15.</li>
</p>
<p>
<li>Please note that the Firefox installation configuration file written at Step 14 disables the Mozilla Maintenance service so that the Mozilla Maintenance service will not be installed during the Firefox update. The values set with the Install Configuration File (<code>firefox_configuration.ini</code>) are altering the system files and seemingly are written somewhere deeper to the innards of Firefox semi-permanently.</li>
<li>Please note that the Firefox installation configuration file written at Step 14 disables the Mozilla Maintenance service so that the Mozilla Maintenance service will not be installed during the Firefox update. The values set with the Install Configuration File (<code>firefox_configuration.ini</code>) are altering the system files and seemingly are written somewhere deeper to the innards of Mozilla Firefox semi-permanently.</li>
</p>
<p>
<li>Please also notice that when run in an elevated PowerShell window and an old Firefox version is detected, Update-MozillaFirefox will automatically try to download files from the Internet without prompting the end-user beforehand or without asking any confirmations (at Step 16 and onwards) and at Step 17 closes a bunch of processes without any further notice. </li>
Expand Down

0 comments on commit 24f8b4f

Please sign in to comment.