diff --git a/doc/holt_circle.gif b/doc/holt_circle.gif index dc6158c..b570669 100644 Binary files a/doc/holt_circle.gif and b/doc/holt_circle.gif differ diff --git a/doc/holt_horiz.gif b/doc/holt_horiz.gif deleted file mode 100644 index 189c52b..0000000 Binary files a/doc/holt_horiz.gif and /dev/null differ diff --git a/doc/holt_vert.gif b/doc/holt_vert.gif deleted file mode 100644 index 16229fc..0000000 Binary files a/doc/holt_vert.gif and /dev/null differ diff --git a/doc/sgpem2uman.texi b/doc/sgpem2uman.texi index ad018ae..ffe9b94 100644 --- a/doc/sgpem2uman.texi +++ b/doc/sgpem2uman.texi @@ -863,16 +863,36 @@ The other clicks... are all the same! @strong{How to show/hide threads} -With the menu item "Show Threads" under the "View" menu the user can enable or +With the menu item "Show/Hide Threads" under the "View" menu the user can enable or disable threads visibility. +@strong{Scaling the graph} + +The user can select a scaling mode to view the graph.@* +This option is available with a popup menu right clicking in client area. + +The options available are: +@itemize +@item @strong{No scaling} (default mode) the graph isn't scaled at all. + A white space can appear at right or bottom of the graph or even + the dimension can exceed client area. With horizontal and vertical scrollbar + the user can view all the graph surface. +@item @strong{Fit in window} the graph is resized to make visible every part of the graph. + A white (sometimes big) space can appear at right or bottom of the graph. +@item @strong{Stretch in window}like above the graph is resized but even stretched + to cover all client area. +@end itemize +Always one of these commands isn't available at a time; +the current mode doesn't appear because there isn't any reason to choose it. + + @c % ------------------------------------------------- @node The Holt graph, The Preferences dialog, The Simulation widget, From the GUI @subsection The Holt graph @cindex holt -@image{holt_circle,7.3cm,8cm,Screenshot of the holt graph} +@image{holt_circle,10.2cm,10.4cm,Screenshot of the holt graph} The graph show the simulation status at @emph{this time}.@* It represent resources, processes or threads (and status), @@ -884,6 +904,8 @@ is displayed. Resources are drawn as squares, processes and threads are circular, requests and allocations are in form of arrows.@* +In center of resources are printed two lines: the name at top, the used/total places at bottom.@* +Into schedulables is shown their name.@* An arrow from process (thread) to a resource is a request from the process to have the resource; an arrow from the resource to the process denote the allocation of the resource to the process. @@ -898,31 +920,50 @@ The colors, as usual, are: green, yellow, red. @strong{How to show processes or threads} -With the menu item "Show Threads" under the "View" menu the user can switch from +With the menu item "Show/Hide Threads" under the "View" menu the user can switch from processes to threads visibility. @strong{How to show or hide the Holt Window} Holt graph, for pratical reasons, is placed in a separate frame out of the main application window.@* -With the item "Show Holt graph" of the "View" menu is possible to show or hide +With the item "Show/Hide Holt graph" of the "View" menu is possible to show or hide this window. To close is always possible to use the standard close button or system menu command. +@strong{Changing graph disposition} + +The user can select the disposition of elements in the graph.@* +This option is available with a popup menu right clicking in client area. + +The options available are: +@itemize +@item @strong{Dispose vertical} items are arranged vertially in two +columns, resources at left, processes (or threads) at right. +@item @strong{Dispose horizontal} items are arranged horizontally in two +rows, resources at top, processes (or threads) at bottom. +@item @strong{Dispose circular} the items are disposed along a circle. +@item @strong{Auto dispose} (default mode) one of above is select in function of +the aspect ratio of the window +@end itemize +Always one of these commands isn't available at a time; +the current mode doesn't appear because there isn't any reason to choose it. + + @strong{Changing size and shape} The user can change size of the Holt window.@* -As the window change size, his contents is scaled and rearranged to fit into -the client area.@* +As the window change size, his contents is scaled to fit into +the client area. + +If the disposition is set in @emph{"Auto dispose"} mode then the disposition +can change during the resizing operation as described following.@* If the height/width ratio is >= 5/3 the items are arranged vertially in two columns, resources at left, processes (or threads) at right.@* If the height/width ratio is <= 3/5 the items are arranged horizontally in two rows, resources at top, processes (or threads) at bottom.@* Otherwise the items are disposed along a circle. -@image{holt_vert,12.1cm,8cm,Vertical arrangement of the holt graph} -@image{holt_horiz,4.5cm,8cm,Horizontal arrangement of the holt graph} - @c % ------------------------------------------------- @node The Preferences dialog, Controlling the simulation, The Holt graph, From the GUI @subsection The Preferences dialog