.\" t .\" @(#)Scroll.1 4/14/94 .TH Scroll 1.20 "April 14 1994" .UC .SH NAME Scroll \- the AfterStep scroll-bar module .SH SYNOPSIS Scroll is spawned by AfterStep, so no command line invocation will work. .SH DESCRIPTION The Scroll module prompts the user to select a target window, if the module was not launched from within a window context in AfterStep. After that, it adds scroll bars to the selected window, to reduce the total desktop space consumed by the window. Scroll reads ~/GNUstep/Library/AfterStep/scroll file when it starts up, and looks for lines similar to "*ScrollFore green". Scroll should not be used with windows which move or resize themselves, nor should it be used with windows which set the WM_COLORMAP_WINDOWS property. Operation is fine with windows that have a private colormap. .SH INITIALIZATION During initialization, \fIScroll\fP will eventually search a configuration file which describes the colors to use. If the Scroll executable is linked to another name, ie ln -s Scroll MoreScroll, then another module called MoreScroll can be started, with a completely different configuration than Scroll, simply by changing the keyword Scroll to MoreScroll. .SH INVOCATION Scroll can be invoked by binding the action 'Module Scroll x y' to a menu or key-stroke in the ~/GNUstep/Library/AfterStep/scroll file. The parameter x and y are integers, which describe the horizontal and vertical window size reduction. AfterStep will search directory specified in the ModulePath configuration option to attempt to locate Scroll. Although nothing keeps you from launching Scroll at start-up time, you probably don't want to put it in autoexec file. .SH CONFIGURATION OPTIONS Scroll reads ~/GNUstep/Library/AfterStep/scroll file when it starts up, and looks for lines as listed below: .IP "*ScrollFore \fIcolor\fP" Tells the module to use \fIcolor\fP instead of grey for scroll bars themselves. .IP "*ScrollBack \fIcolor\fP" Tells the module to use \fIcolor\fP instead of black for the window background. .SH BUGS When the scroll bars are removed by clicking on the button in the lower right corner, the window does not restore its location correctly. .SH AUTHOR Robert Nation