gbdev/rgbds
1
0
Fork 0
mirror of https://github.com/gbdev/rgbds.git synced 2025-11-20 10:12:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document that -MG and -MC count READFILE

Browse Source
This commit is contained in:
Rangi42
2025-07-18 20:26:24 -04:00
parent 53c39d01d4
commit 7086b8aeff
2 changed files with 23 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
contrib/bash_compl/_rgbasm.bash
View File

@@ -155,7 +155,7 @@ _rgbasm_completions() {
parse_short_opt "$cur_word"
if [[ "$state" = 'normal' ]]; then
mapfile -t COMPREPLY < <(compgen -W "${!opts[*]}" -P "$cur_word" ''; compgen -W '-MG -MP -MQ -MT' "$cur_word")
mapfile -t COMPREPLY < <(compgen -W "${!opts[*]}" -P "$cur_word" ''; compgen -W '-MC -MG -MP -MQ -MT' "$cur_word")
return 0
elif [[ "$optlen" = "${#cur_word}" && "$state" != "warning" ]]; then
# This short option group only awaits its argument!

42
man/rgbasm.1
View File

@@ -14,8 +14,8 @@
.Op Fl g Ar chars
.Op Fl I Ar path
.Op Fl M Ar depend_file
.Op Fl MC
.Op Fl MG
.Op Fl MC
.Op Fl MP
.Op Fl MT Ar target_file
.Op Fl MQ Ar target_file
@@ -100,11 +100,12 @@ Add a new
.Dq include path ;
.Ar path
must point to a directory.
When a
When any
.Ic INCLUDE
.Pq including the implicit one from Fl P
.Pq including the implicit one from Fl P ,
.Ic INCBIN ,
or
.Ic INCBIN
.Ic READFILE
is attempted,
.Nm
first looks up the provided path from its working directory; if this fails, it tries again from each of the
@@ -115,6 +116,23 @@ Write
.Xr make 1
dependencies to
.Ar depend_file .
.It Fl MG
To be used in conjunction with
.Fl M .
This makes
.Nm
assume that missing files are auto-generated: when any
.Ic INCLUDE
.Pq including the implicit one from Fl P ,
.Ic INCBIN ,
or
.Ic READFILE
is attempted on a non-existent file, it is added as a dependency, then
.Nm
exits normally or continues processing (depending on whether
.Fl MC
was enabled) instead of erroring out.
This feature is used in automatic updating of Makefiles.
.It Fl MC
Implies
.Fl MG .
@@ -126,22 +144,6 @@ Note that this is
recommended if any non-existent dependencies would have influenced subsequent processing, e.g. by causing an
.Ic IF
condition to take a different branch.
.It Fl MG
To be used in conjunction with
.Fl M .
This makes
.Nm
assume that missing files are auto-generated: when
.Ic INCLUDE
.Pq including the implicit one from Fl P
or
.Ic INCBIN
is attempted on a non-existent file, it is added as a dependency, then
.Nm
exits normally or continues processing (depending on whether
.Fl MC
was enabled) instead of erroring out.
This feature is used in automatic updating of Makefiles.
.It Fl MP
When enabled, this adds a phony target to the rules emitted by
.Fl M