fix: remove relative markdown links from param descriptions
This commit is contained in:
parent
22166bf443
commit
e2edb44fa8
@ -1,11 +0,0 @@
|
||||
---@meta
|
||||
|
||||
---
|
||||
---This function allows you to write directly to RAM. The requested number of bits is written at the address requested. The address is typically specified in hexadecimal format.
|
||||
---
|
||||
---For in-depth detail on how addressing works with various bits parameters, please see `peek`.
|
||||
---
|
||||
---@param addr number # the address of RAM you desire to write (segmented based on bits)
|
||||
---@param val number # the integer value write to RAM (range varies based on bits)
|
||||
---@param bits number # the number of bits to write (1, 2, 4, or 8; default: 8)
|
||||
function poke(addr, val, bits) end
|
@ -51,7 +51,7 @@ function peek(addr, bits) end
|
||||
---
|
||||
---- `poke` - Write to a memory address
|
||||
---
|
||||
---@param bitaddr number # the address of [RAM](RAM) you desire to write
|
||||
---@param bitaddr number # the address of `RAM` you desire to write
|
||||
---@return number bitval # the integer value write to RAM
|
||||
function peek1(bitaddr) end
|
||||
|
||||
@ -64,7 +64,7 @@ function peek1(bitaddr) end
|
||||
---
|
||||
---- `poke` - Write to a memory address
|
||||
---
|
||||
---@param addr2 number # the address of [RAM](RAM) you desire to write (segmented on 2)
|
||||
---@param addr2 number # the address of `RAM` you desire to write (segmented on 2)
|
||||
---@return number val2 # the integer value write to RAM (segmented on 2)
|
||||
function peek2(addr2) end
|
||||
|
||||
@ -77,7 +77,7 @@ function peek2(addr2) end
|
||||
---
|
||||
---- `poke` - Write to a memory address
|
||||
---
|
||||
---@param addr4 number # the address of [RAM](RAM) you desire to write (segmented on 4)
|
||||
---@param addr4 number # the address of `RAM` you desire to write (segmented on 4)
|
||||
---@return number val4 # the integer value write to RAM (segmented on 4)
|
||||
function peek4(addr4) end
|
||||
|
||||
@ -104,7 +104,7 @@ function poke(addr, val, bits) end
|
||||
---
|
||||
---- `peek` - Read from a memory address
|
||||
---
|
||||
---@param bitaddr number # the address of [RAM](RAM) you desire to write
|
||||
---@param bitaddr number # the address of `RAM` you desire to write
|
||||
---@param bitval number # the integer value write to RAM
|
||||
function poke1(bitaddr, bitval) end
|
||||
|
||||
@ -117,7 +117,7 @@ function poke1(bitaddr, bitval) end
|
||||
---
|
||||
---- `peek` - Read from a memory address
|
||||
---
|
||||
---@param addr2 number # the address of [RAM](RAM) you desire to write (segmented on 2)
|
||||
---@param addr2 number # the address of `RAM` you desire to write (segmented on 2)
|
||||
---@param val2 number # the integer value write to RAM (segmented on 2)
|
||||
function poke2(addr2, val2) end
|
||||
|
||||
@ -130,7 +130,7 @@ function poke2(addr2, val2) end
|
||||
---
|
||||
---- `peek` - Read from a memory address
|
||||
---
|
||||
---@param addr4 number # the address of [RAM](RAM) you desire to write (segmented on 4)
|
||||
---@param addr4 number # the address of `RAM` you desire to write (segmented on 4)
|
||||
---@param val4 number # the integer value write to RAM (segmented on 4)
|
||||
function poke4(addr4, val4) end
|
||||
|
||||
|
@ -188,7 +188,7 @@ def get_variable_descriptions(root: MarkdownSection) -> dict[str, str]:
|
||||
if line.startswith("* **") or line.startswith("- **"):
|
||||
names, description = parse_variable_description_line(line)
|
||||
for name in names:
|
||||
descriptions[name] = description
|
||||
descriptions[name] = replace_relative_links(description)
|
||||
|
||||
# TYPO: Because a line explaning the variable "value" in `peek` is missing,
|
||||
# It is hard-coded here
|
||||
@ -198,11 +198,11 @@ def get_variable_descriptions(root: MarkdownSection) -> dict[str, str]:
|
||||
# TYPO: Because "bitaddr", "bitval", "addr2", "addr4", "val2", "val4" are
|
||||
# not explicitly explained in `peek` and `poke`, it is hard-coded here
|
||||
if root.name == "peek*" or root.name == "poke*":
|
||||
descriptions["bitaddr"] = "the address of [RAM](RAM) you desire to write"
|
||||
descriptions["bitaddr"] = "the address of `RAM` you desire to write"
|
||||
descriptions["bitval"] = "the integer value write to RAM"
|
||||
descriptions["addr2"] = "the address of [RAM](RAM) you desire to write (segmented on 2)"
|
||||
descriptions["addr2"] = "the address of `RAM` you desire to write (segmented on 2)"
|
||||
descriptions["val2"] = "the integer value write to RAM (segmented on 2)"
|
||||
descriptions["addr4"] = "the address of [RAM](RAM) you desire to write (segmented on 4)"
|
||||
descriptions["addr4"] = "the address of `RAM` you desire to write (segmented on 4)"
|
||||
descriptions["val4"] = "the integer value write to RAM (segmented on 4)"
|
||||
|
||||
# Because the return type in `fget` is "bool" and is not explicitly documented
|
||||
|
Loading…
Reference in New Issue
Block a user