Re: [ilugd] Convert man pages to hyperlinked doc?

2008-05-01 Thread Sirtaj Singh Kang
On Thursday 01 May 2008, Mahesh T. Pai wrote:
[snip]
 Man!!! As if loving man pages was a pre-requisite for loving the OS!!!

It's not just man. I also hate apropos. Amd I think GNU /bin/yes is
buggy and lacks important features.

-Taj.



___
ilugd mailinglist -- ilugd@lists.linux-delhi.org
http://frodo.hserus.net/mailman/listinfo/ilugd
Next Event: http://freed.in - February 22-24, 2008
Archives at: http://news.gmane.org/gmane.user-groups.linux.delhi 
http://www.mail-archive.com/ilugd@lists.linux-delhi.org/


Re: [ilugd] Convert man pages to hyperlinked doc?

2008-05-01 Thread Sirtaj Singh Kang
On Thursday 01 May 2008, Kenneth Gonsalves wrote:
 On 30-Apr-08, at 10:03 PM, Sirtaj Singh Kang wrote:
  I am here to destroy my little cred as a long-time unix-lover with a
  single statement: I really don't like man pages.

 don't tell me you have stopped wearing a hair shirt and no longer
 sleep on a bed of nails. Shame on you.

Oh I do. But now it's more out of habit than conviction.

-Taj.


___
ilugd mailinglist -- ilugd@lists.linux-delhi.org
http://frodo.hserus.net/mailman/listinfo/ilugd
Next Event: http://freed.in - February 22-24, 2008
Archives at: http://news.gmane.org/gmane.user-groups.linux.delhi 
http://www.mail-archive.com/ilugd@lists.linux-delhi.org/


[ilugd] Convert man pages to hyperlinked doc?

2008-04-30 Thread Sirtaj Singh Kang

I am here to destroy my little cred as a long-time unix-lover with a
single statement: I really don't like man pages.

-- rant, please ignore -

