replace `rst2man` with `pandoc`

This commit is contained in:
Blake Lee 2022-07-18 18:56:46 -04:00
parent 88506d4284
commit a312f8e0ac
No known key found for this signature in database
GPG Key ID: 87157C329108F09E
3 changed files with 96 additions and 91 deletions

View File

@ -9,6 +9,9 @@ PKGS = wlroots wayland-server xcb xkbcommon libinput
CFLAGS += $(foreach p,$(PKGS),$(shell pkg-config --cflags $(p)))
LDLIBS += $(foreach p,$(PKGS),$(shell pkg-config --libs $(p)))
VERSION=0.7.1beta
DATE=$(shell date "+%d %b %Y")
xdg-shell-protocol.h:
$(WAYLAND_SCANNER) server-header \
$(WAYLAND_PROTOCOLS)/stable/xdg-shell/xdg-shell.xml $@
@ -124,8 +127,7 @@ install:
cp ./assets/wall_4K.png ${PREFIX}/share/hyprland
cp ./assets/wall_8K.png ${PREFIX}/share/hyprland
rst2man ./docs/hyprctl.1.rst | gzip -c > /usr/share/man/man1/hyprctl.1.gz
rst2man ./docs/Hyprland.1.rst | gzip -c > /usr/share/man/man1/Hyprland.1.gz
make man
uninstall:
rm -f ${PREFIX}/share/wayland-sessions/hyprland.desktop
@ -150,3 +152,22 @@ config:
cd subprojects/wlroots && ninja -C build/
cd subprojects/wlroots && ninja -C build/ install
man:
pandoc ./docs/Hyprland.1.rst \
--standalone \
--variable=header:"Hyprland User Manual" \
--variable=footer:${VERSION} \
--variable=date:"${DATE}" \
--variable=section:1 \
--from rst \
--to man | gzip -c > /usr/share/man/man1/Hyprland.1.gz
pandoc ./docs/hyprctl.1.rst \
--standalone \
--variable=header:"hyprctl User Manual" \
--variable=footer:${VERSION} \
--variable=date:"${DATE}" \
--variable=section:1 \
--from rst \
--to man | gzip -c > /usr/share/man/man1/hyprctl.1.gz

View File

@ -1,30 +1,24 @@
========
Hyprland
========
:title: Hyprland
:author: Vaxerski <*https://github.com/vaxerski*>
---------------------------------
Dynamic tiling Wayland compositor
---------------------------------
NAME
====
:Date: 15 Jul 2022
:Copyright: Copyright (c) 2022, vaxerski
:Version: 0.7.1beta
:Manual section: 1
:Manual group: Hyprland
Hyprland - Dynamic tiling Wayland compositor
SYNOPSIS
========
``Hyprland`` [arg [...]].
**Hyprland** [*arg [...]*].
DESCRIPTION
===========
``Hyprland`` is a dynamic tiling Wayland compositor based on
**Hyprland** is a dynamic tiling Wayland compositor based on
wlroots that doesn't sacrifice on its looks.
You can launch Hyprland by either going into a TTY and
executing ``Hyprland``, or with a login manager.
executing **Hyprland**, or with a login manager.
NOTICE
======
@ -36,30 +30,29 @@ Although Hyprland is pretty stable, it may have some bugs.
CONFIGURATION
=============
For configuration information please see <`https://github.com/hyprwm/Hyprland/wiki`>.
For configuration information please see <*https://github.com/hyprwm/Hyprland/wiki*>.
OPTIONS
=======
-h, --help
**-h**, **--help**
Show command usage.
-c, --config
**-c**, **--config**
Specify config file to use.
BUGS
====
Submit bug reports and request features online at:
<`https://github.com/hyprwm/Hyprland/issues`>
<*https://github.com/hyprwm/Hyprland/issues*>
SEE ALSO
========
Sources at: <`https://github.com/hyprwm/Hyprland`>
Sources at: <*https://github.com/hyprwm/Hyprland*>
AUTHORS
=======
COPYRIGHT
=========
Vaxerski <`https://github.com/vaxerski`>
Copyright (c) 2022, vaxerski

