[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: anyone wants to help with tutorials writing?



I understand that you really like the man pages idea, and it WAS really
nice once, though it is still a fact in linux.
Still, considering the multi-level multi-dimensional multi-directional
characteristic of a good help file (where a word appears, and if you
wonder what does it mean, you can go and see, then come back, then
return to some other subject, and so on), have you consider using HTML
files?

I'm sorry to sound old_fashioned, but it seems I kinda got stuck on it
as far as we talk about help. suppose you read a manpage about 'ls' or
'find' and there is some reference at the end of the manual, but you
still want to keep searching the current. open a new vconsole? why is
that? aren't we still in the help searching thing?

I hope I made myself clear. not everything that already exists is good,
even in linux, and every good thing will always have a better thing,
still a minimal level of functionality that is oriented towards the type
of work needed by a program is not too much to ask for.

...Ziv
________________________________________________
... and in case I don't see you - 
    good afternoon, good evening and good night!
                   (Jim Carrey, The Truman Show)

> -----Original Message-----
> From:	guy keren [SMTP:choo@actcom.co.il]
> Sent:	Wednesday, January 20, 1999 00:01
> To:	linux-il@cs.huji.ac.il
> Subject:	anyone wants to help with tutorials writing?
> 
> 
> since it seems that i'm not that quick, i thought of trying to find
> some
> good soul that'll help with writing of new tutorials. two types of
> vulanteers appaer to be suitable for the job:
> 
> 1. people who want to write a tutorial about something they know
> really
>    well.
> 
> 2. people who want to learn some area of unix programming, and would
> like
>    to get some guidance, and to contribute to the community while
> doing
>    so.
> 
> the only limitations (which might sound too great to some people) is
> that
> the tutorial should be written in the same format and a similar style
> to
> those i already wrote, and that the tutorials will be free for use (i
> intend to put a "GPL-like" copyright on all the tutorials).
> 
> ideas for tutorials could be:
> 
> 1. using 'man' as a programming aid (for beginners, with tips and
>    explanations of how the unix manual and a manual page is set up,
> etc.).
> 2. unix "users" programming:  /etc/passwd (getpw*), /etc/group,
>    reading/writing to utmp and wtmp files, the basics of suid/sgid
>    programs, etc.
> 3. programming with RPC.
> 
> btw, this doe's not mean i've stopped "tutorializing". the Xlib
> tutorial
> is coming along slowly...
> 
> thanks,
> guy
> 
>