FreeBSD Documentation

[Cy Schubert]

In message <1509293832.21609.7.camel at 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 <Cy.Schubert at cschubert.com>
FreeBSD UNIX:  <cy at FreeBSD.org>   Web:  http://www.FreeBSD.org

	The need of the many outweighs the greed of the few.