discuss: Goodbye!


Previous by date: 9 Apr 2005 12:16:46 -0000 Re: Goodbye!, Rahul Sundaram
Next by date: 9 Apr 2005 12:16:46 -0000 Re: Goodbye!, Rahul Sundaram
Previous in thread: 9 Apr 2005 12:16:46 -0000 Re: Goodbye!, Rahul Sundaram
Next in thread: 9 Apr 2005 12:16:46 -0000 Re: Goodbye!, Rahul Sundaram

Subject: Re: Goodbye!
From: Alex Nordstrom ####@####.####
Date: 9 Apr 2005 12:16:46 -0000
Message-Id: <200504092016.37935.lx@se.linux.org>

On Sat, 9 Apr 2005 19:41, Andrew M.A. Cater wrote:
> There is a danger, however, that if we don't write general documents
> we will end up with more vendor-specific documentation and less
> general applicability - in order to troubleshoot, say, a buggy
> network problem you'll need to trawl through five distributors
> documentation, mailing lists or bug trackers to appreciate that it's
> a general problem and synthesise the solution.

I don't think anyone is disputing the merits of distribution-agnostic 
documentation once it's written. The problem is the burden that it 
places on authors to research distribution differences. Sometimes it's 
not even that obvious what potential differences to research might be.

The only way one can reasonably expect to resolve this is through 
cooperation. The suggestion has been made that TLDP should have subject 
specialists. Perhaps experts with broader domains--distributions--might 
also be useful to incorporate in the review process. If distribution 
agnosticism is to remain a goal (which I believe it should), this needs 
to be controlled just like spelling.

> If you want to be the documentation
> leaders, be prepared to use one format [Docbook], provide better
> style guidelines and actively help people build better docs. Be
> generous in what you accept, be rigorous in what you put out. Be
> prepared to work with the authors of documentation not in English and
> help arrange translations both ways to get better documentation
> worldwide

I agree with your views and wish to subscribe to your newsletter. As 
someone who is trying to resuscitate an effort to translate TLDP 
documents, I would sincerely appreciate all the pointers I can get. I'm 
working my way through the general metadocumentation, but there doesn't 
seem to be a lot of relevant material for translators and translation 
coordinators. Am I just not looking hard enough, or should I expect to 
be the one writing that documentation?

> As it is, there is a plethora of incompatible licences and a
> commercial/ non-commercial split developing as well. Pick one licence
> - GPL/CC would be my choice but allowing the possibility of
> dual-licensing - and stick to it.

Once again, agreed. I fully sympathise with the Debian project's 
criticisms against FDL and the CC licences. My personal preference 
would be GPL. CC attribution share-alike has the potential to become 
useful. Unlike FDL, it appears the intention has always been to make it 
a genuinely free licence, and the wheels are in motion to correct its 
problems.

I am new around here. Please accept my apologies for any incorrect 
assumptions or oversights I have made above and do point them out.

-- 
Alex Nordstrom
http://lx.n3.net/
Please do not CC me in followups;
I am subscribed to the tldp discussion list.

--> -->
 
 
<type 'exceptions.IOError'>
Python 2.5.2: /usr/bin/python
Fri Jul 5 19:15:08 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 0xa1a6c6c>
 /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.showmsg' from '/opt/ezmlm-browse-0.20/commands/showmsg.pyc'>, module.do = <function do at 0xa1b0764>, global ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}
 /opt/ezmlm-browse-0.20/commands/showmsg.py in do(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'})
   18         write(html('msg-pager') % ctxt)
   19         write('<hr>')
   20         sub_showmsg(ctxt, ctxt[MSGNUM])
   21         write('<hr>')
   22         write(html('msg-pager') % ctxt)
global sub_showmsg = <function sub_showmsg at 0xa1a61ec>, ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, global MSGNUM = 'msgnum'
 /opt/ezmlm-browse-0.20/globalfns.py in sub_showmsg(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msgnum=9229)
  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 0xa1a61b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msg = <email.message.Message instance at 0xa203d0c>
 /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0xa203d0c>, 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 0xa1a61b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, p = <email.message.Message instance at 0xa203d4c>
 /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0xa203d4c>, 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 0xa1a6144>, ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part = <email.message.Message instance at 0xa203d4c>
 /opt/ezmlm-browse-0.20/globalfns.py in sub_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0xa203d4c>)
  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 0xa19ee9c>, global html = <function html at 0xa19eed4>, type = 'application/pgp-signature', type.replace = <built-in method replace of str object at 0xa209fa8>
 /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 0xa19ee9c>, 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 0xa137a7c>, 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 0xa1b2a4c>, 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 0xa1b2a4c>, 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'