diff --git a/doc/source-builder.txt b/doc/source-builder.txt index 6aea33f..5cb2457 100644 --- a/doc/source-builder.txt +++ b/doc/source-builder.txt @@ -826,6 +826,57 @@ _RTEMS_ from version control heads is: The macro map defaults to `global` at the start of each included file and the map setting of the macro file including the other macro files does not change. +Personal Macros +^^^^^^^^^^^^^^^ + +When the tools start to run they will load personal macros. Personal macros are +in the standard format for macros in a file. There are two places personal +macros can be configured. The first is the environment variable +`RSB_MACROS`. If presentthe macros from the file the environment variable +points to are loaded. The second is a file called `.rsb_macros` in your home +directory. You need to have the environment variable `HOME` defined for this +work. + +Report Mailing +~~~~~~~~~~~~~~ + +The build reports can be mailed to a specific email address to logging and +monitoring. Mailing requires a number of parameters to function. These are: + +. To mail address +. From mail address +. SMTP host + +.To Mail Address + +The +to+ mail address is taken from the macro `%{_mail_tools_to}` and the +default is _rtems-tooltestresults at rtems.org_. You can override the default +with a personal or user macro file or via the command line option _--mail-to_. + +.From Mail Address + +The +from+ mail address is taken from: + +. GIT configuration +. User `.mailrc` file +. Command line + +If you have configured an email and name in git it will be used used. If you do +not a check is made for a `.mailrc` file. The environment variable _MAILRC_ is +used if present else your home directory is check. If found the file is scanned +for the `from` setting: + + set from="Foo Bar " + +You can also support a from address on the command line with the _--mail-from_ +option. + +.SMTP Host + +The SMTP host is taken from the macro `%{_mail_smtp_host}` and the default is +`localhost`. You can override the default with a personal or user macro file or +via the command line option _--smtp-host_. + Build Set Files ~~~~~~~~~~~~~~~ @@ -1779,7 +1830,8 @@ Options and arguments: --warn-all : Generate warnings --no-clean : Do not clean up the build tree --always-clean : Always clean the build tree, even with an error ---jobs : Run with specified number of jobs, default: num CPUs. +--regression : Set --no-install, --keep-going and --always-clean +---jobs : Run with specified number of jobs, default: num CPUs. --host : Set the host triplet --build : Set the build triplet --target : Set the target triplet @@ -1793,20 +1845,23 @@ Options and arguments: --log file : Log file where all build out is written too --url url[,url] : URL to look for source --no-download : Disable the source downloader +--no-install : Do not install the packages to the prefix --targetcflags flags : List of C flags for the target code --targetcxxflags flags : List of C++ flags for the target code --libstdcxxflags flags : List of C++ flags to build the target libstdc++ code --with-