rgbasm | \n [-EHhLlVvw] [-b\n chars] [-D\n name[=value]]\n [-g chars]\n [-I path]\n [-M depend_file]\n [-MG] [-MP]\n [-MT target_file]\n [-MQ target_file]\n [-o out_file]\n [-P include_file]\n [-p pad_value]\n [-Q fix_precision]\n [-r recursion_depth]\n [-W warning]\n asmfile | \n
The rgbasm program creates an RGB object\n file from an assembly source file. The object file format is documented in\n rgbds(5).
The input asmfile can be a path to a file,\n or - to read from standard input.
Note that options can be abbreviated as long as the abbreviation\n is unambiguous: --verb is\n --verbose, but --ver is\n invalid because it could also be --version. The\n arguments are as follows:
-b\n chars, --binary-digits\n chars-D\n name[=value],\n --define\n name[=value]name\n EQUS\n "value"’\n in code, or ‘name\n EQUS\n "1"’ if\n value is not specified.-E,\n --export-all-g\n chars, --gfx-chars\n chars-H,\n --nop-after-haltnop instruction immediately after any\n halt instruction. This option is deprecated and\n will be removed in the next version.-h,\n --halt-without-nop-I\n path, --include\n pathINCLUDE (including\n the implicit one from -P) or\n INCBIN is attempted,\n rgbasm first looks up the provided path from its\n working directory; if this fails, it tries again from each of the\n “include path” directories, in the order they were\n provided.-L,\n --preserve-ld-l,\n --auto-ldhLD [$FF00+n8],A into\n the opcode LDH [$FF00+n8],A. This option is\n deprecated and will be removed in the next version.-M\n depend_file, --dependfile\n depend_file-MG-M. This makes\n rgbasm assume that missing files are\n auto-generated: when INCLUDE (including the\n implicit one from -P) or\n INCBIN is attempted on a non-existent file, it is\n added as a dependency, then rgbasm exits normally\n instead of erroring out. This feature is used in automatic updating of\n makefiles.-MP-MT\n target_file-M. The exact\n string provided will be written, including spaces and special characters.\n -MT\n fileA -MT\n fileB-MT\n \'fileA fileB\'-MQ is specified, the output\n file name is used.-MQ\n target_file-MT, but additionally escapes any special\n make(1)\n characters, essentially ‘$’.-o\n out_file, --output\n out_file-P\n include_file, --preinclude\n include_fileINCLUDE\n "include_file"-p\n pad_value, --pad-value\n pad_valueDS directives in ROM\n sections, unless overridden. The default is 0x00.-Q\n fix_precision, --q-precision\n fix_precision.’ to match the Q\n notation, for example, ‘-Q\n .16-r\n recursion_depth,\n --recursion-depth\n recursion_depth-V,\n --version-v,\n --verbose-W\n warning, --warning\n warning-wWarnings are diagnostic messages that indicate possibly erroneous\n behavior that does not necessarily compromise the assembling process. The\n following options alter the way warnings are processed.
\n-Werror-Werror=-Werror=obsolete), and this warning is\n implicitly enabled and turned into an error. This is an error if used with\n a meta warning, such as -Werror=all.The following warnings are “meta” warnings, that\n enable a collection of other warnings. If a specific warning is toggled via\n a meta flag and a specific one, the more specific one takes priority. The\n position on the command-line acts as a tie breaker, the last one taking\n effect.
\n-Wall-Wextra-WeverythingThe following warnings are actual warning flags; with each\n description, the corresponding warning flag is included. Note that each of\n these flag also has a negation (for example,\n -Wcharmap-redef enables the warning that\n -Wno-charmap-redef disables). Only the non-default\n flag is listed here. Ignoring the “no-” prefix, entries are\n listed alphabetically.
-Wno-assertWARN-type\n assertions fail. (See “Aborting the assembly process” in\n rgbasm(5) for\n ASSERT).-Wbackwards-forFOR loops have their start and stop\n values switched according to the step value. This warning is enabled by\n -Wall.-Wbuiltin-argsSTRSUB() with indexes outside of the string\'s\n bounds. This warning is enabled by -Wall.-Wcharmap-redef-Wall.-Wdiv-Wempty-macro-arg-Wextra.-Wempty-strrplSTRRPL() is called with an empty string\n as its second argument (the substring to replace). This warning is enabled\n by -Wall.-Wlarge-constant-Wall.-Wlong-string-Wall.-Wmacro-shift-Wextra.-Wno-obsolete_PI\n constant or PRINTT directive are encountered.-Wnumeric-string=-Wnumeric-string=0 or\n -Wno-numeric-string disables this warning.\n -Wnumeric-string=1 or just\n -Wnumeric-string warns about strings longer than\n four characters, since four or fewer characters fit within a 32-bit\n integer. -Wnumeric-string=2 warns about any\n multi-character string.-Wshift-Wshift-amount-Wtruncation=db\n to an 8-bit value) loses some bits. -Wtruncation=0\n or -Wno-truncation disables this warning.\n -Wtruncation=1 warns when an N-bit value is 2**N\n or greater, or less than -2**N. -Wtruncation=2 or\n just -Wtruncation also warns when an N-bit value\n is less than -2**(N-1), which will not fit in two\'s complement\n encoding.-Wunmapped-char=-Wunmapped-char=0 or\n -Wunmapped-char disables this warning.\n -Wunmapped-char=1 or just\n -Wunmapped-char only warns if the active charmap\n is not empty. -Wunmapped-char=2 warns if the\n active charmap is empty, and/or is not the default charmap\n ‘main’.-Wno-userWARN built-in is executed. (See\n “Aborting the assembly process” in\n rgbasm(5) for\n WARN).You can assemble a source file in two ways.
\nStraightforward way:
\n$ rgbasm -o bar.o\n foo.asmPipes way:
\n$ cat foo.asm | rgbasm -o bar.o\n -$ rgbasm -o bar.o - <\n foo.asmThe resulting object file is not yet a usable ROM image—it\n must first be run through rgblink(1)\n and then rgbfix(1).
\nPlease report bugs on\n GitHub.
\nrgbfix(1),\n rgblink(1),\n rgbasm(5),\n gbz80(7),\n rgbds(5),\n rgbds(7)
\nrgbasm was originally written by Carsten\n Sørensen as part of the ASMotor package, and was later packaged in\n RGBDS by Justin Lloyd. It is now maintained by a number of contributors at\n https://github.com/gbdev/rgbds.
rgbasm | \n [-EHhLlVvw] [-b\n chars] [-D\n name[=value]]\n [-g chars]\n [-I path]\n [-M depend_file]\n [-MG] [-MP]\n [-MT target_file]\n [-MQ target_file]\n [-o out_file]\n [-P include_file]\n [-p pad_value]\n [-Q fix_precision]\n [-r recursion_depth]\n [-W warning]\n [-X max_errors]\n asmfile | \n
The rgbasm program creates an RGB object\n file from an assembly source file. The object file format is documented in\n rgbds(5).
The input asmfile can be a path to a file,\n or - to read from standard input.
Note that options can be abbreviated as long as the abbreviation\n is unambiguous: --verb is\n --verbose, but --ver is\n invalid because it could also be --version. The\n arguments are as follows:
-b\n chars, --binary-digits\n chars-D\n name[=value],\n --define\n name[=value]name\n EQUS\n "value"’\n in code, or ‘name\n EQUS\n "1"’ if\n value is not specified.-E,\n --export-all-g\n chars, --gfx-chars\n chars-H,\n --nop-after-haltnop instruction immediately after any\n halt instruction. This option is deprecated and\n will be removed in the next version.-h,\n --halt-without-nop-I\n path, --include\n pathINCLUDE (including\n the implicit one from -P) or\n INCBIN is attempted,\n rgbasm first looks up the provided path from its\n working directory; if this fails, it tries again from each of the\n “include path” directories, in the order they were\n provided.-L,\n --preserve-ld-l,\n --auto-ldhLD [$FF00+n8],A into\n the opcode LDH [$FF00+n8],A. This option is\n deprecated and will be removed in the next version.-M\n depend_file, --dependfile\n depend_file-MG-M. This makes\n rgbasm assume that missing files are\n auto-generated: when INCLUDE (including the\n implicit one from -P) or\n INCBIN is attempted on a non-existent file, it is\n added as a dependency, then rgbasm exits normally\n instead of erroring out. This feature is used in automatic updating of\n makefiles.-MP-MT\n target_file-M. The exact\n string provided will be written, including spaces and special characters.\n -MT\n fileA -MT\n fileB-MT\n \'fileA fileB\'-MQ is specified, the output\n file name is used.-MQ\n target_file-MT, but additionally escapes any special\n make(1)\n characters, essentially ‘$’.-o\n out_file, --output\n out_file-P\n include_file, --preinclude\n include_fileINCLUDE\n "include_file"-p\n pad_value, --pad-value\n pad_valueDS directives in ROM\n sections, unless overridden. The default is 0x00.-Q\n fix_precision, --q-precision\n fix_precision.’ to match the Q\n notation, for example, ‘-Q\n .16-r\n recursion_depth,\n --recursion-depth\n recursion_depth-V,\n --version-v,\n --verbose-W\n warning, --warning\n warning-w-X\n max_errors, --max-errors\n max_errors-X -0\n disables this behavior. The default is 100 if\n rgbasm is printing errors to a terminal, and 0\n otherwise.Warnings are diagnostic messages that indicate possibly erroneous\n behavior that does not necessarily compromise the assembling process. The\n following options alter the way warnings are processed.
\n-Werror-Werror=-Werror=obsolete), and this warning is\n implicitly enabled and turned into an error. This is an error if used with\n a meta warning, such as -Werror=all.The following warnings are “meta” warnings, that\n enable a collection of other warnings. If a specific warning is toggled via\n a meta flag and a specific one, the more specific one takes priority. The\n position on the command-line acts as a tie breaker, the last one taking\n effect.
\n-Wall-Wextra-WeverythingThe following warnings are actual warning flags; with each\n description, the corresponding warning flag is included. Note that each of\n these flag also has a negation (for example,\n -Wcharmap-redef enables the warning that\n -Wno-charmap-redef disables). Only the non-default\n flag is listed here. Ignoring the “no-” prefix, entries are\n listed alphabetically.
-Wno-assertWARN-type\n assertions fail. (See “Aborting the assembly process” in\n rgbasm(5) for\n ASSERT).-Wbackwards-forFOR loops have their start and stop\n values switched according to the step value. This warning is enabled by\n -Wall.-Wbuiltin-argsSTRSUB() with indexes outside of the string\'s\n bounds. This warning is enabled by -Wall.-Wcharmap-redef-Wall.-Wdiv-Wempty-macro-arg-Wextra.-Wempty-strrplSTRRPL() is called with an empty string\n as its second argument (the substring to replace). This warning is enabled\n by -Wall.-Wlarge-constant-Wall.-Wlong-string-Wall.-Wmacro-shift-Wextra.-Wno-obsolete_PI\n constant or PRINTT directive are encountered.-Wnumeric-string=-Wnumeric-string=0 or\n -Wno-numeric-string disables this warning.\n -Wnumeric-string=1 or just\n -Wnumeric-string warns about strings longer than\n four characters, since four or fewer characters fit within a 32-bit\n integer. -Wnumeric-string=2 warns about any\n multi-character string.-Wshift-Wshift-amount-Wtruncation=db\n to an 8-bit value) loses some bits. -Wtruncation=0\n or -Wno-truncation disables this warning.\n -Wtruncation=1 warns when an N-bit value is 2**N\n or greater, or less than -2**N. -Wtruncation=2 or\n just -Wtruncation also warns when an N-bit value\n is less than -2**(N-1), which will not fit in two\'s complement\n encoding.-Wunmapped-char=-Wunmapped-char=0 or\n -Wunmapped-char disables this warning.\n -Wunmapped-char=1 or just\n -Wunmapped-char only warns if the active charmap\n is not empty. -Wunmapped-char=2 warns if the\n active charmap is empty, and/or is not the default charmap\n ‘main’.-Wno-userWARN built-in is executed. (See\n “Aborting the assembly process” in\n rgbasm(5) for\n WARN).You can assemble a source file in two ways.
\nStraightforward way:
\n$ rgbasm -o bar.o\n foo.asmPipes way:
\n$ cat foo.asm | rgbasm -o bar.o\n -$ rgbasm -o bar.o - <\n foo.asmThe resulting object file is not yet a usable ROM image—it\n must first be run through rgblink(1)\n and then rgbfix(1).
\nPlease report bugs on\n GitHub.
\nrgbfix(1),\n rgblink(1),\n rgbasm(5),\n gbz80(7),\n rgbds(5),\n rgbds(7)
\nrgbasm was originally written by Carsten\n Sørensen as part of the ASMotor package, and was later packaged in\n RGBDS by Justin Lloyd. It is now maintained by a number of contributors at\n https://github.com/gbdev/rgbds.
master?",id:"master",level:2},{value:"Pros and cons of master over releases",id:"pros-and-cons-of-master-over-releases",level:3},{value:"Table of contents",id:"table-of-contents",level:2}];function c(e){const s={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",strong:"strong",ul:"ul",...(0,t.a)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(s.h1,{id:"release-information",children:"Release information"}),"\n",(0,r.jsxs)(s.h2,{id:"master",children:["What is ",(0,r.jsx)(s.code,{children:"master"}),"?"]}),"\n",(0,r.jsxs)(s.p,{children:[(0,r.jsx)(s.code,{children:"master"})," is the name of RGBDS' main development branch. It's usually employed as a version name to refer to the state of in-development RGBDS: it contains the latest changes as they are pushed, but for this reason it's very unstable."]}),"\n",(0,r.jsxs)(s.h3,{id:"pros-and-cons-of-master-over-releases",children:["Pros and cons of ",(0,r.jsx)(s.code,{children:"master"})," over releases"]}),"\n",(0,r.jsx)(s.p,{children:"Pros:"}),"\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsx)(s.li,{children:"Get the latest changes quickly"}),"\n",(0,r.jsx)(s.li,{children:"Also get bugfixes quickly"}),"\n",(0,r.jsx)(s.li,{children:"Help development by submitting feedback early"}),"\n"]}),"\n",(0,r.jsx)(s.p,{children:"Cons:"}),"\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsx)(s.li,{children:"Tested, but unstable, so expect things to break often"}),"\n",(0,r.jsxs)(s.li,{children:["Must be compiled manually, unless you ",(0,r.jsx)(s.a,{href:"/install#using-our-ci",children:"use our CI"})]}),"\n",(0,r.jsx)(s.li,{children:"Updated often"}),"\n"]}),"\n",(0,r.jsxs)(s.p,{children:["In general, we only recommend using ",(0,r.jsx)(s.code,{children:"master"})," to experienced users that can afford breakage from time to time.\nIf you do decide to use ",(0,r.jsx)(s.code,{children:"master"}),", we thank you and encourage you to ",(0,r.jsx)(s.a,{href:"https://github.com/gbdev/rgbds/issue",children:"report any bugs you find"}),"!"]}),"\n",(0,r.jsx)(s.h2,{id:"table-of-contents",children:"Table of contents"}),"\n",(0,r.jsxs)(s.p,{children:["These pages are HTML renders of the various ",(0,r.jsx)(s.code,{children:"man"})," pages provided with RGBDS.\nPDFs are also offered for offline reading, and maybe printing."]}),"\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.strong,{children:"Language reference"}),": documentation of the various languages used throughout RGBDS.","\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgbasm.5",children:"Assembly syntax"}),": how to write RGBASM-flavored Game Boy assembly, and what the various directives do. (",(0,r.jsx)(s.a,{target:"_blank",href:n(24132).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/gbz80.7",children:"CPU instructions"}),": a list of CPU instructions, as well as quick descriptions of their various effects. (",(0,r.jsx)(s.a,{target:"_blank",href:n(24940).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgblink.5",children:"Linkerscript format"}),": how to write a linker script for RGBLINK. ",(0,r.jsx)(s.a,{target:"_blank",href:n(42926).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgbds.5",children:"Object file format"}),": a description of the format of files emitted by RGBASM and expected by RGBLINK; useful for integrating custom tooling with RGBDS. (",(0,r.jsx)(s.a,{target:"_blank",href:n(64928).Z+"",children:"PDF"}),")"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.strong,{children:"Command-line options"}),": how to write the command lines to invoke RGBDS programs.","\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgbasm.1",children:"RGBASM"}),", the assembler; (",(0,r.jsx)(s.a,{target:"_blank",href:n(8032).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgblink.1",children:"RGBLINK"}),", the linker; ",(0,r.jsx)(s.a,{target:"_blank",href:n(32810).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgbfix.1",children:"RGBFIX"}),", the header manipulator; (",(0,r.jsx)(s.a,{target:"_blank",href:n(27222).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:["and ",(0,r.jsx)(s.a,{href:"/docs/master/rgbgfx.1",children:"RGBGFX"}),", the image converter. (",(0,r.jsx)(s.a,{target:"_blank",href:n(81581).Z+"",children:"PDF"}),")"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(s.li,{children:["The ",(0,r.jsx)(s.a,{href:"/docs/master/rgbds.7",children:"history"})," of RGBDS is also available for the curious. (",(0,r.jsx)(s.a,{target:"_blank",href:n(22625).Z+"",children:"PDF"}),")"]}),"\n"]})]})}function h(e={}){const{wrapper:s}={...(0,t.a)(),...e.components};return s?(0,r.jsx)(s,{...e,children:(0,r.jsx)(c,{...e})}):c(e)}},24940:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/gbz80.7-f3f9d14a5fa150db27c3f6f6ecae56c0.pdf"},8032:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbasm.1-2b44c973a7f748ed9fde51bde088edaf.pdf"},24132:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbasm.5-0f37cd1c168dc35fc01ae15afa9d3c5a.pdf"},64928:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbds.5-852c95fadc6eea144bf50bff1991ca5f.pdf"},22625:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbds.7-b7388d01eefe300f3794e7c5f2dd241a.pdf"},27222:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbfix.1-2ed4b762dbd054e68e8d246a5ccbb612.pdf"},81581:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbgfx.1-7c6572f44475bce5a4906c656b73b70d.pdf"},32810:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgblink.1-556e33e5d6fecfc244f785826b8e3427.pdf"},42926:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgblink.5-ee9171cb530cf668d9fad6323132c242.pdf"},11151:(e,s,n)=>{n.d(s,{Z:()=>d,a:()=>i});var r=n(67294);const t={},a=r.createContext(t);function i(e){const s=r.useContext(a);return r.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function d(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:i(e.components),r.createElement(a.Provider,{value:s},e.children)}}}]);
\ No newline at end of file
+"use strict";(self.webpackChunkrgbds_www=self.webpackChunkrgbds_www||[]).push([[6971],{59925:(e,s,n)=>{n.r(s),n.d(s,{assets:()=>d,contentTitle:()=>i,default:()=>h,frontMatter:()=>a,metadata:()=>o,toc:()=>l});var r=n(85893),t=n(11151);const a={},i="Release information",o={id:"index",title:"Release information",description:"What is master?",source:"@site/docs/index.md",sourceDirName:".",slug:"/",permalink:"/docs/master/",draft:!1,unlisted:!1,editUrl:"https://github.com/gbdev/rgbds-www/edit/master/docs/index.md",tags:[],version:"current",frontMatter:{},sidebar:"nav",next:{title:"rgbasm(5) \u2014 language documentation",permalink:"/docs/master/rgbasm.5"}},d={},l=[{value:"What is master?",id:"master",level:2},{value:"Pros and cons of master over releases",id:"pros-and-cons-of-master-over-releases",level:3},{value:"Table of contents",id:"table-of-contents",level:2}];function c(e){const s={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",strong:"strong",ul:"ul",...(0,t.a)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(s.h1,{id:"release-information",children:"Release information"}),"\n",(0,r.jsxs)(s.h2,{id:"master",children:["What is ",(0,r.jsx)(s.code,{children:"master"}),"?"]}),"\n",(0,r.jsxs)(s.p,{children:[(0,r.jsx)(s.code,{children:"master"})," is the name of RGBDS' main development branch. It's usually employed as a version name to refer to the state of in-development RGBDS: it contains the latest changes as they are pushed, but for this reason it's very unstable."]}),"\n",(0,r.jsxs)(s.h3,{id:"pros-and-cons-of-master-over-releases",children:["Pros and cons of ",(0,r.jsx)(s.code,{children:"master"})," over releases"]}),"\n",(0,r.jsx)(s.p,{children:"Pros:"}),"\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsx)(s.li,{children:"Get the latest changes quickly"}),"\n",(0,r.jsx)(s.li,{children:"Also get bugfixes quickly"}),"\n",(0,r.jsx)(s.li,{children:"Help development by submitting feedback early"}),"\n"]}),"\n",(0,r.jsx)(s.p,{children:"Cons:"}),"\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsx)(s.li,{children:"Tested, but unstable, so expect things to break often"}),"\n",(0,r.jsxs)(s.li,{children:["Must be compiled manually, unless you ",(0,r.jsx)(s.a,{href:"/install#using-our-ci",children:"use our CI"})]}),"\n",(0,r.jsx)(s.li,{children:"Updated often"}),"\n"]}),"\n",(0,r.jsxs)(s.p,{children:["In general, we only recommend using ",(0,r.jsx)(s.code,{children:"master"})," to experienced users that can afford breakage from time to time.\nIf you do decide to use ",(0,r.jsx)(s.code,{children:"master"}),", we thank you and encourage you to ",(0,r.jsx)(s.a,{href:"https://github.com/gbdev/rgbds/issue",children:"report any bugs you find"}),"!"]}),"\n",(0,r.jsx)(s.h2,{id:"table-of-contents",children:"Table of contents"}),"\n",(0,r.jsxs)(s.p,{children:["These pages are HTML renders of the various ",(0,r.jsx)(s.code,{children:"man"})," pages provided with RGBDS.\nPDFs are also offered for offline reading, and maybe printing."]}),"\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.strong,{children:"Language reference"}),": documentation of the various languages used throughout RGBDS.","\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgbasm.5",children:"Assembly syntax"}),": how to write RGBASM-flavored Game Boy assembly, and what the various directives do. (",(0,r.jsx)(s.a,{target:"_blank",href:n(24132).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/gbz80.7",children:"CPU instructions"}),": a list of CPU instructions, as well as quick descriptions of their various effects. (",(0,r.jsx)(s.a,{target:"_blank",href:n(24940).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgblink.5",children:"Linkerscript format"}),": how to write a linker script for RGBLINK. ",(0,r.jsx)(s.a,{target:"_blank",href:n(42926).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgbds.5",children:"Object file format"}),": a description of the format of files emitted by RGBASM and expected by RGBLINK; useful for integrating custom tooling with RGBDS. (",(0,r.jsx)(s.a,{target:"_blank",href:n(64928).Z+"",children:"PDF"}),")"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.strong,{children:"Command-line options"}),": how to write the command lines to invoke RGBDS programs.","\n",(0,r.jsxs)(s.ul,{children:["\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgbasm.1",children:"RGBASM"}),", the assembler; (",(0,r.jsx)(s.a,{target:"_blank",href:n(8032).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgblink.1",children:"RGBLINK"}),", the linker; ",(0,r.jsx)(s.a,{target:"_blank",href:n(32810).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:[(0,r.jsx)(s.a,{href:"/docs/master/rgbfix.1",children:"RGBFIX"}),", the header manipulator; (",(0,r.jsx)(s.a,{target:"_blank",href:n(27222).Z+"",children:"PDF"}),")"]}),"\n",(0,r.jsxs)(s.li,{children:["and ",(0,r.jsx)(s.a,{href:"/docs/master/rgbgfx.1",children:"RGBGFX"}),", the image converter. (",(0,r.jsx)(s.a,{target:"_blank",href:n(81581).Z+"",children:"PDF"}),")"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(s.li,{children:["The ",(0,r.jsx)(s.a,{href:"/docs/master/rgbds.7",children:"history"})," of RGBDS is also available for the curious. (",(0,r.jsx)(s.a,{target:"_blank",href:n(22625).Z+"",children:"PDF"}),")"]}),"\n"]})]})}function h(e={}){const{wrapper:s}={...(0,t.a)(),...e.components};return s?(0,r.jsx)(s,{...e,children:(0,r.jsx)(c,{...e})}):c(e)}},24940:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/gbz80.7-2aa2149eaa22097d5126c4f343d66c21.pdf"},8032:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbasm.1-9e389d573a588276e914533aec635a50.pdf"},24132:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbasm.5-1ba8aa0b20ccd083713063d3eeceee15.pdf"},64928:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbds.5-57b58743f756aa1971c4ac0239d54833.pdf"},22625:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbds.7-8242814b36851746c4c9fd426db2cd00.pdf"},27222:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbfix.1-e8e2097c9d46890545a0813449f8fecc.pdf"},81581:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgbgfx.1-e9dea51d67367f40da5ef5ab12a24c45.pdf"},32810:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgblink.1-faf8a434f2e77bd5f80a739c1cebb51a.pdf"},42926:(e,s,n)=>{n.d(s,{Z:()=>r});const r=n.p+"assets/files/rgblink.5-5cd208ebacf61751f5b4d665896a4f76.pdf"},11151:(e,s,n)=>{n.d(s,{Z:()=>o,a:()=>i});var r=n(67294);const t={},a=r.createContext(t);function i(e){const s=r.useContext(a);return r.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function o(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:i(e.components),r.createElement(a.Provider,{value:s},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/runtime~main.10c8de5a.js b/assets/js/runtime~main.eab57aab.js
similarity index 99%
rename from assets/js/runtime~main.10c8de5a.js
rename to assets/js/runtime~main.eab57aab.js
index c0d9c298..6e12546c 100644
--- a/assets/js/runtime~main.10c8de5a.js
+++ b/assets/js/runtime~main.eab57aab.js
@@ -1 +1 @@
-(()=>{"use strict";var e,a,d,c,f,b={},t={};function r(e){var a=t[e];if(void 0!==a)return a.exports;var d=t[e]={id:e,loaded:!1,exports:{}};return b[e].call(d.exports,d,d.exports,r),d.loaded=!0,d.exports}r.m=b,r.c=t,e=[],r.O=(a,d,c,f)=>{if(!d){var b=1/0;for(i=0;i