Bug 66540

Summary: [patch] share/man/man4/ppbus.4 wording nits
Product: Documentation Reporter: Michel Lavondes <fox>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Michel Lavondes 2004-05-11 18:40:23 UTC
Patch says it all, really.

Fix: Patch also available from http://www.livejournal.com/users/pauamma/1911.html
How-To-Repeat: man 4 ppbus
Comment 1 Roman Neuhauser 2004-05-11 20:37:53 UTC
# fox@vader.aacc.cc.md.us / 2004-05-11 10:38:23 -0700:
> --- share/man/man4/ppbus.4.orig	Fri May  7 07:43:07 2004
> +++ share/man/man4/ppbus.4	Fri May  7 08:06:15 2004
> @@ -213,7 +213,7 @@
>  modes.
>  The computer acts as master and the peripheral as slave.
>  .Pp
> -Any transfer is defined as a finite state automate.
> +Any transfer is defined as a finite state machine.

    s/automate/automaton/ would be... more faithful to the original? :)
    (ESL, so I might be babbling)

-- 
FreeBSD 4.9-RELEASE-p2
9:36PM up 13:57, 4 users, load averages: 0.13, 0.07, 0.02
Comment 2 Michel Lavondes 2004-05-11 20:58:53 UTC
On Tue, 11 May 2004, Roman Neuhauser wrote:

> # fox@vader.aacc.cc.md.us / 2004-05-11 10:38:23 -0700:
> > --- share/man/man4/ppbus.4.orig	Fri May  7 07:43:07 2004
> > +++ share/man/man4/ppbus.4	Fri May  7 08:06:15 2004
> > -Any transfer is defined as a finite state automate.
> > +Any transfer is defined as a finite state machine.
> 
>     s/automate/automaton/ would be... more faithful to the original? :)
>     (ESL, so I might be babbling)

Mebbe, but even then, I'd go for "finite state machine" as the more common 
English idiom. This is tech writing, not high litterature that has to be 
translated painstakingly for beauty and fidelity. :-)

-- 
"I'd ask if you'd found the right sort of isolated wasteland for your
citadel of dread yet, but that would be a silly question; you're in Utah,
after all." --ESR to Darl McBride (Chief Excessive Ossifier of Squandered 
Clues Obstination), in http://www.catb.org/~esr/writings/mcbride.html
Comment 3 Simon L. B. Nielsen freebsd_committer freebsd_triage 2004-05-11 21:27:13 UTC
On 2004.05.11 13:00:41 -0700, fox@vader.aacc.cc.md.us wrote:
>  On Tue, 11 May 2004, Roman Neuhauser wrote:
>  
>  > # fox@vader.aacc.cc.md.us / 2004-05-11 10:38:23 -0700:
>  > > --- share/man/man4/ppbus.4.orig	Fri May  7 07:43:07 2004
>  > > +++ share/man/man4/ppbus.4	Fri May  7 08:06:15 2004
>  > > -Any transfer is defined as a finite state automate.
>  > > +Any transfer is defined as a finite state machine.
>  > 
>  >     s/automate/automaton/ would be... more faithful to the original? :)
>  >     (ESL, so I might be babbling)
>  
>  Mebbe, but even then, I'd go for "finite state machine" as the more common 
>  English idiom. This is tech writing, not high litterature that has to be 
>  translated painstakingly for beauty and fidelity. :-)


Without having read the manual page in question in detail I think the
original is probably almost OK, except that it should be "automata".
That is a rather common term used in computer science.

-- 
Simon L. Nielsen
FreeBSD Documentation Team
Comment 4 Michel Lavondes 2004-05-11 22:00:46 UTC
On Tue, 11 May 2004, Simon L. Nielsen wrote:

> On 2004.05.11 13:00:41 -0700, fox@vader.aacc.cc.md.us wrote:
> >  
> > finite state "automate"/machine/automaton
> 
> Without having read the manual page in question in detail I think the
> original is probably almost OK, except that it should be "automata".
> That is a rather common term used in computer science.

I think automata is a plural, but I don't really care which wording you
settle on. I just report them as/when I sees them. :-)

-- 
"I'd ask if you'd found the right sort of isolated wasteland for your
citadel of dread yet, but that would be a silly question; you're in Utah,
after all." --ESR to Darl McBride (Chief Excessive Ossifier of Squandered 
Clues Obstination), in http://www.catb.org/~esr/writings/mcbride.html
Comment 5 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-08 17:27:37 UTC
State Changed
From-To: open->closed

Committed, thanks! 


Comment 6 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-08 17:27:37 UTC
Responsible Changed
From-To: freebsd-doc->keramida

I'll MFC this in a few days.