Merge pull request #1700 from wilzbach/fix-17262

Fix Issue 17262 - Better docs for rdmd

Author: wilzbach

rdmd.dd

@@ -72,12 +72,12 @@ $(P
         $(B rdmd) [$(I dmd and rdmd options)] $(I progfile)[.d] [$(I program arguments)]
 )
 
-$(P In addition to $(B dmd)'s options, $(B rdmd) recognizes the following:
+$(P In addition to $(LINK2 $(ROOT_DIR)dmd.html, `dmd`)'s options, $(B rdmd) recognizes the following:
 )
 
 $(DL
 
-$(DT $(B --build-only)) $(DD just build the executable, don't run it)
+$(DT $(B --build-only)) $(DD just build the executable, don't run it. By default, the executable is placed into the source file directory)
 
 $(DT $(B --chatty)) $(DD write dmd commands to stdout before executing
 them)
@@ -94,6 +94,10 @@ evaluated in turn))
 
 $(DT $(B --exclude)=package) $(DD exclude a package from the build (multiple --exclude allowed))
 
+$(DT $(B --include)=package) $(DD negate $(B --exclude) or a standard package (std, etc, core))
+
+$(DT $(B --extra-file)=file)  $(DD include an extra source or object in the compilation (multiple --extra-file allowed))
+
 $(DT $(B --force)) $(DD force a rebuild even if apparently not
 necessary)
 
@@ -110,6 +114,8 @@ $(DT $(B --makedepend)) $(DD print dependencies in makefile format and exit)
 $(DT $(B --man)) $(DD open web browser on manual page)
 
 $(DT $(B --shebang)) $(DD rdmd is in a shebang line (put as first argument))
+
+$(DT $(B --tmpdir)) $(DD use a different temporary directory)
 )
 
 $(H2 Download)