Skip to content

Commit

Permalink
Remove obsoleted commands.
Browse files Browse the repository at this point in the history 
The following commands have been obsolete for a while, and have
been removed.

ColorLimit, Desk, HideGeometryWindow, HilightColorset, IconFont,
IconPath, PixmapPath, SnapAttraction, SnapGrid, WindowFont,
and WindowShadeAnimate.
  • Loading branch information
@somiaj @ThomasAdam
somiaj authored and ThomasAdam committed Dec 14, 2024
1 parent a3c0327 commit 89c8a6b
Show file tree
Hide file tree
Showing 12 changed files with 20 additions and 451 deletions.
15 changes: 1 addition & 14 deletions dev-docs/COMMANDS
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,6 @@ The recognized commands for fvwm 2.6.6 (from cvs) as of 09-Sep-2014:
CleanupColorsets - Reset all used colorsets with the default gray colors
ClickTime - Set a time in milliseconds for click and double click
Close - Try to Delete a window, if this fails, Destroy it
ColorLimit - Set limit on colors used (obsolete)
ColormapFocus - Change the colormap behaviour for low-depth X servers
Colorset - Manage colors used like fg, bg, image bg, gradient bg
CopyMenuStyle - Copy the existing menu style to new or existing one
Expand All @@ -35,7 +34,6 @@ The recognized commands for fvwm 2.6.6 (from cvs) as of 09-Sep-2014:
DefaultLayers - Set StaysOnBottom, StaysPut, StaysOnTop layer numbers
Delete - Try to delete a window using the X delete protocol
Deschedule - Remove commands scheduled earlier using Schedule
Desk - (obsolete, use GotoDesk instead)
DesktopName - Define the desktop names used in WindowList, modules
DesktopSize - Set virtual desktop size in units of physical pages
Destroy - Kill a window without any warning to an application
Expand Down Expand Up @@ -66,21 +64,15 @@ The recognized commands for fvwm 2.6.6 (from cvs) as of 09-Sep-2014:
Focus - Give focus to a window
FocusStyle - Configure focus and raise policy for windows
Function - Execute a user defined function, see AddToFunc
GnomeButton - Pass mouse button presses on root to GNOME program
GnomeShowDesks - Limit GNOME pager to the number of desks
GotoDesk - Switch viewport to another desk same page
GotoDeskAndPage - Switch viewport to another desk and page
GotoPage - Switch viewport to another page same desk
HideGeometryWindow - Hide/show the position/size window
HilightColorset - (obsolete, use Style * HighlightColorset)
IconFont - (obsolete, use Style * IconFont)
Iconify - Change iconification status of a window (minimize)
IconPath - (obsolete, use ImagePath instead)
IgnoreModifiers - Modifiers to ignore on mouse and key bindings
ImagePath - Directories to search for images
InfoStoreAdd - Adds an entry (key/value pairs) to the infostore
InfoStoreRemove - Removes an entry from the infostore
- KeepRc - Do not modify the previous command return code
KeepRc - Do not modify the previous command return code
Key - Bind or unbind a key to an fvwm action
KillModule - Stops an fvwm module
Layer - Change the layer of a window
Expand All @@ -107,7 +99,6 @@ The recognized commands for fvwm 2.6.6 (from cvs) as of 09-Sep-2014:
OpaqueMoveSize - Set maximum size window fvwm should move opaquely
Pick - Prefix to force a window context, prompted if needed
PipeRead - Exec system command interpret output as fvwm commands
PixmapPath - (obsolete, use ImagePath instead)
PlaceAgain - Replace a window using initial window placement logic
PointerKey - Bind an action to a key based on pointer not focus
PointerWindow - Operate on window under pointer if it meets conditions
Expand Down Expand Up @@ -147,8 +138,6 @@ The recognized commands for fvwm 2.6.6 (from cvs) as of 09-Sep-2014:
SetAnimation - Control animated moves and menus
SetEnv - Set an environment variable
Silent - Suppress errors on command, avoid window selection
SnapAttraction - Control attraction of windows during move
SnapGrid - Control grid used with SnapAttraction
State - Control user defined window states
Stick - Change window stickyness
StickAcrossDesks - Change window stickyness on a desk basis
Expand All @@ -165,11 +154,9 @@ The recognized commands for fvwm 2.6.6 (from cvs) as of 09-Sep-2014:
UpdateStyles - Cause styles to update while still in a function
Wait - Pause until a matching window appears
WarpToWindow - Warp the pointer to a window
WindowFont - (obsolete, use Style * Font)
WindowId - Execute command for window matching the windowid
WindowList - Display the window list as a menu to select a window
WindowShade - Shade/unshade a window
WindowShadeAnimate - (obsolete, use Style * WindowShadeSteps)
WindowStyle - Set styles on the selected window
Xinerama - Control Xinerama support
XineramaPrimaryScreen - Identify Xinerama primary screen
Expand Down
17 changes: 1 addition & 16 deletions dev-docs/PARSING.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1045,9 +1045,6 @@ PAGECOORD = INT
PAGESUFFIX = "p"
```
```
CMD_HILIGHTCOLORSET = "HilightColorset" [COLORSET_NUM]
```
```
CMD_ICONIFY = "Iconify" BOOL_OR_TOGGLE
```
```
Expand Down Expand Up @@ -1790,24 +1787,12 @@ STRING_COMMA_TERMINATED = *(STRING_UNQ_NO_COMMA / STRING_Q_PAIR / 1*WSC)
```
;; !!! obsolete commands removed in mvwm

CMD_GNOMEBUTTON = "GnomeButton"
CMD_GNOMESHOWDESKS = "GnomeShowDesks"
CMD_SAVESESSION = "SaveSession"
CMD_SAVEQUITSESSION = "SaveQuitSession"
CMD_QUITSESSION = "QuitSession"

;; !!! obsolete commands in fvwm2

CMD_COLORLIMIT = "ColorLimit"
CMD_WINDOWFONT = "WindowFont" ; Style * Font ...
CMD_WINDOWSHADEANIMATE = "WindowShadeAnimate" ; Style * WindowShadeSteps
CMD_WINDOWSDESK = "WindowsDesk" ; See 'MoveToDesk'
CMD_DESK = "Desk" ; See 'Gotodesk'
;; Not fully obsolete, still used for EdgeScroll resistance.
CMD_EDGERESISTANCE = "EdgeResistance" ; Style * EdgeMoveDelay, EdgeMoveResistance
CMD_HIDEGEOMETRYWINDOW = "HideGeometryWindow" ; GeometryWindow Hide
CMD_ICONFONT = "IconFont" FONTNAME ; Style
CMD_ICONPATH = "IconPath" ; ImagePath
CMD_PIXMAPPATH = "PixmapPath" ; ImagePath
CMD_SNAPATTRACTION = "SnapAttraction" ; Style * SnapAttraction
CMD_SNAPGRID = "SnapGrid" ; Style * SnapGrid
```
94 changes: 3 additions & 91 deletions doc/fvwm3_manpage_source.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3062,9 +3062,6 @@ default root cursor, you must set your root cursor with the
ClickTime also specifies the delay between two clicks to be interpreted as a
double-click.

