Re: [Back it out] was: Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Tom Rhodes
On Thu, 28 Sep 2006 01:04:04 +0200 Daniel Gerzo <[EMAIL PROTECTED]> wrote: > Hello Tom, > > Thursday, September 28, 2006, 12:57:17 AM, you wrote: > > > On Wed, 27 Sep 2006 10:22:34 +0200 > > [EMAIL PROTECTED] wrote: > > > Daniel, > > > Please just back this commit out. While I don't disagree

Re: [Back it out] was: Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Daniel Gerzo
Hello Tom, Thursday, September 28, 2006, 12:57:17 AM, you wrote: > On Wed, 27 Sep 2006 10:22:34 +0200 > [EMAIL PROTECTED] wrote: > Daniel, > Please just back this commit out. While I don't disagree with > the commit, I do see at least one back out request. In the > project, we back out after

[Back it out] was: Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Tom Rhodes
On Wed, 27 Sep 2006 10:22:34 +0200 [EMAIL PROTECTED] wrote: Daniel, Please just back this commit out. While I don't disagree with the commit, I do see at least one back out request. In the project, we back out after a request if we are unable to change the requester's mind. Leaving it in is ju

cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Daniel Gerzo
danger 2006-09-27 21:28:44 UTC FreeBSD src repository (doc committer) Modified files: share/examples/mdoc example.4 Log: Revert my previous change as it does not seem to be entirely correct and popular. Revision ChangesPath 1.27 +8 -6 src/share/examples/

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Christian Brueffer
On Wed, Sep 27, 2006 at 10:49:21AM +0200, Daniel Gerzo wrote: > Quoting Ceri Davies <[EMAIL PROTECTED]>: > > > > >No, we're arguing over grammar. The sentence currently renders as > >something like: > > > > Alternatively, to load the fxp(4) as a module at boot time... > > > > I proposed the

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread John Baldwin
On Wednesday 27 September 2006 04:22, [EMAIL PROTECTED] wrote: > Quoting Christian Brueffer <[EMAIL PROTECTED]>: > > > On Tue, Sep 26, 2006 at 07:59:52PM +, Daniel Gerzo wrote: > >> danger 2006-09-26 19:59:52 UTC > >> > >> FreeBSD src repository (doc committer) > >> > >> Modified file

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread John Baldwin
On Wednesday 27 September 2006 04:45, Ceri Davies wrote: > On Wed, Sep 27, 2006 at 04:15:26AM -0400, Tom Rhodes wrote: > > On Wed, 27 Sep 2006 08:53:14 +0100 > > Ceri Davies <[EMAIL PROTECTED]> wrote: > > > > > On Wed, Sep 27, 2006 at 03:41:24AM -0400, Tom Rhodes wrote: > > > > On Tue, 26 Sep 2006

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Ruslan Ermilov
On Wed, Sep 27, 2006 at 04:54:17AM -0400, Tom Rhodes wrote: [...] > > That's wrong. Getting rid of "the" works. > > I like "enable" in the first bit, and I'll agree "the" should > go, even though your argument works in some cases but fails > in others. > I think a common sense should apply here

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Ceri Davies
On Wed, Sep 27, 2006 at 03:02:22AM -0600, Scott Long wrote: > That said, attention to detail in the docs is _always_ appreciated, > and good, open discussions are always welcomed. It's just a bit > surrealistic to watch a grammar discussion happen between a group of > non-native speakers at 3am

