Skip to content

Commit 38c9c16

Browse files
Fish-GitFish-Git
committed
Document operating modes:
Normal hercules.exe semi-graphical "panel" operating mode, versus herclin.exe standard command-line mode.
1 parent 2247c7b commit 38c9c16

14 files changed

+133
-3
lines changed

‎Hercules_VS2008.vcproj

+12
Original file line numberDiff line numberDiff line change
@@ -2537,6 +2537,18 @@
25372537
RelativePath=".\html\images\greenu.gif"
25382538
>
25392539
</File>
2540+
<File
2541+
RelativePath=".\html\images\herc-panel.jpg"
2542+
>
2543+
</File>
2544+
<File
2545+
RelativePath=".\html\images\herc-panel2.jpg"
2546+
>
2547+
</File>
2548+
<File
2549+
RelativePath=".\html\images\herclin.jpg"
2550+
>
2551+
</File>
25402552
<File
25412553
RelativePath=".\html\images\hercpic-rblk-256.gif"
25422554
>

‎Hercules_VS2015.vcxproj

+3
Original file line numberDiff line numberDiff line change
@@ -1571,6 +1571,9 @@
15711571
<Image Include="html\images\favicon.ico" />
15721572
<Image Include="html\images\greend.gif" />
15731573
<Image Include="html\images\greenu.gif" />
1574+
<Image Include="html\images\herclin.jpg" />
1575+
<Image Include="html\images\herc-panel.jpg" />
1576+
<Image Include="html\images\herc-panel2.jpg" />
15741577
<Image Include="html\images\hercpic-rblk-256.gif" />
15751578
<Image Include="html\images\hercpic-rblk-80.gif" />
15761579
<Image Include="html\images\interruptd.gif" />

‎Hercules_VS2015.vcxproj.filters

+9
Original file line numberDiff line numberDiff line change
@@ -4096,6 +4096,15 @@
40964096
<Image Include="html\images\greenu.gif">
40974097
<Filter>Other Files\DOC\html\images</Filter>
40984098
</Image>
4099+
<Image Include="html\images\herclin.jpg">
4100+
<Filter>Other Files\DOC\html\images</Filter>
4101+
</Image>
4102+
<Image Include="html\images\herc-panel.jpg">
4103+
<Filter>Other Files\DOC\html\images</Filter>
4104+
</Image>
4105+
<Image Include="html\images\herc-panel2.jpg">
4106+
<Filter>Other Files\DOC\html\images</Filter>
4107+
</Image>
40994108
<Image Include="html\images\hercpic-rblk-256.gif">
41004109
<Filter>Other Files\DOC\html\images</Filter>
41014110
</Image>

‎Hercules_VS2017.vcxproj

+3
Original file line numberDiff line numberDiff line change
@@ -1571,6 +1571,9 @@
15711571
<Image Include="html\images\favicon.ico" />
15721572
<Image Include="html\images\greend.gif" />
15731573
<Image Include="html\images\greenu.gif" />
1574+
<Image Include="html\images\herclin.jpg" />
1575+
<Image Include="html\images\herc-panel.jpg" />
1576+
<Image Include="html\images\herc-panel2.jpg" />
15741577
<Image Include="html\images\hercpic-rblk-256.gif" />
15751578
<Image Include="html\images\hercpic-rblk-80.gif" />
15761579
<Image Include="html\images\interruptd.gif" />

‎Hercules_VS2017.vcxproj.filters

+9
Original file line numberDiff line numberDiff line change
@@ -4096,6 +4096,15 @@
40964096
<Image Include="html\images\greenu.gif">
40974097
<Filter>Other Files\DOC\html\images</Filter>
40984098
</Image>
4099+
<Image Include="html\images\herclin.jpg">
4100+
<Filter>Other Files\DOC\html\images</Filter>
4101+
</Image>
4102+
<Image Include="html\images\herc-panel.jpg">
4103+
<Filter>Other Files\DOC\html\images</Filter>
4104+
</Image>
4105+
<Image Include="html\images\herc-panel2.jpg">
4106+
<Filter>Other Files\DOC\html\images</Filter>
4107+
</Image>
40994108
<Image Include="html\images\hercpic-rblk-256.gif">
41004109
<Filter>Other Files\DOC\html\images</Filter>
41014110
</Image>

