Mail Archives: cygwin/2002/04/03/23:35:26
On Wed, Apr 03, 2002 at 08:31:37PM -0800, Joshua Daniel Franklin wrote:
>I was thinking about (end-user) documentation. It seems like there are quite
>a few questions that come up about "What kind of UNIX is Cygwin?" and more
>than once there have been questions about a "man intro" page.
>I know a little groff and I'm thinking of making a collection of
>cygwin-specific
>manpages. Since the full documentation is on the web the manpages could point
>that direction (like the GNU manpages point to info).
>I might start out with a "man intro" page and manpages for the cygwin utils
>and cygwin_foo() functions, as already documented on the website. What I'm
>looking for is feedback on the intro.1 page, which might include:
>
>--URL of the User's Guide
>--the description from the website about "A DLL (cygwin1.dll) that acts as a
> UNIX emulation layer..."
>--emphasis on GNU tools which make the cygwin environment more similar to
> GNU/Linux or GNU/Hurd than, say, Solaris
>--that cygwin is NOT any one UNIX and the importance of the SUSv2 (with URL)
>--SEE ALSO: cygcheck, cygpath, etc.
>--???
>
>Obviously this is not real writing but just points to make on the page. I'll
>post a draft here also.
I think this is a wonderful idea. Can I sign you up to improve the
documentation, too? I'm sure that a lot of it is out of date or needs
more details.
It would be nice if most of it was available in info format, too.
However, I keep asking for volunteers for this so I know I can't be
choosy. If you're willing to provide man pages, they would be much
appreciated.
I wonder if we should nuke the newlib man pages in the process and just
make one cygwin-man package containing everything.
cgf
--
Unsubscribe info: http://cygwin.com/ml/#unsubscribe-simple
Bug reporting: http://cygwin.com/bugs.html
Documentation: http://cygwin.com/docs.html
FAQ: http://cygwin.com/faq/
- Raw text -