Re: Documentation Wish - was Re: AppKit source available as reference
Re: Documentation Wish - was Re: AppKit source available as reference
- Subject: Re: Documentation Wish - was Re: AppKit source available as reference
- From: "Simon Stapleton" <email@hidden>
- Date: Mon, 02 Jul 2001 09:37:14 +0100
Another #0.02 - What about texinfo? I'd LOVE to have texinfo docs.
Browse the info files from either the info browser (light, with
hyperlinks), or rip the whole damn lot out to TeX and print out beee-
yootiful documentation (on the company laser, obviously).
Plus, I'd be able to read the docs alogside my code, all from Emacs.
Which would rock.
Like I said, just #0.02, and maybe not even worth that.
>
From: Michael Dagate <email@hidden>
>
To: email@hidden
>
Subject: Re: Documentation Wish - was Re: AppKit source available
>
as
>
reference?
>
>
Granted that Help Viewer.app sucks hard ;), HTML is not
>
necessarily bad
>
for documentation. It works for the zillions of web pages on the
>
Internet and it hyperlinks well. The problem seems to be one of
>
content
>
(too little) and implementation (too much info on one page).
>
Smaller
>
pages, more links and a separate frame with a Table of Contents
>
would
>
speed navigation tremendously. Better scrolling with arrow and
>
pgup/pgdn
>
keys and the ability to select, copy and paste text would be nice
>
also!
>
>
Ideally, you should be able to highlight a class name or method in
>
>
Project Builder, click Command-something and go right to the
>
document
>
for that class or method. In addition, Project Builder could offer
>
an
>
auto-complete feature that helps you write code. That is, it could
>
>
prompt you with variable and method names where appropriate. For
>
example, a pop-up list can show you all the methods available for
>
a
>
given object (as you type, the list would filter and shrink based
>
on
>
your typing). Then, after selecting a method, a tool tip would
>
appear to
>
help you with the parameters.
>
>
Just my $0.02 worth :)
>
Michael
Simon
--
Your mouse has moved. You must reboot Windows NT for these changes to be
recognised.
This message was sent by Easymail -
http://www.easynet.co.uk/