Add in the new manpages from Aaron St.John (lumina-docs repo).

Also adjust the "community support" shortcut to point to gitter rather than IRC.

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