From b6899c555db7df16a0e0181d009e387d855411f6 Mon Sep 17 00:00:00 2001 From: Jan Holthuis Date: Sat, 22 Aug 2015 16:08:53 +0200 Subject: [PATCH 1/2] Linux: Add install target to Makefile --- shell/linux/Makefile | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/shell/linux/Makefile b/shell/linux/Makefile index 1870ef2f1..111525de5 100644 --- a/shell/linux/Makefile +++ b/shell/linux/Makefile @@ -179,6 +179,8 @@ INCS += -I$(RZDCY_SRC_DIR) -I$(RZDCY_SRC_DIR)/deps -I$(RZDCY_SRC_DIR)/khronos LIBS += -lm -lrt -ldl LIBS += -lpthread +PREFIX ?= /usr/local + ifndef NOT_ARM AS=${CC_PREFIX}gcc ASFLAGS += $(CFLAGS) @@ -248,7 +250,7 @@ OBJECTS:=$(OBJECTS:.S=.build_obj) OBJECTS:=$(patsubst $(RZDCY_SRC_DIR)/%,obj-$(platform)/%,$(OBJECTS)) EXECUTABLE_STRIPPED=nosym-reicast.elf -EXECUTABLE=reicast.elf +EXECUTABLE=reicast all: $(CPPFILES) $(EXECUTABLE) $(EXECUTABLE_STRIPPED) @@ -274,5 +276,12 @@ obj-$(platform)/%.build_obj : $(RZDCY_SRC_DIR)/%.S mkdir -p $(dir $@) $(AS) $(ASFLAGS) $(INCS) $< -o $@ +install: $(EXECUTABLE) + mkdir -p $(DESTDIR)$(PREFIX)/bin 2>/dev/null || /bin/true + install -m755 $(EXECUTABLE) $(DESTDIR)$(PREFIX)/bin + +uninstall: + rm -f $(DESTDIR)$(PREFIX)/bin/$(EXECUTABLE) + clean: rm -f $(OBJECTS) $(EXECUTABLE) $(EXECUTABLE_STRIPPED) .map From 1c57c3a1dd3a7f92a49fea579ea722b4dcbd592a Mon Sep 17 00:00:00 2001 From: Jan Holthuis Date: Sat, 22 Aug 2015 17:05:47 +0200 Subject: [PATCH 2/2] Linux: Add simple man page --- shell/linux/Makefile | 4 ++ shell/linux/man/reicast.1 | 77 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 81 insertions(+) create mode 100644 shell/linux/man/reicast.1 diff --git a/shell/linux/Makefile b/shell/linux/Makefile index 111525de5..163902860 100644 --- a/shell/linux/Makefile +++ b/shell/linux/Makefile @@ -180,6 +180,7 @@ LIBS += -lm -lrt -ldl LIBS += -lpthread PREFIX ?= /usr/local +MAN_DIR ?= ${PREFIX}/share/man/man1 ifndef NOT_ARM AS=${CC_PREFIX}gcc @@ -278,10 +279,13 @@ obj-$(platform)/%.build_obj : $(RZDCY_SRC_DIR)/%.S install: $(EXECUTABLE) mkdir -p $(DESTDIR)$(PREFIX)/bin 2>/dev/null || /bin/true + mkdir -p $(DESTDIR)$(MAN_DIR) 2>/dev/null || /bin/true install -m755 $(EXECUTABLE) $(DESTDIR)$(PREFIX)/bin + install -m644 man/reicast.1 $(DESTDIR)$(MAN_DIR) uninstall: rm -f $(DESTDIR)$(PREFIX)/bin/$(EXECUTABLE) + rm -f $(DESTDIR)$(MAN_DIR)/reicast.1 clean: rm -f $(OBJECTS) $(EXECUTABLE) $(EXECUTABLE_STRIPPED) .map diff --git a/shell/linux/man/reicast.1 b/shell/linux/man/reicast.1 new file mode 100644 index 000000000..1e9993380 --- /dev/null +++ b/shell/linux/man/reicast.1 @@ -0,0 +1,77 @@ +.\" retroarch.1: + +.TH "REICAST" "1" "August 22, 2015" "REICAST" "System Manager's Manual: reicast" + +.SH NAME + +reicast \- The Sega Dreamcast Emulator. + +.SH SYNOPSIS + +\fBreicast\fR [OPTIONS]... [IMAGE FILE] + +.SH "DESCRIPTION" + +\fBreicast\fR is a multi-platform emulator for the Sega Dreamcast. + +.SH "EXAMPLE COMMANDLINE" + +.TP +\fBNo command line options will start reicast in menu mode.\fR +reicast + +.TP +\fBOverride the image specified in the config file to load a specific image.\fR +reicast /path/to/your/image.cdi + +.TP +\fBStart reicast on X11 in full screen.\fR +reicast -config x11:fullscreen=1 + +.SH "CONTROLS" + +.TP +\fBreicast\fR uses the kernel event devices for capturing input. You can define the evdev device id in the config file: +.IP +[input] +.br +evdev_device_id_1 = X +.LP + +If the evdev input works for you, it's probably best to deaktivate the legacy joystick API input: + +.IP +[input] +.br +joystick_device_id =-1 +.LP + +If your version of \fBreicast\fR is compiled against X11, you might want to disable the built-in X11 keyboard support: +.IP +[input] +.br +enable_x11_keyboard = -1 +.LP + +.SH "GENERAL OPTIONS" + +.TP +\fB-config section:option=value\fR +Temporarily override a value of the config file. + +.TP +\fB[IMAGE FILE]\fR +Load a specific image file. If no image is given on the command line, reicast will use the value of the "image" option in the "config" section of the config file. + +.SH "AUTHOR" + +.TP +\fBreicast\fR is developed by a number of people. A list of contributors can be obtained at: +\fIhttps://github.com/reicast/reicast-emulator/graphs/contributors\fP + +.TP +Head over to reicast's git repository if you want to contibute: +\fIhttps://github.com/reicast/reicast-emulator\fP + +.TP +This is free software; you can redistribute it and/or modify it under the terms of the GNU Public License (Version 2).