commit: 09efa60340524cfb39fc764db0e6c064a5ee50d6
parent eba2e9080b3f9e1f963e2b772be2bc06a6b01b4f
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date: Wed, 17 Apr 2024 22:31:18 +0200
xcursorgen.1: import from X.Org xcursorgen
Diffstat:
2 files changed, 70 insertions(+), 0 deletions(-)
diff --git a/Makefile b/Makefile
@@ -1,11 +1,15 @@
# SPDX-FileCopyrightText: 2023 Haelwenn (lanodan) Monnier
# SPDX-License-Identifier: MIT
+VERSION = 0.0.1
+
CC ?= cc
CFLAGS ?= -O2 -g -Wall -Wextra
PREFIX ?= /usr
BINDIR ?= ${PREFIX}/bin
+MANDIR ?= ${PREFIX}/share/man
+MAN1DIR ?= ${MANDIR}/man1
PKG_CONFIG ?= pkg-config
@@ -25,6 +29,8 @@ xcursorgen: ${XCURSORGEN_SRC} | *.h Xcursor/*.h
install: all
mkdir -p ${DESTDIR}${BINDIR}
cp -p xcursorgen ${DESTDIR}${BINDIR}/
+ mkdir -p ${DESTDIR}${MAN1DIR}
+ sed -e 's;xcursorgen-nox-git;xcursorgen-nox ${VERSION};' xcursorgen.1 > ${DESTDIR}${MAN1DIR}/xcursorgen.1
SOURCES = *.c *.h Xcursor/*.h Xcursor/*.c
.PHONY: format
diff --git a/xcursorgen.1 b/xcursorgen.1
@@ -0,0 +1,64 @@
+.\"
+.\" Copyright 2002 Keith Packard.\"
+.\" Permission to use, copy, modify, distribute, and sell this software and its
+.\" documentation for any purpose is hereby granted without fee, provided that
+.\" the above copyright notice appear in all copies and that both that
+.\" copyright notice and this permission notice appear in supporting
+.\" documentation, and that the name of Keith Packard not be used in
+.\" advertising or publicity pertaining to distribution of the software without
+.\" specific, written prior permission. Keith Packard makes no
+.\" representations about the suitability of this software for any purpose. It
+.\" is provided "as is" without express or implied warranty.
+.\"
+.\" KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
+.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
+.\" EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
+.\" CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+.\" DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+.\" PERFORMANCE OF THIS SOFTWARE.
+.\"
+.\"
+.\" $XFree86: xc/programs/xcursorgen/xcursorgen.man,v 1.1 2002/09/03 06:48:28 keithp Exp $
+.\"
+.TH XCURSORGEN 1 "September 03, 2002" "xcursorgen-nox-git"
+.SH NAME
+xcursorgen \- create an X cursor file from a collection of PNG images
+.SH SYNOPSIS
+.B "xcursorgen"
+[ \fB\-V\fP ] [ \fB\-\-version\fP ] [ \fB\-?\fP ] [ \fB\-\-help\fP ]
+[ \fB\-p\fP \fIdir\fP ] [ \fB\-\-prefix\fP \fIdir\fP ]
+.RI "[ " config-file
+.RI "[ " output-file " ] ]"
+.SH DESCRIPTION
+Xcursorgen reads the \fIconfig-file\fP to find the list of cursor images along
+with their hotspot and nominal size information. Xcursorgen converts all of
+the images to Xcursor format and writes them to the \fIoutput-file\fP.
+.P
+Each line in the config file is of the form:
+.br
+<size> <xhot> <yhot> <filename> <ms-delay>
+.br
+.P
+Multiple images with the same <size> are used to create animated cursors,
+the <ms-delay> value on each line indicates how long each image should be
+displayed before switching to the next. <ms-delay> can be elided for static
+cursors.
+.P
+If \fIconfig-file\fP is not specified, or is specified as "-",
+standard input is used for the configuration file.
+If \fIoutput-file\fP is not specified, or is specified as "-",
+standard output is used for the output file.
+.SH OPTIONS
+.TP 8
+.BR \-V ", " \-\-version
+Display the version number and exit.
+.TP 8
+.BR \-? ", " \-\-help
+Display the usage message and exit.
+.TP 8
+.BR "\-p \fIdir\fP" ", " "\-\-prefix \fIdir\fP"
+Find cursor images in the directory specified by \fIdir\fP. If not specified,
+the current directory is used.
+.SH "SEE ALSO"
+Xcursor(3)
