ref: 713eef9ef2468c3902955f99c37ce98802a7820d
parent: 7635a2fc747e19cde64aea96f6c0f71ffec25a5a
author: ISSOtm <[email protected]>
date: Tue Mar 24 06:10:49 EDT 2020
Update mandoc style sheet
--- a/docs/mandoc.css
+++ b/docs/mandoc.css
@@ -1,23 +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).
+ *
+ * Written by Ingo Schwarze <[email protected]>.
+ * 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. */
-/* This is handled in `rgbds.css` instead
- *
- * html { max-width: 100ex; }- */
+html { max-width: 65em; } body { font-family: Helvetica,Arial,sans-serif; } table { margin-top: 0em;- margin-bottom: 0em; }
-td { vertical-align: top; }+ margin-bottom: 0em;
+ 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;margin-bottom: 0em; }
li, dt { margin-top: 1em; }-a.selflink { border-bottom: thin dotted;+.permalink { border-bottom: thin dotted;color: inherit;
font: inherit;
text-decoration: inherit; }
@@ -44,7 +54,6 @@
td.head-vol { text-align: center; } td.head-rtitle {text-align: right; }
-span.Nd { } table.foot { width: 100%;border-top: 1px dotted #808080;
@@ -54,147 +63,189 @@
/* Sections and paragraphs. */
-div.manual-text {- margin-left: 5ex; }
-h1.Sh { margin-top: 2ex;- margin-bottom: 1ex;
- margin-left: -4ex;
+.manual-text {+ margin-left: 3.8em; }
+.Nd { }+section.Sh { }+h1.Sh { margin-top: 1.2em;+ margin-bottom: 0.6em;
+ margin-left: -3.2em;
font-size: 110%; }
-h2.Ss { margin-top: 2ex;- margin-bottom: 1ex;
- margin-left: -2ex;
+section.Ss { }+h2.Ss { margin-top: 1.2em;+ margin-bottom: 0.6em;
+ margin-left: -1.2em;
font-size: 105%; }
-div.Pp { margin: 1ex 0ex; }-a.Sx { }-a.Xr { }+.Pp { margin: 0.6em 0em; }+.Sx { }+.Xr { }/* Displays and lists. */
-div.Bd { }-div.D1 { margin-left: 5ex; }+.Bd { }+.Bd-indent { margin-left: 3.8em; }-ul.Bl-bullet { list-style-type: disc;+.Bl-bullet { list-style-type: disc;padding-left: 1em; }
-li.It-bullet { }-ul.Bl-dash { list-style-type: none;+.Bl-bullet > li { }+.Bl-dash { list-style-type: none;padding-left: 0em; }
-li.It-dash:before {+.Bl-dash > li:before {content: "\2014 "; }
-ul.Bl-item { list-style-type: none;+.Bl-item { list-style-type: none;padding-left: 0em; }
-li.It-item { }-ul.Bl-compact > li {- margin-top: 0ex; }
+.Bl-item > li { }+.Bl-compact > li {+ margin-top: 0em; }
-ol.Bl-enum { padding-left: 2em; }-li.It-enum { }-ol.Bl-compact > li {- margin-top: 0ex; }
+.Bl-enum { padding-left: 2em; }+.Bl-enum > li { }+.Bl-compact > li {+ margin-top: 0em; }
-dl.Bl-diag { }-dt.It-diag { }-dd.It-diag { margin-left: 0ex; }-b.It-diag { font-style: normal; }-dl.Bl-hang { }-dt.It-hang { }-dd.It-hang { margin-left: 10.2ex; }-dl.Bl-inset { }-dt.It-inset { }-dd.It-inset { margin-left: 0ex; }-dl.Bl-ohang { }-dt.It-ohang { }-dd.It-ohang { margin-left: 0ex; }-dl.Bl-tag { margin-left: 10.2ex; }-dt.It-tag { float: left;- margin-top: 0ex;
- margin-left: -10.2ex;
- padding-right: 2ex;
+.Bl-diag { }+.Bl-diag > dt {+ font-style: normal;
+ font-weight: bold; }
+.Bl-diag > dd {+ margin-left: 0em; }
+.Bl-hang { }+.Bl-hang > dt { }+.Bl-hang > dd {+ margin-left: 5.5em; }
+.Bl-inset { }+.Bl-inset > dt { }+.Bl-inset > dd {+ margin-left: 0em; }
+.Bl-ohang { }+.Bl-ohang > dt { }+.Bl-ohang > dd {+ 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; }
-dd.It-tag { clear: right;+.Bl-tag > dd {+ clear: right;
width: 100%;
- margin-top: 0ex;
- margin-left: 0ex;
+ margin-top: 0em;
+ margin-left: 0em;
+ margin-bottom: 0.6em;
vertical-align: top;
overflow: auto; }
-dl.Bl-compact > dt {- margin-top: 0ex; }
+.Bl-compact { margin-top: 0em; }+.Bl-compact > dd {+ margin-bottom: 0em; }
+.Bl-compact > dt {+ margin-top: 0em; }
-table.Bl-column { }-tr.It-column { }-td.It-column { margin-top: 1em; }-table.Bl-compact > tbody > tr > td {- margin-top: 0ex; }
+.Bl-column { }+.Bl-column > tbody > tr { }+.Bl-column > tbody > tr > td {+ margin-top: 1em; }
+.Bl-compact > tbody > tr > td {+ margin-top: 0em; }
-cite.Rs { font-style: normal;+.Rs { font-style: normal;font-weight: normal; }
-span.RsA { }-i.RsB { font-weight: normal; }-span.RsC { }-span.RsD { }-i.RsI { font-weight: normal; }-i.RsJ { font-weight: normal; }-span.RsN { }-span.RsO { }-span.RsP { }-span.RsQ { }-span.RsR { }-span.RsT { text-decoration: underline; }-a.RsU { }-span.RsV { }+.RsA { }+.RsB { font-style: italic;+ font-weight: normal; }
+.RsC { }+.RsD { }+.RsI { font-style: italic;+ font-weight: normal; }
+.RsJ { font-style: italic;+ font-weight: normal; }
+.RsN { }+.RsO { }+.RsP { }+.RsQ { }+.RsR { }+.RsT { text-decoration: underline; }+.RsU { }+.RsV { }-span.eqn { }-table.tbl { }+.eqn { }+.tbl td { vertical-align: middle; }+.HP { margin-left: 3.8em;+ text-indent: -3.8em; }
+
/* Semantic markup for command line utilities. */
table.Nm { }-b.Nm { font-style: normal; }-b.Fl { font-style: normal; }-b.Cm { font-style: normal; }-var.Ar { font-style: italic;+code.Nm { font-style: normal;+ font-weight: bold;
+ font-family: inherit; }
+.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; }
-span.Op { }-b.Ic { font-style: normal; }-code.Ev { font-style: normal;+.Op { display: inline; }+.Ic { font-style: normal;+ font-weight: bold;
+ font-family: inherit; }
+.Ev { font-style: normal;font-weight: normal;
font-family: monospace; }
-i.Pa { font-weight: normal; }+.Pa { font-style: italic;+ font-weight: normal; }
/* Semantic markup for function libraries. */
-span.Lb { }-b.In { font-style: normal; }+.Lb { }+code.In { font-style: normal;+ font-weight: bold;
+ font-family: inherit; }
a.In { }-b.Fd { font-style: normal; }-var.Ft { font-style: italic;+.Fd { font-style: normal;+ font-weight: bold;
+ font-family: inherit; }
+.Ft { font-style: italic;font-weight: normal; }
-b.Fn { font-style: normal; }-var.Fa { font-style: italic;+.Fn { font-style: normal;+ font-weight: bold;
+ font-family: inherit; }
+.Fa { font-style: italic;font-weight: normal; }
-var.Vt { font-style: italic;+.Vt { font-style: italic;font-weight: normal; }
-var.Va { font-style: italic;+.Va { font-style: italic;font-weight: normal; }
-code.Dv { font-style: normal;+.Dv { font-style: normal;font-weight: normal;
font-family: monospace; }
-code.Er { font-style: normal;+.Er { font-style: normal;font-weight: normal;
font-family: monospace; }
/* Various semantic markup. */
-span.An { }-a.Lk { }-a.Mt { }-b.Cd { font-style: normal; }-i.Ad { font-weight: normal; }-b.Ms { font-style: normal; }-span.St { }-a.Ux { }+.An { }+.Lk { }+.Mt { }+.Cd { font-style: normal;+ font-weight: bold;
+ font-family: inherit; }
+.Ad { font-style: italic;+ font-weight: normal; }
+.Ms { font-style: normal;+ font-weight: bold; }
+.St { }+.Ux { }/* Physical markup. */
+.Bf { display: inline; } .No { font-style: normal;font-weight: normal; }
.Em { font-style: italic;@@ -204,3 +255,93 @@
.Li { font-style: normal;font-weight: normal;
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; }
+}
--- a/docs/rgbds.css
+++ b/docs/rgbds.css
@@ -13,7 +13,7 @@
text-align: justify;
/* Center body horizontally (requires <html> to span full width) */
- margin: 10px auto;
+ margin: 0 auto;
/* `mandoc.css`'s default, but it's applied to <html> there */
max-width: 100ex;
}
@@ -28,6 +28,11 @@
code, pre {font-size: smaller;
+}
+
+pre {+ /* Avoid horizontal page scrolling on mobile */
+ overflow: auto;
}
/* Separate lines in tables */
--- a/src/asm/rgbasm.1
+++ b/src/asm/rgbasm.1
@@ -153,7 +153,9 @@
Warns when
.Ic WARN Ns No -type
assertions fail. (See
-.Xr rgbasm 5 "Aborting the assembly process"
+.Dq Aborting the assembly process
+in
+.Xr rgbasm 5
for
.Ic ASSERT ) .
.It Fl Wbuiltin-args
@@ -187,24 +189,31 @@
This warning is enabled by
.Fl Wextra .
.It Fl Wshift
-Warn when shifting triggers C undefined behavior, potentially causing unpredictable behavior.
-Shfting behavior will be changed and this warning removed before next release.
+Warn when shifting right a negative value.
+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
-Warns when the
+Warn when the
.Ic WARN
built-in is executed. (See
-.Xr rgbasm 5 "Aborting the assembly process"
+.Dq Aborting the assembly process
+in
+.Xr rgbasm 5
for
.Ic WARN ) .
.El
.Sh EXAMPLES
You can assemble a source file in two ways.
-Straightforward way:
.Pp
+Straightforward way:
.Dl $ rgbasm -o bar.o foo.asm
.Pp
Pipes way:
-.Pp
.Dl $ cat foo.asm | rgbasm -o bar.o -
.Dl $ rgbasm -o bar.o - < foo.asm
.Pp
--- a/src/asm/rgbasm.5
+++ b/src/asm/rgbasm.5
@@ -239,7 +239,8 @@
.Pp
A funky feature is
.Ql {symbol}-within a string.
+within a string, called
+.Dq symbol interpolation .
This will paste
.Ar symbol Ap s
contents as a string.
@@ -253,6 +254,8 @@
;\ Prints "The answer to life, the universe, and everything is $2A"
PRINTT "The answer to {TOPIC} is {ANSWER}\[rs]n".Ed
+.Pp
+Symbol interpolations can be nested, too!
.Pp
It's possible to change the way numeric symbols are converted by specifying a print type like so:
.Ql {d:symbol} .