Skip to content

Commit

Permalink
Cleanup missing tags
Browse files Browse the repository at this point in the history 
Still has scrolling problem described in Issue JMRI#465.
  • Loading branch information
@jerryg2003
jerryg2003 authored Apr 18, 2022
1 parent 41c61b2 commit 2d7ceae
Showing 1 changed file with 32 additions and 34 deletions.
66 changes: 32 additions & 34 deletions install/WindowsNew.shtml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,7 @@
<!--#include virtual="Sidebar.shtml" -->
<div id="mainContent">

<h1>
JMRI Install Guide: Windows
</h1>
<h1>JMRI Install Guide: Windows</h1>

<p class="important">This Install Guide is for JMRI versions 3 and later -<br>
for earlier versions (2012 and before), <a href="Windows.shtml">refer to the old Windows Install Guide</a>.</p>
Expand All @@ -35,25 +33,26 @@ for earlier versions (2012 and before), <a href="Windows.shtml">refer to the old
<li><a href="#startup">Starting JMRI</a></li>
<li><a href="#notes">Notes</a>
<ul>
<li><a href="#serialconfig">Serial Port configuration</a></li>
<li><a href="#largewindow">Large Windows</a></li>
<li><a href="#themes">Windows Themes and Skins</a></li>
<li><a href="#revert">Reverting to an earlier version</a></li>
<Li><a href="#olderwindows">Installing Java 8 on older versions of Windows</a></li>
<li><a href="#serialconfig">Serial Port configuration</a></li>
<li><a href="#largewindow">Large Windows</a></li>
<li><a href="#themes">Windows Themes and Skins</a></li>
<li><a href="#revert">Reverting to an earlier version</a></li>
<li><a href="#olderwindows">Installing Java 8 on older versions of Windows</a></li>
</ul>
</li>
<li><a href="#debugging">Debugging</a>
<ul>
<li><a href="#errors">Error Messages</a>
<ul>
<li><a href="#stoppedworking">"The JAVA SE Platform binary has stopped working"</a></li>
<li><a href="#registry">".. prefs root node Software\JavaSoft\Prefs .. Windows RegCreateKeyEx(...)..."</a></li>
<li><a href="#stoppedworking">"The JAVA SE Platform binary has stopped working"</a></li>
<li><a href="#registry">".. prefs root node Software\JavaSoft\Prefs .. Windows RegCreateKeyEx(...)..."</a></li>
</ul>
</li>
</li>
<li><a href="#logscreen">The Log Screen</a></li>
<li><a href="#startupissues">Startup issues</a></li>
<li><a href="#shutdownissues">Shutdown issues</a></li>
</ul>
</li>
</li>
</ul>


Expand Down Expand Up @@ -258,35 +257,36 @@ for earlier versions (2012 and before), <a href="Windows.shtml">refer to the old
<a id="startup"></a><h2>Starting JMRI</h2>
<ul>
<li>Connect your computer to your <a
href="../help/en/html/hardware/index.shtml">Command Station hardware</a>.
href="../help/en/html/hardware/index.shtml">Command Station hardware</a>.</li>
<li>Start one of the applications from the JMRI group under Programs in your Start menu.
<p><img src="images/WinStartMenu.png" height="97" width="477" alt="JMRI Start menu">
<br>(This shows the Start menu following a 'Typical' install - a 'Full' install will place additional icons in this menu)
<br>(This shows the Start menu following a 'Typical' install - a 'Full' install will place additional icons in this menu)</li>

<li>Configure the program to connect to your layout. The Connections Preferences will open automatically on first run, or you can open the Preferences pane from the Edit menu. More on this on the <a href="../help/en/html/setup/index.shtml">JMRI Setup help page</a>.
<br>The JMRI <a href="../help/en/html/hardware/index.shtml">Hardware help page</a> lists the various
types of layout equipment that JMRI can connect to, and gives links to instruction pages</li>
<li>When you start DecoderPro 3.8 or later on Windows for the first time, the <strong>JMRI StartUp Wizard</strong> displays a series of screens to guide you through the setup proces:
<ol type="i">
<li>Welcome Screen:
<p style="text-align:center;"><img src="images/InstallWin1.png" height="271" width="469" alt="JMRI Start Wizard">
<p style="text-align:center;"><img src="images/InstallWin1.png" height="271" width="469" alt="JMRI Start Wizard"></li>
<li>Set your Language:
<p style="text-align:center;"><img src="images/InstallWin2Language.png" height="271" width="469" alt="JMRI Start Wizard Set Language">
<p style="text-align:center;"><img src="images/InstallWin2Language.png" height="271" width="469" alt="JMRI Start Wizard Set Language"></li>
<li>Choose your DCC System's Manufacturer (protocol):
<p style="text-align:center;"><img src="images/InstallWin3Connection.png" height="271" width="469" alt="JMRI Start Wizard Choose Manufacturer">
<p style="text-align:center;"><img src="images/InstallWin3Connection.png" height="271" width="469" alt="JMRI Start Wizard Choose Manufacturer"></li>
<li>Choose your hardware Connection Type:
<p style="text-align:center;"><img src="images/InstallWin4Connection.png" height="271" width="469" alt="JMRI Start Wizard Choose Interface">
<p style="text-align:center;"><img src="images/InstallWin4Connection.png" height="271" width="469" alt="JMRI Start Wizard Choose Interface"></li>
<li>That's all!
<p style="text-align:center;"><img src="images/InstallWin5Finished.png" height="271" width="469" alt="JMRI Start Wizard Finished">
<p style="text-align:center;"><img src="images/InstallWin5Finished.png" height="271" width="469" alt="JMRI Start Wizard Finished"></li>
</ol>
</li>
</ul>

