===================================================================
RCS file: /anoncvsroot/anoncvs/cvs/projects/fnaify/fnaify.1,v
retrieving revision 1.20
retrieving revision 1.49
diff -u -r1.20 -r1.49
--- projects/fnaify/fnaify.1	2020/07/16 10:32:55	1.20
+++ projects/fnaify/fnaify.1	2020/10/07 20:31:26	1.49
@@ -1,4 +1,4 @@
-.Dd $Mdocdate: July 16 2020 $
+.Dd $Mdocdate: October 7 2020 $
 .Dt FNAIFY 1
 .Os
 .Sh NAME
@@ -7,14 +7,16 @@
 .Sh SYNOPSIS
 .Nm
 .Op Fl i | y
-.Op Fl hv
+.Op Fl hsv
 .Op Fl c Ar configfile
-.Op Fl d Ar depdir
+.Op Fl D Ar depdir
+.Op Fl d Ar gamedir
+.Op Fl f Ar frameworkfile | Fl F Ar frameworkversion
 .Op Fl m Ar monopath
-.Op Ar gamedir
+.Op Ar userflags
 .Sh DESCRIPTION
 .Nm
-sets up games based on the FNA engine to operate with OpenBSD-native
+runs games based on the FNA engine with OpenBSD-native
 libraries and its
 .Xr mono 1
 runtime.
@@ -24,10 +26,18 @@
 has been extended to attempt configuring XNA games as well.
 .Nm
 can be run in 3 basic modes regarding the addition of missing libraries:
-restrictive, interactive, and permissive.
+restrictive
+.Po
+default
+.Pc
+, interactive, and permissive.
 .Pp
+As of version 3.0,
+.Nm
+unifies both setup and launch of supported games in one command.
+.Pp
 All games require additional libraries from ports, like SDL2. Some of
-them can be found in fnaify-extralibs package, like libatomstb or
+them can be found in the fnaify-extralibs package, like libatomstb or
 libfmod_SDL.
 .Pp
 The arguments are as follows:
@@ -82,7 +92,7 @@
 creates
 .Pa ~/.config/fnaify/fnaify.dllmap.config
 with default settings.
-.It Fl d Ar depdir
+.It Fl D Ar depdir
 Add
 .Ar depdir
 to the directories to search for native library dependencies.
@@ -90,20 +100,36 @@
 .Em before
 the default locations
 .Pq Pa /usr/local/lib No etc. .
+.It Fl d Ar gamedir
+Path to the game's directory
+.Pq defaults to the current working directory .
+.It Fl F Ar frameworkversion
+Choose a specific framework version to use.
+.It Fl f Ar frameworkfile
+Framework file to use. Typically
+.Pa FNA.dll
+or
+.Pa MonoGame.Framework.dll .
+By default will automatically identify the bundled file in the
+game's directory.
+.It Fl h
+Prints help text.
 .It Fl m Ar monopath
 Add
 .Ar monopath
 to the directories the
 .Xr mono 1
 runtime will search for DLLs.
-.It Fl h
-Prints help text.
+.It Fl s
+Force (re-)running setup.
+.It Fl V
+Display version of
+.Nm .
 .It Fl v
 Verbose mode.
-.It Ar gamedir
+.It Ar userflags
 Optional.
-Path to the game directory to process.
-If not specified, the current working directory will be used.
+Flags that are passed to the game as arguments
 .El
 .Sh SUPPORTED GAMES
 .Bl -item -compact
@@ -120,6 +146,12 @@
 .It
 Atom Zombie Smasher
 .It
+A Virus Named TOM [!]
+.It
+Before the Echo [!]
+.It
+Bird Assassin
+.It
 Bleed
 .It
 Bleed 2
@@ -128,6 +160,8 @@
 .It
 Brushwood Buddies
 .It
+Camera Obscura
+.It
 Capsized
 .It
 Celeste (no audio)
@@ -148,9 +182,9 @@
 .It
 Dad Quest
 .It
-Dead Pixels
+Dead Pixels [!]
 .It
-Dead Pixels II
+Dead Pixels II [!]
 .It
 The Dishwasher: Vampire Smile
 .It
