Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 6 Feb 2007 10:32:03 -0500
From:      Bill Moran <wmoran@collaborativefusion.com>
To:        "Jim Stapleton" <stapleton.41@gmail.com>
Cc:        freebsd-questions@freebsd.org
Subject:   Re: I'd like to do my bit to support FreeBSD
Message-ID:  <20070206103203.2af028f5.wmoran@collaborativefusion.com>
In-Reply-To: <80f4f2b20702060716s72ee39c9j7efc25cb9ea370d3@mail.gmail.com>
References:  <80f4f2b20702060716s72ee39c9j7efc25cb9ea370d3@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help
In response to "Jim Stapleton" <stapleton.41@gmail.com>:
> I've found quite a few tricks and techniques for handling FreeBSD's
> ports system when things go south. I'd like to add them to the
> handbook, adding, lets say "4.5.6 - When Ports Attack".
> 
> OK, really it'd be more along the lines of "4.5.6 - Installing Ports
> When Things Go Wrong"
> 
> It would give hints that I've aquired over time from the mailing list,
> or my own use:
> 1) config-recursive (my most recent gem aquired from you nice people!)
> 2) Keeping flag-sets in your make.conf (basically several sets of
> CFLAGS/CXXFLAGS, so if something fails, you can quickly try something
> else)
> 3) How to remove a broken dependancy (read: how to figure the next
> port up, the list, and then configure that port to remove the
> dependancy)
> 4) Rolling back your ports tree to an earlier date or dates, but
> globally or one port at a time
> 5) determining which step will fix your problem.
> 
> 
> Now, as far as I know this would requre:
> 1) Downloading the doc group of the ports tree to it's own special
> directory, keeping the CVS flags in tact - I should be able to do this
> 2) Editing the file of interest - trivial beyond belief
> 3) ??Generating the file??

Start here:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html

As you read through that, you'll probably be pleasantly surprised how
well organized and automated everything is.  I know I was.

> 4) ??Submitting the diffs??

Also covered in the above link.

Once you've generated your docs (step #3) you can post your modified
copy to your personal website and direct people to it to get feedback
and suggestions.  There's also a dedicated mailing list for the
documentation project:
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
which was very helpful when I was doing my first submits.

Thanks for stepping up to help out!

-- 
Bill Moran
Collaborative Fusion Inc.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20070206103203.2af028f5.wmoran>