Go Back   ZeroC Forums > Comments

Reply
 
LinkBack Thread Tools Rate Thread Display Modes
  #1 (permalink)  
Old 03-03-2003
Ken Carpenter Ken Carpenter is offline
Registered User
 
 
Join Date: Feb 2003
Location: Vancouver, B.C., Canada
Posts: 31
Minor Documentation Corrections

Hi Michi,

Here are a few more minor corrections to the documentation. By the way, I got a sense of deja vu reading this document! The organization and some of the diagrams seemed really familiar, so I pulled out my copy of Adv. CORBA Programming with C++. Ice provides not only code reuse, but also documentation reuse!

I really have to thank you for writing that book. After seeing the nasty CORBA C++ mapping I ran shrieking in the opposite direction! Ice looks much nicer.

Corrections:

- TOC page numbers need to be regenerated

- Label the page numbers of the PDF (Document->Number Pages...) so you can go directly to a logical page number with the page number edit box at the bottom of the Acrobat Window.

- Section 19.4.1, page 479:
"So that the service manager to load it properly" --> "So that the service manager CAN load it properly"

- Section 14.5 Mutexes, page 301 (under the "lock" bullet):
"the calling threads has acquired" --> "the calling THREAD has acquired"

- Section 14.8 Timed Locks, page 313, first sentence:
"functions the operate" --> "functions THAT operate"

- Section 14.9 Monitors, page 316, first paragraph:
"when condition becomes true" --> "when A condition becomes true"

- Section 14.9 Monitors, page 317, first paragraph after code block:
"Note that Monitor is template class" --> "Note that Monitor is A template class"

- Section 14.9 Monitors, page 320, second paragraph after code block:
"template class with automatically locks" --> "template class WHICH automatically locks"

- Appedix D.1 Proxies, page 696, 3rd-to-last paragraph:
The first sentence is left incomplete. Looks like it's missing an XREF.



Ken Carpenter
Reply With Quote
  #2 (permalink)  
Old 03-03-2003
michi's Avatar
michi michi is offline
ZeroC Staff
 
Name: Michi Henning
Organization: ZeroC
Project: Ice
 
Join Date: Feb 2003
Location: Brisbane, Australia
Posts: 891
Re: Minor Documentation Corrections

Quote:
Originally posted by Ken Carpenter

Here are a few more minor corrections to the documentation. By the way, I got a sense of deja vu reading this document! The organization and some of the diagrams seemed really familiar, so I pulled out my copy of Adv. CORBA Programming with C++. Ice provides not only code reuse, but also documentation reuse!
Hi Ken,

Yes, there is some reuse in the book, in style and organization. Basically, it worked for the first book, so I figured it would work for the second one

Quote:
I really have to thank you for writing that book. After seeing the nasty CORBA C++ mapping I ran shrieking in the opposite direction! Ice looks much nicer.
Thanks, glad you like it! Yes, the CORBA C++ mapping really is an abomination. The complexity of that thing is insane, and totally unnecessary. Historically, what happened was that there were two competing submissions for the C++ mapping, the one we have now and one by Hyperdesk. The Hyperdesk mapping was much more like the Ice mapping in look and feel. Unfortunately, people decided to benchmark the two mappings and found that the Hyperdesk one was five times slower than the raw C++ mapping we have. So, they decided to adopt the abomination we have now.

The joke is that the speed difference is artificial: the raw mapping does very little, so the application ends up having to do all the things that should be done by the mapping. It turns out that these are the expensive things (such as hitting the memory allocator all the time). In other words, the actual speed difference is almost non-existent when you benchmark the mappings correctly, instead of comparing apples and oranges...

Quote:
Corrections:

- TOC page numbers need to be regenerated

- Label the page numbers of the PDF (Document->Number Pages...) so you can go directly to a logical page number with the page number edit box at the bottom of the Acrobat Window.
We had some problems with the TOC -- I don't know why the page numbers have this nasty habit of going out of sync. We'll fix it for the next version.

Thanks for the suggestion about the PDF page numbers -- I'll do that for the next version as well.

Thanks for all the other corrections -- they'll be fixed in the next version.

Cheers,

Michi.
Reply With Quote
  #3 (permalink)  
Old 03-03-2003
Ken Carpenter Ken Carpenter is offline
Registered User
 
 
Join Date: Feb 2003
Location: Vancouver, B.C., Canada
Posts: 31
Re: Re: Minor Documentation Corrections

Quote:
Originally posted by michi
Thanks for the suggestion about the PDF page numbers -- I'll do that for the next version as well.
You'll want to number the first 15 pages with roman numerals (as you have already in the actual page contents), otherwise when you type in 5, for example, it will still go to the 5th physical page.

Ken Carpenter
Reply With Quote
  #4 (permalink)  
Old 03-03-2003
michi's Avatar
michi michi is offline
ZeroC Staff
 
Name: Michi Henning
Organization: ZeroC
Project: Ice
 
Join Date: Feb 2003
Location: Brisbane, Australia
Posts: 891
Re: Re: Re: Minor Documentation Corrections

Quote:
Originally posted by Ken Carpenter
You'll want to number the first 15 pages with roman numerals (as you have already in the actual page contents), otherwise when you type in 5, for example, it will still go to the 5th physical page.
Yep, I worked that out, no sweat

Cheers,

Michi.
Reply With Quote
Reply



Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Thread Tools
Display Modes Rate This Thread
Rate This Thread:

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

vB code is On
Smilies are On
[IMG] code is Off
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are On

Similar Threads
Thread Thread Starter Forum Replies Last Post
Minor IceStorm enhancements joe Comments 4 05-22-2006 02:29 AM
Minor typos in Ice 3.0.1 manual bartley Comments 0 02-14-2006 02:46 PM
A (very) minor gift as a thank you! SteveWampler Patches 2 01-21-2004 08:52 AM
Minor problem with Ice 1.2.0 on Win 2000 weida Bug Reports 1 10-29-2003 10:00 AM
Minor i386 fixes rodrigc Patches 3 03-07-2003 03:50 PM


All times are GMT -4. The time now is 04:17 PM.


Powered by vBulletin® Version 3.6.4
Copyright ©2000 - 2008, Jelsoft Enterprises Ltd.
Search Engine Optimization by vBSEO 3.0.0
(c) 2008 ZeroC, Inc.