‎Hercules_VS2019.vcxproj

+3
Original file line numberDiff line numberDiff line change
@@ -1571,6 +1571,9 @@
15711571
<Image Include="html\images\favicon.ico" />
15721572
<Image Include="html\images\greend.gif" />
15731573
<Image Include="html\images\greenu.gif" />
1574+
<Image Include="html\images\herclin.jpg" />
1575+
<Image Include="html\images\herc-panel.jpg" />
1576+
<Image Include="html\images\herc-panel2.jpg" />
15741577
<Image Include="html\images\hercpic-rblk-256.gif" />
15751578
<Image Include="html\images\hercpic-rblk-80.gif" />
15761579
<Image Include="html\images\interruptd.gif" />

‎Hercules_VS2019.vcxproj.filters

+9
Original file line numberDiff line numberDiff line change
@@ -4096,6 +4096,15 @@
40964096
<Image Include="html\images\greenu.gif">
40974097
<Filter>Other Files\DOC\html\images</Filter>
40984098
</Image>
4099+
<Image Include="html\images\herclin.jpg">
4100+
<Filter>Other Files\DOC\html\images</Filter>
4101+
</Image>
4102+
<Image Include="html\images\herc-panel.jpg">
4103+
<Filter>Other Files\DOC\html\images</Filter>
4104+
</Image>
4105+
<Image Include="html\images\herc-panel2.jpg">
4106+
<Filter>Other Files\DOC\html\images</Filter>
4107+
</Image>
40994108
<Image Include="html\images\hercpic-rblk-256.gif">
41004109
<Filter>Other Files\DOC\html\images</Filter>
41014110
</Image>

‎Hercules_VS2022.vcxproj

+3
Original file line numberDiff line numberDiff line change
@@ -1571,6 +1571,9 @@
15711571
<Image Include="html\images\favicon.ico" />
15721572
<Image Include="html\images\greend.gif" />
15731573
<Image Include="html\images\greenu.gif" />
1574+
<Image Include="html\images\herclin.jpg" />
1575+
<Image Include="html\images\herc-panel.jpg" />
1576+
<Image Include="html\images\herc-panel2.jpg" />
15741577
<Image Include="html\images\hercpic-rblk-256.gif" />
15751578
<Image Include="html\images\hercpic-rblk-80.gif" />
15761579
<Image Include="html\images\interruptd.gif" />

‎Hercules_VS2022.vcxproj.filters

+9
Original file line numberDiff line numberDiff line change
@@ -4096,6 +4096,15 @@
40964096
<Image Include="html\images\greenu.gif">
40974097
<Filter>Other Files\DOC\html\images</Filter>
40984098
</Image>
4099+
<Image Include="html\images\herclin.jpg">
4100+
<Filter>Other Files\DOC\html\images</Filter>
4101+
</Image>
4102+
<Image Include="html\images\herc-panel.jpg">
4103+
<Filter>Other Files\DOC\html\images</Filter>
4104+
</Image>
4105+
<Image Include="html\images\herc-panel2.jpg">
4106+
<Filter>Other Files\DOC\html\images</Filter>
4107+
</Image>
40994108
<Image Include="html\images\hercpic-rblk-256.gif">
41004109
<Filter>Other Files\DOC\html\images</Filter>
41014110
</Image>

‎html/Makefile.am

+3
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,9 @@ images_sources = \
7777
images/favicon.ico \
7878
images/greend.gif \
7979
images/greenu.gif \
80+
images/herclin.jpg \
81+
images/herc-panel.jpg \
82+
images/herc-panel2.jpg \
8083
images/hercpic-rblk-256.gif \
8184
images/hercpic-rblk-80.gif \
8285
images/interruptd.gif \

‎html/hercinst.html

+70-3
Original file line numberDiff line numberDiff line change
@@ -466,9 +466,75 @@ <h2>Operating Procedure</h2>
466466
</table>
467467
</center>
468468

