Compare commits
1 commit
a2ddf77d4e
...
3c51b624e5
Author | SHA1 | Date | |
---|---|---|---|
![]() |
3c51b624e5 |
3 changed files with 13 additions and 18 deletions
2
Makefile
2
Makefile
|
@ -14,7 +14,7 @@ $(README): $(PROGRAM)
|
|||
./$(PROGRAM) --help > $(README)
|
||||
|
||||
$(MANPAGE): $(README)
|
||||
ronn < $(README) > $(MANPAGE)
|
||||
ronn --date=$$(date +"%Y-%m-%d") --manual="User Commands" --organization=tk-sls.de/git --section="1" < $(README) > $(MANPAGE)
|
||||
|
||||
.PHONY: all install install-bin install-doc install-man
|
||||
|
||||
|
|
|
@ -56,7 +56,7 @@ specified by `XDG_DATA_DIRS`. To match, the string "firefox" must be contained
|
|||
in either the "Exec" or the "Comment" directive. List the matching files, also
|
||||
show the "Exec" and "TryExec" directives in each found file.
|
||||
|
||||
```shell
|
||||
```
|
||||
xdg-desktop-search -s Exec -s Comment -v -d Exec -d TryExec firefox
|
||||
```
|
||||
|
||||
|
|
|
@ -1,12 +1,10 @@
|
|||
.\" generated with Ronn-NG/v0.10.1
|
||||
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
||||
.TH "XDG\-DESKTOP\-SEARCH" "1" "November 2024" ""
|
||||
.\" generated with Ronn-NG/v0.9.1
|
||||
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
|
||||
.TH "XDG\-DESKTOP\-SEARCH" "1" "May 2025" "tk-sls.de/git" "User Commands"
|
||||
.SH "NAME"
|
||||
\fBXDG\-DESKTOP\-SEARCH\fR \- Search for \.desktop files
|
||||
.SH "SYNOPSIS"
|
||||
.nf
|
||||
xdg\-desktop\-search [ OPTIONS ] SEARCH \|\.\|\.\|\.
|
||||
.fi
|
||||
\fBxdg\-desktop\-search [ OPTIONS ] SEARCH \|\.\|\.\|\.\fR
|
||||
.SH "DESCRIPTION"
|
||||
xdg\-desktop\-search locates files with names that end in \fB\.desktop\fR in sub\-directories of name "applications" of a collection of directories refered to as "XDG data directories"\. It the searches the lines of such desktop files for "directives", meaning key\-value\-assignments such as \fBExec=/some/program\fR where the assigned value matches one of the search string given as commandline arguments SEARCH\.
|
||||
.P
|
||||
|
@ -16,28 +14,25 @@ xdg\-desktop\-search returns successfully if the search rendered one or more res
|
|||
.P
|
||||
The path of XDG directories searched can be modified by altering the environment variable \fBXDG_DATA_DIRS\fR\.
|
||||
.SH "ARGUMENTS"
|
||||
.IP "\(bu" 4
|
||||
.IP "\[ci]" 4
|
||||
\fBSEARCH\fR: Search \.desktop files with search directives containing this string\. The searched directives are "Name" and "Exec" by default but can be overridden using the \fB\-s\fR option (see below)\.
|
||||
.IP "" 0
|
||||
.SH "OPTIONS"
|
||||
.IP "\(bu" 4
|
||||
.IP "\[ci]" 4
|
||||
\fB\-h\fR, \fB\-\-help\fR: Print this message and exit\.
|
||||
.IP "\(bu" 4
|
||||
.IP "\[ci]" 4
|
||||
\fB\-v\fR, \fB\-\-verbose\fR: Print directives in found \.desktop files\.
|
||||
.IP "\(bu" 4
|
||||
.IP "\[ci]" 4
|
||||
\fB\-d STRING\fR, \fB\-\-show\-directive STRING\fR: Instead of printing all directives when searching in verbose mode, print only the directive given by \fBSTRING\fR (e\.g\. "Name")\. Option can be repeated to print multiple directives\.
|
||||
.IP "\(bu" 4
|
||||
.IP "\[ci]" 4
|
||||
\fB\-s STRING\fR, \fB\-\-search\-directive STRING\fR: Instead of searching directives "Name" and "Exec" for strings containing \fBSEARCH\fR, search the given directive instead (e\.g\. "Comment")\. Option can be repeated to search in multiple directives\.
|
||||
.IP "" 0
|
||||
.SH "RETURN VALUES"
|
||||
The command returns 0 if \.desktop files were found that match the specified criteria, 1 on usage error and 2 if no matching \.desktop files were found\.
|
||||
.SH "EXAMPLE"
|
||||
Search for the string "firefox" in all \.desktop files found in the path specified by \fBXDG_DATA_DIRS\fR\. To match, the string "firefox" must be contained in either the "Exec" or the "Comment" directive\. List the matching files, also show the "Exec" and "TryExec" directives in each found file\.
|
||||
.IP "" 4
|
||||
.nf
|
||||
xdg\-desktop\-search \-s Exec \-s Comment \-v \-d Exec \-d TryExec firefox
|
||||
.fi
|
||||
.IP "" 0
|
||||
.P
|
||||
\fBxdg\-desktop\-search \-s Exec \-s Comment \-v \-d Exec \-d TryExec firefox\fR
|
||||
.SH "AUTHOR AND COPYRIGHT"
|
||||
Copyright \(co 2024 Tilman Kranz \fIt\.kranz@tk\-sls\.de\fR
|
||||
.SH "LICENSE"
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue