svn commit: r253002 - head

[Alfred Perlstein]

On 7/7/13 2:40 PM, Andriy Gapon wrote:
> on 08/07/2013 00:15 Alfred Perlstein said the following:
>> On 7/7/13 2:01 PM, Garrett Cooper wrote:
>>> Why the magic number 12?
>> Numbers higher seem to result in worse performance as reported by some members
>> of my team.
> Should we really commit all "notes to self" or "my team's knowledge base" to
> FreeBSD source code like this?

I would hope so!  At least in comments, that way we can all help each other.

Otherwise each time another person comes along they are subject to 
having to discover the same things that I did.

What is the point of listing 10+ make targets if someone coming in 
doesn't know which ones to run and how to run them optimally in order to 
ensure a safe build?  Do you not agree that more of this sort of 
documentation should be in the code instead of having to ask on IRC?

For the record I checked multiple pages in developer primer and scoured 
makefiles for a while before giving up and asking on IRC.  I figured it 
would be helpful for the next clueless goon that came in and tried to 
make things better if I recorded my experience to guide them.

I hold no strong feelings towards the comments, other than they should 
be preserved in some form, or maybe even turned into a workable target 
for people that don't want or can not hold all that context in their brains.

-Alfred


>
>>> On Jul 7, 2013, at 1:39 PM, Alfred Perlstein <alfred at FreeBSD.org> wrote:
>>>
>>>> Author: alfred
>>>> Date: Sun Jul  7 20:39:11 2013
>>>> New Revision: 253002
>>>> URL: http://svnweb.freebsd.org/changeset/base/253002
>>>>
>>>> Log:
>>>>    Document tip on how to build all kernels quickly.
>>>>
>>>> Modified:
>>>>    head/Makefile
>>>>
>>>> Modified: head/Makefile
>>>> ==============================================================================
>>>> --- head/Makefile    Sun Jul  7 19:58:14 2013    (r253001)
>>>> +++ head/Makefile    Sun Jul  7 20:39:11 2013    (r253002)
>>>> @@ -32,6 +32,12 @@
>>>> # targets             - Print a list of supported TARGET/TARGET_ARCH pairs
>>>> #                       for world and kernel targets.
>>>> # toolchains          - Build a toolchain for all world and kernel targets.
>>>> +#
>>>> +# "quick" way to test all kernel builds:
>>>> +#    _jflag=`sysctl -n hw.ncpu`
>>>> +#    _jflag=$(($_jflag * 2))
>>>> +#    [ $_jflag -gt 12 ] && _jflag=12
>>>> +#    make universe -DMAKE_JUST_KERNELS JFLAG=${jflag}
>>>> #
>>>> # This makefile is simple by design. The FreeBSD make automatically reads
>>>> # the /usr/share/mk/sys.mk unless the -m argument is specified on the
>>>> _______________________________________________
>>>> svn-src-head at freebsd.org mailing list
>>>> http://lists.freebsd.org/mailman/listinfo/svn-src-head
>>>> To unsubscribe, send any mail to "svn-src-head-unsubscribe at freebsd.org"
>