discuss: Thread: Linux documentation


[<<] [<] Page 1 of 2 [>] [>>]
Subject: Linux documentation
From: Steven ####@####.####
Date: 13 Sep 2007 11:29:55 +0000
Message-Id: <309467.4048.qm@web53204.mail.re2.yahoo.com>

At ####@####.#### (the Linux Documentation Project), David Lawyer wrote:

> Although our leader has been inactive for years, he formally resigned per an
> email sent to the staff list on 7 Sept. 2007.  People on this list seem to
> think it's fine to continue as we've been doing without a leader.  Well, I
> think if we could find a good leader that had the time we would be better off.

Time, technical ability, and affability. This last quality often seems in
shortest supply for oss projects. Our forums seem pretty friendly to me :) even
if some of our pages are prehistory.

... Volunteers ?

How are the html man pages going ? (have i missed some news ?) Hmmm... the idea
is nice, but maybe not so worthwhile considering the poor state of Linux man
pages in general.

One of my pet hates is the slack regard GNU and the kernel team appear to have
for man pages, which imho are a great, simple documentation format. (KDE also
have a beautiful front-end for them. In konqueror open "man:halt" for example).
They are *all* either old, appearing that way, or deprecated for the info
format which... the less said the better.

Lets face it , Linux has a great kernel but the doco and user interface are
really suffering from a lack of leadership and consistency. This is part of the
reason Mickeysoft are still the main desktop player, bit players like Archlinux
get any exposure, and Ubuntu have community momentum.  IBM / Novell / Redhat /
LinuxFoundation have ignored this issue too long. Together, they have to win
the desktop before they can relegate Mickeysoft to laughable history as they
deserve.  (Really - vista is not much more than an industry sponsored spyware
layer to xp, itself an exercise in locking business and home into the one
platform - though win98 *wasn't* a great OS overall). The recent and on-going
kerfufus over at kerneltrap.org about Con's scheduling patches seem to me
related to this leadership issue.  I'm not bashing Linus... He's #1, but not
the desktop messiah we'd like.

... The mailing list ~has~ been quiet :>

- Steven.



      ____________________________________________________________________________________
Luggage? GPS? Comic books? 
Check out fitting gifts for grads at Yahoo! Search
http://search.yahoo.com/search?fr=oni_on_mail&p=graduation+gifts&cs=bz
Subject: Re: [discuss] Linux documentation
From: Sam Varshavchik ####@####.####
Date: 13 Sep 2007 22:48:16 +0000
Message-Id: <cone.1189723665.741972.16049.500@commodore.email-scan.com>

Steven writes:

> How are the html man pages going ? (have i missed some news ?) Hmmm... the idea
> is nice, but maybe not so worthwhile considering the poor state of Linux man
> pages in general.

They're doing just fine, thank you for asking. Besides the core man pages 
set, I also have coreutils, util-linux, gnutls, openldap, linuxpam, SDL, and 
PCRE man pages, as nicely-rendered HTML.

http://www.tldp.org/manpages/man-html/



--> -->
 
 
<type 'exceptions.IOError'>
Python 2.5.2: /usr/bin/python
Fri May 17 03:52:32 2024

A problem occurred in a Python script. Here is the sequence of function calls leading up to the error, in the order they occurred.

 /opt/ezmlm-browse-0.20/<string> in ()
 /opt/ezmlm-browse-0.20/main.py in main()
  424 
  425         if path is not None:
  426                 main_path(path)
  427         else:
  428                 main_form()
global main_form = <function main_form at 0x9ea7c6c>
 /opt/ezmlm-browse-0.20/main.py in main_form()
  378         except ImportError:
  379                 die(ctxt, "Invalid command")
  380         module.do(ctxt)
  381 
  382 def main():
module = <module 'commands.showthread' from '/opt/ezmlm-browse-0.20/commands/showthread.pyc'>, module.do = <function do at 0x9ec2b1c>, global ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}
 /opt/ezmlm-browse-0.20/commands/showthread.py in do(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'})
    9         ctxt.update(ezmlm.thread(ctxt[THREADID]))
   10         header(ctxt, 'Thread: ' + ctxt[SUBJECT], 'showthread')
   11         do_list(ctxt, 'msgs', ctxt[MSGSPERPAGE], ctxt[MESSAGES],
   12                         lambda:sub_showmsg(ctxt, ctxt[MSGNUM]))
   13         footer(ctxt)
global sub_showmsg = <function sub_showmsg at 0x9ea71ec>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, global MSGNUM = 'msgnum'
 /opt/ezmlm-browse-0.20/globalfns.py in do_list(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, name='msgs', perpage=10, values=[{'author': u'Steven', 'authorid': 'cnmdaobedbobmpjbghal', 'date': '13 Sep 2007 11:29:55 +0000', 'month': 200709, 'msgnum': 10391, 'subject': u'Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1189682995.0}, {'author': u'Sam Varshavchik', 'authorid': 'efnhgfakkkdlpfbcfkgp', 'date': '13 Sep 2007 22:48:16 +0000', 'month': 200709, 'msgnum': 10392, 'subject': u'Re: Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1189723696.0}, {'author': u'jdd', 'authorid': 'kmhebagfemoedpejdpbn', 'date': '14 Sep 2007 06:03:52 +0000', 'month': 200709, 'msgnum': 10393, 'subject': u'Re: Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1189749832.0}, {'author': u'Sergiusz Pawlowicz', 'authorid': 'lapblejjgaalkeidnfij', 'date': '14 Sep 2007 08:55:04 +0000', 'month': 200709, 'msgnum': 10394, 'subject': u'Re: Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1189760104.0}, {'author': u'jdd', 'authorid': 'kmhebagfemoedpejdpbn', 'date': '14 Sep 2007 10:29:13 +0000', 'month': 200709, 'msgnum': 10395, 'subject': u'Re: Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1189765753.0}, {'author': u'John Eikenberry', 'authorid': 'lkbkcmaamhomjleacepc', 'date': '14 Sep 2007 17:18:44 +0000', 'month': 200709, 'msgnum': 10396, 'subject': u'Re: Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1189790324.0}, {'author': u'Steven', 'authorid': 'cnmdaobedbobmpjbghal', 'date': '15 Sep 2007 07:15:52 +0000', 'month': 200709, 'msgnum': 10397, 'subject': u'Re: Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1189840552.0}, {'author': u'Michael Kerrisk', 'authorid': 'kfhjllckiilailgdfnkd', 'date': '21 Sep 2007 20:58:42 +0000', 'month': 200709, 'msgnum': 10410, 'subject': u'Re: Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1190408322.0}, {'author': u'Steven', 'authorid': 'cnmdaobedbobmpjbghal', 'date': '23 Sep 2007 01:12:09 +0000', 'month': 200709, 'msgnum': 10413, 'subject': u'Re: Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1190509929.0}, {'author': u'Dan Scott', 'authorid': 'ogifmkdlbbgabjfhlhei', 'date': '23 Sep 2007 02:25:49 +0000', 'month': 200709, 'msgnum': 10414, 'subject': u'Re: Linux documentation', 'threadid': 'cinpibghijdpdmaajdda', 'timestamp': 1190514349.0}], peritem=<function <lambda> at 0x9ec2ca4>)
  128                 write(template % ctxt)
  129                 if peritem:
  130                         peritem()
  131                 ctxt[ROW] += 1
  132 
peritem = <function <lambda> at 0x9ec2ca4>
 /opt/ezmlm-browse-0.20/commands/showthread.py in ()
    9         ctxt.update(ezmlm.thread(ctxt[THREADID]))
   10         header(ctxt, 'Thread: ' + ctxt[SUBJECT], 'showthread')
   11         do_list(ctxt, 'msgs', ctxt[MSGSPERPAGE], ctxt[MESSAGES],
   12                         lambda:sub_showmsg(ctxt, ctxt[MSGNUM]))
   13         footer(ctxt)
global sub_showmsg = <function sub_showmsg at 0x9ea71ec>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, global MSGNUM = 'msgnum'
 /opt/ezmlm-browse-0.20/globalfns.py in sub_showmsg(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msgnum=10392)
  229         format_timestamp(ctxt, ctxt)
  230         write(html('msg-header') % ctxt)
  231         rec_showpart(ctxt, msg, 0)
  232         write(html('msg-footer') % ctxt)
  233         ctxt.pop()
global rec_showpart = <function rec_showpart at 0x9ea71b4>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msg = <email.message.Message instance at 0x9f603ec>
 /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x9f603ec>, partnum=1)
  205                 else:
  206                         for p in part.get_payload():
  207                                 partnum = rec_showpart(ctxt, p, partnum+1)
  208         else:
  209                 write(html('msg-sep') % ctxt)
partnum = 1, global rec_showpart = <function rec_showpart at 0x9ea71b4>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, p = <email.message.Message instance at 0x9f60fcc>
 /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x9f60fcc>, partnum=2)
  208         else:
  209                 write(html('msg-sep') % ctxt)
  210                 sub_showpart(ctxt, part)
  211         return partnum
  212 
global sub_showpart = <function sub_showpart at 0x9ea7144>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part = <email.message.Message instance at 0x9f60fcc>
 /opt/ezmlm-browse-0.20/globalfns.py in sub_showpart(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x9f60fcc>)
  164         type = ctxt[TYPE] = part.get_content_type()
  165         ctxt[FILENAME] = part.get_filename()
  166         template = html('msg-' + type.replace('/', '-'))
  167         if not template:
  168                 template = html('msg-' + type[:type.find('/')])
global template = <function template at 0x9e9fe9c>, global html = <function html at 0x9e9fed4>, type = 'application/pgp-signature', type.replace = <built-in method replace of str object at 0x9f620c8>
 /opt/ezmlm-browse-0.20/globalfns.py in html(name='msg-application-pgp-signature')
   40 
   41 def html(name):
   42         return template(name + '.html')
   43 
   44 def xml(name):
global template = <function template at 0x9e9fe9c>, name = 'msg-application-pgp-signature'
 /opt/ezmlm-browse-0.20/globalfns.py in template(filename='msg-application-pgp-signature.html')
   31         except IOError:
   32                 if not _template_zipfile:
   33                         _template_zipfile = zipfile.ZipFile(sys.argv[0])
   34                 try:
   35                         f = _template_zipfile.open(n).read()
global _template_zipfile = None, global zipfile = <module 'zipfile' from '/usr/lib/python2.5/zipfile.pyc'>, zipfile.ZipFile = <class zipfile.ZipFile at 0x9e38a7c>, global sys = <module 'sys' (built-in)>, sys.argv = ['-c', '/opt/ezmlm-browse-0.20']
 /usr/lib/python2.5/zipfile.py in __init__(self=<zipfile.ZipFile instance at 0x9f6030c>, file='-c', mode='r', compression=0, allowZip64=False)
  337             self.filename = file
  338             modeDict = {'r' : 'rb', 'w': 'wb', 'a' : 'r+b'}
  339             self.fp = open(file, modeDict[mode])
  340         else:
  341             self._filePassed = 1
self = <zipfile.ZipFile instance at 0x9f6030c>, self.fp = None, builtin open = <built-in function open>, file = '-c', modeDict = {'a': 'r+b', 'r': 'rb', 'w': 'wb'}, mode = 'r'

<type 'exceptions.IOError'>: [Errno 2] No such file or directory: '-c'
      args = (2, 'No such file or directory')
      errno = 2
      filename = '-c'
      message = ''
      strerror = 'No such file or directory'