*ColorLimit* _limit_::
This command is obsolete. See the *--color-limit* option to fvwm.

*ColormapFocus* FollowsMouse | FollowsFocus::
By default, fvwm installs the colormap of the window that the cursor
is in. If you use
Expand Down Expand Up @@ -3323,32 +3320,6 @@ WindowId 0x3800002 FakeKeypress press A
+
Note: all command names can be abbreviated with their first letter.

*HilightColorset* [_num_]::
This command is obsoleted by the *Style* option _HilightColorset_.
Please use
+

....
Style * HilightColorset num
....

+
instead.

*IconFont* [_fontname_]::
This command is obsoleted by the *Style* option _IconFont_. Please use
+

....
Style * IconFont fontname
....

+
instead.

*IconPath* _path_::
This command is obsolete. Please use *ImagePath* instead.

*ImagePath* _path_::
Specifies a colon separated list of directories in which to search for
images (both monochrome and pixmap). To find an image given by a
Expand Down Expand Up @@ -3446,9 +3417,6 @@ for string translation. It is out of the scope of this discussion to
explain how to build locale catalogs. Please refer to the GNU gettext
documentation.

*PixmapPath* _path_::
This command is obsolete. Please use *ImagePath* instead.

*PrintInfo* _subject_ [_verbose_]::
Print information on _subject_ to debug log file, which defaults to
_$HOME/.fvwm/fvwm3-output.log_ . Environment variables _$FVWM_USERDIR_
Expand Down Expand Up @@ -3534,15 +3502,6 @@ Use the *Deschedule* command to stop periodic commands.
switches to the opposite state. If the _bool_ argument is not given, the state
is toggled.

*WindowFont* [_fontname_]::
This command is obsoleted by the *Style* option _Font_. Please use
+
....
Style * Font fontname
....
+
instead.

*WindowList* [(_conditions_)] [_position_] [_options_] [_double-click-action_]::
Generates a pop-up menu (and pops it up) in which the title and
geometry of each of the windows currently on the desktop are shown.
Expand Down Expand Up @@ -3805,10 +3764,6 @@ GeometryWindow Hide
....


