From owner-freebsd-current@freebsd.org Sun Oct 29 16:38:29 2017 Return-Path: Delivered-To: freebsd-current@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 77812E464A1 for ; Sun, 29 Oct 2017 16:38:29 +0000 (UTC) (envelope-from cy.schubert@komquats.com) Received: from smtp-out-no.shaw.ca (smtp-out-no.shaw.ca [64.59.134.9]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "Client", Issuer "CA" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 39DA483FA5; Sun, 29 Oct 2017 16:38:28 +0000 (UTC) (envelope-from cy.schubert@komquats.com) Received: from spqr.komquats.com ([96.50.22.10]) by shaw.ca with SMTP id 8qbReOF2zI8mC8qbSeyuT0; Sun, 29 Oct 2017 10:38:27 -0600 X-Authority-Analysis: v=2.2 cv=HahkdmM8 c=1 sm=1 tr=0 a=jvE2nwUzI0ECrNeyr98KWA==:117 a=jvE2nwUzI0ECrNeyr98KWA==:17 a=8nJEP1OIZ-IA:10 a=02M-m0pO-4AA:10 a=6I5d2MoRAAAA:8 a=YxBL1-UpAAAA:8 a=cC0HMT5ZxCGGPxlH05MA:9 a=wPNLvfGTeEIA:10 a=IjZwj45LgO3ly-622nXo:22 a=Ia-lj3WSrqcvXOmTRaiG:22 Received: from slippy.cwsent.com (slippy [10.1.1.91]) by spqr.komquats.com (Postfix) with ESMTPS id 8B36417A; Sun, 29 Oct 2017 09:38:25 -0700 (PDT) Received: from slippy (localhost [127.0.0.1]) by slippy.cwsent.com (8.15.2/8.15.2) with ESMTP id v9TGcPIk023700; Sun, 29 Oct 2017 09:38:25 -0700 (PDT) (envelope-from Cy.Schubert@cschubert.com) Message-Id: <201710291638.v9TGcPIk023700@slippy.cwsent.com> X-Mailer: exmh version 2.8.0 04/21/2012 with nmh-1.6 Reply-to: Cy Schubert From: Cy Schubert X-os: FreeBSD X-Sender: cy@cwsent.com X-URL: http://www.cschubert.com/ To: Ian Lepore cc: Allan Jude , freebsd-current@freebsd.org Subject: Re: FreeBSD Documentation In-Reply-To: Message from Ian Lepore of "Sun, 29 Oct 2017 10:17:12 -0600." <1509293832.21609.7.camel@freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Date: Sun, 29 Oct 2017 09:38:25 -0700 X-CMAE-Envelope: MS4wfMRYE3wy4fVqSyOSe1dY5qW6X62c2s9zcwiwr22vaS3/SRNlFAek+U5q2YQkrA6vpspEK9Mv6Ij+EGvQhnc6e+RVjaPh7sNgwbppPC3tbqMMmI0JO5Ua fA57DmpSdiJC6CBvhSlpEEymTv/8m//Ko1FKZyzhz2gDeuCXoRbGwGTK67T4S90lcQPxrDI7WlFije1bDcx5PzGzPAaCfbpm0xZVO/k/9v3xDPXj+vKiqMwV +ZNsYQhZrB4yVErWYUeqUw== X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Oct 2017 16:38:29 -0000 In message <1509293832.21609.7.camel@freebsd.org>, Ian Lepore writes: > On Sun, 2017-10-29 at 11:37 -0400, Allan Jude wrote: > > On 2017-10-29 11:00, Kurt Jaeger wrote: > > > > > > Hi! > > > > > > > > > > > How can we suggest edits for the docs? > > > Checkout the docs repo: > > > > > >   svn checkout https://svnweb.freebsd.org/doc/head/ . > > > > > > Change the relevant files, create a new problem report on > > > > > >   https://bugs.freebsd.org/ > > > > > > and attach the svn diff to that problem report. > > > > > Since the document in question is a man page, it actually lives in > > the > > src tree. > > > > svn checkout https://svn.freebsd.org/base/head/ . > > > > cd usr.sbin/jail > > > > vi jail.8 > > > > svn diff > jail_manpage.patch > > > > And then attach that patch to a bugzilla, or upload it to > > reviews.freebsd.org > > > > > > I hope I'm right in thinking that just submitting the proposed changes > as plain text would also be an option?  I suspect there are more people > with good ideas on improving manpages than there are people who've > decided they really want to learn the arcane skill of manpage markup > language. That's a useful skill too. Not just here but in Solaris, AIX and Linux. IMO every sysadmin should have a rudimentary nroff markup skill. But if the markup is indeed an impediment, just sending in text will work too. -- Cheers, Cy Schubert FreeBSD UNIX: Web: http://www.FreeBSD.org The need of the many outweighs the greed of the few.