<!-- *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*- -->

<a id="notes"></a>
<h2>Notes</h2> <a id="serialconfig"></a>
<h2>Notes</h2>

<a id="serialconfig"></a>
<h3>Serial Port configuration</h3>
<p>DecoderPro may encounter problems if the Serial Port used to connect to the layout shares an interrupt with another Serial Port. Typically COM1 and COM3 share an interrupt, as do COM2 and COM4. In particular, some systems are unable to communicate (and may experience a lockup) when the layout's Serial Port shares an interrupt with a port used for a serial mouse. Make sure that the Serial Port connected to your layout does not share an interrupt with another Serial Port.</p>
<p>With Windows XP, your Serial Port parameters might not be properly set for hardware flow control. To fix this, right-click on My Computer and select Properties. Go to the Hardware tab and click on Device Manager. Open up the section that says Ports (COM &amp; LPT). Right-click on the Serial Port you have the LocoBuffer hooked up to and select Properties. Go to the Port Settings tab and set the options to:<br>
Expand Down Expand Up @@ -333,24 +333,23 @@ find this is to follow the "Preferences" link in "JMRI > Tools and Demos" from t
<br><img src="images/WinDebugLog-01_StartMenuPreferences.png" height="358" width="531" alt="Preferences link in JMRI > Tools and Demos start menu">
<br>Once opened, navigate up one level to your user-profile folder.
<p>Depending on the version of Windows, this will typically be one of:</p>
<dl>
<dt>Windows 2000 - XP
<dd>C:\Documents and Settings\[username]
<dt>Windows Vista - 7 - 10
<dd>C:\Users\[username]
</dl>
<table>
<tr><th>Windows Version</th><th>User Profile Folder</th></tr>
<tr><td>Windows 2000 - XP</td><td>C:\Documents and Settings\[username]</td></tr>
<tr><td>Windows Vista, 7, 8, 10, 11</td><td>C:\Users\[username]</td></tr>
</table>
Within this folder, look for - and delete - the folder "JMRI", then rename
the folder "JMRI_backup" to "JMRI".
<p>Restart JMRI and you should be back to where you were before installing the new version.</p>

<!-- *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*- -->

<a id="oldwindows"></a>
<a id="olderwindows"></a>
<h3>Installaing Java 8 on older Windows versions</h3>
<p>
Windows98 and ME can run <a href="../releasenotes/jmri2.14.1.shtml">JMRI 2.8</a>.
<p>Note: It is possible to install Java 1.8 onto machines running Windows XP or Vista SP1, but this
is <em>unsupported</em> by Oracle.
is <em>unsupported</em> by Oracle.</p>

<ul>
<li>To do this for Windows XP, visit the <a href="http://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-2177648.html">
Expand All @@ -361,12 +360,12 @@ the folder "JMRI_backup" to "JMRI".
you'll have to reinstall the 151 version of Java as described here.) The installer will
complain that it is unsupported,but should allow you to continue with the installation.
Assuming that this is successful, proceed with installation of
<a href="../download/index.shtml">current JMRI test and production releases</a>.
<a href="../download/index.shtml">current JMRI test and production releases</a>.</li>
<li>To do this for Windows Vista SP1, visit the <a href="http://www.java.com/en/download/manual.jsp">
Manual Java Downloads page</a> and choose the Offline Installer for Windows. The installer will
complain that it is unsupported, but should allow you to continue with the installation.
Assuming that this is successful, proceed withinstallation of
<a href="../download/index.shtml">current JMRI test and production releases</a>.
<a href="../download/index.shtml">current JMRI test and production releases</a>.</li>
</ul>

<p>
Expand All @@ -379,6 +378,7 @@ the folder "JMRI_backup" to "JMRI".
"WARNING: An illegal reflective access operation has occurred"<br>
or "WARNING: Please consider reporting this to the maintainers".<br>
You can ignore the messages.
</p>


<!-- *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*- -->
Expand All @@ -394,11 +394,9 @@ the folder "JMRI_backup" to "JMRI".
There is a <a href="WindowsSeStoppedWorking.shtml">separate Help page</a>
for debugging the "The JAVA SE Platform binary has stopped working" error message.</li>
<li><a id="registry"></a>
<div class="wide">

This comment has been minimized.

Sign in to view

Copy link
@silverailscolo

silverailscolo Apr 19, 2022

I think it is a good idea to remove this <div>, which is inside an <li> element. The <ul> list allows adding more errors if need arises (I did test display of wide code blocks, but not inside a list).
Let's see how this displays on screen.
<code class="block">
<code>
WARN - Could not open/create prefs root node Software\JavaSoft\Prefs at root 0x80000002. Windows RegCreateKeyEx(...) returned error code 5
</code>
</div>
</code><br>
You can ignore this one. This is an internal warning from Java itself. Certain combinations of
Windows configuration and Java 8 version emit it, but it doesn't have any adverse
impact on JMRI or the computer. Oracle has said they'll fix it in Java 9, i.e.
Expand Down

0 comments on commit 2d7ceae

Please sign in to comment.