Add "Show in Tracker" button (#2)

* Add "Show in Tracker" button to open the command' location

* _CommandIsScript() simply checks if the command's path is valid
  and points to a text file.

* _ShowCommand() opens the current script's location in Tracker and
  selects it.

* Only enable the "Show in Tracker" button, if the command is a text file.
  It stays disabled, e.g. for a simple CLI command like /bin/ls.

* Update user guide

* Mention the new "Show in Tracker" button and drag'n'drop of a script file
  to set the command.
* Updated screenshot.
* Optimized all PNGs.

Assets/UserGuide/index.rst

@@ -60,6 +60,8 @@ Command Management Window
 
 
 The command management window allows you to add/edit/remove/sort shortcuts.
+You can drag'n'drop a script to replace the currently shown command path.
+If the command is a script, the `Show in Tracker` button will open its location in a Tracker window. From there you can rename it or open it in an editor etc.
 
 
 Command List

Source/CommandsWindow.cpp

@@ -17,8 +17,10 @@
 #include <IconUtils.h>
 #include <LayoutBuilder.h>
 #include <ListView.h>
+#include <NodeInfo.h>
 #include <Path.h>
 #include <Resources.h>
+#include <Roster.h>
 #include <ScrollView.h>
 #include <StringView.h>
 #include <private/shared/ToolBar.h>
@@ -32,6 +34,7 @@ enum {
 	kUserGuideAction = 'GiDe',
 	kListSelectAction = 'LsTs',
 	kBrowseCommandAction = 'BrWz',
+	kShowCommandAction = 'SwWz',
 	kListUpdateAction = 'LsUp'
 };
 
@@ -81,6 +84,7 @@ CommandsWindow::CommandsWindow(BString& title)
 						.SetInsets(0)
 						.Add(fBrowseButton = new BButton("Browse" B_UTF8_ELLIPSIS, new BMessage(kBrowseCommandAction)))
 						.AddGlue()
+						.Add(fShowButton = new BButton("Show in Tracker", new BMessage(kShowCommandAction)))
 					.End()
 					.Add(fTerminalCheckBox, 1, 3)
 				.End()
@@ -122,6 +126,9 @@ CommandsWindow::MessageReceived(BMessage* message)
 		case kBrowseCommandAction:
 			_BrowseCommand();
 			break;
+		case kShowCommandAction:
+			_ShowCommand();
+			break;
 		case kDeleteCommandAction:
 			_DeleteCommand();
 			break;
@@ -174,6 +181,73 @@ CommandsWindow::_BrowseCommand()
 }
 
 
+void
+CommandsWindow::_ShowCommand()
+{
+	BEntry itemEntry(_Deescape(fCommandControl->Text()));
+	status_t status = itemEntry.InitCheck();
+	if (status == B_OK) {
+		BEntry parentDirectory;
+		status = itemEntry.GetParent(&parentDirectory);
+		if (status == B_OK) {
+			entry_ref ref;
+			status = parentDirectory.GetRef(&ref);
+			if (status == B_OK) {
+				node_ref nref;
+				status = itemEntry.GetNodeRef(&nref);
+				if (status == B_OK)
+					_ShowInTracker(ref, &nref);
+			}
+		}
+	}
+}
+
+
+status_t
+CommandsWindow::_ShowInTracker(const entry_ref& ref, const node_ref* nref)
+{
+	status_t status = B_ERROR;
+
+	BMessenger tracker("application/x-vnd.Be-TRAK");
+	if (tracker.IsValid()) {
+		BMessage message(B_REFS_RECEIVED);
+		message.AddRef("refs", &ref);
+
+		if (nref != NULL)
+			message.AddData("nodeRefToSelect", B_RAW_TYPE, (void*)nref, sizeof(node_ref));
+
+		status = tracker.SendMessage(&message);
+	}
+	return status;
+}
+
+
+bool
+CommandsWindow::_CommandIsScript()
+{
+	BPath path = _Deescape(fCommandControl->Text());
+	if (path.InitCheck() != B_OK)
+		return false;
+
+	char mimeType[B_MIME_TYPE_LENGTH];
+	BNode commandNode(path.Path());
+	BNodeInfo(&commandNode).GetType(mimeType);
+	if (strncmp("text/", mimeType, 5) == 0)
+		return true;
+
+	return false;
+}
+
+
+const char*
+CommandsWindow::_Deescape(const char* path)
+{
+	BString text(path);
+	text.CharacterDeescape('\\');
+	return text.String();
+}
+
+
 void
 CommandsWindow::_InitNewCommand()
 {
@@ -231,6 +305,7 @@ CommandsWindow::_SelectItem()
 	fCommandControl->SetEnabled(true);
 
 	fBrowseButton->SetEnabled(true);
+	fShowButton->SetEnabled(true);
 
 	fTerminalCheckBox->SetValue(item->UseTerminal());
 	fTerminalCheckBox->SetEnabled(true);
@@ -253,6 +328,8 @@ CommandsWindow::_UpdateItem()
 		fListView->InvalidateItem(fListView->CurrentSelection());
 	}
 
+	fShowButton->SetEnabled(_CommandIsScript());
+
 	_SaveCommands();
 }
 
@@ -320,6 +397,7 @@ CommandsWindow::_InitControls()
 	fCommandControl->SetEnabled(false);
 
 	fBrowseButton->SetEnabled(false);
+	fShowButton->SetEnabled(false);
 
 	fTerminalCheckBox->SetValue(1);
 	fTerminalCheckBox->SetEnabled(false);

Source/CommandsWindow.h

@@ -33,12 +33,17 @@ class CommandsWindow : public BWindow {
 			void		_SelectItem();
 			void		_UpdateItem();
 			void		_BrowseCommand();
+			void		_ShowCommand();
+			status_t	_ShowInTracker(const entry_ref& ref, const node_ref* nref = NULL);
+			bool		_CommandIsScript();
+			const char*	_Deescape(const char* path);
 			void		_RefsReceived(BMessage* message);
 			status_t	_LoadCommands();
 			status_t	_SaveCommands();
 			BBitmap*	_ResourceBitmap(const char* name, float width, float height);
 
 		BButton*		fBrowseButton;
+		BButton*		fShowButton;
 		BCheckBox*		fTerminalCheckBox;
 		BListView*		fListView;
 		BFilePanel*		fBrowsePanel;