From owner-freebsd-arm@freebsd.org Sat Oct 17 06:11:24 2015 Return-Path: Delivered-To: freebsd-arm@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id E8717A17B5D; Sat, 17 Oct 2015 06:11:23 +0000 (UTC) (envelope-from russ.haley@gmail.com) Received: from mail-vk0-x235.google.com (mail-vk0-x235.google.com [IPv6:2607:f8b0:400c:c05::235]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id A565CCE0; Sat, 17 Oct 2015 06:11:23 +0000 (UTC) (envelope-from russ.haley@gmail.com) Received: by vkaw128 with SMTP id w128so79885034vka.0; Fri, 16 Oct 2015 23:11:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to:cc:content-type; bh=XIJiVC6j12PgytBTyxw+i9rVDMQshqXGWOecJL6uMjo=; b=D3F5O+RQG1YmkL/Th9NuWlRxErwkbweRD5f8QvJ7tOc38SExvqYByDd9TMdHPcvF4t UTNlfWQUjsTByua8XS9+b2ehKOR+B5Y6Kg8pDoBzPX8R3RfSE5DWCQqZPm//zN/82126 AslktgTN/TgqJjUCXbn+gAoCWKNEVgrWhk/1+RzlEwfCQtSc0Mr2MxXKwlSpsQEGL1e5 7T3aUOgpTqol9+e8ejozoQ/4qFEkhrgQN42qzQKPgD/EIpiEZATvEnh5fQxggghswIx5 nuS/gnamZQ4qHMEKxpK2qoC8/kppWcUEN8bWqCDN9dRJhkVpjs7cRFQ4LG2X7AgUtsT/ +wBA== MIME-Version: 1.0 X-Received: by 10.31.33.75 with SMTP id h72mr13126975vkh.144.1445062282597; Fri, 16 Oct 2015 23:11:22 -0700 (PDT) Received: by 10.31.66.9 with HTTP; Fri, 16 Oct 2015 23:11:22 -0700 (PDT) Date: Fri, 16 Oct 2015 23:11:22 -0700 Message-ID: Subject: Patch file for man pages netmap.4, src.conf.5, build.7 From: Russell Haley To: freebsd-arm , freebsd-doc@freebsd.org Cc: Warner Losh , Ian Lepore , John-Mark Gurney Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.20 X-BeenThere: freebsd-arm@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: "Porting FreeBSD to ARM processors." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 17 Oct 2015 06:11:24 -0000 Hi, There was a previous discussion about making some small changes to the src.conf and build man pages to include reference to src.conf.5 in the buikd.7 manpage. I have updated the two documents appropriately. I believe I also addressed Mr. Loshs' comment pertaining to the scope of the src.conf file and the format of the title. I also found a typo in netmap.4. In terms of coming up to speed with documentation, I had asked about where to find documentation about, er, documentation and started with the Documentation Primer (Why is this a "primer" and others are a "handbook"?). This seems to me to be a mistake. After claiming domain over man pages, the "primer" never mentions mdoc, groff, troff, man, mandoc or any other item that seems remotely related to man pages ever again? Please, correct me if I am wrong. I did however find the following bits of information: https://forums.freebsd.org/threads/howto-create-a-manpage-from-scratch.13200/ https://www.freebsd.org/cgi/man.cgi?query=mdoc&apropos=0&sektion=0&manpath=FreeBSD+10.2-RELEASE&arch=default&format=html http://mdocml.bsd.lv/ http://mdocml.bsd.lv/man/mdoc.7.html http://manpages.bsd.lv/ Which could be pieced nicely together to make a man pages handbook or at least a section in the "primer"? Thanks, Russell