They are sometimes nice as a reference, terrible as tutorials, and very
bad for searching for specific pieces of information when you don't know
the exact term to search with, scaling very poorly when they grow large
(take a look at the man page for bash if you don't believe me).

Some tools come with docs in the truly lovely and usable info format
(thanks tons KDE et al for actually making it possible to read info
without wondering how to close the viewer), but these not very common.

--

What I am looking for is something that can convert a given man page to
HTML or some other similar format, with such new-fangled features like
a useful table of contents, perhaps even an index.

Is there some tool to do this?

-Taj.


___
ilugd mailinglist -- ilugd@lists.linux-delhi.org
http://frodo.hserus.net/mailman/listinfo/ilugd
Next Event: http://freed.in - February 22-24, 2008
Archives at: http://news.gmane.org/gmane.user-groups.linux.delhi 
http://www.mail-archive.com/ilugd@lists.linux-delhi.org/


Re: [ilugd] Convert man pages to hyperlinked doc?

2008-04-30 Thread Ashish Shukla आशीष शुक्ल
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

 Sirtaj == Sirtaj Singh Kang [EMAIL PROTECTED] writes:

Sirtaj What I am looking for is something that can convert a given man 
page to
Sirtaj HTML or some other similar format, with such new-fangled features 
like
Sirtaj a useful table of contents, perhaps even an index.

Sirtaj Is there some tool to do this?

man2html[1], konqueror already does this, when you do, man:ls .

Sirtaj -Taj.

[1] - http://www.nongnu.org/man2html/

HTH
- -- 
Ashish Shukla आशीष शुक्ल  http://wahjava.wordpress.com/
·-- ·-  ·--- ·- ···- ·- ·--·-· --· -- ·- ·· ·-·· ·-·-·- -·-· --- --
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFIGKJlHy+EEHYuXnQRAiLyAKCB9AGmYzmcdtuA1L0ZMZ7Ov4efcgCgvMik
xfzOLFavhMoST5rkvbPUmAc=
=DQNc
-END PGP SIGNATURE-

___
ilugd mailinglist -- ilugd@lists.linux-delhi.org
http://frodo.hserus.net/mailman/listinfo/ilugd
Next Event: http://freed.in - February 22-24, 2008
Archives at: http://news.gmane.org/gmane.user-groups.linux.delhi 
http://www.mail-archive.com/ilugd@lists.linux-delhi.org/


Re: [ilugd] Convert man pages to hyperlinked doc?

2008-04-30 Thread Sirtaj Singh Kang

On Wednesday 30 April 2008, Ashish Shukla आशीष शुक्ल wrote:
[snip]
 man2html[1], konqueror already does this, when you do, man:ls .

I'm aware of that, and yes it's a pretty major improvement from reading
the page in a terminal, but it still doesn't do TOC or hyperlinks of
any kind.

I grok the problem that troff is not really designed for semantic markup
but for presentation, but surely there are some heuristics that can be
applied for conversions in the common case...

-Taj.


___
ilugd mailinglist -- ilugd@lists.linux-delhi.org
http://frodo.hserus.net/mailman/listinfo/ilugd
Next Event: http://freed.in - February 22-24, 2008
Archives at: http://news.gmane.org/gmane.user-groups.linux.delhi 
http://www.mail-archive.com/ilugd@lists.linux-delhi.org/


Re: [ilugd] Convert man pages to hyperlinked doc?

2008-04-30 Thread Mayank
On Wed, Apr 30, 2008 at 10:20 PM, Sirtaj Singh Kang [EMAIL PROTECTED] wrote:


 On Wednesday 30 April 2008, Ashish Shukla आशीष शुक्ल wrote:
 [snip]
  man2html[1], konqueror already does this, when you do, man:ls .

 I'm aware of that, and yes it's a pretty major improvement from reading
 the page in a terminal, but it still doesn't do TOC or hyperlinks of
 any kind.

 I grok the problem that troff is not really designed for semantic markup
 but for presentation, but surely there are some heuristics that can be
 applied for conversions in the common case...

 -Taj.


 ___
 ilugd mailinglist -- ilugd@lists.linux-delhi.org
 http://frodo.hserus.net/mailman/listinfo/ilugd
 Next Event: http://freed.in - February 22-24, 2008
 Archives at: http://news.gmane.org/gmane.user-groups.linux.delhi
 http://www.mail-archive.com/ilugd@lists.linux-delhi.org/



Hi,
You can try TkMan (http://tkman.sourceforge.net) as man pages and
texinfo browser. Or if you really wish to export the contents to HTML then
maybe PolyglotMan (http://polyglotman.sourceforge.net) can be of some help,
btw I've never tried using this software :)

Regards,
Mayank
___
ilugd mailinglist -- ilugd@lists.linux-delhi.org
http://frodo.hserus.net/mailman/listinfo/ilugd
Next Event: http://freed.in - February 22-24, 2008
Archives at: http://news.gmane.org/gmane.user-groups.linux.delhi 
http://www.mail-archive.com/ilugd@lists.linux-delhi.org/


Re: [ilugd] Convert man pages to hyperlinked doc?

2008-04-30 Thread Kenneth Gonsalves

On 30-Apr-08, at 10:03 PM, Sirtaj Singh Kang wrote:

 I am here to destroy my little cred as a long-time unix-lover with a
 single statement: I really don't like man pages.

don't tell me you have stopped wearing a hair shirt and no longer  
sleep on a bed of nails. Shame on you.


-- 
regards

Kenneth Gonsalves
Associate, NRC-FOSS
[EMAIL PROTECTED]
http://nrcfosshelpline.in/code/





___
ilugd mailinglist -- ilugd@lists.linux-delhi.org
http://frodo.hserus.net/mailman/listinfo/ilugd
Next Event: http://freed.in - February 22-24, 2008
Archives at: http://news.gmane.org/gmane.user-groups.linux.delhi 
http://www.mail-archive.com/ilugd@lists.linux-delhi.org/