mirror of
https://github.com/gbdev/rgbds.git
synced 2025-11-23 03:22:08 +00:00
Eldred Habert
GitHub
18
Makefile
18
Makefile
@@ -197,15 +197,15 @@ checkpatch:
|
|||||||
MANDOC := -Thtml -Ios=General -Oman=%N.%S.html -Ostyle=mandoc.css
|
MANDOC := -Thtml -Ios=General -Oman=%N.%S.html -Ostyle=mandoc.css
|
||||||
|
|
||||||
wwwman:
|
wwwman:
|
||||||
$Qmandoc ${MANDOC} src/rgbds.7 > docs/rgbds.7.html
|
$Qmandoc ${MANDOC} src/rgbds.7 | src/doc_postproc.awk > docs/rgbds.7.html
|
||||||
$Qmandoc ${MANDOC} src/gbz80.7 > docs/gbz80.7.html
|
$Qmandoc ${MANDOC} src/gbz80.7 | src/doc_postproc.awk > docs/gbz80.7.html
|
||||||
$Qmandoc ${MANDOC} src/rgbds.5 > docs/rgbds.5.html
|
$Qmandoc ${MANDOC} src/rgbds.5 | src/doc_postproc.awk > docs/rgbds.5.html
|
||||||
$Qmandoc ${MANDOC} src/asm/rgbasm.1 > docs/rgbasm.1.html
|
$Qmandoc ${MANDOC} src/asm/rgbasm.1 | src/doc_postproc.awk > docs/rgbasm.1.html
|
||||||
$Qmandoc ${MANDOC} src/asm/rgbasm.5 > docs/rgbasm.5.html
|
$Qmandoc ${MANDOC} src/asm/rgbasm.5 | src/doc_postproc.awk > docs/rgbasm.5.html
|
||||||
$Qmandoc ${MANDOC} src/fix/rgbfix.1 > docs/rgbfix.1.html
|
$Qmandoc ${MANDOC} src/fix/rgbfix.1 | src/doc_postproc.awk > docs/rgbfix.1.html
|
||||||
$Qmandoc ${MANDOC} src/link/rgblink.1 > docs/rgblink.1.html
|
$Qmandoc ${MANDOC} src/link/rgblink.1 | src/doc_postproc.awk > docs/rgblink.1.html
|
||||||
$Qmandoc ${MANDOC} src/link/rgblink.5 > docs/rgblink.5.html
|
$Qmandoc ${MANDOC} src/link/rgblink.5 | src/doc_postproc.awk > docs/rgblink.5.html
|
||||||
$Qmandoc ${MANDOC} src/gfx/rgbgfx.1 > docs/rgbgfx.1.html
|
$Qmandoc ${MANDOC} src/gfx/rgbgfx.1 | src/doc_postproc.awk > docs/rgbgfx.1.html
|
||||||
|
|
||||||
# This target is used during development in order to prevent adding new issues
|
# This target is used during development in order to prevent adding new issues
|
||||||
# to the source code. All warnings are treated as errors in order to block the
|
# to the source code. All warnings are treated as errors in order to block the
|
||||||
|
|||||||
348
docs/mandoc.css
Executable file → Normal file
348
docs/mandoc.css
Executable file → Normal file
@@ -1,20 +1,33 @@
|
|||||||
/* $Id: mandoc.css,v 1.22 2017/07/16 18:45:00 schwarze Exp $ */
|
/* $Id: mandoc.css,v 1.45 2019/03/01 10:57:18 schwarze Exp $ */
|
||||||
/*
|
/*
|
||||||
* Standard style sheet for mandoc(1) -Thtml and man.cgi(8).
|
* Standard style sheet for mandoc(1) -Thtml and man.cgi(8).
|
||||||
|
*
|
||||||
|
* Written by Ingo Schwarze <schwarze@openbsd.org>.
|
||||||
|
* I place this file into the public domain.
|
||||||
|
* Permission to use, copy, modify, and distribute it for any purpose
|
||||||
|
* with or without fee is hereby granted, without any conditions.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/* Global defaults. */
|
/* Global defaults. */
|
||||||
|
|
||||||
html { max-width: 100ex; }
|
html { max-width: 65em; }
|
||||||
body { font-family: Helvetica,Arial,sans-serif; }
|
body { font-family: Helvetica,Arial,sans-serif; }
|
||||||
table { margin-top: 0em;
|
table { margin-top: 0em;
|
||||||
margin-bottom: 0em; }
|
margin-bottom: 0em;
|
||||||
td { vertical-align: top; }
|
border-collapse: collapse; }
|
||||||
|
/* Some browsers set border-color in a browser style for tbody,
|
||||||
|
* but not for table, resulting in inconsistent border styling. */
|
||||||
|
tbody { border-color: inherit; }
|
||||||
|
tr { border-color: inherit; }
|
||||||
|
td { vertical-align: top;
|
||||||
|
padding-left: 0.2em;
|
||||||
|
padding-right: 0.2em;
|
||||||
|
border-color: inherit; }
|
||||||
ul, ol, dl { margin-top: 0em;
|
ul, ol, dl { margin-top: 0em;
|
||||||
margin-bottom: 0em; }
|
margin-bottom: 0em; }
|
||||||
li, dt { margin-top: 1em; }
|
li, dt { margin-top: 1em; }
|
||||||
|
|
||||||
a.selflink { border-bottom: thin dotted;
|
.permalink { border-bottom: thin dotted;
|
||||||
color: inherit;
|
color: inherit;
|
||||||
font: inherit;
|
font: inherit;
|
||||||
text-decoration: inherit; }
|
text-decoration: inherit; }
|
||||||
@@ -41,7 +54,6 @@ table.head { width: 100%;
|
|||||||
td.head-vol { text-align: center; }
|
td.head-vol { text-align: center; }
|
||||||
td.head-rtitle {
|
td.head-rtitle {
|
||||||
text-align: right; }
|
text-align: right; }
|
||||||
span.Nd { }
|
|
||||||
|
|
||||||
table.foot { width: 100%;
|
table.foot { width: 100%;
|
||||||
border-top: 1px dotted #808080;
|
border-top: 1px dotted #808080;
|
||||||
@@ -51,147 +63,189 @@ td.foot-os { text-align: right; }
|
|||||||
|
|
||||||
/* Sections and paragraphs. */
|
/* Sections and paragraphs. */
|
||||||
|
|
||||||
div.manual-text {
|
.manual-text {
|
||||||
margin-left: 5ex; }
|
margin-left: 3.8em; }
|
||||||
h1.Sh { margin-top: 2ex;
|
.Nd { }
|
||||||
margin-bottom: 1ex;
|
section.Sh { }
|
||||||
margin-left: -4ex;
|
h1.Sh { margin-top: 1.2em;
|
||||||
|
margin-bottom: 0.6em;
|
||||||
|
margin-left: -3.2em;
|
||||||
font-size: 110%; }
|
font-size: 110%; }
|
||||||
h2.Ss { margin-top: 2ex;
|
section.Ss { }
|
||||||
margin-bottom: 1ex;
|
h2.Ss { margin-top: 1.2em;
|
||||||
margin-left: -2ex;
|
margin-bottom: 0.6em;
|
||||||
|
margin-left: -1.2em;
|
||||||
font-size: 105%; }
|
font-size: 105%; }
|
||||||
div.Pp { margin: 1ex 0ex; }
|
.Pp { margin: 0.6em 0em; }
|
||||||
a.Sx { }
|
.Sx { }
|
||||||
a.Xr { }
|
.Xr { }
|
||||||
|
|
||||||
/* Displays and lists. */
|
/* Displays and lists. */
|
||||||
|
|
||||||
div.Bd { }
|
.Bd { }
|
||||||
div.D1 { margin-left: 5ex; }
|
.Bd-indent { margin-left: 3.8em; }
|
||||||
|
|
||||||
ul.Bl-bullet { list-style-type: disc;
|
.Bl-bullet { list-style-type: disc;
|
||||||
padding-left: 1em; }
|
padding-left: 1em; }
|
||||||
li.It-bullet { }
|
.Bl-bullet > li { }
|
||||||
ul.Bl-dash { list-style-type: none;
|
.Bl-dash { list-style-type: none;
|
||||||
padding-left: 0em; }
|
padding-left: 0em; }
|
||||||
li.It-dash:before {
|
.Bl-dash > li:before {
|
||||||
content: "\2014 "; }
|
content: "\2014 "; }
|
||||||
ul.Bl-item { list-style-type: none;
|
.Bl-item { list-style-type: none;
|
||||||
padding-left: 0em; }
|
padding-left: 0em; }
|
||||||
li.It-item { }
|
.Bl-item > li { }
|
||||||
ul.Bl-compact > li {
|
.Bl-compact > li {
|
||||||
margin-top: 0ex; }
|
margin-top: 0em; }
|
||||||
|
|
||||||
ol.Bl-enum { padding-left: 2em; }
|
.Bl-enum { padding-left: 2em; }
|
||||||
li.It-enum { }
|
.Bl-enum > li { }
|
||||||
ol.Bl-compact > li {
|
.Bl-compact > li {
|
||||||
margin-top: 0ex; }
|
margin-top: 0em; }
|
||||||
|
|
||||||
dl.Bl-diag { }
|
.Bl-diag { }
|
||||||
dt.It-diag { }
|
.Bl-diag > dt {
|
||||||
dd.It-diag { margin-left: 0ex; }
|
font-style: normal;
|
||||||
b.It-diag { font-style: normal; }
|
font-weight: bold; }
|
||||||
dl.Bl-hang { }
|
.Bl-diag > dd {
|
||||||
dt.It-hang { }
|
margin-left: 0em; }
|
||||||
dd.It-hang { margin-left: 10.2ex; }
|
.Bl-hang { }
|
||||||
dl.Bl-inset { }
|
.Bl-hang > dt { }
|
||||||
dt.It-inset { }
|
.Bl-hang > dd {
|
||||||
dd.It-inset { margin-left: 0ex; }
|
margin-left: 5.5em; }
|
||||||
dl.Bl-ohang { }
|
.Bl-inset { }
|
||||||
dt.It-ohang { }
|
.Bl-inset > dt { }
|
||||||
dd.It-ohang { margin-left: 0ex; }
|
.Bl-inset > dd {
|
||||||
dl.Bl-tag { margin-left: 10.2ex; }
|
margin-left: 0em; }
|
||||||
dt.It-tag { float: left;
|
.Bl-ohang { }
|
||||||
margin-top: 0ex;
|
.Bl-ohang > dt { }
|
||||||
margin-left: -10.2ex;
|
.Bl-ohang > dd {
|
||||||
padding-right: 2ex;
|
margin-left: 0em; }
|
||||||
|
.Bl-tag { margin-top: 0.6em;
|
||||||
|
margin-left: 5.5em; }
|
||||||
|
.Bl-tag > dt {
|
||||||
|
float: left;
|
||||||
|
margin-top: 0em;
|
||||||
|
margin-left: -5.5em;
|
||||||
|
padding-right: 0.5em;
|
||||||
vertical-align: top; }
|
vertical-align: top; }
|
||||||
dd.It-tag { clear: right;
|
.Bl-tag > dd {
|
||||||
|
clear: right;
|
||||||
width: 100%;
|
width: 100%;
|
||||||
margin-top: 0ex;
|
margin-top: 0em;
|
||||||
margin-left: 0ex;
|
margin-left: 0em;
|
||||||
|
margin-bottom: 0.6em;
|
||||||
vertical-align: top;
|
vertical-align: top;
|
||||||
overflow: auto; }
|
overflow: auto; }
|
||||||
dl.Bl-compact > dt {
|
.Bl-compact { margin-top: 0em; }
|
||||||
margin-top: 0ex; }
|
.Bl-compact > dd {
|
||||||
|
margin-bottom: 0em; }
|
||||||
|
.Bl-compact > dt {
|
||||||
|
margin-top: 0em; }
|
||||||
|
|
||||||
table.Bl-column { }
|
.Bl-column { }
|
||||||
tr.It-column { }
|
.Bl-column > tbody > tr { }
|
||||||
td.It-column { margin-top: 1em; }
|
.Bl-column > tbody > tr > td {
|
||||||
table.Bl-compact > tbody > tr > td {
|
margin-top: 1em; }
|
||||||
margin-top: 0ex; }
|
.Bl-compact > tbody > tr > td {
|
||||||
|
margin-top: 0em; }
|
||||||
|
|
||||||
cite.Rs { font-style: normal;
|
.Rs { font-style: normal;
|
||||||
font-weight: normal; }
|
font-weight: normal; }
|
||||||
span.RsA { }
|
.RsA { }
|
||||||
i.RsB { font-weight: normal; }
|
.RsB { font-style: italic;
|
||||||
span.RsC { }
|
font-weight: normal; }
|
||||||
span.RsD { }
|
.RsC { }
|
||||||
i.RsI { font-weight: normal; }
|
.RsD { }
|
||||||
i.RsJ { font-weight: normal; }
|
.RsI { font-style: italic;
|
||||||
span.RsN { }
|
font-weight: normal; }
|
||||||
span.RsO { }
|
.RsJ { font-style: italic;
|
||||||
span.RsP { }
|
font-weight: normal; }
|
||||||
span.RsQ { }
|
.RsN { }
|
||||||
span.RsR { }
|
.RsO { }
|
||||||
span.RsT { text-decoration: underline; }
|
.RsP { }
|
||||||
a.RsU { }
|
.RsQ { }
|
||||||
span.RsV { }
|
.RsR { }
|
||||||
|
.RsT { text-decoration: underline; }
|
||||||
|
.RsU { }
|
||||||
|
.RsV { }
|
||||||
|
|
||||||
span.eqn { }
|
.eqn { }
|
||||||
table.tbl { }
|
.tbl td { vertical-align: middle; }
|
||||||
|
|
||||||
|
.HP { margin-left: 3.8em;
|
||||||
|
text-indent: -3.8em; }
|
||||||
|
|
||||||
/* Semantic markup for command line utilities. */
|
/* Semantic markup for command line utilities. */
|
||||||
|
|
||||||
table.Nm { }
|
table.Nm { }
|
||||||
b.Nm { font-style: normal; }
|
code.Nm { font-style: normal;
|
||||||
b.Fl { font-style: normal; }
|
font-weight: bold;
|
||||||
b.Cm { font-style: normal; }
|
font-family: inherit; }
|
||||||
var.Ar { font-style: italic;
|
.Fl { font-style: normal;
|
||||||
|
font-weight: bold;
|
||||||
|
font-family: inherit; }
|
||||||
|
.Cm { font-style: normal;
|
||||||
|
font-weight: bold;
|
||||||
|
font-family: inherit; }
|
||||||
|
.Ar { font-style: italic;
|
||||||
font-weight: normal; }
|
font-weight: normal; }
|
||||||
span.Op { }
|
.Op { display: inline; }
|
||||||
b.Ic { font-style: normal; }
|
.Ic { font-style: normal;
|
||||||
code.Ev { font-style: normal;
|
font-weight: bold;
|
||||||
|
font-family: inherit; }
|
||||||
|
.Ev { font-style: normal;
|
||||||
font-weight: normal;
|
font-weight: normal;
|
||||||
font-family: monospace; }
|
font-family: monospace; }
|
||||||
i.Pa { font-weight: normal; }
|
.Pa { font-style: italic;
|
||||||
|
font-weight: normal; }
|
||||||
|
|
||||||
/* Semantic markup for function libraries. */
|
/* Semantic markup for function libraries. */
|
||||||
|
|
||||||
span.Lb { }
|
.Lb { }
|
||||||
b.In { font-style: normal; }
|
code.In { font-style: normal;
|
||||||
|
font-weight: bold;
|
||||||
|
font-family: inherit; }
|
||||||
a.In { }
|
a.In { }
|
||||||
b.Fd { font-style: normal; }
|
.Fd { font-style: normal;
|
||||||
var.Ft { font-style: italic;
|
font-weight: bold;
|
||||||
|
font-family: inherit; }
|
||||||
|
.Ft { font-style: italic;
|
||||||
font-weight: normal; }
|
font-weight: normal; }
|
||||||
b.Fn { font-style: normal; }
|
.Fn { font-style: normal;
|
||||||
var.Fa { font-style: italic;
|
font-weight: bold;
|
||||||
|
font-family: inherit; }
|
||||||
|
.Fa { font-style: italic;
|
||||||
font-weight: normal; }
|
font-weight: normal; }
|
||||||
var.Vt { font-style: italic;
|
.Vt { font-style: italic;
|
||||||
font-weight: normal; }
|
font-weight: normal; }
|
||||||
var.Va { font-style: italic;
|
.Va { font-style: italic;
|
||||||
font-weight: normal; }
|
font-weight: normal; }
|
||||||
code.Dv { font-style: normal;
|
.Dv { font-style: normal;
|
||||||
font-weight: normal;
|
font-weight: normal;
|
||||||
font-family: monospace; }
|
font-family: monospace; }
|
||||||
code.Er { font-style: normal;
|
.Er { font-style: normal;
|
||||||
font-weight: normal;
|
font-weight: normal;
|
||||||
font-family: monospace; }
|
font-family: monospace; }
|
||||||
|
|
||||||
/* Various semantic markup. */
|
/* Various semantic markup. */
|
||||||
|
|
||||||
span.An { }
|
.An { }
|
||||||
a.Lk { }
|
.Lk { }
|
||||||
a.Mt { }
|
.Mt { }
|
||||||
b.Cd { font-style: normal; }
|
.Cd { font-style: normal;
|
||||||
i.Ad { font-weight: normal; }
|
font-weight: bold;
|
||||||
b.Ms { font-style: normal; }
|
font-family: inherit; }
|
||||||
span.St { }
|
.Ad { font-style: italic;
|
||||||
a.Ux { }
|
font-weight: normal; }
|
||||||
|
.Ms { font-style: normal;
|
||||||
|
font-weight: bold; }
|
||||||
|
.St { }
|
||||||
|
.Ux { }
|
||||||
|
|
||||||
/* Physical markup. */
|
/* Physical markup. */
|
||||||
|
|
||||||
|
.Bf { display: inline; }
|
||||||
.No { font-style: normal;
|
.No { font-style: normal;
|
||||||
font-weight: normal; }
|
font-weight: normal; }
|
||||||
.Em { font-style: italic;
|
.Em { font-style: italic;
|
||||||
@@ -201,3 +255,93 @@ a.Ux { }
|
|||||||
.Li { font-style: normal;
|
.Li { font-style: normal;
|
||||||
font-weight: normal;
|
font-weight: normal;
|
||||||
font-family: monospace; }
|
font-family: monospace; }
|
||||||
|
|
||||||
|
/* Tooltip support. */
|
||||||
|
|
||||||
|
h1.Sh, h2.Ss { position: relative; }
|
||||||
|
.An, .Ar, .Cd, .Cm, .Dv, .Em, .Er, .Ev, .Fa, .Fd, .Fl, .Fn, .Ft,
|
||||||
|
.Ic, code.In, .Lb, .Lk, .Ms, .Mt, .Nd, code.Nm, .Pa, .Rs,
|
||||||
|
.St, .Sx, .Sy, .Va, .Vt, .Xr {
|
||||||
|
display: inline-block;
|
||||||
|
position: relative; }
|
||||||
|
|
||||||
|
.An::before { content: "An"; }
|
||||||
|
.Ar::before { content: "Ar"; }
|
||||||
|
.Cd::before { content: "Cd"; }
|
||||||
|
.Cm::before { content: "Cm"; }
|
||||||
|
.Dv::before { content: "Dv"; }
|
||||||
|
.Em::before { content: "Em"; }
|
||||||
|
.Er::before { content: "Er"; }
|
||||||
|
.Ev::before { content: "Ev"; }
|
||||||
|
.Fa::before { content: "Fa"; }
|
||||||
|
.Fd::before { content: "Fd"; }
|
||||||
|
.Fl::before { content: "Fl"; }
|
||||||
|
.Fn::before { content: "Fn"; }
|
||||||
|
.Ft::before { content: "Ft"; }
|
||||||
|
.Ic::before { content: "Ic"; }
|
||||||
|
code.In::before { content: "In"; }
|
||||||
|
.Lb::before { content: "Lb"; }
|
||||||
|
.Lk::before { content: "Lk"; }
|
||||||
|
.Ms::before { content: "Ms"; }
|
||||||
|
.Mt::before { content: "Mt"; }
|
||||||
|
.Nd::before { content: "Nd"; }
|
||||||
|
code.Nm::before { content: "Nm"; }
|
||||||
|
.Pa::before { content: "Pa"; }
|
||||||
|
.Rs::before { content: "Rs"; }
|
||||||
|
h1.Sh::before { content: "Sh"; }
|
||||||
|
h2.Ss::before { content: "Ss"; }
|
||||||
|
.St::before { content: "St"; }
|
||||||
|
.Sx::before { content: "Sx"; }
|
||||||
|
.Sy::before { content: "Sy"; }
|
||||||
|
.Va::before { content: "Va"; }
|
||||||
|
.Vt::before { content: "Vt"; }
|
||||||
|
.Xr::before { content: "Xr"; }
|
||||||
|
|
||||||
|
.An::before, .Ar::before, .Cd::before, .Cm::before,
|
||||||
|
.Dv::before, .Em::before, .Er::before, .Ev::before,
|
||||||
|
.Fa::before, .Fd::before, .Fl::before, .Fn::before, .Ft::before,
|
||||||
|
.Ic::before, code.In::before, .Lb::before, .Lk::before,
|
||||||
|
.Ms::before, .Mt::before, .Nd::before, code.Nm::before,
|
||||||
|
.Pa::before, .Rs::before,
|
||||||
|
h1.Sh::before, h2.Ss::before, .St::before, .Sx::before, .Sy::before,
|
||||||
|
.Va::before, .Vt::before, .Xr::before {
|
||||||
|
opacity: 0;
|
||||||
|
transition: .15s ease opacity;
|
||||||
|
pointer-events: none;
|
||||||
|
position: absolute;
|
||||||
|
bottom: 100%;
|
||||||
|
box-shadow: 0 0 .35em #000;
|
||||||
|
padding: .15em .25em;
|
||||||
|
white-space: nowrap;
|
||||||
|
font-family: Helvetica,Arial,sans-serif;
|
||||||
|
font-style: normal;
|
||||||
|
font-weight: bold;
|
||||||
|
color: black;
|
||||||
|
background: #fff; }
|
||||||
|
.An:hover::before, .Ar:hover::before, .Cd:hover::before, .Cm:hover::before,
|
||||||
|
.Dv:hover::before, .Em:hover::before, .Er:hover::before, .Ev:hover::before,
|
||||||
|
.Fa:hover::before, .Fd:hover::before, .Fl:hover::before, .Fn:hover::before,
|
||||||
|
.Ft:hover::before, .Ic:hover::before, code.In:hover::before,
|
||||||
|
.Lb:hover::before, .Lk:hover::before, .Ms:hover::before, .Mt:hover::before,
|
||||||
|
.Nd:hover::before, code.Nm:hover::before, .Pa:hover::before,
|
||||||
|
.Rs:hover::before, h1.Sh:hover::before, h2.Ss:hover::before, .St:hover::before,
|
||||||
|
.Sx:hover::before, .Sy:hover::before, .Va:hover::before, .Vt:hover::before,
|
||||||
|
.Xr:hover::before {
|
||||||
|
opacity: 1;
|
||||||
|
pointer-events: inherit; }
|
||||||
|
|
||||||
|
/* Overrides to avoid excessive margins on small devices. */
|
||||||
|
|
||||||
|
@media (max-width: 37.5em) {
|
||||||
|
.manual-text {
|
||||||
|
margin-left: 0.5em; }
|
||||||
|
h1.Sh, h2.Ss { margin-left: 0em; }
|
||||||
|
.Bd-indent { margin-left: 2em; }
|
||||||
|
.Bl-hang > dd {
|
||||||
|
margin-left: 2em; }
|
||||||
|
.Bl-tag { margin-left: 2em; }
|
||||||
|
.Bl-tag > dt {
|
||||||
|
margin-left: -2em; }
|
||||||
|
.HP { margin-left: 2em;
|
||||||
|
text-indent: -2em; }
|
||||||
|
}
|
||||||
|
|||||||
63
docs/rgbds.css
Normal file
63
docs/rgbds.css
Normal file
@@ -0,0 +1,63 @@
|
|||||||
|
/* Overrides to default mandoc styling for HTML renders of RGBDS man pages */
|
||||||
|
|
||||||
|
html {
|
||||||
|
/* Reduce contrast */
|
||||||
|
background-color: #f8f8f8;
|
||||||
|
color: #222;
|
||||||
|
|
||||||
|
/* Override `mandoc.css`'s sowe can put it on <body> instead */
|
||||||
|
max-width: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
body {
|
||||||
|
/* Center body horizontally (requires <html> to span full width) */
|
||||||
|
margin: 0 auto;
|
||||||
|
/* `mandoc.css`'s default, but it's applied to <html> there */
|
||||||
|
max-width: 65em;
|
||||||
|
|
||||||
|
/* Improve readability */
|
||||||
|
font-size: 16px;
|
||||||
|
line-height: 1.4;
|
||||||
|
text-align: justify;
|
||||||
|
|
||||||
|
/* Prevent text from bumping sides on mobile devices */
|
||||||
|
padding: 10px 20px 10px 10px;
|
||||||
|
}
|
||||||
|
@media print {
|
||||||
|
body {
|
||||||
|
/* Max width doesn't make sense for print */
|
||||||
|
max-width: none;
|
||||||
|
/* Make font slightly smaller for printing */
|
||||||
|
font-size: 14px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
code, pre {
|
||||||
|
font-size: smaller;
|
||||||
|
}
|
||||||
|
|
||||||
|
pre {
|
||||||
|
/* Avoid horizontal page scrolling on mobile */
|
||||||
|
overflow: auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Separate lines in tables */
|
||||||
|
table.Bl-column {
|
||||||
|
border-collapse: collapse;
|
||||||
|
}
|
||||||
|
table.Bl-column tr:not(:first-child) > td,
|
||||||
|
table.Bl-column tr:not(:first-child) > th {
|
||||||
|
border-top: 1px solid #aaa;
|
||||||
|
}
|
||||||
|
|
||||||
|
table.Bl-column th {
|
||||||
|
/* Apply `.Sy` style to table headers */
|
||||||
|
font-style: normal;
|
||||||
|
font-weight: bold;
|
||||||
|
}
|
||||||
|
|
||||||
|
table.Bl-column td,
|
||||||
|
table.Bl-column th {
|
||||||
|
/* Add horizontal spacing between columns */
|
||||||
|
padding: 2px 7px 0;
|
||||||
|
}
|
||||||
@@ -51,9 +51,9 @@ The defaults are 01.
|
|||||||
.It Fl D Ar name Ns Oo = Ns Ar value Oc , Fl Fl define Ar name Ns Oo = Ns Ar value Oc
|
.It Fl D Ar name Ns Oo = Ns Ar value Oc , Fl Fl define Ar name Ns Oo = Ns Ar value Oc
|
||||||
Add a string symbol to the compiled source code.
|
Add a string symbol to the compiled source code.
|
||||||
This is equivalent to
|
This is equivalent to
|
||||||
.Ql Ar name Ic EQUS Qq Ar value
|
.Ql Ar name Ic EQUS \(dq Ns Ar value Ns \(dq
|
||||||
in code, or
|
in code, or
|
||||||
.Ql Ar name Ic EQUS Qq 1
|
.Ql Ar name Ic EQUS \(dq1\(dq
|
||||||
if
|
if
|
||||||
.Ar value
|
.Ar value
|
||||||
is not specified.
|
is not specified.
|
||||||
@@ -153,7 +153,9 @@ prefix, entries are listed alphabetically.
|
|||||||
Warns when
|
Warns when
|
||||||
.Ic WARN Ns No -type
|
.Ic WARN Ns No -type
|
||||||
assertions fail. (See
|
assertions fail. (See
|
||||||
.Xr rgbasm 5 "Aborting the assembly process"
|
.Dq Aborting the assembly process
|
||||||
|
in
|
||||||
|
.Xr rgbasm 5
|
||||||
for
|
for
|
||||||
.Ic ASSERT ) .
|
.Ic ASSERT ) .
|
||||||
.It Fl Wbuiltin-args
|
.It Fl Wbuiltin-args
|
||||||
@@ -182,37 +184,40 @@ This warning is enabled by
|
|||||||
Warn when obsolete constructs such as the
|
Warn when obsolete constructs such as the
|
||||||
.Ic jp [hl]
|
.Ic jp [hl]
|
||||||
instruction or
|
instruction or
|
||||||
.Cm HOME
|
.Ic HOME
|
||||||
section type are encountered.
|
section type are encountered.
|
||||||
This warning is enabled by
|
This warning is enabled by
|
||||||
.Fl Wextra .
|
.Fl Wextra .
|
||||||
.It Fl Wshift
|
.It Fl Wshift
|
||||||
Warn when shifting triggers C undefined behavior, potentially causing unpredictable behavior.
|
Warn when shifting right a negative value.
|
||||||
Shfting behavior will be changed and this warning removed before next release.
|
Use a division by 2^N instead.
|
||||||
|
.It Fl Wshift-amount
|
||||||
|
Warn when a shift's operand is negative or greater than 32.
|
||||||
|
.It Fl Wno-truncation
|
||||||
|
Warn when an implicit truncation (for example,
|
||||||
|
.Ic db )
|
||||||
|
loses some bits.
|
||||||
.It Fl Wno-user
|
.It Fl Wno-user
|
||||||
Warns when the
|
Warn when the
|
||||||
.Ic WARN
|
.Ic WARN
|
||||||
built-in is executed. (See
|
built-in is executed. (See
|
||||||
.Xr rgbasm 5 "Aborting the assembly process"
|
.Dq Aborting the assembly process
|
||||||
|
in
|
||||||
|
.Xr rgbasm 5
|
||||||
for
|
for
|
||||||
.Ic WARN ) .
|
.Ic WARN ) .
|
||||||
.El
|
.El
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
You can assemble a source file in two ways.
|
You can assemble a source file in two ways.
|
||||||
Straightforward way:
|
|
||||||
.Pp
|
.Pp
|
||||||
.Bd -literal -offset indent
|
Straightforward way:
|
||||||
$ rgbasm -o bar.o foo.asm
|
.Dl $ rgbasm -o bar.o foo.asm
|
||||||
.Ed
|
|
||||||
.Pp
|
.Pp
|
||||||
Pipes way:
|
Pipes way:
|
||||||
|
.Dl $ cat foo.asm | rgbasm -o bar.o -
|
||||||
|
.Dl $ rgbasm -o bar.o - < foo.asm
|
||||||
.Pp
|
.Pp
|
||||||
.Bd -literal -offset indent
|
The resulting object file is not yet a usable ROM image\(emit must first be run through
|
||||||
$ cat foo.asm | rgbasm -o bar.o -
|
|
||||||
$ rgbasm -o bar.o - < foo.asm
|
|
||||||
.Ed
|
|
||||||
.Pp
|
|
||||||
The resulting object file is not yet a usable ROM image \(em it must first be run through
|
|
||||||
.Xr rgblink 1
|
.Xr rgblink 1
|
||||||
and then
|
and then
|
||||||
.Xr rgbfix 1 .
|
.Xr rgbfix 1 .
|
||||||
|
|||||||
1523
src/asm/rgbasm.5
1523
src/asm/rgbasm.5
File diff suppressed because it is too large
Load Diff
85
src/doc_postproc.awk
Executable file
85
src/doc_postproc.awk
Executable file
@@ -0,0 +1,85 @@
|
|||||||
|
#!/usr/bin/awk -f
|
||||||
|
|
||||||
|
/^\s+<td><b class="Sy">.+<\/b><\/td>$/ {
|
||||||
|
# Assuming that all cells whose contents are bold are heading cells,
|
||||||
|
# use the HTML tag for those
|
||||||
|
sub(/td><b class="Sy"/, "th");
|
||||||
|
sub(/b><\/td/, "th");
|
||||||
|
}
|
||||||
|
|
||||||
|
BEGIN {
|
||||||
|
in_synopsis = 0
|
||||||
|
}
|
||||||
|
/<table class="Nm">/ {
|
||||||
|
in_synopsis = 1
|
||||||
|
}
|
||||||
|
/<\/table>/ {
|
||||||
|
# Resets synopsis state even when already reset, but whatever
|
||||||
|
in_synopsis = 0
|
||||||
|
}
|
||||||
|
/<code class="Fl">-[a-zA-Z]/ {
|
||||||
|
# Add links to arg descr in synopsis section
|
||||||
|
if (in_synopsis) {
|
||||||
|
while (match($0, /<code class="Fl">-[a-zA-Z]+/)) {
|
||||||
|
# 123456789012345678 -> 18 chars
|
||||||
|
optchars = substr($0, RSTART + 18, RLENGTH - 18)
|
||||||
|
i = length(optchars)
|
||||||
|
while (i) {
|
||||||
|
end = RSTART + 18 + i
|
||||||
|
i -= 1
|
||||||
|
len = i ? 1 : 2
|
||||||
|
$0 = sprintf("%s<a href=\"#%s\">%s</a>%s",
|
||||||
|
substr($0, 0, end - len - 1),
|
||||||
|
substr($0, end - 1, 1),
|
||||||
|
substr($0, end - len, len),
|
||||||
|
substr($0, end))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/<div class="Nd">/ {
|
||||||
|
# Make the description blurb inline, as with terminal output
|
||||||
|
gsub(/div/, "span")
|
||||||
|
}
|
||||||
|
|
||||||
|
BEGIN {
|
||||||
|
pages["gbz80", 7] = 1
|
||||||
|
pages["rgbds", 5] = 1
|
||||||
|
pages["rgbds", 7] = 1
|
||||||
|
pages["rgbasm", 1] = 1
|
||||||
|
pages["rgbasm", 5] = 1
|
||||||
|
pages["rgblink",1] = 1
|
||||||
|
pages["rgblink",5] = 1
|
||||||
|
pages["rgbfix", 1] = 1
|
||||||
|
pages["rgbgfx", 1] = 1
|
||||||
|
}
|
||||||
|
/<a class="Xr">/ {
|
||||||
|
# Link to other pages in the doc
|
||||||
|
for (i in pages) {
|
||||||
|
split(i, page, SUBSEP)
|
||||||
|
name = page[1]
|
||||||
|
section = page[2]
|
||||||
|
gsub(sprintf("<a class=\"Xr\">%s\\(%d\\)", name, section),
|
||||||
|
sprintf("<a class=\"Xr\" href=\"%s.%d.html\">%s(%d)", name, section, name, section))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
{
|
||||||
|
# Make long opts (defined using `Fl Fl`) into a single tag
|
||||||
|
gsub(/<code class="Fl">-<\/code><code class="Fl">/, "<code class=\"Fl\">-")
|
||||||
|
}
|
||||||
|
|
||||||
|
{
|
||||||
|
print
|
||||||
|
}
|
||||||
|
|
||||||
|
/<head>/ {
|
||||||
|
# Add viewport size <meta> tag for mobile users
|
||||||
|
print " <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">"
|
||||||
|
}
|
||||||
|
|
||||||
|
/<link/ {
|
||||||
|
# Inject our own style overrides
|
||||||
|
print(" <link rel=\"stylesheet\" href=\"rgbds.css\" type=\"text/css\" media=\"all\"/>")
|
||||||
|
}
|
||||||
793
src/gbz80.7
793
src/gbz80.7
File diff suppressed because it is too large
Load Diff
@@ -41,7 +41,7 @@ option to change this.
|
|||||||
Similarly, WRAM0 sections are placed in the first 4 KiB of WRAM
|
Similarly, WRAM0 sections are placed in the first 4 KiB of WRAM
|
||||||
.Pq Dq bank 0 ,
|
.Pq Dq bank 0 ,
|
||||||
and WRAMX sections are placed in any bank of the last 4 KiB.
|
and WRAMX sections are placed in any bank of the last 4 KiB.
|
||||||
If your ROM doesn't use banked, WRAM you can use the
|
If your ROM doesn't use banked WRAM, you can use the
|
||||||
.Fl w
|
.Fl w
|
||||||
option to change this.
|
option to change this.
|
||||||
.Pp
|
.Pp
|
||||||
@@ -93,14 +93,14 @@ The default is 0.
|
|||||||
This option is ignored.
|
This option is ignored.
|
||||||
It was supposed to perform smart linking but fell into disrepair, and so has been removed.
|
It was supposed to perform smart linking but fell into disrepair, and so has been removed.
|
||||||
It will be reimplemented at some point.
|
It will be reimplemented at some point.
|
||||||
.It Fl t , Fl tiny
|
.It Fl t , Fl Fl tiny
|
||||||
Expand the ROM0 section size from 16 KiB to the full 32 KiB assigned to ROM and prohibit the use of ROMX sections.
|
Expand the ROM0 section size from 16 KiB to the full 32 KiB assigned to ROM and prohibit the use of ROMX sections.
|
||||||
Useful for ROMs that fit in 32 KiB.
|
Useful for ROMs that fit in 32 KiB.
|
||||||
.It Fl V , Fl version
|
.It Fl V , Fl Fl version
|
||||||
Print the version of the program and exit.
|
Print the version of the program and exit.
|
||||||
.It Fl v , Fl verbose
|
.It Fl v , Fl Fl verbose
|
||||||
Verbose: enable printing more information to standard error.
|
Verbose: enable printing more information to standard error.
|
||||||
.It Fl w , Fl wramx
|
.It Fl w , Fl Fl wramx
|
||||||
Expand the WRAM0 section size from 4 KiB to the full 8 KiB assigned to WRAM and prohibit the use of WRAMX sections.
|
Expand the WRAM0 section size from 4 KiB to the full 8 KiB assigned to WRAM and prohibit the use of WRAMX sections.
|
||||||
.El
|
.El
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
@@ -115,11 +115,13 @@ You should use
|
|||||||
.Xr rgbfix 1
|
.Xr rgbfix 1
|
||||||
to fix these so that the program will actually run in a Game Boy:
|
to fix these so that the program will actually run in a Game Boy:
|
||||||
.Pp
|
.Pp
|
||||||
.D1 $ rgbfix -v bar.gb
|
.Dl $ rgbfix -v bar.gb
|
||||||
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
Here is a more complete example:
|
Here is a more complete example:
|
||||||
.Pp
|
.Pp
|
||||||
.D1 $ rgblink -o bin/game.gb -n bin/game.sym -p 0xFF obj/title.o obj/engine.o
|
.Dl $ rgblink -o bin/game.gb -n bin/game.sym -p 0xFF obj/title.o obj/engine.o
|
||||||
|
.Ed
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
Please report bugs on
|
Please report bugs on
|
||||||
.Lk https://github.com/rednex/rgbds/issues GitHub .
|
.Lk https://github.com/rednex/rgbds/issues GitHub .
|
||||||
|
|||||||
Reference in New Issue
Block a user