Return to hatari-prg-args.1 CVS log

Up to [HATARI the Atari ST Emulator] / hatari / tools

Annotation of hatari/tools/hatari-prg-args.1, revision 1.1.1.1

1.1       root        1: .TH "hatari-prg-args" "1" "2018-05-01" "Hatari" "Hatari utilities"
                      2: .SH NAME
                      3: hatari\-prg\-args \- autorun Atari programs with arguments
                      4: .SH SYNOPSIS
                      5: .B hatari\-prg\-args
                      6: [\fI\-q\fP] [\fIHatari args\fP]
                      7: \fB--\fP
                      8: <\fIAtari program\fP> <\fIprogram args\fP>
                      9: .SH DESCRIPTION
                     10: Utility for running Hatari so that it autostarts given Atari program
                     11: and inserts given arguments to program (to its basepage, with builtin
                     12: Hatari debugger facilities).
                     13: .PP
                     14: If Atari program arguments have same (host) path prefix as given Atari
                     15: program, those prefixes are replaced with "C:\\". Unix path separators
                     16: (/) are replaced with Atari ones (\\) and whole filename is upper-cased.
                     17: .PP
                     18: If program and its input files are on a disk image, all paths need to
                     19: be given as on with TOS, and won't be translated.
                     20: .PP
                     21: Other program arguments are passed unmodified.
                     22: .SH NOTES
                     23: Maximum Atari program command line length that can be given (in basepage)
                     24: is 126 characters.
                     25: .PP
                     26: On Unix, Atari/DOS path separators (\\) need to be quoted.
                     27: .SH OPTIONS
                     28: .TP
                     29: .B \-q
                     30: Make Hatari quit when the started Atari program terminates.
                     31: If given, this needs to be the first argument.
                     32: .SH EXAMPLES
                     33: .TP
                     34: Start SID player in mono and tell it to play given SID song:
                     35: .B hatari\-prg\-args -m -- atari/sidplay.ttp atari/sids/test.sid
                     36: .TP
                     37: Run it from disk image instead of host directory:
                     38: .B hatari\-prg\-args -m -- 'A:\\\\SIDPLAY.TTP' 'SIDS\\\\TEST.SID'
                     39: .SH SEE ALSO
                     40: .IR hatari (1),
                     41: .IR hconsole (1)
                     42: .SH "AUTHOR"
                     43: Written by Eero Tamminen <oak at helsinkinet fi>.
                     44: .SH "LICENSE"
                     45: This program is free software; you can redistribute it and/or modify
                     46: it under the terms of the GNU General Public License as published by
                     47: the Free Software Foundation; either version 2 of the License, or (at
                     48: your option) any later version.
                     49: .SH "NO WARRANTY"
                     50: This program is distributed in the hope that it will be useful, but
                     51: WITHOUT ANY WARRANTY; without even the implied warranty of
                     52: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
                     53: General Public License for more details.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.