469+
<p>
470+
471+
Hercules can operate in either of two modes: (semi-)graphical "panel"
472+
mode or simple non-graphical standard command-line mode.
473+
474+
<p>
475+
476+
The default semi-graphical "panel" mode of operation is invoked by the
477+
"hercules.exe" executable, and the non-graphical standard command-line
478+
mode by the "herclin.exe" executable. They are both exactly identical
479+
except for how the terminal screen is managed.
480+
481+
<p>
482+
483+
In the normal (default) semi-graphical "panel" mode, Hercules.exe draws
484+
to screen directly itself, and does not rely on any terminal manager
485+
functionality (Terminal or Command-Prompt program). It paints (draws)
486+
messages and other information (such as its command line and CPU status
487+
line) on specifc screen lines starting at specific columns, etc:
488+
489+
<br><br>
490+
<center>
491+
<img src="images/herc-panel.jpg"><br><br>Hercules managed Hardware Machine Console (HMC)
492+
</center>
493+
494+
<p><br>
495+
496+
It relies on certain keystrokes (such as the PageUp and PageDown keys,
497+
etc) to perform actions such as displaying previously issued messages
498+
and switching to its alternate semi-graphical display panel via the Esc.
499+
key (which shows an overal summary of the machine's state, such as its
500+
current set of register values, list of devices, etc):
501+
502+
<br><br>
503+
<center>
504+
<img src="images/herc-panel2.jpg"><br><br>Hercules managed semi-graphical panel
505+
</center>
506+
507+
<p><br>
508+
509+
When started in standard command-line mode via "herclin.exe", the terminal
510+
screen is managed completely by your host operating system's terminal
511+
management software. Hercules does not paint the screen itself at all. It simply
512+
issues messages to "stdout" just like any other command-line program and your operating
513+
system's terminal management software decides where on the screen that line
514+
will be displayed. Additionally, Hercules does not read directly from the
515+
command-ine itself either. Instead, it simply reads from "stdin" and processes
516+
the commands it reads. Your host operating system's terminal manager is in charge
517+
of managing the command-line, not Hercules:
518+
519+
<br><br>
520+
<center>
521+
<img src="images/herclin.jpg"><br><br><u><i>Unmanaged</i></u> "herclin.exe" terminal screen,<br>
522+
scrolled back several screens to see previously issued terminal commands.
523+
</center>
524+
525+
<p><br>
526+
527+
In standard "herclin.exe" command-line mode, Hercules operates just like any other
528+
normal command-line program, and you can use the Terminal's scroll bar (if it has
529+
one) and/or your mouse's scroll wheel to scroll the screen backward or forward to
530+
see previously issued mesages and/or commands and their responses. Your host
531+
operating system's terminal manager is in charge of painting the screen and reading
532+
the command line, not Hercules.
533+
469534
<h4>Command line arguments</h4>
470535
<p>
471-
To start Hercules enter this command at the host's command prompt:
536+
To start Hercules in the default "panel" operating mode, enter this command
537+
at the host's command prompt:
472538
<blockquote><code><pre>
473539
hercules [ -f <em>filename</em> ] | [ --config=<em>filename</em> ]
474540
[ -o <em>logfile</em>] | [ --output=<em>logfile</em> ]&nbsp;&nbsp;|&nbsp;&nbsp;[ --logfile=<em>logfile</em> ]
@@ -635,8 +701,9 @@ <h4>Command line arguments</h4>
635701
<h4>Using the keyboard</h4>
636702
<p>
637703

638-
The main Hercules screen contains a scrollable list of messages with a command
639-
input area and system status line at the bottom of the screen.
704+
In the default "panel" operating mode, the main Hercules screen contains
705+
a scrollable list of messages with a command input area and system status
706+
line at the bottom of the screen. (see further above)
640707
<p>
641708
To scroll through the messages, use either the Page Up or Page Down keys,
642709
the Ctrl + Up Arrow or Ctrl + Down Arrow keys, or the Home or End and/or

‎html/images/herc-panel.jpg

134 KB
Loading

‎html/images/herc-panel2.jpg

61.9 KB
Loading

‎html/images/herclin.jpg

86.3 KB
Loading

0 commit comments

Comments
 (0)