FreeBSD Documentation

[Ngie Cooper]

> On Oct 29, 2017, at 13:53, Rodney W. Grimes <freebsd-rwg at pdx.rh.CN85.dnsmgr.net> wrote:
> 
> -- Start of PGP signed section.
> [ Charset UTF-8 unsupported, converting... ]
>>> 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
> 
> Lets make this MUCH easier on a user.....
> cp /usr/share/man/man8/jail.8.gz /tmp
> cd /tmp
> gzip -d jail.8.gz
> cp -p jail.8 jail.8.orig
> vi jail.8
> diff -u jail.8.orig jail.8 >jail.8.patch
> 
> And then attach that patch to a bugzilla....
> 
> More commands, but much shorter amount of time.
> 
> (Of cource broken if your system is not -current or close to it)

No. Just do a sparse checkout of share/man/man8 ... less error prone and one has a usable diff instead of a diff that might contain local modifications, or be a few revisions behind.

> -- 
> Rod Grimes                                                 rgrimes at freebsd.org
> _______________________________________________
> freebsd-current at freebsd.org mailing list
> https://lists.freebsd.org/mailman/listinfo/freebsd-current
> To unsubscribe, send any mail to "freebsd-current-unsubscribe at freebsd.org"