search helpers: Change the group name, follow my own rules for mimetype

list termination, improve readme.

Author: mtwebster

libnemo-private/nemo-search-engine-advanced.c

@@ -32,7 +32,7 @@
 #define DEBUG_FLAG NEMO_DEBUG_SEARCH
 #include "nemo-debug.h"
 
-#define SEARCH_HELPER_GROUP "Nemo Search Cat Helper"
+#define SEARCH_HELPER_GROUP "Nemo Search Helper"
 
 #define FILE_SEARCH_ONLY_BATCH_SIZE 500
 #define CONTENT_SEARCH_BATCH_SIZE 1

search-helpers/README.md

@@ -4,32 +4,32 @@ Nemo's file and content search utilizes a plugin-type system to allow content se
 
 The only requirements for a helper is the ability to extract text from a given file type and print it to stdout. A definition file provides details necessary to use the helper.
 
-##### Example definition file:
+##### Example definition file (note: text/plain support is built-in to nemo, this is only to illustrate):
 
 ```
-[Nemo Search Cat Helper]
-TryExec=pdftotext
-Exec=pdftotext %s -
-MimeType=application/pdf;
-Priority=200
+[Nemo Search Helper]
+TryExec=cat
+Exec=cat %s
+MimeType=text/plain;
+Priority=100
 
 ```
-The `Nemo Search Cat Helper` group name is mandatory.
+The `Nemo Search Helper` group name is mandatory.
 
 - The filename must end in `.nemo_search_helper`.
 - `TryExec` should be set to the name of the executable (without any arguments). When the helpers are loaded, Nemo will
   check that the program a) exists and b) is executable. If these checks fail, the helper will be skipped. If only a
   program name is provided, it must exist in the user's path. This can also be an absolute path. 
 - `Exec` should provide the full command line necessary to extract the text from the file. The `%s` argument will be replaced by
   the file name being processed during content search. Note, uris are not supported, only paths (local files).
-- `MimeType`is a semicolon (`;`)-separated list of mimetypes that this search helper should be used with. It must be
+- `MimeType`is a semicolon (`;`)-separated list of mimetypes that this search helper should be used with. It should be
   semicolon-terminated (even if there's only a single item).
 - `Priority` is a value used to break a tie when multiple helpers support the same mimetype. The higher value wins. In the
-  event of a tie, the last helper processed is used (the order is currently undefined). If the `Priority` entry is missing,
+  event of a tie, the last helper processed is used (the order of files processed is undefined). If the `Priority` entry is missing,
   the value is assumed to be 100.
 - The `TryExec`, `Exec` and `MimeType` keys are mandatory.
 
-These definition files can be placed in `<datadir>/nemo/search-helpers` where `<datadir>` can be some directory in XDG_DATA_DIRS or under the user's data directory (`~/.local/share/namo/search-helpers`). The user directory is processed last, and takes precedence over the system dirs.
+These definition files can be placed in `<datadir>/nemo/search-helpers` where `<datadir>` can be some directory in XDG_DATA_DIRS or under the user's data directory (`~/.local/share/namo/search-helpers`). The user directory is *always* processed last.
 
 ##### Debugging:
 If something doesn't seem to be working, you can run nemo with debugging enabled:

search-helpers/mso.nemo_search_helper

@@ -1,5 +1,5 @@
-[Nemo Search Cat Helper]
+[Nemo Search Helper]
 TryExec=nemo-mso-to-txt
 Exec=nemo-mso-to-txt %s
-MimeType=application/vnd.openxmlformats-officedocument.wordprocessingml.document;application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;application/vnd.openxmlformats-officedocument.presentationml.presentation
+MimeType=application/vnd.openxmlformats-officedocument.wordprocessingml.document;application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;application/vnd.openxmlformats-officedocument.presentationml.presentation;
 priority=100

search-helpers/third-party/exif.nemo_search_helper

@@ -1,5 +1,5 @@
-[Nemo Search Cat Helper]
+[Nemo Search Helper]
 TryExec=exif
 Exec=exif -m %s
-MimeType=image/jpeg;image/png;image/gif;image/bmp;image/tiff
+MimeType=image/jpeg;image/png;image/gif;image/bmp;image/tiff;
 Priority=100

search-helpers/third-party/id3.nemo_search_helper

@@ -1,5 +1,5 @@
-[Nemo Search Cat Helper]
+[Nemo Search Helper]
 TryExec=id3
 Exec=id3 -l %s
-MimeType=audio/mpeg
+MimeType=audio/mpeg;
 Priority=100

search-helpers/third-party/libreoffice.nemo_search_helper

@@ -1,4 +1,4 @@
-[Nemo Search Cat Helper]
+[Nemo Search Helper]
 TryExec=odt2txt
 Exec=odt2txt %s
 MimeType=application/vnd.oasis.opendocument.text;application/vnd.oasis.opendocument.spreadsheet;application/vnd.oasis.opendocument.presentation;application/vnd.oasis.opendocument.graphics;

search-helpers/third-party/pdf2txt.nemo_search_helper

@@ -1,4 +1,4 @@
-[Nemo Search Cat Helper]
+[Nemo Search Helper]
 TryExec=pdf2txt
 Exec=pdf2txt %s
 MimeType=application/pdf;

search-helpers/third-party/pdftotext.nemo_search_helper

@@ -1,4 +1,4 @@
-[Nemo Search Cat Helper]
+[Nemo Search Helper]
 TryExec=pdftotext
 Exec=pdftotext %s -
 MimeType=application/pdf;

search-helpers/third-party/ps2ascii.nemo_search_helper

@@ -1,4 +1,4 @@
-[Nemo Search Cat Helper]
+[Nemo Search Helper]
 TryExec=ps2ascii
 Exec=ps2ascii %s
 MimeType=application/ps;