Bug 55397

Summary: (no subject)
Product: Documentation Reporter: Kirill Ponomarev <krion>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Kirill Ponomarev freebsd_committer freebsd_triage 2003-08-08 20:40:09 UTC 
Typo in developers-handbook

Fix: ===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml,v
retrieving revision 1.30
Comment 1 Bruce A. Mah freebsd_committer freebsd_triage 2003-08-08 20:43:32 UTC 
If memory serves me right, Kirill Ponomarew wrote:

>  <chapter id="tools">
> @@ -1831,7 +1831,7 @@
>        <para>Instead of using a proprietary macro language for
>  	configuration, Emacs uses a version of Lisp specially adapted
>  	for editors, known as Emacs Lisp.  This can be quite useful if
> -	you want to go on and learn something like Common Lisp, as
> +	you want to go on and learn something like Emacs Lisp, as
>  	it is considerably smaller than Common Lisp (although still
>  	quite big!).</para>

Hmmm...the original text looks fine to me.  Why do you want to make 
this change?

Bruce.
Comment 2 Kirill Ponomarev freebsd_committer freebsd_triage 2003-08-08 20:45:59 UTC 
Hi,

On Fri, Aug 08, 2003 at 12:43:32PM -0700, Bruce A. Mah wrote:
> If memory serves me right, Kirill Ponomarew wrote:
> 
> >  <chapter id="tools">
> > @@ -1831,7 +1831,7 @@
> >        <para>Instead of using a proprietary macro language for
> >  	configuration, Emacs uses a version of Lisp specially adapted
> >  	for editors, known as Emacs Lisp.  This can be quite useful if
> > -	you want to go on and learn something like Common Lisp, as
> > +	you want to go on and learn something like Emacs Lisp, as
> >  	it is considerably smaller than Common Lisp (although still
> >  	quite big!).</para>
> 
> Hmmm...the original text looks fine to me.  Why do you want to make 
> this change?


Erm:

This can be quite useful if you want to go on and learn
something like Common Lisp, as it is considerably smaller than
Common Lisp.

I mean this sentence doesn't make too much sense for me ;-)

What do you think ?

-Kirill
Comment 3 Bruce A. Mah freebsd_committer freebsd_triage 2003-08-08 20:53:14 UTC 
If memory serves me right, Kirill Ponomarew wrote:

> This can be quite useful if you want to go on and learn
> something like Common Lisp, as it is considerably smaller than
> Common Lisp.
> 
> I mean this sentence doesn't make too much sense for me ;-)

OK.  The original meaning of the sentence is correct but it's just very
unclear (your patch actually changed the meaning of the sentence).  How
about:

Working with Emacs Lisp can be quite helpful if you want to go on and
learn something like Common Lisp.  Emacs Lisp has many features of
Common Lisp, although it is considerably smaller and thus easier to
master.

(This changes the meaning of the sentence too, but it's consistent with 
my understanding of the situation.)

Bruce.
Comment 4 Kirill Ponomarev freebsd_committer freebsd_triage 2003-08-08 20:57:08 UTC 
Hi,

On Fri, Aug 08, 2003 at 12:53:14PM -0700, Bruce A. Mah wrote:
 
> OK.  The original meaning of the sentence is correct but it's just very
> unclear (your patch actually changed the meaning of the sentence).  How
> about:
> 
> Working with Emacs Lisp can be quite helpful if you want to go on and
> learn something like Common Lisp.  Emacs Lisp has many features of
> Common Lisp, although it is considerably smaller and thus easier to
> master.
> 
> (This changes the meaning of the sentence too, but it's consistent with 
> my understanding of the situation.)


Yes, your version is very good. Thank you ;-)

-Kirill
Comment 5 Bruce A. Mah freebsd_committer freebsd_triage 2003-08-08 21:38:23 UTC 
State Changed
From-To: open->closed

Committed my variation of this text.  Thanks for pointing this 
problem out!