View File

@ -1,130 +1,121 @@
=======
hyprctl
=======
:title: hyprctl(1)
:author: Vaxerski <*https://github.com/vaxerski*>
----------------------------------------------------------------
Utility for controlling parts of Hyprland from a CLI or a script
----------------------------------------------------------------
NAME
====
:Date: 15 Jul 2022
:Copyright: Copyright (c) 2022, vaxerski
:Version: 0.7.1beta
:Manual section: 1
:Manual group: hyprctl
hyprctl - Utility for controlling parts of Hyprland from a CLI or a script
SYNOPSIS
========
``hyprctl`` [(opt)flags] [command] [(opt)args]
**hyprctl** [*(opt)flags*] [**command**] [*(opt)args*]
DESCRIPTION
===========
``hyprctl`` is a utility for controlling some parts of the compositor from a CLI or a script.
**hyprctl** is a utility for controlling some parts of the compositor from a CLI or a script.
COMMANDS
========
CONTROL COMMANDS
================
Control
**dispatch**
``dispatch``
Call a dispatcher with an argument.
Call a dispatcher with an argument.
An argument must be present.
For dispatchers without parameters it can be anything.
An argument must be present.
For dispatchers without parameters it can be anything.
Returns: *ok* on success, and an error message on failure.
Returns: `ok` on success, and an error message on failure.
Examples:
**hyprctl** *dispatch exec kitty*
Examples:
**hyprctl** *dispatch pseudo x*
``hyprctl`` `dispatch exec kitty`
**keyword**
``hyprctl`` `dispatch pseudo x`
Set a config keyword dynamically.
``keyword``
Returns: *ok* on success, and an error message on failure.
Set a config keyword dynamically.
Examples:
**hyprctl** *keyword bind SUPER,0,pseudo*
Returns: `ok` on success, and an error message on failure.
**hyprctl** *keyword general:border_size 10*
Examples:
**reload**
``hyprctl`` `keyword bind SUPER,0,pseudo`
Force a reload of the config file.
``hyprctl`` `keyword general:border_size 10`
**kill**
``reload``
Enter kill mode, where you can kill an app by clicking on it.
You can exit by pressing ESCAPE.
Force a reload of the config file.
INFO COMMANDS
=============
``kill``
**version**
Enter kill mode, where you can kill an app by clicking on it.
You can exit by pressing ESCAPE.
Prints the Hyprland version, flags, commit and branch of build.
Info
**monitors**
``version``
Lists all the outputs with their properties.
Prints the Hyprland version, flags, commit and branch of build.
**workspaces**
``monitors``
Lists all workspaces with their properties.
Lists all the outputs with their properties.
**clients**
``workspaces``
Lists all windows with their properties.
Lists all workspaces with their properties.
**devices**
``clients``
Lists all connected input devices.
Lists all windows with their properties.
**activewindow**
``devices``
Returns the active window name.
Lists all connected input devices.
**layers**
``activewindow``
Lists all the layers.
Returns the active window name.
**splash**
``layers``
Lists all the layers.
``splash``
Returns the current random splash.
Returns the current random splash.
OPTIONS
=======
--batch
**--batch**
Specify a batch of commands to execute.
Example:
**hyprctl** *--batch "keyword general:border_size 2 ; keyword general:gaps_out 20"*
``hyprctl`` `--batch "keyword general:border_size 2 ; keyword general:gaps_out 20"`
*;* separates the commands.
`;` separates the commands.
**-j**
-j
Outputs information in JSON.
BUGS
====
Submit bug reports and feature requests online at:
<`https://github.com/hyprwm/hyprctl/issues`>
Submit bug reports and request features online at:
<*https://github.com/hyprwm/Hyprland/issues*>
SEE ALSO
========
Sources at: <`https://github.com/hyprwm/hyprctl`>
Sources at: <*https://github.com/hyprwm/Hyprland*>
AUTHORS
=======
COPYRIGHT
=========
Vaxerski <`https://github.com/vaxerski`>
Copyright (c) 2022, vaxerski