diff options
Diffstat (limited to 'src-qt5/core/lumina-open')
| -rw-r--r-- | src-qt5/core/lumina-open/lumina-open.1 | 114 | ||||
| -rw-r--r-- | src-qt5/core/lumina-open/lumina-open.8 | 104 | ||||
| -rw-r--r-- | src-qt5/core/lumina-open/lumina-open.pro | 4 |
3 files changed, 106 insertions, 116 deletions
diff --git a/src-qt5/core/lumina-open/lumina-open.1 b/src-qt5/core/lumina-open/lumina-open.1 deleted file mode 100644 index cb671da3..00000000 --- a/src-qt5/core/lumina-open/lumina-open.1 +++ /dev/null @@ -1,114 +0,0 @@ -.Dd March 29, 2017 -.Dt LUMINA-OPEN 1 -.Os Lumina Desktop Environment -.\"------------------------------------------------------------------- -.Sh NAME -.Nm lumina-open -.Nd Application launcher for the Lumina Desktop Environment. -.\"------------------------------------------------------------------- -.Sh SYNOPSIS -.Nm -.Pp -.Nm -.Cm [-select | -action <ActionID>] <file path or URL> -.Pp -.Nm -.Cm [-volumeup | -volumedown | -brightnessup | -brightnessdown | --autostart-apps | -terminal] -.\"------------------------------------------------------------------- -.Sh DESCRIPTION -Given a file with an absolute pathway or URL, the -.Nm -utility finds the appropriate application with which to open the -file. If the file is a *.desktop application shortcut, -.Nm -starts the application automatically. Using the appropriate flags -allows -.Nm -to perform a few specific system operations. Here are the commands, -flags, and descriptions of their functionality: -.Pp -.Bl -tag -width indent -.It Ic lumina-open -Displays the description and usage for lumina-open. -.It Ic lumina-open [-select | -action <ActionID>] <file path or URL> -Opens the file using the appropriate application. -.It Fl select -Optional flag. Bypasses any default application settings to display -the application selector window. -.It Fl action\ <ActionID> -Optional flag. Runs the specified ActionID that is listed in -a .desktop registration file rather than the main command. -.It Ic lumina-open [-volumeup | -volumedown | -brightnessup | --brightnessdown | -autostart-apps | -terminal] -.Pp -This command is used to perform system operations, depending on the -specific flags. -.It Fl volumeup -Increase system audio volume by 5%. -.It Fl volumedown -Decrease system audio volume by 5%. -.It Fl brightnessup -Increase screen brightness by 5%. -.It Fl brightnessdown -Decrease screen brightness by 5%. -.It Fl autostart-apps -Launches all applications registered with the XDG autostart -application. Typically run by the desktop and not manually launched. -.It Fl terminal -Open the user's default terminal. -.El -.\"------------------------------------------------------------------- -.Sh EXAMPLES -.Bl -tag -width indent -.It lumina-open -brightnessup -Increase screen brightness. -.Pp -.It lumina-open sample.txt -.Nm -finds the default program for .txt files and opens sample.txt with -the appropriate application. -.It lumina-open ~/Documents -.Nm -launches the default file manager, pointed to the current user's -Documents directory. -.It lumina-open http://lumina-desktop.org -Launches the default web browser pointed to the Lumina website. -.El -.\"------------------------------------------------------------------- -.Sh FILES -.Bl -tag -width indent -.It Pa ${XDG_CONFIG_HOME}/mimeapps.list -Default file that saves mimetype to application associations. -.It Pa ${XDG_CONFIG_HOME}/${XDG_CURRENT_DESKTOP}-mimeapps.list -Default file that saves mimetype to application associations for the -current desktop session. This file is used before the generic -associations file. -.El -.\"------------------------------------------------------------------- -.Sh SEE ALSO -.Xr XDG-OPEN(1) -.\"------------------------------------------------------------------- -.Sh REFERENCES -For .desktop entry specifications and formatting, refer to these -websites: -.Bl -tag -width indent -.Pp -.Cm https://specifications.freedesktop.org/desktop-entry-spec/latest/ -.Pp -Specifications for .desktop files. -.Pp -.Cm https://specifications.freedesktop.org/mime-apps-spec/latest/ -.Pp -Details how default applications are registered. -.Pp -.Cm https://specifications.freedesktop.org/autostart-spec/latest/ -.Pp -Used in the -autostart-apps action. Determines which applications -are automatically started. -.Pp -.El -.\"------------------------------------------------------------------- -.Sh AUTHOR -.An Tim Moore -.Aq timmoore88@gmail.com diff --git a/src-qt5/core/lumina-open/lumina-open.8 b/src-qt5/core/lumina-open/lumina-open.8 new file mode 100644 index 00000000..582ad2ee --- /dev/null +++ b/src-qt5/core/lumina-open/lumina-open.8 @@ -0,0 +1,104 @@ +.Dd November 7, 2017 +.Dt LUMINA-OPEN 1 +.Os 1.3.3 + +.Sh NAME +.Nm lumina-open +.Nd a graphical front-end to xdg-open. +Opens files or links with the proper application. + +.Sh SYNOPSIS +.Nm +.Pp +.Nm +.Op Fl select | action No <ActionID> +.Op Ar FILE_PATH | URL +.Pp +.Nm +.Op Fl volumeup | volumedown | brightnessup | brightnessdown | \ + autostart-apps | terminal + +.Sh DESCRIPTION +Given a file with an absolute pathway or URL, the +.Nm +utility finds the appropriate application to open the file. +If the file is a *.desktop application shortcut, +.Nm +starts the application automatically. +.Nm +can also perform specific system operations. +Here are all flags and descriptions: +.Pp +.Bl -tag -width indent +.It Ic lumina-open +Displays the description and usage for lumina-open. +.It Nm Fl select +Bypasses any default application settings to display the application +selector window. +.It Nm Fl action\ \fIActionID\fR +Runs the specified ActionID that is listed in a .desktop registration +file rather than the main command. +.It Nm Fl volumeup +Increase system audio volume by 5%. +.It Nm Fl volumedown +Decrease system audio volume by 5%. +.It Nm Fl brightnessup +Increase screen brightness by 5%. +.It Nm Fl brightnessdown +Decrease screen brightness by 5%. +.It Nm Fl autostart-apps +Launches all applications registered with the XDG autostart application. +Typically run by the desktop instead of manually launched. +.It Nm Fl terminal +Open the default terminal. +.El + +.Sh EXAMPLES +.Bl -tag -width indent +.It lumina-open sample.txt +.Nm +finds the default program for .txt files and opens sample.txt with +the appropriate application. +.It lumina-open ~/Documents +.Nm +launches the default file manager pointed to the current Documents +directory. +.It lumina-open http://lumina-desktop.org +Launches the default web browser pointed to the Lumina website. +.El + +.Sh FILES +.Bl -tag -width indent +.It Pa %{XDG_CONFIG_HOME}/mimeapps.list +Default file that saves mimetype to application associations. +.It Pa %{XDG_CONFIG_HOME}/${XDG_CURRENT_DESKTOP}-mimeapps.list +Default file that saves mimetype to application associations for the +current desktop session. +This file is used before the generic associations file. +.El + +.Sh SEE ALSO +.Xr XDG-OPEN(1) + +.Sh REFERENCES +For .desktop entry specifications and formatting, refer to these +websites: +.Bl -tag -width indent +.Pp +.Cm https://specifications.freedesktop.org/desktop-entry-spec/latest/ +.Pp +Specifications for .desktop files. +.Pp +.Cm https://specifications.freedesktop.org/mime-apps-spec/latest/ +.Pp +Details how default applications are registered. +.Pp +.Cm https://specifications.freedesktop.org/autostart-spec/latest/ +.Pp +Used in the -autostart-apps action. +Determines which applications are automatically started. +.El + +.Sh AUTHORS +.An Tim Moore and Aaron St. John +.Aq timmoore88@gmail.com diff --git a/src-qt5/core/lumina-open/lumina-open.pro b/src-qt5/core/lumina-open/lumina-open.pro index b31c7a0e..0e0d1e76 100644 --- a/src-qt5/core/lumina-open/lumina-open.pro +++ b/src-qt5/core/lumina-open/lumina-open.pro @@ -89,8 +89,8 @@ TRANSLATIONS = i18n/lumina-open_af.ts \ dotrans.path=$${L_SHAREDIR}/lumina-desktop/i18n/ dotrans.extra=cd i18n && $${LRELEASE} -nounfinished *.ts && cp *.qm $(INSTALL_ROOT)$${L_SHAREDIR}/lumina-desktop/i18n/ -manpage.path=$${L_MANDIR}/man1/ -manpage.extra="$${MAN_ZIP} lumina-open.1 > $(INSTALL_ROOT)$${L_MANDIR}/man1/lumina-open.1.gz" +manpage.path=$${L_MANDIR}/man8/ +manpage.extra="$${MAN_ZIP} lumina-open.8 > $(INSTALL_ROOT)$${L_MANDIR}/man8/lumina-open.8.gz" INSTALLS += target manpage |