aboutsummaryrefslogtreecommitdiff
path: root/games/hatari/manpage.2.6.0.diff
diff options
context:
space:
mode:
Diffstat (limited to 'games/hatari/manpage.2.6.0.diff')
-rw-r--r--games/hatari/manpage.2.6.0.diff554
1 files changed, 554 insertions, 0 deletions
diff --git a/games/hatari/manpage.2.6.0.diff b/games/hatari/manpage.2.6.0.diff
new file mode 100644
index 0000000000..404141822a
--- /dev/null
+++ b/games/hatari/manpage.2.6.0.diff
@@ -0,0 +1,554 @@
+diff -Naur hatari-v2.6.0/doc/fr/hatari.1 hatari-v2.6.0.patched/doc/fr/hatari.1
+--- hatari-v2.6.0/doc/fr/hatari.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/doc/fr/hatari.1 2025-06-24 02:59:27.843526845 -0400
+@@ -2,7 +2,7 @@
+ .\" First parameter, NAME, should be all caps
+ .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+ .\" other parameters are allowed: see man(7), man(1)
+-.TH "HATARI" "1" "2008-03-14" "Hatari" ""
++.TH "HATARI" "6" "2008-03-14" "Hatari" ""
+ .\" Please adjust this date whenever revising the manpage.
+
+ .SH "NAME"
+diff -Naur hatari-v2.6.0/doc/hatari.1 hatari-v2.6.0.patched/doc/hatari.1
+--- hatari-v2.6.0/doc/hatari.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/doc/hatari.1 2025-06-24 02:59:27.843526845 -0400
+@@ -2,7 +2,7 @@
+ .\" First parameter, NAME, should be all caps
+ .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+ .\" other parameters are allowed: see man(7), man(1)
+-.TH "HATARI" "1" "2020-11-27" "Hatari" ""
++.TH "HATARI" "6" "2020-12-18" "Hatari" ""
+ .\" Please adjust this date whenever revising the manpage.
+
+ .SH "NAME"
+@@ -710,7 +710,9 @@
+ will act as
+ .B Alternate
+ as well as long as you do not press it together with a Hatari hotkey
+-combination.
++combination. Note to US keyboard layout users: if you don't have an
++.B AltGr
++key on your keyboard, use the right Alt key.
+ .PP
+ The
+ .B right Ctrl
+@@ -836,40 +838,49 @@
+ .PP
+ Other Hatari programs and utilities:
+ .br
+-.IR hmsa (1),
+-.IR zip2st (1),
+-.IR atari\-convert\-dir (1),
+-.IR atari\-hd\-image (1),
+-.IR hatariui (1),
+-.IR hconsole (1),
+-.IR gst2ascii (1),
+-.IR hatari_profile (1)
++.IR hmsa (6),
++.IR zip2st (6),
++.IR atari\-convert\-dir (6),
++.IR atari\-hd\-image (6),
++.IR hatariui (6),
++.IR hconsole (6),
++.IR gst2ascii (6),
++.IR hatari_profile (6)
+
+ .SH "FILES AND DIRECTORIES"
+ .TP
+-/etc/hatari.cfg (or /usr/local/etc/hatari.cfg)
++/etc/hatari.cfg
+ The global configuration file of Hatari.
+ .TP
+ ~/.config/hatari/
+ The (default) directory for user's personal Hatari files;
+-.B hatari.cfg
++.RS 2
++.TP
++hatari.cfg
+ (configuration file),
+-.B hatari.nvram
++.TP
++hatari.nvram
+ (NVRAM content file),
+-.B hatari.sav
++.TP
++hatari.sav
+ (Hatari memory state snapshot file which Hatari can load/save automatically
+ when it starts/exits),
+-.B hatari.prn
++.TP
++hatari.prn
+ (printer output file),
++.RE
+ .TP
+-/usr/share/hatari/ (or /usr/local/share/hatari/)
++/usr/share/hatari/
+ The global data directory of Hatari.
++.RS 2
+ .TP
+ tos.img
+ The TOS ROM image will be loaded from the data directory of Hatari unless it
+ is specified on the command line or the configuration file.
++.RE
+
+ .SH "AUTHOR"
+ This manual page was written by Marco Herrn <marco@mherrn.de> for the
+ Debian project and later modified by Thomas Huth and Eero Tamminen to
+-suit the latest version of Hatari.
++suit the latest version of Hatari. Later it was modified by B. Watson
++<urchlay@slackware.uk> for the SlackBuilds.org project to fix some formatting.
+diff -Naur hatari-v2.6.0/python-ui/hatariui.1 hatari-v2.6.0.patched/python-ui/hatariui.1
+--- hatari-v2.6.0/python-ui/hatariui.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/python-ui/hatariui.1 2025-06-24 03:00:39.980520056 -0400
+@@ -2,7 +2,7 @@
+ .\" First parameter, NAME, should be all caps
+ .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+ .\" other parameters are allowed: see man(7), man(1)
+-.TH "hatariui" "1" "2025-05-28" "Hatari" "Hatari UI"
++.TH "hatariui" "6" "2025-05-28" "Hatari" "Hatari UI"
+ .SH "NAME"
+ hatariui \- Python/Gtk UI for Hatari
+ .SH "SYNOPSIS"
+@@ -217,8 +217,8 @@
+ .I hatariui
+ shell script.
+ .SH "SEE ALSO"
+-.IR hmsa (1),
+-.IR hconsole (1)
++.IR hmsa (6),
++.IR hconsole (6)
+ .SH "COPYRIGHT"
+ Hatari UI is written by Eero Tamminen <oak at helsinkinet fi>.
+ .PP
+diff -Naur hatari-v2.6.0/python-ui/hatariui.1.orig hatari-v2.6.0.patched/python-ui/hatariui.1.orig
+--- hatari-v2.6.0/python-ui/hatariui.1.orig 1969-12-31 19:00:00.000000000 -0500
++++ hatari-v2.6.0.patched/python-ui/hatariui.1.orig 2025-06-24 02:59:27.843526845 -0400
+@@ -0,0 +1,233 @@
++.\" Hey, EMACS: -*- nroff -*-
++.\" First parameter, NAME, should be all caps
++.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
++.\" other parameters are allowed: see man(7), man(1)
++.TH "hatariui" "1" "2025-05-28" "Hatari" "Hatari UI"
++.SH "NAME"
++hatariui \- Python/Gtk UI for Hatari
++.SH "SYNOPSIS"
++.B hatariui | hatariui.py
++.RI [options]
++.RI [directory|diskimage|program]
++.SH "DESCRIPTION"
++.I hatariui
++is a Python/Gtk UI for Hatari which can either embed the Hatari window
++(on X11 systems) or run in a separate window. By default it provides
++normal application menus and some extra buttons for faster access to
++fast\-forward and other functionality, but these are fully configurable
++with the command line options. While it lacks support for some of
++the Hatari configuration options that Hatari SDL GUI has, it also
++supports some options that the Hatari built\-in SDL GUI doesn't.
++.PP
++Besides the UI configurability, some of the other advantages
++.I hatariui
++has over the SDL GUI included with Hatari itself, are use of a normal
++Gtk file selector with all of its features (directory shortcuts etc),
++support for UTF\-8 (in file names) and in general blending better to
++the user's desktop environment.
++.PP
++Additionally, Hatari can run while one uses UI configuration dialogs,
++and it can stop Hatari completely to better save the battery on mobile
++computers. For devices without a keyboard, it offers a text input
++dialog and one can configure buttons for often used strings (with
++command line options).
++.SH "HATARIUI / HATARIUI.PY"
++.I hatariui
++is a shell script wrapper for the hatariui.py Python script.
++It's used to run the Python script with suitable options for default
++usage, and to set up the correct installation directory for rest
++of the Hatari UI Python scripts and data files.
++.PP
++Options below are actually for the hatariui.py script. If you want
++to change options given for it, modify the
++.I hatariui
++shell script or make your own based on the installed one.
++.\" following command line helps in updating the options:
++.\" hatariui.py --help|sed -e 's/^\t\+/.TP\n.B /' -e 's/\t\+/\n/g' -e 's/-/\\-/g' >> hatariui.1
++.SH "OPTIONS"
++.TP
++.B \-h, \-\-help
++Hatari UI command line help
++.TP
++.B \-n, \-\-nomenu
++Omit menubar from the window
++.TP
++.B \-e, \-\-embed
++Embed Hatari window (to middle of controls)
++.TP
++.B \-f, \-\-fullscreen
++Start in fullscreen
++.TP
++.B \-l, \-\-left <controls>
++Add a toolbar at left
++.TP
++.B \-r, \-\-right <controls>
++Add a toolbar at right
++.TP
++.B \-t, \-\-top <controls>
++Add a toolbar at top
++.TP
++.B \-b, \-\-bottom <controls>
++Add a toolbar at bottom
++.TP
++.B \-p, \-\-panel <name>,<controls>
++Add a separate window with given name and controls
++.PP
++You can have only one toolbar on each side of the Hatari window.
++Panels are separate windows and you can have as many of them as you wish.
++For each of the panels, you need to add a button with the name of
++the panel (see "MyPanel" in the Examples section).
++.PP
++Following buttons can be added to toolbars and panels:
++.TP
++.B |
++Separator between action buttons
++.TP
++.B >
++Start next toolbar row in panel windows
++.TP
++.B about
++Hatari UI information
++.TP
++.B authors
++Hatari authors
++.TP
++.B bugs
++Report a bug
++.TP
++.B changes
++Latest Hatari changes
++.TP
++.B compatibility
++Hatari compatibility list
++.TP
++.B debug
++Activate Hatari debugger
++.TP
++.B device
++Midi / Printer / RS232 enabling dialog
++.TP
++.B display
++Display settings dialog
++.TP
++.B floppy
++Floppy image dialog
++.TP
++.B forward
++Toggle Hatari fast-forward
++.TP
++.B full
++Toggle whether Hatari is fullscreen
++.TP
++.B harddisk
++Hard disk config dialog
++.TP
++.B hatari
++Hatari home page
++.TP
++.B hatariui
++Hatari UI home page
++.TP
++.B input
++Text / mouse click injection dialog
++.TP
++.B joystick
++Joystick settings dialog
++.TP
++.B lconfig
++Load configuration
++.TP
++.B load
++Load emulation snapshot
++.TP
++.B machine
++Hatari machine config dialog
++.TP
++.B mails
++Hatari mailing lists
++.TP
++.B manual
++Hatari manual
++.TP
++.B path
++Path config dialog
++.TP
++.B pause
++Pause Hatari to save battery
++.TP
++.B quit
++Quit Hatari UI
++.TP
++.B recanim
++Record animation
++.TP
++.B recsound
++Record YM/Wav
++.TP
++.B release
++Hatari release notes
++.TP
++.B reset
++Warm or cold reset Hatari
++.TP
++.B run
++(Re\-)run Hatari
++.TP
++.B save
++Save emulation snapshot
++.TP
++.B sconfig
++Save configuration
++.TP
++.B shot
++Grab a screenshot
++.TP
++.B sound
++Sound settings dialog
++.TP
++.B todo
++Hatari TODO
++.TP
++.B trace
++Hatari tracing dialog
++.TP
++.B uirelease
++Hatari UI release notes
++.TP
++.B <panel name>
++Button for the specified panel window
++.TP
++.B <name>=<string/code>
++Synthetize string or single key <code>. NOTE: disable fast-forward
++before injection or key-repeat will repeat each injected key!
++.PP
++If no options are given, the UI uses basic controls.
++.SH "EXAMPLES"
++Example on how to add top, right and bottom toolbars and a separate
++"MyPanel" panel window:
++.nf
++ hatariui.py \-\-embed \\
++ \-t "about,run,pause,quit" \\
++ \-p "MyPanel,Macro=Test,Undo=97,Help=98,>,F1=59,F2=60,>,close" \\
++ \-r "pause,debug,trace,machine,MyPanel" \\
++ \-b "sound,|,forward,|,full"
++.fi
++.PP
++For more examples on Hatari UI options usage, see the
++.I hatariui
++shell script.
++.SH "SEE ALSO"
++.IR hmsa (1),
++.IR hconsole (1)
++.SH "COPYRIGHT"
++Hatari UI is written by Eero Tamminen <oak at helsinkinet fi>.
++.PP
++This program is free software; you can redistribute it and/or modify
++it under the terms of the GNU General Public License as published by
++the Free Software Foundation; either version 2 of the License, or (at
++your option) any later version.
++.PP
++This program is distributed in the hope that it will be useful, but
++WITHOUT ANY WARRANTY; without even the implied warranty of
++MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
++General Public License for more details.
+diff -Naur hatari-v2.6.0/tools/atari-convert-dir.1 hatari-v2.6.0.patched/tools/atari-convert-dir.1
+--- hatari-v2.6.0/tools/atari-convert-dir.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/tools/atari-convert-dir.1 2025-06-24 02:59:27.844526845 -0400
+@@ -1,4 +1,4 @@
+-.TH "atari-convert-dir" "1" "2015-04-26" "Hatari" "Hatari utilities"
++.TH "atari-convert-dir" "6" "2015-04-26" "Hatari" "Hatari utilities"
+ .SH NAME
+ atari\-convert\-dir \- helper for creating Atari compatible disk images
+ .SH SYNOPSIS
+@@ -16,9 +16,9 @@
+ use is also recommended with \fIzip2st\fP tool content (because Mtools
+ \fImcopy\fP doesn't convert long file names correctly for Atari).
+ .SH SEE ALSO
+-.IR atari\-hd\-image (1),
+-.IR zip2st (1),
+-.IR hatari (1),
++.IR atari\-hd\-image (6),
++.IR zip2st (6),
++.IR hatari (6),
+ .IR mcopy (1)
+ .SH "AUTHOR"
+ Written by Eero Tamminen <oak at helsinkinet fi>.
+diff -Naur hatari-v2.6.0/tools/atari-hd-image.1 hatari-v2.6.0.patched/tools/atari-hd-image.1
+--- hatari-v2.6.0/tools/atari-hd-image.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/tools/atari-hd-image.1 2025-06-24 02:59:27.844526845 -0400
+@@ -1,4 +1,4 @@
+-.TH "atari-hd-image" "1" "2015-04-26" "Hatari" "Hatari utilities"
++.TH "atari-hd-image" "6" "2015-04-26" "Hatari" "Hatari utilities"
+ .SH NAME
+ atari\-hd\-image \- tool for creating a harddisk image for use with Hatari
+ .SH SYNOPSIS
+@@ -37,12 +37,12 @@
+ 8MB image with partition named 'TEST', and files from content/:
+ .B atari\-hd\-image 8 8mb-disk.img TEST content/
+ .SH SEE ALSO
+-.IR atari\-convert\-dir (1),
+-.IR hmsa (1),
+-.IR zip2st (1),
+-.IR hatari (1),
+-.IR mkdosfs (1),
+-.IR sfdisk (1),
++.IR atari\-convert\-dir (6),
++.IR hmsa (6),
++.IR zip2st (6),
++.IR hatari (6),
++.IR mkdosfs (8),
++.IR sfdisk (8),
+ .IR dd (1)
+ .SH "AUTHOR"
+ Written by Eero Tamminen <oak at helsinkinet fi>.
+diff -Naur hatari-v2.6.0/tools/debugger/gst2ascii.1 hatari-v2.6.0.patched/tools/debugger/gst2ascii.1
+--- hatari-v2.6.0/tools/debugger/gst2ascii.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/tools/debugger/gst2ascii.1 2025-06-24 02:59:27.844526845 -0400
+@@ -2,7 +2,7 @@
+ .\" First parameter, NAME, should be all caps
+ .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+ .\" other parameters are allowed: see man(7), man(1)
+-.TH "GST2ASCII" "1" "2023-09-03" "Hatari" "Hatari utilities"
++.TH "GST2ASCII" "6" "2023-09-03" "Hatari" "Hatari Utilities"
+ .SH "NAME"
+ gst2ascii \- Filter and output Atari program symbol table as ASCII
+ .SH "SYNOPSIS"
+@@ -74,8 +74,8 @@
+ .br
+ symbols program.sym TEXT DATA BSS
+ .SH "SEE ALSO"
+-.IR hatari (1),
+-.IR hatari_profile (1)
++.IR hatari (6),
++.IR hatari_profile (6)
+ .SH "AUTHOR"
+ Written by Eero Tamminen <oak at helsinkinet fi>.
+ .SH "LICENSE"
+diff -Naur hatari-v2.6.0/tools/debugger/hatari_profile.1 hatari-v2.6.0.patched/tools/debugger/hatari_profile.1
+--- hatari-v2.6.0/tools/debugger/hatari_profile.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/tools/debugger/hatari_profile.1 2025-06-24 02:59:27.844526845 -0400
+@@ -2,7 +2,7 @@
+ .\" First parameter, NAME, should be all caps
+ .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+ .\" other parameters are allowed: see man(7), man(1)
+-.TH "HATARI_PROFILE" "1" "2013-04-15" "Hatari" "Hatari utilities"
++.TH "HATARI_PROFILE" "6" "2013-04-15" "Hatari" "Hatari utilities"
+ .SH "NAME"
+ hatari_profile \- Post-processor for Hatari profiler data
+ .SH "SYNOPSIS"
+@@ -151,10 +151,10 @@
+ -------------------------------------------------------------
+ .fi
+ .SH "SEE ALSO"
+-.IR hatari (1),
+-.IR gst2ascii (1),
+-.IR hconsole (1)
+-.IR hatariui (1)
++.IR hatari (6),
++.IR gst2ascii (6),
++.IR hconsole (6),
++.IR hatariui (6)
+ .SH "AUTHOR"
+ Written by Eero Tamminen <oak at helsinkinet fi>.
+ .SH "LICENSE"
+diff -Naur hatari-v2.6.0/tools/hatari-prg-args.1 hatari-v2.6.0.patched/tools/hatari-prg-args.1
+--- hatari-v2.6.0/tools/hatari-prg-args.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/tools/hatari-prg-args.1 2025-06-24 02:59:27.844526845 -0400
+@@ -1,4 +1,4 @@
+-.TH "hatari-prg-args" "1" "2018-05-01" "Hatari" "Hatari utilities"
++.TH "hatari-prg-args" "6" "2018-05-01" "Hatari" "Hatari utilities"
+ .SH NAME
+ hatari\-prg\-args \- autorun Atari programs with arguments
+ .SH SYNOPSIS
+@@ -37,8 +37,8 @@
+ Run it from disk image instead of host directory:
+ .B hatari\-prg\-args -m -- 'A:\\\\SIDPLAY.TTP' 'SIDS\\\\TEST.SID'
+ .SH SEE ALSO
+-.IR hatari (1),
+-.IR hconsole (1)
++.IR hatari (6),
++.IR hconsole (6)
+ .SH "AUTHOR"
+ Written by Eero Tamminen <oak at helsinkinet fi>.
+ .SH "LICENSE"
+diff -Naur hatari-v2.6.0/tools/hconsole/hconsole.1 hatari-v2.6.0.patched/tools/hconsole/hconsole.1
+--- hatari-v2.6.0/tools/hconsole/hconsole.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/tools/hconsole/hconsole.1 2025-06-24 02:59:27.845526845 -0400
+@@ -2,7 +2,7 @@
+ .\" First parameter, NAME, should be all caps
+ .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+ .\" other parameters are allowed: see man(7), man(1)
+-.TH "HCONSOLE" "1" "2010-10-10" "Hatari" "Hatari utilities"
++.TH "HCONSOLE" "6" "2010-10-10" "Hatari" "Hatari utilities"
+ .SH "NAME"
+ hconsole \- Interactive Python console for using Hatari's remote API
+ .SH "SYNOPSIS"
+@@ -52,8 +52,8 @@
+ By default hconsole and its examples are installed under
+ the /usr/share/hatari/hconsole/ directory.
+ .SH "SEE ALSO"
+-.IR hatari (1),
+-.IR hatariui (1)
++.IR hatari (6),
++.IR hatariui (6)
+ .SH "AUTHOR"
+ Written by Eero Tamminen <oak at helsinkinet fi>.
+ .SH "LICENSE"
+diff -Naur hatari-v2.6.0/tools/hmsa/hmsa.1 hatari-v2.6.0.patched/tools/hmsa/hmsa.1
+--- hatari-v2.6.0/tools/hmsa/hmsa.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/tools/hmsa/hmsa.1 2025-06-24 02:59:27.845526845 -0400
+@@ -2,7 +2,7 @@
+ .\" First parameter, NAME, should be all caps
+ .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+ .\" other parameters are allowed: see man(7), man(1)
+-.TH "HMSA" "1" "2010-05-30" "Hatari" "Hatari utilities"
++.TH "HMSA" "6" "2010-05-30" "Hatari" "Hatari utilities"
+ .SH "NAME"
+ hmsa \- Atari MSA / ST disk image creator and converter
+ .SH "SYNOPSIS"
+@@ -48,9 +48,9 @@
+ .br
+ hmsa disk.msa
+ .SH "SEE ALSO"
+-.IR hatari (1),
+-.IR zip2st (1),
+-.IR atari\-hd\-image (1)
++.IR hatari (6),
++.IR zip2st (6),
++.IR atari\-hd\-image (6)
+ .SH "AUTHOR"
+ Written by Thomas Huth <huth at tuxfamily.org>. This manual page
+ added by Eero Tamminen <oak at helsinkinet fi>.
+diff -Naur hatari-v2.6.0/tools/zip2st.1 hatari-v2.6.0.patched/tools/zip2st.1
+--- hatari-v2.6.0/tools/zip2st.1 2025-06-21 17:03:09.000000000 -0400
++++ hatari-v2.6.0.patched/tools/zip2st.1 2025-06-24 02:59:27.845526845 -0400
+@@ -1,4 +1,4 @@
+-.TH "ZIP2ST" "1" "2016-02-26" "Hatari" "Hatari utilities"
++.TH "ZIP2ST" "6" "2016-02-26" "Hatari" "Hatari utilities"
+ .SH NAME
+ zip2st \- convert directory or .zip archive to .st disk image
+ .SH SYNOPSIS
+@@ -29,11 +29,11 @@
+ within a .zip archive, you need to extract them before conversion.
+ .PP
+ .SH SEE ALSO
+-.IR hmsa (1),
+-.IR atari\-convert\-dir (1),
+-.IR atari\-hd\-image (1),
+-.IR hatari (1),
+-.IR unzip (1),
++.IR hmsa (6),
++.IR atari\-convert\-dir (6),
++.IR atari\-hd\-image (6),
++.IR hatari (6),
++.IR unzip (6),
+ .IR mtools (1),
+ .IR basename (1),
+ .IR dd (1).