documentation clarification

Kevin D. Kinsey, DaleCo, S.P. kdk at daleco.biz
Tue Aug 3 22:04:15 UTC 2004


Allon Stern wrote:

> where does one send corrections/clarifications for documentation 
> related to FreeBSD?
>

I'm not expert, and don't play one on TV, but this
seems to work pretty well:

1.  Find the offending source file and make a copy.

2.  Edit the copied file as desired, keeping appropriate
    SGML tags, etc., in place.

3.  Create a patch:

       diff -nu sourcefile myedit > sourcefile.patch

4.  Create a problem report using send-pr(1), and
    include the patch inline after the pre-formatted
    stuff.  Your PR's title string should be something
    like this:

    (PATCH) foobar(1) seg faults when used with "-R" switch
    or:
    (PATCH) fix of spelling errors in handbook chapter 3

Specific guidelines for the documentation team (that
you would probably want to read, also) are in the "FDP
Primer"  [/usr/share/doc/en/books/fdp-primer; also available
at the www site].

Kevin Kinsey



More information about the freebsd-doc mailing list