*HideGeometryWindow* [Never | Move | Resize]::
This command has been depreciated and is now obsolete. Use
*GeometryWindow Hide* instead.

*Layer* [_arg1_ _arg2_] | [default]::
Puts the current window in a new layer. If _arg1_ is non zero then the
next layer is the current layer number plus _arg1_. If _arg1_ is zero
Expand Down Expand Up @@ -4007,8 +3962,7 @@ See also the *AnimatedMove* command.
*MoveToDesk* [prev | _arg1_ [_arg2_] [_min_ _max_]]::
Moves the selected window to another desktop. The arguments are the
same as for the *GotoDesk* command. Without any arguments, the window
is moved to the current desk. *MoveToDesk* is a replacement for the
obsolete *WindowsDesk* command, which can no longer be used.
is moved to the current desk.

*MoveThreshold* [_pixels_]::
When the user presses a mouse button upon an object fvwm waits to see
Expand Down Expand Up @@ -4288,37 +4242,6 @@ are allowed, and in particular can be used to make the motion appear
more cartoonish, by briefly moving slightly in the opposite direction
of the main motion. The above settings are the default.

*SnapAttraction* [_proximity_ [_behaviour_] [Screen]]::
The *SnapAttraction* command is obsolete. It has been replaced by the
*Style* command option _SnapAttraction_.

*SnapGrid* [_x-grid-size_ _y-grid-size_]::
The *SnapGrid* command is obsolete. It has been replaced by the
*Style* command option _SnapGrid_.

*WindowsDesk* _arg1_ [_arg2_]::
Moves the selected window to another desktop.
+
This command has been removed and must be replaced by *MoveToDesk*,
the arguments for which are the same as for the *GotoDesk* command.
+
*Important*
You cannot simply change the name of the command: the syntax has
changed. If you used:
+

....
WindowsDesk n
....

+
to move a window to desk n, you have to change it to:
+

....
MoveToDesk 0 n
....

*XorPixmap* [_pixmap_]::
Selects the pixmap with which bits are xor'ed when doing rubber-band
window moving or resizing. This has a better chance of making the
Expand Down Expand Up @@ -4668,10 +4591,6 @@ For backward compatibility, the optional argument may also be 1 to
signify "on", and 2 to signify "off". Note that this syntax is
obsolete, and will be removed in the future.

*WindowShadeAnimate* [_steps_ [p]]::
This command is obsolete. Please use the _WindowShadeSteps_ option of
the *Style* command instead.

=== Mouse & Key Bindings

*IgnoreModifiers* [_Modifiers_]::
Expand Down Expand Up @@ -5441,7 +5360,6 @@ The _Font_ and _IconFont_ options take the name of a font as their
sole argument. This font is used in the window or icon title. By
default the font given in the *DefaultFont* command is used. To
revert back to the default, use the style without the name argument.
These styles replace the older *WindowFont* and _IconFont_ commands.
+
The deprecated _IndexedWindowName_ style causes fvwm to use window
titles in the form
Expand Down Expand Up @@ -6752,10 +6670,7 @@ or for the descriptions of available styles and flags, see the
Add or divert commands to the decor named _decor_. A decor is a name
given to the set of commands which affect button styles, title-bar
styles and border styles. If _decor_ does not exist it is created;
otherwise the existing _decor_ is modified. Note: Earlier versions
allowed to use the *HilightColorset* and *WindowFont* commands in decors.
This is no longer possible. Please use the *Style* command with the
_Hilight..._ and _Font_ options.
otherwise the existing _decor_ is modified.
+
New decors start out exactly like the "default" decor without any
style definitions. A given decor may be applied to a set of windows
Expand All @@ -6780,7 +6695,7 @@ AddToDecor FlatDecor
+ BorderStyle -- HiddenHandles NoInset
Style FlatStyle \
UseDecor FlatDecor, HandleWidth 4, Colorset 0, HilightColorset 1
UseDecor FlatDecor, HandleWidth 4, Colorset 0
Style xterm UseStyle FlatStyle
....
Expand Down Expand Up @@ -7398,9 +7313,6 @@ endif::[]

=== Controlling the Virtual Desktop

*Desk* [screen _RANDRNAME_] _arg1_ [_arg2_] [_min_ _max_]::
This command has been renamed. Please see *GotoDesk* command.

*DesktopName* _desk_ _name_::
Defines the name of the desktop number _desk_ to _name_. This name is
used in the *WindowList* command and in the *FvwmPager* where it
Expand Down
Loading

0 comments on commit 89c8a6b

Please sign in to comment.