Re: Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Sergey Babkin
>From: [EMAIL PROTECTED] >Quoting Christian Brueffer <[EMAIL PROTECTED]>: > >> I don't agree to these changes, see below for details (also I don't see where >> exactly you removed second person usage, it's still being used in the new >> version). > >We want to aviod to use words like "you", "your"

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Joel Dahl
On Tue, 2006-09-26 at 22:23 +0200, Christian Brueffer wrote: > On Tue, Sep 26, 2006 at 07:59:52PM +, Daniel Gerzo wrote: > > danger 2006-09-26 19:59:52 UTC > > > > FreeBSD src repository (doc committer) > > > > Modified files: > > share/examples/mdoc example.4 > > Log: > >

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Scott Long
Tom Rhodes wrote: On Wed, 27 Sep 2006 03:02:22 -0600 Scott Long <[EMAIL PROTECTED]> wrote: Daniel Gerzo wrote: Quoting Ceri Davies <[EMAIL PROTECTED]>: No, we're arguing over grammar. The sentence currently renders as something like: Alternatively, to load the fxp(4) as a module at

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Tom Rhodes
On Wed, 27 Sep 2006 03:02:22 -0600 Scott Long <[EMAIL PROTECTED]> wrote: > Daniel Gerzo wrote: > > > Quoting Ceri Davies <[EMAIL PROTECTED]>: > > > >> > >> No, we're arguing over grammar. The sentence currently renders as > >> something like: > >> > >> Alternatively, to load the fxp(4) as a

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Scott Long
Daniel Gerzo wrote: Quoting Ceri Davies <[EMAIL PROTECTED]>: No, we're arguing over grammar. The sentence currently renders as something like: Alternatively, to load the fxp(4) as a module at boot time... I proposed the following change: Alternatively, to load .Ns Nm module at boot

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Tom Rhodes
On Wed, 27 Sep 2006 10:37:33 +0200 Christian Brueffer <[EMAIL PROTECTED]> wrote: > On Wed, Sep 27, 2006 at 04:15:26AM -0400, Tom Rhodes wrote: > > On Wed, 27 Sep 2006 08:53:14 +0100 > > Ceri Davies <[EMAIL PROTECTED]> wrote: > > > > > On Wed, Sep 27, 2006 at 03:41:24AM -0400, Tom Rhodes wrote: >

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Tom Rhodes
On Wed, 27 Sep 2006 09:45:14 +0100 Ceri Davies <[EMAIL PROTECTED]> wrote: > On Wed, Sep 27, 2006 at 04:15:26AM -0400, Tom Rhodes wrote: > > On Wed, 27 Sep 2006 08:53:14 +0100 > > Ceri Davies <[EMAIL PROTECTED]> wrote: > > > > > On Wed, Sep 27, 2006 at 03:41:24AM -0400, Tom Rhodes wrote: > > > > O

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Daniel Gerzo
Quoting Ceri Davies <[EMAIL PROTECTED]>: No, we're arguing over grammar. The sentence currently renders as something like: Alternatively, to load the fxp(4) as a module at boot time... I proposed the following change: Alternatively, to load .Ns Nm module at boot time... That's w

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Ceri Davies
On Wed, Sep 27, 2006 at 04:15:26AM -0400, Tom Rhodes wrote: > On Wed, 27 Sep 2006 08:53:14 +0100 > Ceri Davies <[EMAIL PROTECTED]> wrote: > > > On Wed, Sep 27, 2006 at 03:41:24AM -0400, Tom Rhodes wrote: > > > On Tue, 26 Sep 2006 22:23:39 +0200 > > > Christian Brueffer <[EMAIL PROTECTED]> wrote: >

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Christian Brueffer
On Wed, Sep 27, 2006 at 04:15:26AM -0400, Tom Rhodes wrote: > On Wed, 27 Sep 2006 08:53:14 +0100 > Ceri Davies <[EMAIL PROTECTED]> wrote: > > > On Wed, Sep 27, 2006 at 03:41:24AM -0400, Tom Rhodes wrote: > > > On Tue, 26 Sep 2006 22:23:39 +0200 > > > Christian Brueffer <[EMAIL PROTECTED]> wrote: >

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread danger
Quoting Christian Brueffer <[EMAIL PROTECTED]>: On Tue, Sep 26, 2006 at 07:59:52PM +, Daniel Gerzo wrote: danger 2006-09-26 19:59:52 UTC FreeBSD src repository (doc committer) Modified files: share/examples/mdoc example.4 Log: Remove second person from the sentece and re

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Tom Rhodes
On Wed, 27 Sep 2006 08:53:14 +0100 Ceri Davies <[EMAIL PROTECTED]> wrote: > On Wed, Sep 27, 2006 at 03:41:24AM -0400, Tom Rhodes wrote: > > On Tue, 26 Sep 2006 22:23:39 +0200 > > Christian Brueffer <[EMAIL PROTECTED]> wrote: > > > > > | @@ -33,11 +33,9 @@ > > > > | .Nm example > > > > | .Nd "ex

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Ceri Davies
On Wed, Sep 27, 2006 at 03:41:24AM -0400, Tom Rhodes wrote: > On Tue, 26 Sep 2006 22:23:39 +0200 > Christian Brueffer <[EMAIL PROTECTED]> wrote: > > > | @@ -33,11 +33,9 @@ > > > | .Nm example > > > | .Nd "example device driver manual page" > > > | .Sh SYNOPSIS > > > | -To compile the > > > | -.

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Tom Rhodes
On Tue, 26 Sep 2006 22:23:39 +0200 Christian Brueffer <[EMAIL PROTECTED]> wrote: > On Tue, Sep 26, 2006 at 07:59:52PM +, Daniel Gerzo wrote: > > danger 2006-09-26 19:59:52 UTC > > > > FreeBSD src repository (doc committer) > > > > Modified files: > > share/examples/mdoc example

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-27 Thread Ceri Davies
On Tue, Sep 26, 2006 at 10:23:39PM +0200, Christian Brueffer wrote: > On Tue, Sep 26, 2006 at 07:59:52PM +, Daniel Gerzo wrote: > > danger 2006-09-26 19:59:52 UTC > > > > FreeBSD src repository (doc committer) > > > > Modified files: > > share/examples/mdoc example.4 > > Log:

