list-cmd-edit - displays and edits lists of labels which are associated with a command and optionally with an icon and, if so, executes the command (provided by Starbuntu)

list-cmd-edit --list=<path of the list source>[ --arg=<item of the list> --head=<header> --icon=<path of the symbol, if not contained in the list source> --winicon=<window symbol> --parent=<invoking program> --edit=true|false --shut=true|false (window closes on unfocus) --opt=<further yad options separated by non-breakable spaces>]

The Starbuntu program list-cmd-edit administrates the lists "App Menu", "Recently Used Menu", "Bookmarks Menu", "Memo Menu", "File Exposition Menu", "Url Exposition Menu", "Volume Menu" and "Session Control Menu" which are integrated in the panel Tint2 and allows their processing with the exception of the "Recently Used" Menu, the Session Control Menu and the App Menu. However, the latter menu allows the input of environment variables and parameters in the format <environment variabless>%<parameters>. Alike the program list-cmd-edit processes the list of the marked folders in the file manager Rox as well as a self-created one. Therefore the handling of these lists is everywhere the same.

You select a list item either with the Up-Down keys, with a mouse click or by typing a (possibly regex) partial string of it. In the latter case the typed letters remain active for some seconds during which you can jump with the Up-Down keys only between the thus selected items. With the Return key or with a double mouse click you activate the selected list item.

If you want to add a list entry please act as follows:

1. Select the line, which shall be preceded by the new entry. If there is no line yet, you will find a sample entry that you can edit.
   
   
2. Click on "Edit" and then on "New".
   
   
3. Edit the fields 'Label' and 'Detail'. If so, select also an icon (optional). If you only edit 'Label', you set a permanent header of the list that you can extinguish again by leaving all fields empty.
   
   
4. Click on "OK".

If you want to change a list entry please act as described above but omit the click on "New". You can change an existing header by calling the program with the parameter --head=<header>. Otherwise a temporary header will be created with this parameter.

Please be careful in case of inserting certain special characters because some of them can lead to undesired results. By clicking on 'Hints' you'll get an appropriate workaround.

If you want to edit a pure text list entry you can do it by doubleclicking on it. So you get the text view mode of the entry. Doing this long texts can be edited more comfortably and the special character problem doesn't count.

If you want to delete a list entry please act as follows:

1. Choose the line you want to delete.
   
   
2. Click on "Edit".
   
   
3. Click on "Del".

The raw data of the pre-assembled mentioned lists are located as text files *.lst in the folder ~/.config/gtk-3.0 with the exception of the App Menu whose data are stored in ~/.config/menus and the list of the marked folders in the file manager Rox whose text file marked-directories.lst is located in the folder ~/.config/rox.sourceforge.net/ROX-Filer.

If you want to use the program list-cmd-edit for own lists please respect the following tips:

• List format of the source *.lst: [icon path‖]command/path‖label
  
  
• Please notice carefully the delimiter '‖' (='DOUBLE VERTICAL LINE', not to be confused with two 'pipes', i.e. '||').

However, creating own lists by means of the Starbuntu program multimenu is much easier and, moreover, allows also a nested structure of the list.

--list=<path of the list source>
[ --arg=<item of the list> ]
[ --head=<header> ]
[ --icon=<path of the symbol, if not contained in the list source> ]
[ --winicon=<window symbol> ]
[ --parent=<invoking program> ]
[ --edit=true|false ]
[ --shut=true|false (window closes on unfocus) ]
[ --opt=<further yad options separated by non-breakable spaces> ]

/usr/local/bin/list-cmd-edit
$HOME/.config/gtk-3.0/files.lst
$HOME/.config/gtk-3.0/links.lst
$HOME/.config/gtk-3.0/notes.lst
$HOME/.config/gtk-3.0/volume.lst
$HOME/.config/rox.sourceforge.net/ROX-Filer/marked-directories.lst
$HOME/.config/menus/Apps.lst
$HOME/.config/menus/AudioVideo.lst
$HOME/.config/menus/File-Management.lst
$HOME/.config/menus/Game.lst
$HOME/.config/menus/Graphics.lst
$HOME/.config/menus/LibreOffice.lst
$HOME/.config/menus/Network.lst
$HOME/.config/menus/Office.lst
$HOME/.config/menus/Settings.lst
$HOME/.config/menus/Starbuntu-File-Apps.lst
$HOME/.config/menus/Starbuntu-Network.lst
$HOME/.config/menus/Starbuntu-Settings.lst
$HOME/.config/menus/Starbuntu-System-Admin.lst
$HOME/.config/menus/Starbuntu-Utility.lst
$HOME/.config/menus/System-Administration.lst
$HOME/.config/menus/System-Tools.lst
$HOME/.config/menus/Terminate.lst
$HOME/.config/menus/Utility.lst

Peter Starfinger <info@die-starfingers.de>