Describe macports.conf setting buildmakejobs in guide

[ryandesign@…]

The guide should describe the macports.conf setting buildmakejobs. Currently it only says this:

use_parallel_build

This keyword is for specifying whether or not it is safe for a port to use multiple cpus or multiple cores in parallel during its build phase. If a port is declared to be builadble [sic] this way, the option -j N may be passed to the make command if parallel builds are enabled system-wide. This can be obtained by setting buildmakejobs in macports.conf. The integer N refers to the number of parallel build threads.

But this is in the section on writing portfiles. buildmakejobs should also be mentioned in a section on the conf file. It should also mention that setting buildmakejobs to 0 will cause MacPorts to automatically figure out how many cores or CPUs are in your computer and use that value.

[markd@…]

I clarified it in r33778, and updated macport.conf.in comments referring to buildmakejobs variable in r33776. But the macport.conf section (to become the new macports.conf.5) has not been written yet. The .conf file sections in the "MP internals" section is only intended as a summary of the configuration files present. When the macports.conf.5 file is written, the comments (or something similar) will be incorporated into the man page section and hopefully fulfill your request. Does that sound reasonable?