@@ -158,6 +192,8 @@
 .It
 Dust: An Elysian Tail
 .It
+Eagle Island
+.It
 Eliza
 .It
 Escape Goat
@@ -166,8 +202,6 @@
 .It
 EXAPUNKS
 .It
-Explosionade
-.It
 FEZ
 .It
 Fist Puncher
@@ -176,16 +210,16 @@
 .It
 Flotilla
 .It
-Game Type
-.It
 Gateways
 .It
-Grand Class Melee 2
+Grand Class Melee 2 [!]
 .It
 Growing Pains
 .It
 HackNet
 .It
+Hidden in Plain Sight
+.It
 Hive
 .It
 Hyphen
@@ -202,7 +236,7 @@
 .It
 Molek-Syntez
 .It
-Mount Your Friends
+Mount Your Friends [!]
 .It
 NeuroVoider
 .It
@@ -224,23 +258,31 @@
 .It
 Phoenix Force
 .It
+PlanetFriend
+.It
 Press X to Not Die
 .It
 Rex Rocket
 .It
 Rogue Legacy
 .It
+Ruggnar
+.It
 Salt and Sanctuary
 .It
+Session Seven
+.It
 Shenzhen I/O
 .It
 Shipwreck
 .It
+Signs of Life
+.It
 Skulls of the Shogun
 .It
 Soulcaster 1 & 2
 .It
-SpaceChem
+SpaceChem [!]
 .It
 SpeedRunners
 .It
@@ -248,13 +290,13 @@
 .It
 Sumico
 .It
-Super Amazing Wagon Adventure
+Super Amazing Wagon Adventure [!]
 .It
 Super Blood Hockey
 .It
 Super Rad Raygun
 .It
-Sword of the Stars: The Pit
+Sword of the Stars: The Pit [!]
 .It
 Terraria
 .It
@@ -262,13 +304,15 @@
 .It
 TowerFall: Ascension
 .It
+Ultra Hat Dimension
+.It
 Unexplored
 .It
 Unholy Heights (no audio)
 .It
 The Useful Dead
 .It
-Weapon of Choice
+Weapon of Choice [!]
 .It
 Wizorb
 .It
@@ -284,20 +328,19 @@
 .El
 .Sh EXIT STATUS
 .Nm
-returns 1 if an error occurred with the arguments of files provided,
-otherwise 0.
+returns 1 if an error occurred, otherwise 0.
 .Sh EXAMPLES
 Run in permissive mode, suitable to set up most supported games
 automatically.
 .Pp
-.Dl $ fnaify -y path/to/game/directory
+.Dl $ fnaify -y -d path/to/game/directory
 .Pp
 Run in interactive mode.
 .Nm
 will prompt the user if any additional DLLs are recommended, or if a
 file needs to be selected for the launch script.
 .Pp
-.Dl $ fnaify -i path/to/game/directory
+.Dl $ fnaify -i
 .Sh SEE ALSO
 .Xr mono 1 ,
 .Xr mono-config 5
@@ -308,16 +351,19 @@
 .An Thomas Frohwein Aq Mt thfr@openbsd.org .
 .Sh RELEASE HISTORY
 .Bl -tag -width Ds
-.It 2.3
+.It 3.0
+Stop creating launch script. Instead use fnaify for both
+setup and launch.
 Support for several Zachtronics games. Add libstubborn use to dllmap.
 Symlinking for MonoGame, e.g. NeuroVoider.
+Preferential use of installed FNA.dll over bundled one.
 .It 2.2
 Fix config for mono 6. Add support for libcestub.
 .It 2.1
 Support for additional XNA games. Add MONO_FORCE_COMPAT quirk.
 .It 2.0
 Add support for XNA games.
-Introduce modes
+Introduce interactivity flags
 .Fl i | y
 to facilitate adding in needed assemblies/libraries.
 .It 1.3
@@ -337,3 +383,4 @@
 .Sh AUTHORS
 .An -nosplit
 .An Thomas Frohwein Aq Mt thfr@openbsd.org
+.An Mariusz Zaborski