Description: Add manpage and get it installed by upstream's build system.
 The old manpage (from 1.x series) was not merged upstream and was not
 very good (not that this one is).  Needs some improvement before it
 can be forwarded upstream.
Author: Yavor Doganov <yavor@gnu.org>
Forwarded: no
Last-Update: 2025-03-06
---

--- lynkeos.app.orig/application/GNUstep/GNUmakefile
+++ lynkeos.app/application/GNUstep/GNUmakefile
@@ -126,3 +126,15 @@
 
 after-clean::
 	$(RM) $(symlinks)
+
+after-install::
+	if [ ! -f $(GNUSTEP_DOC_MAN) ]; then \
+	  $(MKDIRS) $(GNUSTEP_DOC_MAN); \
+	fi
+	if [ ! -f $(GNUSTEP_DOC_MAN)/man1 ]; then \
+	  $(MKDIRS) $(GNUSTEP_DOC_MAN)/man1; \
+	fi
+	$(INSTALL_DATA) Lynkeos.1 $(GNUSTEP_DOC_MAN)/man1
+
+after-uninstall::
+	$(RM) $(GNUSTEP_DOC_MAN)/man1/Lynkeos.1*
--- /dev/null
+++ lynkeos.app/application/GNUstep/Lynkeos.1
@@ -0,0 +1,74 @@
+.\"Lynkeos(1) man page
+.\"Written by Yavor Doganov <yavor@gnu.org>
+.\"Copyright (C) 2018-2025 Debian GNUstep maintainers
+.\"License: GPL-2+
+.TH LYNKEOS 1 "March 2025" GNUstep "GNUstep Manual Pages"
+.SH NAME
+Lynkeos \- an application for processing of astronomical images
+.SH SYNOPSIS
+\fBLynkeos\fR [\fIoptions\fR] [\fIfile\fR]
+.PP
+.SH DESCRIPTION
+.B Lynkeos
+is a program dedicated to processing of astronomical (mainly
+planetary) images taken with a webcam through a telescope.  It can
+import images and movies in various formats.  The images are stacked
+and processed with different algorithms to improve the quality of the
+end result.
+.PP
+.B Lynkeos
+is optimized for multi-processor and multi-core machines.
+.PP
+.SH OPTIONS
+No options are supported apart from the global GNUstep
+\fB\--GNU-Debug\fR option.  If supplied, \fIfile\fR must be a Lynkeos
+Project file (Apple binary property list with
+.B .seq
+extension).
+.PP
+.B Lynkeos
+is fully configurable from its GUI interface.  The only option which
+is not exposed to the user is for debugging inter-thread
+communication.  It can be set with the
+.BI defaults(1)
+tool:
+
+defaults write net.sourceforge.lynkeos ThreadConnectionDebug
+.I n
+
+Where
+.I n
+should be a number representing the debug level:
+.I 1
+for debug messages related to the queue and
+.I 2
+for full debugging (more verbose).
+.PP
+.SH BUGS AND LIMITATIONS
+Because
+.B Lynkeos
+does all of its image processing in secondary threads, it only works
+with the default cairo GNUstep backend.  Certain functionality is
+disabled or does not work properly due to incomplete GNUstep
+implementations of the Cocoa API or differences in behavior.
+.PP
+.SH SEE ALSO
+Comprehensive online help:
+
+.I http://lynkeos.sourceforge.net/wiki/index.php?title=Help:Contents
+
+Online tutorial:
+
+.I http://lynkeos.sourceforge.net/wiki/index.php?title=Help:Tutorial
+.PP
+.SH AUTHORS
+.B Lynkeos
+was written by Jean-Etienne Lamiaud.
+.PP
+This manual page was written by Yavor Doganov <yavor@gnu.org>.
+.SH COPYING
+\(co 2018-2025 Debian GNUstep maintainers
+.PP
+This manual page is distributed under the same license as the
+.B Lynkeos
+program.