Re: cvs commit: src/share/examples/mdoc example.4

2006-09-26 Thread Christian Brueffer
On Tue, Sep 26, 2006 at 07:59:52PM +, Daniel Gerzo wrote: > danger 2006-09-26 19:59:52 UTC > > FreeBSD src repository (doc committer) > > Modified files: > share/examples/mdoc example.4 > Log: > Remove second person from the sentece and rephrase a bit. > > Approved by:

cvs commit: src/share/examples/mdoc example.4

2006-09-26 Thread Daniel Gerzo
danger 2006-09-26 19:59:52 UTC FreeBSD src repository (doc committer) Modified files: share/examples/mdoc example.4 Log: Remove second person from the sentece and rephrase a bit. Approved by: trhodes (mentor), keramida (mentor) Revision ChangesPath 1.26 +6

cvs commit: src/share/examples/mdoc example.4

2006-09-18 Thread Ruslan Ermilov
ru 2006-09-18 15:18:54 UTC FreeBSD src repository Modified files: share/examples/mdoc example.4 Log: Fix wording to what I intended originally. Revision ChangesPath 1.25 +5 -4 src/share/examples/mdoc/example.4 __

cvs commit: src/share/examples/mdoc example.4

2006-09-18 Thread Ruslan Ermilov
ru 2006-09-18 11:56:51 UTC FreeBSD src repository Modified files: share/examples/mdoc example.4 Log: - Avoid using second person. - Demonstrate how .Nm can be used without the side effect of causing a line break in the SYNOPSIS section. Revision ChangesPath

cvs commit: src/share/examples/mdoc example.4

2006-06-05 Thread Christian Brueffer
brueffer2006-06-05 19:31:57 UTC FreeBSD src repository Modified files:(Branch: RELENG_6) share/examples/mdoc example.4 Log: MFC: rev. 1.23 Make this example more real world usable: When the manpage first appeared is not interesting, when the driver appeared is.

cvs commit: src/share/examples/mdoc example.4

2006-05-20 Thread Christian Brueffer
brueffer2006-05-20 09:49:05 UTC FreeBSD src repository Modified files: share/examples/mdoc example.4 Log: Make this example more real world usable: When the manpage first appeared is not interesting, when the driver appeared is. Most people who use this example leave the m

cvs commit: src/share/examples/mdoc example.4

2006-04-04 Thread Christian Brueffer
brueffer2006-04-04 20:58:53 UTC FreeBSD src repository Modified files:(Branch: RELENG_6) share/examples/mdoc example.4 Log: MFC: rev. 1.22 Add a standard boilerplate to the SYNOPSIS section that mentions how to load a kernel module. Approved by:re (hrs)

cvs commit: src/share/examples/mdoc example.4

2006-04-01 Thread Christian Brueffer
brueffer2006-04-01 10:10:37 UTC FreeBSD src repository Modified files: share/examples/mdoc example.4 Log: Add a standard boilerplate to the SYNOPSIS section that mentions how to load a kernel module. MFC after: 3 days Revision ChangesPath 1.22 +13 -1