In manuals, use wrapping macros instead of literal parens, etc.

This commit is contained in:
Anthony J. Bentley
2011-04-10 00:37:58 -06:00
parent abf8f8255a
commit ba30863b73
2 changed files with 17 additions and 10 deletions

View File

@@ -94,8 +94,8 @@ and the global checksum
Most values in the ROM header are only cosmetic.
The bare minimum requirements for a workable image are checksums, the Nintendo
logo, and (if needed) the CGB/SGB flags.
It is a good idea to pad the image to a valid size as well ("valid" meaning a
multiple of 32KiB).
It is a good idea to pad the image to a valid size as well
.Pq Dq valid No meaning a multiple of 32KiB .
.Pp
The following will make a plain, no-color Game Boy game without checking for
a valid size:
@@ -103,14 +103,19 @@ a valid size:
.D1 $ rgbfix \-v foo.gb
.Pp
The following will make a SGB-enabled, color-enabled game with a title of
"foobar", and pad it to a multiple of 32KiB.
(The Game Boy itself does not use the title, but some emulators or ROM managers
might.)
.Dq foobar ,
and pad it to a multiple of 32KiB.
.Po
The Game Boy itself does not use the title, but some emulators or ROM managers
might.
.Pc
.Pp
.D1 $ rgbfix \-vcs \-p 0 \-t foobar baz.gb
.Pp
The following will duplicate the header (sans global checksum) of the game
"Survival Kids":
The following will duplicate the header
.Pq sans global checksum
of the game
.Dq Survival Kids :
.Pp
.D1 $ rgbfix \-cjsv \-k A4 \-m 0x1B \-p 0xFF \-r 3 \-t SURVIVALKIDAVKE SurvivalKids.gbc
.Sh SEE ALSO

View File

@@ -46,7 +46,9 @@ When padding an image, pad with this value. The default is 0x00.
.It Fl s Ar symbol
???
.It Fl t
Write a tiny (32KiB) ROM file. This forces all DATA/CODE sections to be of
Write a tiny
.Pq 32KiB
ROM file. This forces all DATA/CODE sections to be of
type HOME, and increases the HOME section size from 16KiB to 32KiB.
.El
.Sh EXAMPLES
@@ -55,8 +57,8 @@ image like so:
.Pp
.D1 $ rgblink \-o bar.gb foo.o
.Pp
The resulting bar.gb will not have correct checksums (unless you put them in
the assembly source).
The resulting bar.gb will not have correct checksums
.Pq unless you put them in the assembly source .
You should use
.Xr rgbfix 1
to fix these so that the program will actually run in a Game Boy: