=================================================================== RCS file: /anoncvsroot/anoncvs/cvs/projects/fnaify/fnaify.1,v retrieving revision 1.34 retrieving revision 1.49 diff -u -r1.34 -r1.49 --- projects/fnaify/fnaify.1 2020/08/06 21:55:03 1.34 +++ projects/fnaify/fnaify.1 2020/10/07 20:31:26 1.49 @@ -1,4 +1,4 @@ -.Dd $Mdocdate: August 6 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,8 +146,12 @@ .It Atom Zombie Smasher .It +A Virus Named TOM [!] +.It Before the Echo [!] .It +Bird Assassin +.It Bleed .It Bleed 2 @@ -130,9 +160,11 @@ .It Brushwood Buddies .It +Camera Obscura +.It Capsized .It -Celeste (no audio) [!] +Celeste (no audio) .It Chaos Heart .It @@ -160,6 +192,8 @@ .It Dust: An Elysian Tail .It +Eagle Island +.It Eliza .It Escape Goat @@ -168,8 +202,6 @@ .It EXAPUNKS .It -Explosionade [!] -.It FEZ .It Fist Puncher @@ -178,8 +210,6 @@ .It Flotilla .It -Game Type [!] -.It Gateways .It Grand Class Melee 2 [!] @@ -190,7 +220,7 @@ .It Hidden in Plain Sight .It -Hive [!] - sometimes doesn't start up +Hive .It Hyphen .It @@ -246,6 +276,8 @@ .It Shipwreck .It +Signs of Life +.It Skulls of the Shogun .It Soulcaster 1 & 2 @@ -282,6 +314,8 @@ .It Weapon of Choice [!] .It +Wizorb +.It Wyv and Keep .El .Sh FILES @@ -294,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 @@ -319,16 +352,18 @@ .Sh RELEASE HISTORY .Bl -tag -width Ds .It 3.0 -Enable modes (\fIsetup\fP, \fIrun\fP). +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 @@ -348,3 +383,4 @@ .Sh AUTHORS .An -nosplit .An Thomas Frohwein Aq Mt thfr@openbsd.org +.An Mariusz Zaborski