Re(4): [Ilugc] Volunteers? New man page doc project

  • From: arvy@xxxxxxxxxxx (Arvind Kalyan)
  • Date: 28 Apr 2004 22:28:37 +0530

do `info libc` and see how many examples you get. Just for an
example. Info pages are giving you almost the complete details (usage,
specifications, limits etc). 

Its inappropriate to say that info pages dont give you examples :)

its the `man` which gives you the explanation for the options, which
is how it should be. I dont want to be shown the examples each time I
want to have a quick look at the list of options a command gives me.

May be you should work on man2 or mane (man with examples). And people
who want to see examples in man pages can use your version of 'man'
pages. I wouldn't want my man pages to have example code, please!


Shaks <cyborg4k@xxxxxxxxx> writes:

"Isn't that one of the reasons we have info pages?"

info pages don't give you examples, only an
explanation for the options. We are more concerned
here about giving illustrative examples.

"I think you should be considering DocBook XML for
documentation - you
can choose man, info, HTML, rich text format or plain
text output after
preparing the documentation proper and marking them up
(or mark-upping
them?)"

Sure,

Shaks

=====
--------------------------------------------------------------------------
Gentoo Linux 1.4 (2.6.5-mm1) / FreeBSD Unix 4.9 - Pentium M 1.40GHz - 512 MB 
- 40 GB - 14" - 4.5-4.9 lbs - CD-RW/DVD-ROM - Intel PRO/1000 Gigabit Ethernet 
- Intel PRO/Wireless Network Connection 802.11b
                                                  http://www.rit.edu/~sak5991
--------------------------------------------------------------------------


      
              
__________________________________
Do you Yahoo!?
Win a $20,000 Career Makeover at Yahoo! HotJobs  
http://hotjobs.sweepstakes.yahoo.com/careermakeover ;
_______________________________________________
To unsubscribe, email ilugc-request@xxxxxxxxxxxxx with 
"unsubscribe <password> address"
in the subject or body of the message.  
http://www.ae.iitm.ac.in/mailman/listinfo/ilugc



-- 
Arvind Kalyan (arv) <arvy at kongu dot ac dot in>
i=0141;do{putchar(i);i=i&1?(0x10|i&0xf0)|(i&0xf)<<1:i&4?0:i|4;}while(i);


From phani kumar" <phanichv@xxxxxxxxxxxxxx  Wed Apr 28 16:26:51 2004
From: phani kumar" <phanichv@xxxxxxxxxxxxxx (phani kumar)
Date: 28 Apr 2004 16:26:51 -0000
Subject: [Ilugc] sound problem
Message-ID: <20040428162651.31115.qmail@xxxxxxxxxxxxxxxxxxxxxxx>

 This is a multipart mime message


--Next_1083169611---0-202.54.124.178-31107
Content-type: text/html;
        charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline

<P>=0AHai everybody,<BR>=0A<BR>=0AI have a opti sound card in my comp. I ha=
ve RedHat 8 installed in it. The problem is that while booting the sound ca=
rd modules does not get loaded. When I do a &quot;sndconfig&quot; it will d=
etect the sound card and play test sound and every thing works with sound w=
ell until I shutdown the system. Again, when I boot the system, I have to d=
o sndconfig to load the sound card modules.<BR>=0A<BR>=0AThe modules.conf f=
ile is being overwritten by sndconfig successfully and it contains all the =
required modules to be loaded.<BR>=0A<BR>=0AWhat might be my problem? Pleas=
e help me to solve it.<BR>=0A<BR>=0APhani Kumar<BR>=0A=0A</P>=0A=0A=0ACH.V.=
PHANI KUMAR<br>=0A239, Brahmaputra&nbsp;Hostel<br>=0AIIT Madras,<br>=0AChen=
nai -&nbsp;600036<br>=0A<br>=0ACell -&nbsp;9444103019<br><br>=0A<A target=
=3D"_blank" HREF=3D"http://clients.rediff.com/signature/track_sig.asp";><IMG=
 SRC=3D"http://ads.rediff.com/RealMedia/ads/adstream_nx.cgi/www.rediffmail.=
com/inbox.htm@Bottom" BORDER=3D0 VSPACE=3D0 HSPACE=3D0></a>=0A
--Next_1083169611---0-202.54.124.178-31107
Content-type: text/plain;
        charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline

Hai everybody,=0A=0AI have a opti sound card in my comp. I have RedHat 8 in=
stalled in it. The problem is that while booting the sound card modules doe=
s not get loaded. When I do a "sndconfig" it will detect the sound card and=
 play test sound and every thing works with sound well until I shutdown the=
 system. Again, when I boot the system, I have to do sndconfig to load the =
sound card modules.=0A=0AThe modules.conf file is being overwritten by sndc=
onfig successfully and it contains all the required modules to be loaded.=
=0A=0AWhat might be my problem? Please help me to solve it.=0A=0APhani Kuma=
r=0A=0A=0ACH.V.PHANI KUMAR=0A239, Brahmaputra Hostel=0AIIT Madras,=0AChenna=
i - 600036=0A=0ACell - 9444103019
--Next_1083169611---0-202.54.124.178-31107--


Other related posts: