From 59fa217a7b7ec41aadd10e3128bbdabf54904b94 Mon Sep 17 00:00:00 2001
From: jn64 <23169302+jn64@users.noreply.github.com>
Date: Fri, 9 Dec 2022 14:30:09 +0800
Subject: [PATCH] Draft manpage (pandoc Markdown)

While Markdown isn't the best fit for writing manpages,
it's the easiest for future contributions/maintenance.
However, pandoc is a heavy dependency for producing
a single manpage. Other tools [1] could be evaluated.

The only pandoc-isms are the title block [2]
(first 3 lines) which will rarely change,
and the definition lists ':' for options
which is self-explanatory.

The Markdown source is intentionally not hard wrapped.
pandoc automatically hard wraps the roff man output
(which may be further re-wrapped by manpage viewers).

To produce the manpage (outputs a file Cemu.1):

    pandoc -s -f markdown-smart -t man Cemu.1.md -o Cemu.1

Preview from Markdown without writing to file:

    pandoc -s -f markdown-smart -t man Cemu.1.md | man -l -

markdown-smart *disables* the smart typography extension
to avoid mangling '--'. [3]

[1]: https://drewdevault.com/2018/05/13/scdoc.html
[2]: https://pandoc.org/MANUAL.html#extension-pandoc_title_block
[3]: https://pandoc.org/MANUAL.html#extensions
---
 dist/linux/Cemu.1.md | 85 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 dist/linux/Cemu.1.md

diff --git a/dist/linux/Cemu.1.md b/dist/linux/Cemu.1.md
new file mode 100644
index 00000000..08bf69fc
--- /dev/null
+++ b/dist/linux/Cemu.1.md
@@ -0,0 +1,85 @@
+% CEMU(1) Cemu | Wii U emulator
+% Exzap; Petergov
+% 2022-12-09
+
+# NAME
+
+Cemu - Wii U emulator
+
+# SYNOPSIS
+
+**Cemu** [_OPTIONS_...]
+
+# DESCRIPTION
+
+**Cemu** is a Wii U emulator that is able to run most Wii U games and homebrew in a playable state. It's written in C/C++ and is being actively developed with new features and fixes to increase compatibility, convenience and usability.
+
+# OPTIONS
+
+If an option has argument _n_, a value of 1 (or no argument) enables the option. A value of 0 disables the option.
+
+## Launch options
+
+**-g** _path_, **--game** _path_
+
+: Path of game to launch
+
+**-m** _path_, **--mlc** _path_
+
+: Custom mlc folder location
+
+**-f** [_n_], **--fullscreen** [_n_]
+
+: Launch games in fullscreen mode
+
+**-u** [_n_], **--ud** [_n_]
+
+: Render output upside-down
+
+**-a** _id_, **--account** _id_
+
+: Persistent id of account
+
+**--force-interpreter** [_n_]
+
+: Force interpreter CPU emulation and disable recompiler
+
+**--act-url** _url_
+
+: URL prefix for account server
+
+**--ecs-url** _url_
+
+: URL for ECS service
+
+**-h**, **--help**
+
+: Display a usage message and exit
+
+**-v**, **--version**
+
+: Display Cemu version and exit
+
+## Extractor tool
+
+**-e** _path_, **--extract** _path_
+
+: Path to WUD or WUX file for extraction
+
+**-p** _path_, **--path** _path_
+
+: Path of file to extract (for example meta/meta.xml)
+
+**-o** _path_, **--output** _path_
+
+: Output path for extracted file
+
+# BUGS
+
+To report a bug, visit _https://github.com/cemu-project/Cemu/issues_
+
+# SEE ALSO
+
+Project homepage:
+
+_https://github.com/cemu-project/Cemu_