ps3-video-mode.8: New file.

3 files changed, 175 insertions, 0 deletions

diff --git a/ps3-boot-game-os.in b/ps3-boot-game-os.in
index 6bd4475..4cdf436 100644
--- a/ps3-boot-game-os.in
+++ b/ps3-boot-game-os.in
@@ -34,6 +34,8 @@ usage() {
 	echo "" >&2
 	echo "     -p, --poweroff" >&2
 	echo "             Poweroff system after setting boot flag." >&2
+	echo "SEE ALSO" >&2
+	echo "     ps3-flash-util" >&2
 	echo "" >&2
 	echo "Send bug reports to @PACKAGE_BUGREPORT@" >&2
 	echo "" >&2
diff --git a/ps3-dump-bootloader.in b/ps3-dump-bootloader.in
index c0a9b44..3042a8a 100644
--- a/ps3-dump-bootloader.in
+++ b/ps3-dump-bootloader.in
@@ -31,6 +31,9 @@ usage() {
 	echo "" >&2
 	echo "     -s, --sum" >&2
 	echo "             Compute the md5sum and print it to stdout." >&2
+	echo "SEE ALSO" >&2
+	echo "     ps3-flash-util, md5sum" >&2
+	echo "" >&2
 	echo "" >&2
 	echo "Send bug reports to @PACKAGE_BUGREPORT@" >&2
 	echo "" >&2
diff --git a/ps3-video-mode.8 b/ps3-video-mode.8
new file mode 100644
index 0000000..f055ee4
--- /dev/null
+++ b/ps3-video-mode.8
@@ -0,0 +1,170 @@
+.\" PS3 video mode utility.
+.\"
+.\" Copyright (C) 2008 Sony Computer Entertainment Inc.
+.\" Copyright 2008 Sony Corp.
+.\"
+.\" This library is free software; you can redistribute it and/or
+.\" modify it under the terms of the GNU Library General Public
+.\" License as published by the Free Software Foundation;
+.\" version 2 of the License.
+.\"
+.\" This library 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
+.\" Library General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU Library General Public
+.\" License along with this library; if not, write to the Free Software
+.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
+.\"
+.\" Maintainer's note: For syntax help see the man pages for 'mdoc' and
+.\" 'mdoc.samples'.
+.\"
+.Dd ""
+.Dt ps3-video-mode 8
+.Os
+.Sh NAME
+.\" ====
+.Nm ps3-video-mode
+.Nd PS3 video mode utility
+
+.Sh SYNOPSIS
+.\" ========
+.Nm
+.Op Fl m, -mode Ar mode-id
+.Op Fl r, -rgb
+.Op Fl f, -full-screen
+.Op Fl c, -full-color
+.Op Fl d, -dither
+.Op Fl h, -help
+.Op Fl v, -version
+
+.Sh DESCRIPTION
+.\" ===========
+The ps3-video-mode utility is used to display or change the video mode
+of the PS3 game console.  The default behavior is to display the current
+video mode ID.
+
+.Sh OPTIONS
+.\" =======
+.Bl -tag -width indent
+.\"
+.It Fl m, -mode Ar mode-id
+Set the system video mode to 
+.Ar mode-id .
+See the 
+.Ar NOTES
+section below for more information on the
+.Ar mode-id
+value.
+.\"
+.It Fl r, -rgb
+Use RGB color space.
+.\"
+.It Fl f, -full-screen
+Use full screen mode.
+.\"
+.It Fl c, -full-color
+Use HDMI full color range.
+.\"
+.It Fl d, -dither
+Use dither mode.
+.\"
+.It Fl h, -help
+Print a help message.
+.\"
+.It Fl v, -version
+Display the version number of the invoked program.
+.El
+
+.Sh NOTES
+.\" =====
+
+.Ss Video Mode IDs
+.\" --------------
+The supported video
+.Ar mode-id
+are as follows:
+.Pp
+.Bd -literal -offset indent
+ALL       0:auto mode
+YUV 60Hz  1:480i  2:480p  3:720p  4:1080i  5:1080p
+YUV 50Hz  6:576i  7:576p  8:720p  9:1080i 10:1080p
+VESA     11:WXGA 12:SXGA 13:WUXGA
+RGB 60Hz 33:480i 34:480p 35:720p 36:1080i 37:1080p
+RGB 50Hz 38:576i 39:576p 40:720p 41:1080i 42:1080p
+.Pp
+RGB color space:  <video mode ID> + 32
+Full screen mode: <video mode ID> + 128
+Full color mode:  <video mode ID> + 1536
+Dither mode:      <video mode ID> + 2048
+.Ed
+
+.Bl -compact
+.It
+The VESA resolutions are only valid for the HDMI port.
+.Pp
+.It 
+The signal from the HDMI port supports RGB color space regardless
+of the video mode ID.
+.El
+
+.Ss Full Screen Mode
+.\" ----------------
+Originally 480/576i, 480/576p, 720p, 1080i, and 1080p were analog broadcast
+resolutions that included overscan.  The
+.Sy --full-screen
+option causes the overscan region of the broadcast modes to be used for
+pixel display
+
+.Ss Full Color Mode
+.\" ---------------
+Most standard televisions do not expect a digital video signal with
+a full dynamic range.  So for example, with an 8 bit video signal a
+standard television does not expect values of 0-255.  The full range mode
+.Sy --full-color
+causes the output video signal to have a full dynamic range.  This option
+must be specified by the user because the information from HDMI does not
+specify whether the attached display supports full range mode or not.
+
+.Ss Dither Mode
+.\" -----------
+The dither mode option
+.Sy --dither
+suppresses the machband effect.
+
+.Ss Other Notes
+.\" -----------
+.Bl -compact
+.It
+Don’t change the display resolution while sound is playing.
+.Pp
+.It
+Don’t change the display resolution from Xwindows.  If you do, you
+will need to restart the Xserver.  This is because the X frame buffer
+driver assumes a frame buffer has a fixed line length.
+.Pp
+.It
+If you would like to boot linux in a specific video mode you may pass the
+video mode with the
+.Sy video=
+option on the kernel commad line.
+.El
+
+.Sh EXAMPLES
+.\" ========
+The following two examples both set the video mode to 60Hz 720p full
+screen mode:
+
+.Bd -literal -offset indent
+ps3-video-mode --mode=3 --full-screen
+ps3-video-mode --mode=131
+.Ed
+
+.Sh AUTHOR
+.\" ======
+Written by Masashi Kimoto and Geoff Levand.
+
+.Sh REPORTING BUGS
+.\" ==============
+Report bugs to Geoff Levand <geoffrey.levand@am.sony.com>.