bugLet me illustrate... - Bugs: bug #20207, Documentation improvements for...

 
 

You are not allowed to post comments on this tracker with your current authentication level.

bug #20207: Documentation improvements for wx-2.8.0

Submitted by:  Greg Chicares <chicares>
Submitted on:  Mon 18 Jun 2007 11:43:34 PM UTC  
 
Category: NoneSeverity: 3 - Normal
Item Group: NoneStatus: Fixed
Privacy: PublicAssigned to: Vadim Zeitlin <zeitlin>
Open/Closed: Closed

Sat 18 Jul 2009 10:51:06 AM UTC, comment #3:

BTW, we no longer use the wxLog classes this way;
see 'ChangeLog' for 20090410T1113Z, and also:

http://lists.nongnu.org/archive/html/lmi/2009-04/msg00018.html

Greg Chicares <chicares>
Project Administrator
Sat 02 Aug 2008 12:00:06 AM UTC, comment #2:

Addressing this only in wx-2.9 is fine.
We don't need it backported to wx-2.8 .

Greg Chicares <chicares>
Project Administrator
Fri 01 Aug 2008 11:49:35 PM UTC, comment #1:

As the documentation system for wx has changed in svn trunk I'd prefer to only address your points (all of which are definitely valid!) in 2.9 only and not in 2.8.

Would this be sufficient or do we really need this for 2.8 [too]?

Thanks!

Vadim Zeitlin <zeitlin>
Project MemberIn charge of this item.
Mon 18 Jun 2007 11:43:34 PM UTC, original submission:

In a mailing-list message I haven't sent yet, I'll say:

| (b) Messages written to a wxLog appear asynchronously,
| in idle time, provided that no higher-priority message
| is queued--so an "error" displaces a "warning".

At least I think that's the case.

I was sure I'd read that somewhere, but right now I can't
find it in the wx-2.8.0 help file. It was in wx-2.5.4
help for "wxLog classes overview", under "wxLogMessage":

Notice that the standard behaviour is to not show
informational messages if there are any errors later -
the logic being that the later error messages make the
informational messages preceding them meaningless.

but that's absent in wx-2.8.0 . A deliberate change?
It seemed like an important point to me. And even in the
wx-2.5.4 help file, it isn't obvious to me whether only
wxLogMessage is suppressed if a wxLogError arises before
the wxLogMessage is displayed. Would a wxLogSysError
suppress a wxLogError? Would a wxLogWarning suppress (or
be suppressed by) anything? I don't need to know this
today; I'd just like to see it in the help file (or a
technote, or wherever), because I'll probably want to
know someday.

And I had a hard time finding documentation that logs are
flushed in idle time. It's explained under wxApp::Yield();
a pointer to that in "wxLog classes overview" might help.

One last "wxLog classes overview" thought: would it be
good to provide hyperlinks for wxLogFatalError and the
other functions that are listed in boldface?

Greg Chicares <chicares>
Project Administrator

 

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -unavailable- added by chicares (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can click here to add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follow 2 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Sat 18 Jul 2009 10:51:06 AM UTCchicaresStatusNone=>Fixed
      Open/ClosedOpen=>Closed

    Back to the top


    Powered by Savane 3.1-cleanup1