Ideas for the doxydocs

[Francesco Montorsi]

Bryan Petty ha scritto:
> On 3/4/08, Francesco Montorsi <f18m_cpp217828 at yahoo.it> wrote:
>> should I assume that the page linked above is already ok?
> 
> Looks fine here, the version of Mac OS X pretty much defines the theme
> used.
good

> More generally, just specifying 10.5 would be fine. It would be
> preferable to have all screenshots under 10.5, though I think many are
> still working off of 10.4 (such as myself), so not as many people will
> be available to submit screenshots. Honestly though, I'm not sure how
> much of a difference there is between the two, I don't think there is
> much of one when it comes to the core widgets.
good; I'll set 10.4 and 10.5 as the "allowed" versions for MacOsX.


>>  Maybe we should add screenshots for a larger number of controls?
> 
> I was thinking that this should hold off until the rest of the manual
> is finished. This is delaying the conversion some, and the sooner
> we're finished with the original contents of the manual, the sooner we
> can stop worrying about out of sync edits (not that there would be
> many even if we hadn't finished this conversion for another couple
> months, but I'd feel better if the important parts were finished
> first, we wouldn't be holding up a 2.9.0 release).
I agree.


> Aside from that though, I'm still hesitant about how many screenshots
> we add to the manual. My HTML version of the manual is already bigger
> than the LaTeX HTML version (compressed), and I only have half of the
> classes in my version, and many of those still don't have any attached
> documentation. We're going to easily double the size of the manual
> download with the conversion to Doxygen already. I would like to see
> screenshots in the manual, but they should really be kept to a
> minimum, as in just the classes that it really helps to have them.
ok, let's see how big becomes the manual with those screenshots before 
adding more.

Francesco